GSAVE Instruction

GSAVE( options ) template

Initiates (or turns off) automatic saving of graphs to disk. It replaces the older ENVIRONMENT GSAVE=... GFORMAT=... operation. The HEADER, FOOTER and PATTERNS options can be used to make changes in the exported graphs while keeping the original screen appearance.

Wizard

GSAVE sets up RATS to save graphs automatically as they are generated. You can save graphs after they are generated by doing File—Save As...

Parameters

template

A template (or a specific filename) to be used for saving graphs.

Options

FORMAT=[RGF]/PORTRAIT/LANDSCAPE/PDF/LPDF/WMF/PNG/PICT/JPEG

By default, graphs are saved in RGF (RATS Graph File) format. Use FORMAT to select a different format. PORTRAIT and LANDSCAPE are PostScript format in portrait and landscape orientations, respectively. PDF and LPDF are Adobe PDF in portrait and landscape modes respectively. Portrait means standard orientation so you don't have to rotate the page. To keep the proportions reasonable it will, by default, use only about the half of a page. Landscape rotates clockwise and, since the height of the page is then the width, uses the full page. PDF and LPDF were added with version 9.1. PNG is Portable Network Graphics (bitmap), which was added with version 9.2. JPEG is a digital photography format added with version 10.1.

WMF is Windows Metafile (or "Picture"), while PICT is an older Macintosh format. The availability of some formats is platform-dependent.

[HEADER]/NOHEADER

[FOOTER]/NOFOOTER

Use NOHEADER and/or NOFOOTER to strip off header or footer labels on the graph. This is useful if you want to use headers or footers to identify the graphs as displayed on screen in RATS, but don't want those labels included in the version saved to disk, such as when generating graphs for publication where any captions will be added in the word-processing software. If applied to an SPGRAPH or nested SPGRAPHs, only the headers/footers on the outer SPGRAPH will be stripped—any such labels on the individual graphs (or nested SPGRAPHs) are retained. This applies to all graphs saved or otherwise exported, whether with GSAVE, or menu operations.

PATTERNS/[NOPATTERNS]

Use PATTERNS to switch to black and white only when graphs are saved or exported—they will still show as color on the screen. This applies to all graphs saved or otherwise exported, whether with GSAVE, or menu operations.

Filename Templates

The template will usually be a filename string that includes an asterisk (*) symbol. For each graph you generate, RATS will save the graph using a filename constructed by replacing the asterisk with a sequence number. Omit the asterisk to save a single graph using a specific name.

Example

gsave(format=portrait,patterns) "ImpulseResponse*.eps"

@varirf(model=canmodel,steps=12,page=byshocks)

This uses the @VARIRF procedure to generate a set of impulse response graphs. The graphs will be saved as black and white PostScript files called "ImpulseResponse1.eps", "ImpulseResponse2.eps", and so on.