Function GED_L2_A - Get ERNE Level-2 Science Data, program series 'a'
Version 1.1
Level(s): 2
Format(s): f10, f30, f40, f50
Calling sequences:
data=GED_L2_A()
data=GED_L2F10()
data=GED_L2F30()
data=GED_L2F40()
data=GED_L2F50()
Input parameters: none
Returns: Level 2 ERNE data read from disk file is returned as an array of
structures (see below).
Keyword parameters:
FILENAME filename
A string containing the name of the disk file to be read. If set to an
empty named variable, PICKFILE is invoked to select the file interactively
and the variable is used for the returning of the selection.
PICKFILE is invoked also if 'filename' is missing. If PICKFILE is invoked,
the name of the selected file will also be printed to standard output.
See also section Input file names below.
PATH path
A string containing the directory where to look for files. If set to named
variable, the directory of the specified or selected file is returned.
FILLMODE fillMode
If set to a named variable, a vector of fill-mode bytes is returned when
PHA data is read. The vector has the same length as the counter and matrix
vectors,i.e., one fill mode value per each major frame in the input file is
returned.
_REF_EXTRA relyparams
Provides a way to accept unknown keywords that perhaps have some meaning
for other programs called by the GED-system.
Input file names:
The type of level-2 input data is decided by the file name which must end with one of the
recognized extension. See the first column of table of the Input/Ouput structures below.
Output data formats:
Level 2 data is returned as vectors of structures (see below). The vectors have a length
equalling the number of major frames per level 2 file except for direction distribution data,
where it is lower by a factor of about four (4-min resolution), and for pulse height data,
where it equals the number of PHA events in the file.
Input/Output structures:
format
1345
extension record structure 0000 description note
--------------------------------------------------------------------------------
.counters TscCounters_a +--- ESU science counters
" TscCounters_b -+-- ESU science counters
" TscCounters_c --+- ESU science counters
" TscCounters_d ---+ ESU science counters
.10s_spectra Tsc10sCntrs_a +--- LED+HED 10 second spectra
.pn_spectra TscEcntrs_a +--- LED+HED on-board spectra
.led_spectra TledEcntrs_b -+++ LED on-board spectra
.hed_spectra ThedEcntrs_b -+++ HED on-board spectra
.led_pha TscHheader_a ++++ LED pulse height data (a)
" TledPHAevent_a ++++ LED pulse height data (a)
" TledPHArecord_a ++++ LED pulse height data (b)
.hed_pha TscHeader_a ++++ HED pulse height data (a)
" ThedPHAevent_a ++++ HED pulse height data (a)
" ThedPHArecord_a ++++ HED pulse height data (b)
.hed_electrons ThedElectronCntrs_a +--- HED "electrons"
.hed_relat ThedElectronCntrs_b -+++ HED "electrons"
.hed_anisotropy_AN ThedDirCntrs_a +--- HED dx-dy-profiles: 0-5 (c)
.hed_anisotropy_BN ThedDirCntrs_b +--- HED phi-theta tables: 0-5 (c)
.hed_dirdistrN ThedDirCntrs_c -+++ HED phi-theta tables: 0-5 (c)
a) INPUT, from a lev-2 file: Science Headers, each followed by two bytes
(fillMode and nEvents) and then a nEvents of PHA event structures.
b) OUTPUT, function result: array of records
c) N = channel number {0..5}. Note that the file extensions are truncated
before N when deciding the file type below.
Version history:
1.1 2007-03-02 (ER)
Corrected erros in the comment section.
1.0 2006-11-03 (ER)
New program combining the functionality of the format specific programs:
ged_l2.1.0.2
ged_l2.3.0.2
ged_l2.4.0.2
ged_l2.5.0.2
The new program utilises automated (on-need) structure definition system.
NOTE: by combining the earlier format specific IDL-programs in to one
program, the synchronized version numbering system between the
IDL-programs and the corresponding C-program (SClev1to2) has become
obsolete and thus we have changed from the earlier 3-level version
numbers to 2-level numbering system.