General

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

GENERAL INFORMATION:

The described version of the SATAN/GRAF package runs on different versions of Microsoft WINDOWS and under Wine on LINUX.

The SATAN/GRAF package consists of two independently usable but closely connected parts. SATAN offers possibilities to read list-mode data (event-by-event data), to sort them into one- or two-dimensional spectra, called "analyzers", and to perform complex operations with these analyzers. GRAF shows the graphic representation of analyzers or of numerical data which can be entered directly as one-or two-dimensional data arrays via an ASCII dataset.

Features of the WINDOWS version of SATAN:
bulletWritten in modern PL/I for Workstations (last release February 2008).
bulletMulti-thread design.
bulletReading of data arrays in different simple ASCII formats
bulletReading of ASCII and binary list-mode data in several formats.
bulletElaborate support of GSI-type list-mode data structures with filter capability.
bulletOnline usage by connection to Remote Event Server.
bulletCommand language for batch mode. 
bulletNumerous capabilities for manipulating analyzers.
bulletPowerful fit capabilities with least-squares and Poisson fits.
bulletGraphic presentation of 1-dimensional and 2-dimensional spectra.
bulletAutomatic peak finding in one and two dimensions.
bulletMulti-spectra life display.
bulletGraphic package GRAF incorporated.
bulletSupports graphics output on plotters and to EPS and WMF files.
bulletNeeds no other than the PL/I run-time library 

 

I. Handling

When starting SATAN, two windows are available, the command window (for entering commands) and the interface window (as a graphical interface). Together with a display, there appears also a graphical tool interface with options to change the graphical presentation.
The command window offers some features that are not obvious:
1. Repeating commands (history)
The "<" and ">" signs, followed by "ENTER" select commands that were previously entered. They can be exetuded by striking the "ENTER" key again.
2. Processing files by dropping the file names into the command window
Certain processes that are linked to specific file extensions
(.scom, .grf etc) can be started by dropping the file names into the command window with the cursor from the Windows explorer.

Running SATAN on Linux
SATAN runs also on Linux under Wine, although some problems may appear, depending on the Wine version.

Using SATAN without a PL/I compiler
The full functionality of SATAN is available, including the accumulation of listmode data by a pre-defined default analysis program
(see HELP DefaultAnalysis), without the need for a PL/I compiler. However, a user-defined analysis routine cannot be used.
In addition to the SATAN executable (SATAN.exe), the run-time library is required (_gdi32.dll, HEPWM20.DLL, HEPW20.DLL, IBMOM35I.DLL, ibmwm20.dll, ibmws20.dll, _user32.dll).


II. Data analysis

SATAN offers the possibility to analyze list-mode data in SATAN format, in GOOSY format, in IN2P3 format or in ASCII format. For this purpose, the user must write an analysis routine. This is the only source program, the user has to supply to SATAN. An assortment of macros is offered to define spectra ("AGEN"), to provide the data ("EVENT", "GOOREAD")
and to sort the results ("ANAL") into the spectra, named analyzers. In a similar way, SATAN offers the possibility to perform Monte-Carlo simulations and to sort the results immediately into spectra. Versatile tools are offered to combine or to process the contents of the spectra (fit, peak finding, arithmetic operations, projections etc.).

Analyzers and modified list-mode data can be written on disk for further processing (command ADUMP, command LOUTPUT and macro LOUT).

A documentation of the SATAN analysis features is available as PDF file.


III
. Graphics representation

In GRAF, three different graphic subgroups are defined:
1. Data points, connecting lines, axes and explanations.
The data are given as numbers in the input dataset. The definition as "x" or "y" values, error bars etc. and the choice of the data symbols is made in the header line. The representation of the data can be changed interactively by several display parameters.
2. Text.
Text can be added to a data diagram or may be plotted alone. It may be given in a dataset or entered interactively by the command "GWRITE". Formatting of text and of formulae is supported.
3. Graphic elements.
Several graphic elements like lines, arrows, transistors etc. can be added to the data diagram or may be plotted alone. They may be given in a dataset or entered interactively by the command "GELEMENT".

There are several possibilities to determine the display parameters which determine e.g. size of the figure, linear or logarithmic axes and many other characteristics of the figure.
The hierarchy of the display parameters is given below:
1. Priority: parameters of the commands GDISP, GPLOT, and GOVER;
2. Priority: parameters of the command GPRESET;
3. Priority: parameters given in the dataset with P: ... ;
4. Priority: parameters of the command GSET;
5. Priority: default parameters which are determined by the program from the data.
The actually used display parameters are written to the dataset in the form "P: ..." by the command GSAVE.

After GPLOT, the plotter remains allocated until the next GPLOT command is entered. You may explicitly end the picture e.g. in order to free the POSTSCRIPT dataset or to send the picture to the plotter with the command GPCLOSE.

For preparing insets or combinations of figures with the command GOVER, the command "SEXEC xxx" may be useful which executes a sequence of commands, written to the dataset "xxx". (See HELP SCOM for a detailed description of this feature.)

For preparing large pictures like posters it may be necessary to display or plot enlarged parts of the picture without changing the axes (XMIN, XMAX, YMIN, YMAX, FORMAT etc.). This may be done by specifying the parameters XREL, YREL and SCALING.
==> XREL(-.4) YREL(-.4) SCALING(5)
will enlarge the central part of the figure.

The allocated size on the plotter paper is determined mainly by the area covered by the axes. If you want to draw graphic elements or to write a text outside this area you may allocate more paper by the parameters XRSIZE(...) and YRSIZE(...). E.g. a value of 2 allocates enough place for another figure besides (or above) the normal position. The parameter FRAME of GPLOT or GDISP allows to visualize the allocated size.
Important notes:
The default values for XRSIZE and YRSIZE depend on the output device!
If you want to control the allocated size, please specify both parameters, XRSIZE and YRSIZE and fix them in the dataset (with GSAVE). With the command GOVER no additional area is allocated!

The orientation of the picture on a plot can be chosen by the parameters PORT and LAND of GPLOT. If neither PORT nor LAND are specified, the optimum orientation is
automatically chosen. The position of the picture on the allocated paper can be modified by the parameters XREL and YREL of GPLOT. For more information see HELP POSTSCRIPT.

The option "SIZE( .. )" of the command GSET is intended to limit the possible area on the plotter to DIN formats (==> GSET / SIZE(A5) ). For most plotters available at GSI, the size values are known to GRAF, and the pictures will be limited in size automatically.

The output device POST of GPLOT is intended to create POSTSCRIPT files to be included in TEX files (or similar applications). If these files are sent to a plotter, the orientation is fixed to PORTRAIT. It is recommended to direct GPLOT directly to the printer to produce a graphics output on paper, not to print a POSTSCRIPT file.
If you are lost in the variety of parameters available for the representation, use GDISP / AUTO to return to the standard set.

The graphics features of GRAF and the analysis features of SATAN are closely linked.