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.