Display parameters
The are many different display parameters which affect the layout of a picture.
They may be specified at various places. These are, sorted by increasing priority:
a) defaults determined from the data,
b) in the input file on lines starting with P:.
c) with the command GPRESET
d) with the commands GPLOT, GDISP or GOVER.
Listed by functionality
Default
Mode
UNIT() mm
General
AUTO no
CHECK no
DEVICE() *
PALETTE() multi
FRAME no
NOFRAME no
XREL() 0
YREL() 0
XPOS() 0
YPOS() 0
CMODE() 1
COMMENT
NOCOMMENT no
DSNAME
NODSNAME no
Size
SIZE()
SCALING() 1
SCREL() 1
FORMAT() 0.7
XRSIZE() 1
YRSIZE() 1
Axes
AXES() yes
AXIS yes
NOAXIS no
AXFAC() 1
AXCOLOUR()
TICIN yes
TICOUT no
XGRID yes
XNUMBER yes
YGRID yes
YNUMBER yes
NOXGRID yes
NOXNUMBER no
NOYGRID yes
NOYNUMBER no
XREAL
YREAL
ZREAL
XINT
YINT
ZINT
INT
REAL
XLIN yes
YLIN yes
ZLIN yes
XLOG no
YLOG no
ZLOG no
XTICDIST
YTICDIST
ZTICDIST
2-dim data
SCATTER no
CONTOUR no
CLUSTER yes
ISOMETRIC no
CUTS()
NOZAREA
ZAREA no
NCUT() 6
2DCOLOUR() multi
Window
XMIN() 0
YMIN() 0
ZMIN() data dependent
XMAX() 100
YMAX() 70
ZMAX() data dependent
SPACE yes
NOSPACE no
XSPACE yes
XNOSPACE no
YSPACE yes
YNOSPACE no
ZSPACE yes
ZNOSPACE no
XWINDOW no
YWINDOW no
NOXWINDOW no
NOYWINDOW no
NOWINDOW no
WINDOW no
Data
BINSIZE()
XBIN()
YBIN()
COLUMN() 4
BASELINE()
CONFIDENCE() -1
LINEWIDTH() 0.4
POLYNOMIAL() -1
SECTIONS
SAREA
NOSAREA
SORT
NOSORT
SLIN
SLOG
SMAX
SMIN
SYMBOL() 4
WEIGHT() 0
Alphabetic list:
Default
AUTO no
AXCOLOUR()
AXFAC() 1
AXIS yes
AXES()
BASELINE()
BINSIZE()
CHECK no
CMODE() 1
CLUSTER yes
CLCOL()
COLUMN() 4
COMMENT
CONTOUR no
CONFIDENCE()
CUTS()
DEVICE() *
DISTANCE()
DSNAME
FITMODE() representation
FORMAT 0.7
FRAME no
HATCHING 4
INT no
ISO no
LAND yes
LINEWIDTH() 0.4
NCUT 6
NOAXIS no
NOCOMMENT no
NODSNAME no
NOFRAME no
NOSAREA no
NOSORT no
NOSPACE no
NOWINDOW no
NOXGRID no
NOXNUMBER no
NOXSPACE no
NOXWINDOW no
NOYGRID no
NOYNUMBER no
NOYSPACE no
NOYWINDOW no
NOZAREA no
NOZSPACE no
PALETTE() multi
PHI()
POLYNOMIAL() -1
PORT no
REAL
ROTATE()
SCALING() 1
SCATTER no
SCREL() 1
SECTIONS()
SIZE()
SAREA
SLIN
SLOG
SMAX
SMIN
SORT no
SPACE yes
SYMBOL() 4
THETA()
TICIN yes
TICOUT no
UNIT() mm
WEIGHT() 0
WINDOW no
XBIN()
XINT
XLIN yes
XLOG no
XMAX 100
XMIN 0
XNUMBER no
XPOS 0
XREAL
XREL 0
XRSIZE 1
XTICDIST
XWINDOW no
YBIN()
YINT
YLIN yes
YLOG no
YMAX 70
YMIN 0
YNUMBER no
YPOS 0
YREAL
YREL 0
YRSIZE 1
YTICDIST
YWINDOW no
ZAREA no
ZINT
ZLIN yes
ZLOG no
ZMAX
ZMIN
ZREAL
ZTICDIST
2DCOLOUR multi
Parameter ACC
Accumulate y values for the same x values
Parameter AFAC(afac)
MVS only
Multiply content of analyzers
Parameters XCAL(xc0,xc1,...),YCAL(yc0,yc1,...)
MVS only
coefficients of polynomial for calibration of analyzer channels:
xcalib = xc0 + xc1 * channel + ...
ycalib = yc0 + yc1 * channel + ...
The calibration of the x-axis of a one-dimensional
analyzer modifies also the height of the spectrum
so that the number of counts per x-unit is preserved.
Parameter AUTO
Reset to default parameters
Parameter AXCOLOUR(axc)
Set colours of axes and title of picture
Parameter AXFAC(axf)
Controls the size of the axis description.
Parameters AXIS,NOAXIS
AXIS
Draw axes
NOAXIS
Do not draw axes
Parameter AXES(ax)
Allows single axes to be drawn. The following selections are supported:
ax=left draw a left axis,
ax=right draw a right axis,
ax=down draw a lower axis,
ax=up draw an upper axis,
ax=l draw a left axis,
ax=r draw a right axis,
ax=r(num) draw a right axis, with numbering and text
ax=d draw a lower axis,
ax=u draw an upper axis.
Combinations are allowed.
Parameter BASELINE(base)
BASELINE(base)
Defines the baseline for histograms and columns.
By default the lower x-axis is the baseline,
this can be changed with this parameter.
Useful e.g. as baseline(0) for histograms with negative contents..
Parameters BINSIZE(bs),XBIN(xbs),YBIN(ybs)
BINSIZE(bs)
Binsize for all dimensions
XBIN(xbs)
Binsize in x-direction only
YBIN(ybs)
Binsize in y-direction only (for 2-dimensional data)
Related: Binning and Statistical errors, command GMODE/HISTO
Parameter CHECK
Debug option, lots of output
Parameter CMODE(cm)
Specifies the character mode:
cm = 0: data symbols,
1: thin characters, proportional font,
2: CALCOMP (historical, MVS only),
3: thick characters, proportional font,
11: thin characters, equidistant font,
13: thick equidistant, equidistant font
Parameter CLUSTER
CLUSTER
Selects cluster plot of 2-dimensional data, related: CONTOUR ISO CUTS
Parameter 2DCOLOUR(2dc)
CLCOL(2dc)
Obsolete parameter, replaced by:
2DCOLOUR(2dc)
Specifies colours of CLUSTERs or CONTOUR lines of 2-dimensional data.
Allowed selections are:
2dc=multi for multicoloured plots,
2dc=grey for greyscale plots,
2dc=d for default (foreground) colour,
2dc=arbitrary colours
For cluster plots you may add full for full area clusters, e.g.:
2DCOL(multi,full)
Related: CUTS.
Parameter SECTIONS()
Not yet implemented
Parameter COLUMN(col)
Width of columns = col * UNIT * SCALING,
Related: SYMBOL LINEWIDTH
Parameter CONFIDENCE(co)
If 0 < co < 1 for automatic polynomial fits two additional curves
are drawn marking the lower and upper limits corresponding to confidence level co.
Usually co = 0.683 is chosen, corresponding to the fit parameter errors (one sigma).
Values of 0.954 and 0.998 correspond to two and three sigma, respectively.
Related: POLYNOMIAL.
Parameter CONTOUR
CONTOUR
Selects contour plot of 2-dimensional data, related: CLUSTER ISO CUTS
Parameter NCUT(ncut)
Number of cuts for cluster or contour plot.
Related: CUTS
Parameter CUTS(cuts)
Specifies z-cuts through 2-dimensional data.
Related: CONTOUR CLUSTER.
Parameter DEVICE(dev)
Specifies the graphics output device. Currently supported are:
dev=* Current graphics screen
dev=filename.ps PostScript output to file
dev=filename.eps PostScript output to file
dev=pqueue PostScript output to printer queue
dev=xhost:screennum X11-output to specified host
Note that PostScript files opened with GDISP or GPLOT
have to be closed explicitly before they
can be sent to the plotter/printer (GPCLOSE,GDCLOSE).
You can also use the command GCOPY to copy a picture from one output device to another.
Parameter DISTANCE(dist)
Viewing distance for ISOmetric display of 2D data
Parameter FITMODE(fm)
Sets the global fit mode:
fm = data fits the data as they are read.
fm = representation
or
repr
fits the data as presented,
i.e. for log plots the logarithm of the data is fitted.
See also Fitting data
Parameter FIT2D
MVS,VMS only
FIT2D provide the 2-dim data for a polynomial fit with the SATAN fit package
Parameter FORMAT(fmt)
Length of y axis / length of x axis. If fmt=0 the ratio is calculated
from the x and y world limits.
Related: SCALING
Parameters FRAME,NOFRAME
FRAME
Draw a frame around the allocated drawing area.
NOFRAME
Don't draw a frame around the allocated drawing area.
Related: XRSIZE YRSIZE
Parameter HATCHING(hatchdist)
Set distance of lines in hatched areas, in mm * SCALING.
Parameter ISO
Selects isometric plot, related: CONTOUR CLUSTER
Not yet implemented.
Parameters LAND,PORT
LAND
Landscape orientation
PORT
Portrait orientation
Parameter LINEWIDTH(lw)
Linewidth in UNIT, if linewidth multipliers T are specified in the input file
Parameters COMMENT,NOCOMMENT
COMMENT
Write the picture title
NOCOMMENT
Do not write the picture title
Parameters DSNAME,NODSNAME
DSNAME
write the dataset name on the plot margin
NODSNAME
do not write the dataset name on the plot margin
Parameters SPACE,NOSPACE,XSPACE,NOXSPACE,YSPACE,NOYSPACE,ZSPACE,NOZSPACE
SPACE
Add some space to the specified data limits
NOSPACE
Take exactly the specified data limits
XSPACE
Add some space to the specified x-limits
NOXSPACE
Take exactly the specified x-limits
YSPACE
Add some space to the specified y-limits
NOYSPACE
Take exactly the specified y-limits
ZSPACE
Add some space to the specified z-limits
NOZSPACE
Take exactly the specified z-limits
Related: XMIN,XMAX,YMIN,YMAX,ZMIN,ZMAX
Parameters XNUMBER,NOXNUMBER,YNUMBER,NOYNUMBER
XNUMBER
Description and numbers at the x-axis
NOXNUMBER
No description and numbers at the x-axis
YNUMBER
Description and numbers at the y-axis
NOYNUMBER
No description and numbers at the y-axis
Parameter PHI(phi)
Azimuth viewing angle for isometric plot,
Related: THETA
Parameter PALETTE(pal)
Specifies the available colour palette on the output device. Valid selections are:
pal=mono for monochrome (i.a. black/white),
pal=multi assumes unlimited colour capabilities,
pal=def allows device dependent default palette.
The PALETTE() parameter is useful for coloured plots to be send to monochrome devices.
Specifying mono avoids grey scale rendering: coloured picture
elements are printed in the foreground colour. No modification of the
original dataset is necessary.
Parameter POLYNOMIAL(p)
Specifies the degree of fitted polynomial, for automatic polynomial fit.
p < 0 switches off automatic fit which is necessary to enable the separate fit package.
Parameter REAL,INT
REAL
Selects floating point numbers at all axes.
INT
Selects integer numbers at all axes.
Related: YREAL YINT XREAL XINT
Parameter ROTATE(rot)
Defines the angle to rotate the figure with respect to the previous figure which was
drawn with GDISP or GPLOT.
For command GOVER only.
Rotation axis is the origin of the overlaid picture.
Not yet implemented.
Parameter SCATTER
SCATTER
Selects scatter plot of 2-dimensional data, related: CONTOUR ISO CUTS
Parameter SCALING(scalefac)
Length of x axis = scalefac * 20 cm, related: SCREL FORMAT
Parameter SCREL(scalerel)
Scaling relative to the SCALING of the figure drawn with a previous GDISP or GPLOT command.
For use with command GOVER only.
Parameter SHIFT(sh)
Not yet implemented.
Parameter SIZE(ss)
Limits the maximum size of paper to be allocated.
ss = A0, A1, ... or A7 (DIN norm)
or
ss = xsize,ysize (pair of numbers interpreted in cm)
Parameters SAREA,NOSAREA
SAREA
When scaling of symbol sizes is requested
scale the area instead of the linear dimension of symbols,
i.e. the square root of the symbol sizes is subject to transformation.
NOSAREA
When scaling of symbol sizes is requested
scale the linear dimensions instead of the area of symbols,
Related: SMIN,SMAX
Parameters SLIN
SLIN
Linear scaling of symbol sizes.
SLOG
Logarithmic scaling of symbol sizes.
Related: SAREA, SMAX, SMIN.
Parameters SMAX(smx),SMIN(smn)
If smn>=0, smx>=0 and smx-smn>0 the symbol sizes of the individual data points are scaled.
If SLIN is active:
snew = ( sold - smn ) / ( smx - smn )
If SLOG is active:
snew = ( log10(sold) - log10(smn) ) / ( log10(smx) - log10(smn) )
Related: SAREA, NOSAREA
Parameters SORT,NOSORT
SORT
sort the data points in ascending order of x-values
NOSORT
don't sort the data points in ascending order of x-values
Parameter SYMBOL(sym)
Size of symbols = sym * UNIT * SCALING
Parameter THETA(theta)
Polar viewing angle for isometric plot, related: PHI
Parameter TICIN,TICOUT
TICIN
tic marks inside the picture.
TICOUT
tic marks outside the picture.
Parameter UNIT(un)
Length unit for all size parameters. Valid choices are mm or cm.
Related: SYMBOL LINEWIDTH COLUMN HATCH
Parameter WEIGHT(w)
For smooth curves:
w = 0 : curves go through the data points,
w > 0 : curves deviate from the data points
Parameter WINDOW,NOWINDOW,XWINDOW,NOXWINDOW,YWINDOW,NOYWINDOW
WINDOW
use limits ...
NOWINDOW
don't use limits ...
XWINDOW
use x-limits ...
NOXWINDOW
don't use x-limits ...
YWINDOW
use y-limits ...
NOYWINDOW
don't use y-limits ...
defined by command GSWINDOW
Parameters XGRID,NOXGRID
XGRID,NOXGRID
Enables (disables) plotting of an additional grid based on the ticmarks of the x-axis.
Related: XTICDIST,YGRID,ZGRID
Parameter XLIN
XLIN linear x axis, related: XLOG YLIN YLOG
Parameter XLOG
XLOG log x axis, related: XLIN YLIN YLOG
Parameter XMAX(xmax)
Maximum x value, related: XMIN YMIN YMAX
Parameter XMIN(xmin)
Minimum x value, related: XMAX YMIN YMAX
Parameter XREAL,XINT
XREAL
Selects floating point numbers at the x-axis.
XINT
Selects integer numbers at the x-axis.
Related: YREAL YINT REAL INT
Parameter XPOS(xp)
Move the whole picture in x direction, in units of the width of the allocated plot area.
Related: YPOS
Parameter XREL(xr)
Move the whole picture in x direction, in units of the x-axis length.
Related: YREL
Parameter XRSIZE(xrs)
Allocate space in x-direction, in units of the length of the x-axis.
Related: YRSIZE
Parameter XTICDIST(xtd)
If xtd>0: distance between ticmarks, in x-units (linear scale only)
Related: YTICDIST,ZTICDIST
Parameters YGRID,NOYGRID
YGRID,NOYGRID
Enables (disables) plotting of an additional grid based on the ticmarks of the y-axis.
Related: XGRID,YTICDIST,ZGRID
Parameter YLIN
YLIN linear y axis, related: YLOG XLIN XLOG
Parameter YLOG
YLOG log y axis, related: YLIN XLIN XLOG
Parameter YMAX(ymax)
Maximum y value, related: YMIN XMIN XMAX
Parameter YMIN(ymin)
Minimum y value, related: YMAX XMIN XMAX
Parameter YREAL,YINT
YREAL
Selects floating point numbers at the y-axis,
YINT
Selects integer numbers at the y-axis,
Related: XINT XREAL REAL INT
Parameter YPOS(yp)
Move the whole picture in y direction, in units of the height of the allocated plot area.
Related: XPOS
Parameter YREL(yr)
Move the whole picture in y direction, in units of the y-axis length.
Related: XREL
Parameter YRSIZE(yrs)
Allocate space in y-direction, in units of the length of the y-axis.
Related: XRSIZE
Parameter YTICDIST(ytd)
If ytd>0: distance between ticmarks, in y-units (linear scale only)
Related: XTICDIST,ZTICDIST
Parameters ZAREA,NOZAREA
ZAREA
Plot the cluster area size for 2-dimensional data data proportional to the cut values,
NOZAREA
Plot the cluster linear size for 2-dimensional data proportional to the cut values,
Related: CLUSTER.
Parameters ZGRID,NOZGRID
Enables (disables) plotting of an additional grid based on the ticmarks of the z-axis.
Related: XGRID,YGRID,ZTICDIST
Parameter ZLIN
Linear z axis (for 2-dim data), related:ZLOG
Parameter ZLOG
Log z axis (for 2-dim data), related:ZLIN
Parameter ZMAX(zmax)
Maximum z value (for 2-dim data), related: ZMIN
Parameter ZMIN(zmin)
Minimum z value (for 2-dim data), related: ZMAX
Parameter ZREAL,ZINT
ZREAL
Selects floating point numbers at the z-axis,
ZINT
Selects integer numbers at the z-axis.
Parameter ZTICDIST(ztd)
If ztd>0: distance between ticmarks, in z-units (linear scale only)
Related: XTICDIST,YTICDIST
Handling of binsizes
If BINSIZE, XBIN or YBIN are specified when reading data with GREAD,
the data values are accumulated for as many x-values (or y-values in case of 2-dim data)
or histogram channels as are specified with the binsize.
Error bars are assumed to be statistical and independent
and are accumulated as sum of squares.