Library

Home ] Up ] General ] Short ] Syntax ] Postscript ] Hints ] Cursor ] DSN ] Arithmetik ] Line Modes ] Colours ] Polar ] 2Dim ] 3Dim ] Analyzers ] [ Library ] Types ] Text ] Graphic ] Inbed ] Fit ] Presentation ] Extend ] Concepts ] Dynamic ] Listmode ] Macros ] Goosydata ] Online ] Commands (List) ] Commands (Details) ] Install ] MSWindows ] Problems ]

GSI
FRS

 

 

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.)