graphics: OPTIONS

LOGARITHMIC-X

Requests the x-axis be logarithmic in the following plot.

This option is also set by various commands - it may therefore happen that your request is overruled. E.g. some gas plots have forced logarithmic scales, the logarithmic and linear options are reset when these plots are produced.

LOGARITHMIC-Y

Requests the y-axis be logarithmic in the following plot.

GRID

Requests a grid be overlaid on the following plots, which can make reading the values easier.

The grid is plotted with the representation GRID.

In Cartesian log scale plots covering more than 1 decade, you can further choose whether you wish to have only the decade grid lines (DECADES-ONLY) or all grid lines (COMPLETE-GRID).

[By default, no grid is displayed.]

DECADES-ONLY

Specifies that, in a Cartesian plot with a log scale covering more than 1 decade, only the decade grid lines are to be plotted and not the grid lines for 2, 3,\ ...\ 9 times the decade.

The opposite, COMPLETE-GRID, requests all grid lines to be shown.

This option has effect only when the GRID option is in effect.

[Initially, COMPLETE-GRID is selected.]

TIME-STAMP

Requests a time stamp be displayed on each plot. The string displayed in the time stamp can be modified with the STAMP graphics command.

[By default, a time stamp is displayed and the stamp indicated by default the version of Garfield used for making the plot.]

CLEAR-BEFORE-PLOT

By default, the (graphics) screen is cleared before and after a plot has been made. If you wish to overlay several plots, you have to suppress the clears with the NOCLEAR-BEFORE-PLOT and NOCLEAR-AFTER-PLOT options.

CLEAR-AFTER-PLOT

On workstations where graphics and printout are displayed in different windows, the automatic clear of the graphics screen after each plot is useless. You can suppress it by requesting NOCLEAR-AFTER-PLOT.

The NOCLEAR-AFTER-PLOT option is primarily used when one wishes to add elements to a plot. This option can, in combination with CLEAR-BEFORE-PLOT, also be used to overlay two consecutive plots.

When overlaying plots, it is advisable to use the REPRESENTATION command to set the colours of the TITLE, the LABELS and the NUMBERS to BACKGROUND in all but the last plot.

Example:

!options noclear-after nowait-after-plot !representation title text-colour background !rep numbers text-colour background !rep labels text-colour background

&FIELD area -1 -1 1 1 plot-field cont v

!options noclear-before-plot !rep numbers text-colour foreground !rep labels text-colour foreground

&DRIFT area -1 -1 1 1 drift wire

!rep title text-colour red !options wait-after-plot Call GKS_select_nt(0) Call plot_text(0.1,0.95,`My own title`,`title`) Call plot_end

!options clear-before-plot

WAIT-BEFORE-PLOT

By default, a prompt is displayed to hit return before any graphics output is sent to the screen.

This is useful on ordinary terminals, but less so on workstations, and you may wish to switch this option off on such devices.

WAIT-AFTER-PLOT

By default, a message is displayed when the plot is finished and the user is then prompted to hit the return key before the screen is switched back to alphanumeric mode.

This behaviour is not meaningful on workstations and it might therefore be a good idea to switch this option off on such devices.

DISPLAY-CONTROL-CHARACTERS

Various characters have a special meaning for the underlying graphics system. With HPLOT for instance, the symbols [ and ] are used to indicate that the enclosed text should be shown using the Greek font.

If you wish special characters to be interpreted this way, then specify the option EXECUTE-CONTROL-CHARACTERS. But many of the built-in plots contain special characters, e.g. [ and ] are used as delimiters of the units. These plots will therefore not come out right if you switch this option on. In practice, this option is only useful if you wish to have full control, in user plots, over the special characters that a specific graphics system offers.

If on the other hand you select DISPLAY-CONTROL-CHARACTERS, then [ and ] are displayed as such. Furthermore, on some graphics systems, several special symbols are easily accessible:

In units (recognised by the squared brackets that enclose them), the strings 'cm2', 'cm3', 'micron', 'microsec' and 'microamp', are shown in their usual way (superscript 2 for 'cm2', Greek mu for 'micron' etc.
Some particle names (e.g. electron-, mu+, tau-) as well as some chemical compounds (e.g. CO2, C3H8) are shown the way they are normally printed with superscripts to indicate the charge and subscripts showing the number of atoms per molecule.
Greek letters, diacritics and ligatures are accessible as SGML entities, e.g. &Ksi; é and ß. For a list of SGML entities, see for instance: http://home.eclipse.net/~lionheart/html/entities.html
Superscript and subscript can be produced using SGML tags, e.g. <SUP>55</SUP>Fe and CO<SUB>2</SUB>.

[The default is DISPLAY-CONTROL-CHARACTERS.]

CLIP-AREAS

This option has currently no effect.

[This option is on by default.]

CLIP-LINES

Most line plotting procedures, both those used internally by Garfield and PLOT_LINE remove portions which are located outside the main plot window and which could therefore overlap with the labels and the numbers along the axes.

If you wish to plot lines in these areas, then you've to switch this option off - otherwise plots will look more clean if you leave the option switched on.

[This option is on by default.]

CLIP-MARKERS

Most marker plotting procedures, both those used internally by Garfield and PLOT_MARKERS remove markers which are located outside the main plot window and which could therefore overlap with the labels and the numbers along the axes.

If you wish to plot markers in these areas, then you've to switch this option off - otherwise plots will look more clean if you leave the option switched on.

Note that markers are either plotted entirely or not at all. This option does not control removing parts of a marker that are outside the main plot window.

[This option is on by default.]

CLIP-TEXT

This option has currently no effect.

[This option is on by default.]

Go to the top level, to graphics, to OPTIONS, to the topic index, to the table of contents, or to the full text.

Formatted on 21/01/18 at 16:55.