extracts valid data from SPD and creates an AAR:
|
aar = extract_aar( spd [,/all] ) |
extract_aar extracts the valid data of a SPD, sorts them according to
wavelength and puts the resulting spectrum ("flux vs. wavelength
") in an AAR:
- data points with zero wavelength (e.g. dark currents) or points flagged as
NODATA (e.g. photometric checks after
FLUXCON) are skipped
- data points of S06 reference scans are skipped as well, unless the keyword
/all is specified
- a detector number det, a line number line, a scan
counter scnt and a scan direction tag sdir is assigned
to every data point of the AAR
- the time keys, detector flags and status word are transfered
- for SWS01 observations the line tag of the AAR structure is
set to the AOT band number, to which an up/down scan pair belongs; the
scnt field is set to one
- for AOT's other than SWS01 the line tag contains the number
of the line as it appears in the sequence of lines in the SPD; the scan
counter tag scnt counts repetitive scans of a specific line
- in the case of an FP observation the FP is dominating the scan direction
tag: as long as the FP RUN FLAG is set, sdir
is equal 1
- for all other observations the sdir field is +1 for upscans and
-1 for downscans (reminder: upscans have increasing grating scanner
positions and decreasing wavelengths and vice versa)
Cal-files: none
Help text: IA auto analysis
Comment:
use the showstruct command to visualize
the AAR structure:
IA3 TEST> showstruct,aar
(1)
|----TYPE(1)
|-HISTORY(1)
|--HEADER(1)
|----DATA(8000)
|---WAVE(1) ; wavelength [um]
|---FLUX(1) ; flux density [Jy]
|--STDEV(1) ; standard deviation
|---TINT(1) ; integration time [1/24 Hz]
|----DET(1) ; detector number
|----ITK(1) ; SWS instrument time key
|----UTK(1) ; ISO universal time key
|---RPID(2) ; raster point id
|--SPARE(2) ; spare
|---LINE(1) ; line number
|---SDIR(1) ; scan direction
|---SCNT(1) ; scan counter
|-STATUS(1) ; status word
|---FLAG(1) ; detector flag
Warning:
currently it's recommended to use the keyword /all in general.
Otherwise not only the reference scan data, but also some proper science
data might not show up in the AAR.
