Space Research Laboratory

When using ged to read ERNE data, the type of data and the associated reader function is determined based on the data file name (or the name of the first file in a file name array). Some reader functions can process the data based on keywords. The set of acknowledged keywords are typically specific to the reader function in question, so in order to find what options are available, the user should consult the documentation of the reader function associated with the desired data type. The functions for each data type can be found in the quick reference tables on the main page.

This is the most basic example of ged usage.

IDL> mydata = ged()

If FILENAMES keyword is not set, ged will call datafilename function which will open a Graphical User Interface (GUI) window to let user interactively select the desired files. The result mydata will be an array of file records. Level-2 pulse height data are exceptions, as the reader output record structure is slightly modified from the one used in the input disk files (see the quick reference table on the main page).

User can provide keywords for the datafilename function via ged. The most important keywords are:

• START: a string coding the date of the first file. Format = 'DDMMYYYY'
• STOP: a string coding the date of the last file. Format = 'DDMMYYYY'
• DATATYPE: a string coding the data type, see datafilename for the list of available types.
• DLEVEL: a string coding the data level. This defaults to '3', so it must be set only if requesting for level-2 data.
• UNDERCOVER: if set (UNDERCOVER=1 or /UNDERCOVER) the interactive window will not open. This assumes of course that the three keywords (START,STOP and DATATYPE) with no default values are set also.
• MUTE: setting (MUTE=1 or /MUTE) will prevent datafilename from printing its informative messages on the console.

The DATA FORMAT -field will be set automatically depending on the value of the START-field, but can be also set manually in special cases. The other available parameters in the GUI have default values that should not be changed for normal operations. The GUI doesn't present all the awailable keywords, these have to be set manually in the ged call if needed. See datafilename for the description of the whole keyword set.

IDL> mydata = ged(START='01012000',STOP='10012000')

IDL> dt0 = '01012000'
IDL> dt1 = '10012000'
IDL> mydata = ged(START=dt0,STOP=dt1)

IDL> dt0 = '01012000'
IDL> dt1 = '10012000'
IDL> mydata = ged(START=dt0, STOP=dt1, DATATYPE='Proton+Helium Spectra', /UNDERCOVER, /MUTE)

IDL> fns = DATAFILENAME()
IDL> mydata = ged(FILENAMES=fns)

IDL> dt0 = '01012000'
IDL> dt1 = '10012000'
IDL> mydata = ged(START=dt0, STOP=dt1, DATATYPE='Proton+Helium Spectra', G3SPE_DT=6*60*60.0, /G3SPE_EEXP, G3SPE_EINFO=info, /UNDERCOVER, /MUTE)

IDL> dt0 = '01012000'
IDL> dt1 = '10012000'
IDL> mydata = ged(START=dt0, STOP=dt1, DATATYPE='LED Pulse Height Data', G3PHA_AMP=amps, /UNDERCOVER, /MUTE)

IDL> dt0 = '01012000'
IDL> dt1 = '10012000'
IDL> mydata = ged(START=dt0, STOP=dt1, DATATYPE='HED Pulse Height Data', G3PHA_AMP=amps, /UNDERCOVER, /MUTE)

IDL> mydata = ged(DATATYPE='LED Direction Spectra', G3LDS_EINFO=info)

IDL> psel = [6,10,14]
IDL> mydata = ged(DATATYPE='LED Direction Spectra', G3LDS_EINFO=info, EILD_CHS_P=psel, EILD_CHS_HE=-1)