2 The structure of a WRplot le

Preface:

A WRplot le may contain several PLOTs and/or MULTIPLOTs. The rule is: One PLOT per page, unless it is in a MULTIPLOT (also one MULTIPLOT per page).

All WRplot commands need to be written in CAPITALS; small letters may, of course, within strings. Names of variables are case-sensitive.

Comment lines start with an * and may start (nearly) everywhere. Blanks are allowed in (nearly) all places, too.

Parameters can be separated as desired: a delimiter (comma, equality sign or colon), one or more blanks, or a delimiter and blanks. The TAB-character is interpreted as blanks.

Lines may be up to 132 characters long. KASDEF-commands can have continuation lines (see Ch. 3).

Attention, emacs users! WRplot is a fortran program. fortran reads in formatted les line by line. Each line must end with a carriage-return symbol (CR, \Enter"-button). Some editors, especially emacs in its default settings, do not close the last line of a le with a CR but directly with an end-of-le (EOF). The last line can not be read by fortran, then. To avoid this in emacs or xemacs, add this line
(setq require-final-newline t) ; always add a newline at EOF
into the conguration le .emacs or .xemacs/custom.el, respectively. Alternatively one always needs to add a blank line (CR) at the end of the le.

MULTIPLOT START

 
Optional; all following plots in the le until the occurrence of MULTIPLOT END are being added into a single plot.

PAPERFORMAT

<Format: string> [Keyword]
Optional; unless specied the default (A4Q) format is used.

Allowed formats: A4Q (default), A4H, A3Q, A3H etc. until A0; \H" = german Hochkant (Portrait), \Q" = Quer (Landscape), SCREEN and SCREEN2.

Allowed keywords: BBNOROTATE, BBROTATE, EPS.

Additionally to the AnH/Q formats, there are two additional formats: SCREEN and SCREEN2. The rst is a landscape format with an aspect ratio of 4:3, like a monitor screen. The short axis corresponds to the A4 equivalent, the long axis is slightly shorter (28.03 cm21.02 cm). The format SCREEN2 is even better; it has a aspect ratio of 4:3, too, and corresponds to the known media format ArchA. With this option one can create pdf les using the script ps2pdf_screen which look nice in the XVGA fullscreen mode.

The optional keywords BBNOROTATE (default) and BBROTATE allow the user to rotate the BondingBox. With BBROTATE landscape plots can e.g. be placed in LATEX portrait pages.

When using the optional keyword EPS, the produced PostScript le will be marked as an EPS le in its rst line without suppressing the showpage at the end (if needed, one can remove this manually from the ps le). This feature was added to improve the integration of WRplot-made PS les into Microsoft \word" documents.

FORMATFACTOR

<scale factor: real>
(Default=1., optional), scales the following plot or all plots of the multi-plot by the given scale factor.

PLOT :

[<plot name: string>]
Start of a plot. Plot name (optional) appears in the console window and may help to identify dierent plots in the same le, e.g. in the interactive mode.

KASDEF commands

(see Ch. 3)
Some KASDEF commands may be placed between the datasets but they are executed before the box and datasets are plotted. By KASDEF PAUSE (see below) the execution of the following KASDEF commands is delayed until the datasets are plotted. With KASDEF LATEBOX the plotting of the box is delayed to the end.

HEADER

: <title:string>
Upper caption of the plot. Following this line a sequence of ve lines is mandatory (they describe the plot box, see Ch. 4).

N=. . .

[Parameter]
In this line the description of the dataset starts (see Ch. 5).

END

or ENDE: End of the plot

MULTIPLOT END

or MULTIPLOT ENDE nishes the multi-plot started with MULTIPLOT START.