File Formats

SATAN AREAD file format

Files of these types are used as input for the SATAN AIMPORT (formerly AREAD) command.

/*AREAD$$HEADER  ANALYZER  ='<anlid>.<evtid>'
/*AREAD$$HEADER  DIM       =<analyzer dimension>
/*AREAD$$HEADER  TYPE      ={ 'I' | 'L' | 'R' | 'D' | '2' | '4' | '24' | '28' }

/*AREAD$$HEADER  CHANNEL(<dim>)=<number of bins>
/*AREAD$$HEADER  LIMITS((<dim>-1)*2+1)=<lower limit>
/*AREAD$$HEADER  LIMITS((<dim>-1)*2+2)=<upper limit>
/*AREAD$$HEADER  BINSIZE(<dim>)=<binsize>
/* this is a comment
<data line 1>
<data line 2>
...
<data line n>

The first line of the input file is always assumed to be a comment line or part of the header. A comment line starts with /*, its content is ignored. A header line starts with /*AREAD$$HEADER and contains definitions of target analyzer attributes, in the form

name = value

The target data types are defined as

'I' | '2' : short (2-byte) integers 
'L' | '4' : long (4-byte) integers 
'R' | '24': single precision (4-byte) floating point numbers
'D' | '28': double precision (8-byte) floating point numbers

The specifications for CHANNEL,LIMITS,BINSIZE run from <dim>=1 to <dim>=<analyzer dimension>.
Defaults are:

ANALYZER  =file name without extension
DIM       =1
TYPE      ='R'
CHANNEL(<dim>)=number of data items
BINSIZE(<dim>)=1

The
Data lines contain freely formatted numbers, separated by blanks or commas. For multidimensional objects, data are stored with the leftmost array index running slowest (PL/I convention)
The recommended (not mandatory) file name extension is .aread. An example is here

| GSI Biophysics | command subsystem |

Last updated: M.Kraemer@gsi.de, 2-Nov-2005

Impressum Data privacy protection