Command DISPLAY
| GSI | Biophysics | display commands |

DISPLAY

anl
evt
/
dim()
window()
all
bins()
project()
lin
log
sqrt
auto
fix
calib()
nocalib
error
noerror
type(5)
format()
colour(1)
width(1)
line(1)
marker(1)
debug

Purpose

Display (parts of) analyzer spectra with one or more dimensions in a one-dimensional representation

Parameters

anl

Name or number of an analyzer with one or more dimensions. If omitted, the last specified analyzer is assumed.

evt

Qualifier name or number. If omitted, the last specified qualifier is assumed.

dim(d)

For analyzers with more than one dimension only: the analyzer dimension to be displayed (onto which will be projected). Replacable default: the first dimension.

window(w)

project(w)

Spectrum segment to be displayed, specified by A limit omitted in the number list is replaced by the actual value (or the analyzer limit, initially). An asterisk (*) means the corresponding analyzer limit. Lower limits smaller or upper limits larger than the corresponding analyzer limit are reset to the latter. The limits are not modified to match with the bin borders.
If a reference to a calibration 'c' exists for a displayed dimension (see key word CALIB(c) or command AMOD), the number list for this dimension refers to 'c' (and not to the analyzer channel numbers).
If the analyzer has more than one dimension, and if a display window or condition number is specified, only the limits of the actually displayed dimension are taken from 'w'. The display window or condition limits of the not displayed dimension(s) are used as projection limits.

all

In the displayed dimension, the analyzer limits are used. The projection limits, if needed, are taken from the previous display.

bins(b)

Display bin size. Independent of the display limits, bins are added always starting with the first analyzer bin. Default: the analyzer bin size.

lin

Linear y-axis.

log

Logarithmic y-axis.

sqrt

Square root y-axis.
Not yet implemented.

auto

Automatic y-scaling.

fix

Fixed y-scaling.

calib(c)

If once given, the values for the x-axis and the x-axis description are taken from the calibration 'c'. 'c' consists of two names 'cname.cqual'. If 'cqual' is omitted, 'CAL' is assumed. A reference between the calibration and the corresponding analyzer dimension is created and remains valid for subsequent DISPLAY commands.
Not yet implemented

nocalib

The reference to the calibration 'c' - if existing - will be ignored for the current command.

error

Spectra are drawn with error bars, if defined previously by the command AERROR.

noerror

No error bars are drawn.
If error and noerror are omitted, the global error mode is in effect (see command DMODE). Initially no error bars are drawn.

type(t)

Number defining the type of spectrum representation. Valid types are: Replaceable default is t=5 (polygon histogram).

format(r)

Ratio of width and height of the spectrum, defined by the length of the corresponding axes. Allowed values are in the range between r = 0.4 and r = 1.7. If r > 1.4, there is no space for informations on display windows and points right of the spectrum display. Replaceable default is r = 1.4.
Not yet implemented.

colour(c)

Colour number. Replaceable default is c = 1.

width(w)

Width number. Replaceable default is w = 1.

line(l)

Line type number. Replaceable default is l = 1.

marker(m)

Marker number. Replaceable default is m = 1.
With the keywords colour, width, line, and marker, a logical number between 1 and 10 is expected, which refers to the attributes look-up table. See the command DATTR for the graphic attributes assigned to these numbers.

debug

Debug switch. Lots of output !

Function

Remarks

Display windows and points have the same dimensionality as the analyzers, for which they have been defined (see commands DSWINDOW and DSPOINT). For analyzers with two or more dimensions, display windows may be used in both, the one- and two-dimensional display environments.

When changing the displayed dimensions (with dim(d)) for analyzers with more than one dimension, previous display limits are not taken as new projection limits, and vice versa.
See the command DMODE for the definition of global representation modes.
Error bars will only be drawn, if defined previously with the command AERROR.
A global reference to a calibration can also be specified with the command AMOD. Calibrations can be created, modified, or deleted with the command ACALIB.

Examples


Analyzer segment, projections
D  3  2 
Display analyzer no. 3 with qualifier no. 2 within the analyzer limits (startup default). If the analyzer has more than one dimension, the complete analyzer range of the second (and possibly higher) dimension(s) is projected onto the x-axis.
D  /  WINDOW(*,1000)
Plot a spectrum segment with the upper x-limit 1000. The lower x-limit is assumed to be the corresponding analyzer limit.
D / DIM(2) 
Now a projection onto the second dimension is displayed. Both, display and projection limits, are taken from the corresponding analyzer limits.
D / WIN(A)
Display the last specified analyzer and dimension within the corresponding limits of display window A.
D  A3  LIST /  DIM(2)  WINDOW(*,*,,200,197,197) BIN(4)
The analyzer A3.LIST may have three dimensions. A projection onto the second dimension is drawn with bin size 4 along the x-axis. To perform the projection, summation is performed within the analyzer limits of the first dimension, whereas in the third dimension, only channel 197 is taken into account.
D / W(3)
The same dimension of A3.LIST is displayed, but now again with the analyzer bin size, and the display limits are taken from (the second dimension of) analyzer condition number 3. Summation is performed within the projection limits of the previous display.

Calibration
D / CAL(ENERGY)
Repeat the display of the last specified spectrum segment, but the x-axis has values and description from the calibration ENERGY.CAL.
D / W(77.1,78.7)
The display limits have been changed. The specified values are calibrated values.
D / NOCAL   W(101,200)
For this display, channel numbers are used for the x-axis, and no x-axis description is available. The x-limits 101 and 200 refer to channel numbers.

Display with error bars
AERROR  B  LIST                                                  
D  B  LIST / ERR  TY(1)  MARK(9)
Define statistical errors for analyzer B.LIST and display the spectrum (with marker no. 9, initially circles) with error bars.
| GSI | Biophysics | display commands |
Last updated: M.Kraemer@gsi.de, 4-Aug-1999