CERN home page CERN home page Consult pages Consult pages Writeups at CERN Writeups at CERN Garfield pages Garfield pages Help Help graphics graphics This page This page Table of contents Keyword index

graphics: OPTIONS


LOGARITHMIC-X

Requests the x axis be logarithmic in the following plot.

This option is used mainly internally but you can use it from the input too. Don't be surprised however if your request is overruled !


LOGARITHMIC-Y

Requests the y axis be logarithmic in the following plot.

This option is used mainly internally but you can use it from the input too. Don't be surprised however if your request is overruled !


GRID

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

The grid is plotted with the representation GRID.

[By default, no grid is displayed.]


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:

!opt noclear-after nowait-after
!rep title text-colour background
!rep numbers text-colour background
!rep labels text-colour background

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

!opt noclear-before !rep numbers text-colour foreground !rep labels text-colour foreground

&DRIFT area -1 -1 1 1 drift wire

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

!opt clear-before


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:

  1. 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.
  2. 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.
  3. Greek letters, diacritics and ligatures are accessible as SGML entities, e.g. &Ksi; é and ß (for a list, see entities) For a list of SGML entities, see for instance: http://home.eclipse.net/~lionheart/html/entities.html

[The default is DISPLAY-CONTROL-CHARACTERS.]


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

Formatted on 0100-08-27 at 04:53.