Command DISPLAY
| GSI
| Biophysics
| display commands
|
- 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
- * : analyzer limits (replaceable default)
- letter : display window identifier
- # : temporary window
- one number : analyzer condition number
- number list : lower and upper limits
for the displayed dimension
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:
- 0 no spectrum
- 1 single markers
- 2 polygon line
- 3 polygon line with markers
- 4 vertical lines
- 5 polygon histogram
- 6 polygon histogram with vertical lines
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
Impressum Data privacy protection