SATAN Help
LIBRARY OF ANALYZERS AND CONDITIONS
Libraries of analyzers, consisting of spectra, display windows and conditions may be
created by using the command ADUMP. The data of different
analyzers may be distributed to different datasets or dumped in a single dataset. If you
have defined some analyers (by the macro $AGEN in your
analysis routine or by the interactive command AGEN), you
may type "ADUMP * / DSN(TEST) APPEND" and view the dataset "TEST.DMP"
in order to check the syntax of an analyzer library. By default, analyzer dumps are ASCII
datasets. Libraries may also be created or modified by a text editor.
The analyzer data of a library in a specific dataset can be fetched into computer memory
by the command AFETCH. With "AFETCH * /
DSN(datasetname) REPLACE", all data elements of the library can be fetched. Analyzers
which have the same names as permanent (resident) analyzers, defined by the $AGEN macro,
can only be fetched if their attributes match.
(Althoug the data formats of GRAF datasets and analyzer libraries are very similar,
analyzer libraries generally cannot be read by the command GREAD!)
Analyzer libraries may be used e.g.
o as an archive of spectra, accumulated in an analysis of list-mode data;
o as a collection of analyzer conditions (1-dim. and 2-dim.), valid for the analysis of
list-mode data.
An example for a dump of a one-dimensional analyzer:
| Raw TOF spectrum ==> title
| C: Written on 19-JUN-1995 16:30:05.40
==> time*
| C: preliminary analysis ==>
comment of dump
| S: ANALYZER(TOF_RAW) TITLE(Raw TOF spectrum)
==> name, title
| S: DSN(F220.LMD) DATE(15JUN93) RUN(R31) ...
==> list-mode file information
| X: Channel ==> x axis
| Y: Counts ==> y axis
| C:Limits: 0, 2047 ==> limits*
| C:Binsize: 5 ==> binsize*
| A: (X = 0 TO 2047 BY 5) Y,HT0
==> loop of channels
| 56,59,58,58,79, .... ==> data
| W1(1): (PEAK) 520 1069 ==>
condition
| W1(A): (BACKGROUND) 1070 1900
==> window
More than one analyzers may be dumped into the same dataset with the command
ADUMP / APPEND.
The title given in the first line of the dump is overwritten by the title specified in the
4. line. Those statements marked with a * sign are not interpreted by AFETCH.
The comment of the dump (3rd line) is listed by the AFETCH
command.
An example for the dump of a two-dimensional analyzer in a more compact form:
| MUSIC vs TOF
| S: ANALYZER(MUSIC_TOF)
| A2: X = -1000 TO 1000 BY 16; Y = 0 TO 2047 BY 16;
| 0,1,0,2,3,1,4, ...
| W2(1): (213AC) X Y ==>
condition
| 993,756;1007,770;789,1078;1028,725;
==> coordinates of condition
The dump of only a condition looks like this:
| Condition ==> title
| S: ANALYZER(MUSIC_TOF) ==>
analyzer name
| W2(1): (213AC) X Y ==> condition
| 993,756;1007,770;789,1078;1028,725;
==> coordinates of condition
(Conditions and windows on two-dimensional analyzers are always polygons.)