Save the default view of a geomap object to disk as a Windows metafile (.EMF or .WMF), PostScript (.EPS), bitmap (.BMP), Graphics Interchange Format (.GIF), Joint Photographic Experts Exchange (.JPEG), Portable Network Graphics (.PNG), Portable Document Format (.PDF), LaTeX (.TEX), or Markdown (.MD).
Syntax
geomap_name.save(options) [path\]file_name
Follow the keyword with a name for the file. file_name may include the file type extension, or the file type may be specified using the “t=” option. A geomap may be saved with an EMF, WMF, EPS, BMP, GIF, JPG, PNG, PDF, or MD extension. The MD (Markdown) setting uses very basic syntax and should be usable in most editors.
If an explicit path is not specified, the file will be stored in the default directory, as set in the global options.
Options
t=file_type | Specifies the file type, where file_type may be one of: Enhanced Windows metafile (“emf” or “meta”), ordinary Windows metafile (“wmf”), Encapsulated PostScript (“eps” or “ps”), Bitmap file (“bmp”), Graphics Interchange Format (“gif”), Joint Photographic Experts Exchange (“jpeg” or “jpg”), Portable Network Graphics (“png”), Portable Document Format (“pdf”), LaTeX (“tex”), or Markdown (“md”). Files will be saved with the “.emf”, “.wmf”, “.eps”, “.bmp”, “.gif”, “.jpeg”, “.png”, “.pdf”, “.tex”, or “.md” extensions, respectively. |
u=units | Specify units of measurement, where units is one of: “in” (inches), “cm” (centimeters), “pt” (points), “pica” (picas), “pixels” (pixels). Note: pixels are only applicable to bmp, gif, jpeg, and png files. Default is inches otherwise. |
w=width | Set width of the graphic in the selected units. |
h=height | Set height of the graphic in the selected units. |
c / -c | [Save / Do not save] the geomap in color. |
trans / -trans | [Set / Do not set] background to transparent (for graph formats which support transparency). |
d = dpi | Specify the number of dots per inch. Only applicable to bmp, gif, jpeg, and png files when units has not been set to pixels. In the case units = “pixels”, it is ignored. |
Note that if only a width or a height option is specified, EViews will calculate the other dimension holding the aspect ratio of the geomap constant. If both width and height are provided, the aspect ratio will no longer be locked. (Note that the aspect ratio for an ordinary Windows Metafile (.WMF) cannot be unlocked, so only a height or width should be specified in this case.) EViews will default to the current geomap dimensions if size is unspecified.
All defaults with exception to dots per inch are taken from the global graph export settings (Options/Graphics Defaults.../Exporting). The default dots per inch for bmp, gif, jpeg, and png file types is equal to the number of pixels per logical inch along the screen width of your system. Values may therefore differ from system to system.
Postscript Options
box / -box | [Save / Do not save] the geomap with a bounding box. The bounding box is an invisible rectangle placed around the graphic to indicate its boundaries. The default is taken from the global graph export settings. |
land | Save the geomap in landscape orientation. The default uses portrait mode. |
prompt | Force the dialog to appear from within a program. |
LaTeX Options
texspec / -texspec | [Include / Do not include] the full LaTeX documentation specification in the LaTeX output. The default behavior is taken from the global default settings. |
Examples
gmap1.save(t=ps, -box, land) c:\data\MyGra1
saves GMAP1 as a PostScript file “MyGra1.EPS”. The geomap is saved in landscape orientation without a bounding box.
gmap2.save(t=emf, u=pts, w=300, h=300) MyGra2
saves GMAP2 in the default directory as an Enhanced Windows metafile “MyGra2.EMF”. The image will be scaled to
points.
gmap3.save(t=png, u=in, w=5, d=300) MyGra3
saves GMAP3 in the default directory as a PNG file “MyGra3.PNG”. The image will be 5 inches wide at 300 dpi.
Cross-references
See
“Geomaps” for a discussion of geomaps.