Command DOVERLAY
| GSI | Biophysics | display commands |

DOVERLAY

anl
evt
o1
b1
o2
b2
/
xoff()
xfac()
yoff()
yfac()
window()
dim()
bins()
project()
type(5)
error
noerror
colour(1)
width(1)
line(1)
marker(1)
debug

Purpose

Display a one-dimensional spectrum representation without clearing the graphic screen (overlay)

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.

o1

b1

o2

b2

Two pairs of x-values of the overlay (o1,o2) and the basic (b1,b2) spectrum. The overlay spectrum segment is adjusted to the previous display such that the corresponding x-coordinates are matching.

xoff(x)

Constant which is added to the x-coordinates of the overlaid spectrum. Default: x=0.

xfac(f)

Factor by which the x-coordinates of the overlaid spectrum are multiplied. Default: f=1.
The calibration values specified with xoff and xfac are ignored, if x-coordinates for adjustment are explicitly given.

yoff(y)

Constant which is added to the y-values of the overlaid spectrum. Default: y=0.

yfac(g)

Factor by which the overlaid spectrum data are multiplied. Default: g=1.

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 display commands DISPLAY/CALIB(c) and D2/CALIB(c) or the analyzer 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 DOVERLAYED dimension(s) are used as projection limits.

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.

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.

type(t)

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

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 display command DMODE). Initially no error bars are drawn.

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



When changing the displayed dimensions (keyword dim(d)) for analyzers with more than one dimension, previous display limits are not taken as new projection limits, and vice versa.
If the primary display was done with a calibrated axis, the number list specified with the window option also refers to this calibration.
If a list of attributes is specified, the values are kept and cyclically assigned to the next overlays, which are drawn into the same picture. The graphic attributes may be specified using global parameters.

Examples

DOVE  A1  200 100 500 700 / YFAC(10)
Display the spectrum of analyzer A1 over the already drawn spectrum. Channel no 200 of the overlay spectrum is located in the position of channel no 100 of the previous spectrum on the x-axis, and channel no 500 of the overlay in the position of channel no 700 of the old one. Additionally, the contents of the displayed channels of the overlay spectrum are multiplied by a factor of 10 (for the display only).
DOVE  A / TYPE(5) COL(2..4)                                      
DOVE  B                                                          
DOVE  C
Analyzers A, B, and C are overlaid on the current display, represented by polygon histograms with colours 2, 3, and 4.

| GSI | Biophysics | display commands |
Last updated: M.Kraemer@gsi.de, 4-Aug-1999