|
|
|
|
SATAN Help
PARAMETERS DEFINING THE GRAPHIC PRESENTATION OF A PICTURE General list with default values: ---------------------------------------------------------------------- *** MODE *** | *** AXES *** | *** WINDOW *** Unit : mm | Axis/Noaxis : Axis | Space/Nospace: Space | Axis(options): - | Noxspace? : no *** GENERAL *** | Axfac : 1 | Noyspace? : no Auto? : no | Axcol : D | Device : XWIN/POST | Backcol : None | Xmin : 0 / a) Graf : | Ticin/Ticout: Ticin | Xmax : 100 / a) Frame? : no | Xnumber/Noxn: Xnumber | Ymin : 0 / a) Xrel : 0 | Ynumber/Noyn: Ynumber | Ymax : 70 / a) Yrel : 0 | Xreal/Xint : a) | Window? : no Xpos : 0 | Yreal/Yint : a) | Xwindow? : no Ypos : 0 | Xlin/Xlog : a) | Ywindow? : no Force? : no | Ylin/Ylog : a) | Full? : no Cmode : 3 | Xticfac : 1 | Nocomment?: no | Xticunit : 1 | Nolegend? : no | Yticfac : 1 | *** DATA *** Notitle? : no | Yticunit : 1 | Acc? : no Nowrite? : no | | Binsize : 1 Nodsn? : no | | Column : Palette : Multi | *** 2-DIM DATA *** | Hatching : | Zmin,Zmax : a) | Linewidth : *** SIZE *** | Zlin,Zlog : a) | Polynomial : 2 Scaling : 1 | 2Dcolour : Multi | Sections : 1 Screl : - | Contour? : | Sort? : no Format : 0.7 | Cuts : a) | Symbol : 4 Xrsize : 1... | Ncuts : 8 | Weight : 0 Yrsize : 1... | Cluster? : | Life? : no | Isometric? | | Theta : | | Phi : | ----------------------------------------------------------------------- a) default values defined by the data The above parameters are related to different commands (GSET, GPRESET, GDISP, GPLOT, GOVER). All may be specified in the dataset by "P: ... ".
Detailed description: (Only the most commonly used parameters are listed.) 2dcolor:Parameter of GDISP, GPLOT, GOVER, GSET, GPRESET. => {GDISP,GPLOT,GOVER,GSET,GPRESET} / 2DCOLOR(c) Specifies the way clusters are displayed in 2-dimensional presentations. Both the color and the size can be specified. Options for color are "{MULTICOLOR,R,G,B,RG,...,GRAYSCALE}". MULTICOLOR attributes different colors to different ranges of counts. Specifying one color demands to display all clusters in the same color. GRAYSCALE corresponds to a sequence of colors which look reasonable on a black-and- white plotter. Per default, also the sizes are a measure of the counts. Additional keywords "FULL", "ABSSIZE", "NOZEROES" demands full-size clusters, cluster sizes proportional to ABS(Z) and/or suppression of channels with Z = 0. Examples: GDISP / 2DCOL(R) ; GDISP / 2DCOL(MULTI;FULL) Acc: Switch to be specified by "P: ACC" in the GRAF dataset. Accumulates the y values belonging to the same x value. If several data points with the same x coordinate appear in one data column in a GRAF dataset, the sum of these values is displayed. If error bars are given, the square root of the quadratic sum of the original error bars is shown. Auto: Switch of GDISP, GPLOT, GOVER. => {GDISP,GPLOT,GOVER} / AUTO Sets several parameters to default values. The limits are chosen in a way that all data points are shown. This option is useful if one is lost in the variation of the many parameters. Axcol: Parameter of GDISP, GPLOT, GOVER, GSET, GPRESET. => {GDISP,GPLOT,GOVER,GSET,GPRESET} / AXCOL(c) Specifies the colour of the axes, including captions and title. Default color ( AXCOL(D) ) is black. Other colors are given by additive mixing of read, green and blue. E. g. blue axes are specified by "/AXCOL(B)". Axfac: Parameter of GDISP, GPLOT, GOVER, GSET, GPRESET. => {GDISP,GPLOT,GOVER,GSET,GPRESET} / AXFAC(r) Determines the sizes of the captions of the axis and the linewiths of axes and ticmarks. The parameter also defines, how many ticmarks are drawn. Axis: Switch of GDISP, GPLOT, GOVER, GSET, GPRESET. => {GDISP,GPLOT,GOVER,GSET,GPRESET} / NOAXIS All axes including the captions are drawn. This is the default option. Remark: The parameter AXIS(options) when specified in the GRF dataset offers even more flexibility: ==> P: AXIS(LEFT;DOWN;UPPER;DOWN) -- draw "left", "right", "upper" and "down" axis without numbers and text ==> P: AXIS(LEFT,NUMBERS,TEXT) -- draw only left axis with numbers and text ==> P: AXIS(R,N,T;U,N,T) -- draw right and upper axes with numbers and text Backcol:Parameter of GDISP, GPLOT, GOVER, GSET, GPRESET. => {GDISP,GPLOT,GOVER,GSET,GPRESET} / BACKCOL(c) Specifies the colour of the background inside the axes. Default color is white. Other colors are given by additive mixing of read, green and blue. E. g. yellow background is specified by "/BACKCOL(RG)". Bin: Parameter of GDISP, GPLOT, GOVER, GSET, GPRESET. => {GDISP,GPLOT,GOVER,GSET,GPRESET} / BIN(i) Specifies an additional bin-size factor for 1-dim. data. The parameter i must be positive and integer. The original data are not modified. Xbin: Parameter of GDISP, GPLOT, GOVER, GSET, GPRESET. => {GDISP,GPLOT,GOVER,GSET,GPRESET} / BIN(i) Specifies an additional bin-size factor for the x direction of 2-dim. data. The parameter i must be positive and integer. The original data are not modified. Ybin: Parameter of GDISP, GPLOT, GOVER, GSET, GPRESET. => {GDISP,GPLOT,GOVER,GSET,GPRESET} / BIN(i) Specifies an additional bin-size factor for the y direction of 2-dim. data. The parameter i must be positive and integer. The original data are not modified. Device: Parameter of GDISP, GPLOT. => {GDISP,GPLOT} / DEV(c) List of default devices: GDISP / DEV(XWIN) (screen) GPLOT / DEV(POST) (postscript file) Other useful options: .. / DEV(VL00) (dummy device) Force: Switch of GDISP, GPLOT, GOVER. => {GDISP,GPLOT,GOVER} / FORCE Force the display of empty analyzers. Format: Parameter of GDISP, GPLOT, GOVER, GSET, GPRESET. => {GDISP,GPLOT,GOVER,GSET,GPRESET} / FORMAT(r) The length of the y axis is defined as r*x. x is the length of the x axis defined by the parameter SCALING. In other words, the FORMAT parameter gives the ratio of the length of the y axis and the length of the x axis. r=0.7 is a typical landscape plot, while r=1.4 is a typical portrait plot. The option /FORMAT(FIXED) or FORMAT(0) allows to assure that one unit on the x axis has the same length as one unit on the y axis. The format parameter is calculated accordingly. This option is useful to plot a chart of the nuclides, where the distance from one isotope to the next should be equal to the distance from one element to the next. Frame: Switch of GDISP, GPLOT. => {GDISP,GPLOT} / FRAME A frame of thin lines is drawn around the whole area allocated for the figure. This is not the default option. Full: Switch of GDISP, GPLOT, GOVER. => {GDISP,GPLOT,GOVER} / FULL The full range of the figure or analyzer in x and y is shown. Graf: Switch of GDISP, GPLOT, GOVER, GSET, GPRESET. => {GDISP,GPLOT,GOVER,GSET,GPRESET} / GRAF Suppress drawing the outer frame when plotting analyzers. Grid: Option of GDISP, GPLOT, GOVER. => {GDISP,GPLOT,GOVER} / GRID(50,0.1,DR) Draw a grid of vertical and horizontal lines over the diagramme. 1. Parameter: distance of vertical lines keys for logarithmic x axis: 1 - integer powers of 10 2 - 1,2,5 times powers of 10 3 - 1,2,..9 times powers of 10 2. Parameter: distance of horizontal lines keys for logarithmic y axis: 1 - integer powers of 10 2 - 1,2,5 times powers of 10 3 - 1,2,..9 times powers of 10 3. Parameter: style (l,d,p or m) and colour (r,g or b) of line colours can be mixed, e.g. rrg 4. Parameter (optional): line width in mm Life: Switch of GDISP, GOVER. => {GDISP,GPLOT,GOVER} / LIFE Events are shown immediately on the screen during accumulation of an analyzer. Noaxis: Switch of GDISP, GPLOT, GOVER, GSET, GPRESET. => {GDISP,GPLOT,GOVER,GSET,GPRESET} / NOAXIS All axes including the captions are suppressed. This is not the default option. Nocomment:Switch of GDISP, GPLOT, GOVER, GSET, GPRESET. => {GDISP,GPLOT,GOVER,GSET,GPRESET} / NCOMMENT All comments are suppressed. This is not the default option. Nolegend:Switch of GDISP, GPLOT, GOVER, GSET, GPRESET. => {GDISP,GPLOT,GOVER,GSET,GPRESET} / NOLEGEND The legend (explanation of data symbols and lines, or of cluster sizes and colours for 2-dim. presentation) is suppressed. This is not the default option. Nodsn: Parameter of GDISP, GPLOT, GOVER, GSET, GPRESET. => {GDISP,GPLOT,GOVER,GSET,GPRESET} / NODSN The text at the left side of the figure which specifies the dataset name or the analyzer name is suppressed. This is not the default option. Nospace:Parameter of GDISP, GPLOT, GOVER, GSET, GPRESET. => {GDISP,GPLOT,GOVER,GSET,GPRESET} / NOSPACE Take exact limits. If the parameters XMIN, XMAX, YMIN, YMAX are specified, these are exactly taken as limits. Otherwise, the extreme data points are drawn just on the axes. This is not the default option. This option is recommended if different figures with the same limits are to be overlaid by the command GOVER. Notitle:Parameter of GDISP, GPLOT, GOVER, GSET, GPRESET. => {GDISP,GPLOT,GOVER,GSET,GPRESET} / NOTITLE The title of the figure is suppressed. This is not the default option. Nowrite:Parameter of GDISP, GPLOT, GOVER, GSET, GPRESET. => {GDISP,GPLOT,GOVER,GSET,GPRESET} / NOWRITE Any text, specified by W:.. in the dataset, suppressed. This is not the default option. Noxspace:Parameter of GDISP, GPLOT, GOVER, GSET, GPRESET. => {GDISP,GPLOT,GOVER,GSET,GPRESET} / NOXSPACE Take exact limits in x direction. If the parameters XMIN, XMAX are specified, these are exactly taken as limits. Otherwise, the extreme data points are drawn just on the axes. Noyspace:Parameter of GDISP, GPLOT, GOVER, GSET, GPRESET. => {GDISP,GPLOT,GOVER,GSET,GPRESET} / NOYSPACE Take exact limits in y direction. If the parameters YMIN, YMAX are specified, these are exactly taken as limits. Otherwise, the extreme data points are drawn just on the axes. Noxnum: Switch of GDISP, GPLOT, GOVER, GSET, GPRESET. => {GDISP,GPLOT,GOVER,GSET,GPRESET} / NOXNUMBER The caption of the x axis, text and numbers, is suppressed. This is not the default option. Noynum: Switch of GDISP, GPLOT, GOVER, GSET, GPRESET. => {GDISP,GPLOT,GOVER,GSET,GPRESET} / NOYNUMBER The caption of the y axis, text and numbers, is suppressed. This is not the default option. Unit: Parameter of GSET => GSET / UNIT({mm,cm}) Basic unit (mm or cm) for several parameters which specify the size of an object in absolute size. It is recommended to keep the default option (mm). Weight: Parameter of GDISP, GPLOT, GOVER, GSET, GPRESET. => {GDISP,GPLOT,GOVER,GSET,GPRESET} / SCALING(r) This parameter specifies the way a smooth line is adjusted to the data points. The value zero means that the smooth line exactly meets the data points. Higher values give more freedom to the smooth line to smooth out the fluctuations of the points. See also LINE MODE "S". Scaling:Parameter of GDISP, GPLOT, GOVER, GSET, GPRESET. => {GDISP,GPLOT,GOVER,GSET,GPRESET} / SCALING(r) The size of the figure is chosen in a way that the x axis of the figure has a length of 20 cm * r. Screl: Parameter of GOVER. => GOVER / SCREL(r) The size of the figure is chosen in a way that the x axis of the figure has a length of r*dx. dx is the length of the x axis of the figure drawn with the preceding GDISP or GPLOT command. Sections: Parameter to be specified by P: SECTIONS(r) in the GRAF dataset. Multiply the sections of dashed, dotted and dash-dotted lines by the factor r. See also LINE MODES "D", "P", "M". Sort: Switch of GDISP, GPLOT, GOVER, GSET, GPRESET. => {GDISP,GPLOT,GOVER,GSET,GPRESET} / SORT Sort the data of a GRAF dataset in ascending order before drawing. Space: Switch of GDISP, GPLOT, GOVER, GSET, GPRESET. => {GDISP,GPLOT,GOVER,GSET,GPRESET} / SPACE Create some space between the limits given by the data points or the parameters XMIN, XMAX, YMIN, YMAX and the axes. The amount of space depends on the presentation and is chosen by graphical aspects. Therefore, this option should not be used when different figures are to be overlaid by the command GOVER with the same limits. The option SPACE is the default option. Symbol: Parameter of GDISP, GPLOT, GOVER, GSET, GPRESET. => {GDISP,GPLOT,GOVER,GSET,GPRESET} / SYMBOL(r) The size of the data symbols is defined as r*s*(1 mm). s is the value of the parameter SCALING. Ticin: Switch of GDISP, GPLOT, GOVER, GSET, GPRESET. => {GDISP,GPLOT,GOVER,GSET,GPRESET} / XLIN Turn the tic marks of the lower x axis and of the left y axis inside. This is the default option. Ticout: Switch of GDISP, GPLOT, GOVER, GSET, GPRESET. => {GDISP,GPLOT,GOVER,GSET,GPRESET} / XLIN Turn the tic marks of the lower x axis and of the left y axis outside. This option is useful to better distinguish single counts of a spectrum. The default option is TICIN Xlin: Switch of GDISP, GPLOT, GOVER, GSET, GPRESET. => {GDISP,GPLOT,GOVER,GSET,GPRESET} / XLIN Linear x axis is chosen. Xint: Switch of GDISP, GPLOT, GOVER, GSET, GPRESET. => {GDISP,GPLOT,GOVER,GSET,GPRESET} / XINT Annotation of x axis is written in integer numbers. Xlog: Switch of GDISP, GPLOT, GOVER, GSET, GPRESET. => {GDISP,GPLOT,GOVER,GSET,GPRESET} / XLOG Logarithmic x axis is chosen. Xmax: Parameter of GDISP, GPLOT, GOVER, GSET, GPRESET. => {GDISP,GPLOT,GOVER,GSET,GPRESET} / XMAX(r) Specifies the lower horizontal limit of the figure. See also SPACE Xmin: Parameter of GDISP, GPLOT, GOVER, GSET, GPRESET. => {GDISP,GPLOT,GOVER,GSET,GPRESET} / XMIN(r) Specifies the upper horizontal limit of the figure. See also SPACE Xpos: Parameter of GDISP, GPLOT, GOVER. => {GDISP,GPLOT,GOVER} / XPOS(r) The figure is shifted to the right-hand side by the total width of the figure. A sequence of integer numbers specified for XPOS will produce a combination of figures, one besides the other. See also size of the allocated graphic surface. Xreal: Switch of GDISP, GPLOT, GOVER, GSET, GPRESET. => {GDISP,GPLOT,GOVER,GSET,GPRESET} / XREAL Annotation of x axis is written in floating-point numbers. Xrel: Parameter of GDISP, GPLOT, GOVER. => {GDISP,GPLOT,GOVER} / XREL(r) The figure is shifted to the right-hand side by the length of the x axis time r. A sequence of integer numbers specified for XREL will produce a combination of figures with common axes. See also size of the allocated graphic surface. Xrsize: Parameter of GDISP, GPLOT. => {GDISP,GPLOT} / XRSIZE(r) The width of the allocated graphic surface is defined by r*dx. dx is the length of the x axis, defined by the parameter SCALING. This parameter should be specified in specific cases, only. See also size of the allocated graphic surface. Xticfac: Parameter of GDISP, GPLOT, GOVER, GSET, GPRESET. => (GDISP,GPLOT,GOVER,GSET,GPRESET) / XTICFAC(r) The distance of the tic marks at the x axis is increased (or reduced) to "r" times the default value. Also less (or more) annotations (the numbers) at the tic marks are written. The value of "r" is taken as an input for an automatic determination of the tic marks at "rounded" x values. This option is supported for linear x scale only. Xticunit: Parameter of GDISP, GPLOT, GOVER, GSET, GPRESET. => (GDISP,GPLOT,GOVER,GSET,GPRESET) / XTICUNIT(r) The distance of the tic marks at the x axis is drawn in units of "r". This option is supported for linear x scale only. E.g. r=15, 45 or 90 is suited if the x values are angles in degree. Yint: Switch of GDISP, GPLOT, GOVER, GSET, GPRESET. => {GDISP,GPLOT,GOVER,GSET,GPRESET} / YINT Annotation of y axis is written in integer numbers. Ylin: Switch of GDISP, GPLOT, GOVER, GSET, GPRESET. => {GDISP,GPLOT,GOVER,GSET,GPRESET} / YLIN Linear y axis is chosen. Ylog: Switch of GDISP, GPLOT, GOVER, GSET, GPRESET. => {GDISP,GPLOT,GOVER,GSET,GPRESET} / YLOG Logarithmic y axis is chosen. Ymax: Parameter of GDISP, GPLOT, GOVER, GSET, GPRESET. => {GDISP,GPLOT,GOVER,GSET,GPRESET} / YMAX(r) Specifies the upper vertical limit of the figure. See also SPACE Ymin: Parameter of GDISP, GPLOT, GOVER, GSET, GPRESET. => {GDISP,GPLOT,GOVER,GSET,GPRESET} / YMIN(r) Specifies the upper vertical limit of the figure. See also SPACE Ypos: Parameter of GDISP, GPLOT, GOVER. => {GDISP,GPLOT,GOVER} / YPOS(r) The figure is shifted upwards by the total height of the figure. A sequence of integer numbers specified for YPOS will produce a combination of figures, one above the other. See also size of the allocated graphic surface. Yreal: Switch of GDISP, GPLOT, GOVER, GSET, GPRESET. => {GDISP,GPLOT,GOVER,GSET,GPRESET} / YREAL Annotation of y axis is written in floating-point numbers. Yrel: Parameter of GDISP, GPLOT, GOVER. => {GDISP,GPLOT,GOVER} / YREL(r) The figure is shifted upwards by the length of the y axis times r. A sequence of integer numbers specified for YREL will produce a combination of figures with common axes. See also size of the allocated graphic surface. Yrsize: Parameter of GDISP, GPLOT. => {GDISP,GPLOT} / YRSIZE(r) The height of the allocated graphic surface is defined by r*dy. dy is the length of the y axis, defined by the parameters SCALING and FORMAT. This parameter should be specified in specific cases, only. See also size of the allocated graphic surface. Yticfac: Parameter of GDISP, GPLOT, GOVER, GSET, GPRESET. => (GDISP,GPLOT,GOVER,GSET,GPRESET) / YTICFAC(r) The distance of the tic marks at the y axis is increased (or reduced) to "r" times the default value. Also less (or more) annotations (the numbers) at the tic marks are written. The value of "r" is taken as an input for an automatic determination of the tic marks at "rounded" y values. This option is supported for linear y scale only. Yticunit: Parameter of GDISP, GPLOT, GOVER, GSET, GPRESET. => (GDISP,GPLOT,GOVER,GSET,GPRESET) / YTICUNIT(r) The distance of the tic marks at the y axis is drawn in units of "r". This option is supported for linear y scale only. E.g. r=15, 45 or 90 is suited if the y values are angles in degree. Size of the allocated graphic area SATAN/GRAF assumes the lower left corner of the allocated graphic area on screen or paper as the basis for several parameters which define the size or the location of a figure. This is important in order to understand the size of the allocated graphic surface. The commands GDISP or GPLOT allocate the graphic surface. One can extend the size of the graphic surface upwards and to the right by the commands XREL, XPOS, YREL and YPOS. Example: GDISP / XREL(2) YREL(1) lets enough space to fill in two figures of the same size to the left and one below. Therefore it is recommended to begin a sequence of figures in the upper right corner. A figure drawn with GDISP / XREL(0) YREL(0) appear always in the lower left corner of the allocated graphic surface. Negative values for XREL and YREL will not allocate additional surface. The command GOVER does not allocate any additional surface. Example: GREAD FIGURE3 GDISP / XREL(2) YREL(1) NOXNUMBER NOYNUMBER GREAD FIGURE1 GDISP / XREL(0) YREL(1) NOYNUMBER GREAD FIGURE2 GDISP / XREL(1) YREL(1) NOXNUMBER NOYNUMBER GREAD FIGURE4 GDISP / XREL(0) YREL(0) GREAD FIGURE5 GDISP / XREL(1) YREL(0) NOXNUMBER GREAD FIGURE6 GDISP / XREL(2) YREL(0) NOXNUMBER The figures will be arranged in the following way: (FIGURE1) (FIGURE2) (FIGURE3) (FIGURE4) (FIGURE5) (FIGURE6) Note that several captions of the axes are suppressed, because they would be placed inside the neigboring figure. Since these figures have common axes, one should take care that the limits are identical. Any value for XREL, YREL, XPOS and YPOS is allowed. A sufficiently large surface is allocated automatically, if the option GSET / ZONE(nx,ny) is specified. The parameters XRSIZE and YRSIZE of GDISP and GPLOT allow to control the size of the allocated graphic surface. |
