next up previous contents index
Next: A.4 Second Stage of Up: A. Product Description Previous: A.2 Raw Data Files

Subsections


A.3 First Stage of the Pipeline

There are two files in this section: the SWS Standard Processed Data (SPD), and the SWS Glitch History Data.


A.3.1 Standard Processed Data (SPD)

These files are normally named swsp*.fits by the IDA.

A.3.1.1 Headers

The SPD files contain primary headers described in Table A.4. In this table example information is used to fill the header.

Most keywords are self-explanatory, or have been described above. Those that are not are INSTRA, INSTDEC and INSTROLL. These are the instruments pointing direction and roll, and are described in the ISO Handbook Volume I, [17].

Table A.4: SPD primary headers
Header keyword   Contents   Comment
SIMPLE = T / file does conform to FITS standard
BITPIX = 8 / number of bits per data pixel
NAXIS = 0 / number of data axes
EXTEND = T / FITS dataset may contain extensions
COMMENT FITS (Flexible Image Transport System) format defined in Astronomy and
COMMENT Astrophysics Supplement Series v44/p363, v44/p371,v73/p359,v73/p365.
COMMENT Contact the NASA Science Office of Standards and Technology for the
COMMENT FITS Definition document #100 and other FITS formation.
ORIGIN = 'ESA ' / European Space Agency
DATE = '2001-12-17' / Creation date 2001/351 2001/303
TELESCOP = 'ISO ' / Infrared Space Observatory
INSTRUME = 'SWS ' / Instrument used
COMMENT SWS Standard Processed Data
FILENAME = 'SWSP62400216' / File name
FILEVERS = '2693 ' / Version ID (derived from creation date)
OLPVERS = 'OLP_101 ' / SOC OLP system version
CALGVERS = 'CALG_71 ' / SOC OLP CAL-G files version
USERNAME = 'PIPEPAR' / Product not catalogued
OBJECT = '200400 MARS' / Target ID as given by proposer
OBSERVER = 'TDEGRAAU' / Proposer ID in ISO Mission DB
EQUINOX = 2000.0000 / Equinox
TMRATE = 32 / Telemetry rate in Kbps (Kbits/s)
EOHAUTCS = '97212233059' / Approx. UTC of start of observation
EOHAUTCE = '97213001349' / Approx. UTC of end of observation
EOHAAOTN = 'S06 ' / AOT name
EOHAPLID = 'MARS_A ' / Proposal ID
EOHAOSN = '16 ' / Observation sequence number
EOHAPSN = '00 ' / Pointing sequence number
EOHAPCAT = '1 ' / Proposal category
EOHACIND = ' ' / Calibration indicator
EOHATTYP = '001 ' / Target type
ATTUTCSL = '97212233032' / UTC of start time of slew to intended target
ATTUTCS = '97212233041' / UTC of time of first arrival at intended target
ATTOTFTH = 10.000000 / On-target flag threshold (arc secs)
ATTRA = 200.20242 / Intended Right Ascension of instrument viewing
ATTDEC = $ -$8.9580800 / Intended DEClination (with ATTRA)
ATTTYPE = 'T ' / Type of attitude operation (P/R/T)
ATTGUIDE = 72040 / Guide star reference number
ATTSAANG = 73.200000 / Solar aspect angle (degrees)
ATTERROR = 0 / CONTINGEncy flag(0=success; 1=target not acq'd)
TREFUTC1 = 270775859 / UTC (whole seconds since 01-01-1989)
TREFUTC2 = 8492230 / UTC (remaining fraction of second)
TREFUTK = 1324988640 / ISO Uniform Time Key (UTK)
TREFITK = 1324988640 / ISO INSTRUMENT Time Key (ITK)
TREFITKU = 0.041666667 / ITK unit length in seconds
TREFCOR1 = 270775859 / UTC of 1st reference time
TREFPHA1 = 624.25378 / Orbital phase at TREFCOR1
TREFHEL1 = $ -$146.18 / Heliocentric correction +(s) at TREFCOR1
TREFDOP1 = $ -$29.50 / ISO velocity towards target (km/s) at TREFCOR1
TREFCOR2 = 270777144 / UTC of 2nd reference time
TREFPHA2 = 624.26868 / Orbital phase at TREFCOR2
TREFHEL2 = $ -$146.30 / Heliocentric correction +(s) at TREFCOR2
TREFDOP2 = $ -$29.46 / ISO velocity towards target (km/s) at TREFCOR2
TREFCOR3 = 270778429 / UTC of 3rd reference time
TREFPHA3 = 624.28359 / Orbital phase at TREFCOR3
TREFHEL3 = $ -$146.42 / Heliocentric correction +(s) at TREFCOR3
TREFDOP3 = $ -$29.42 / ISO velocity towards target (km/s) at TREFCOR3
ISRRSEV = 1 / RTA maximum severity level = WA
ISRQSEV = 1 / QLA maximum severity level = WA
ISRRWARN = 'OK ' / RTA warning flag from IS user
ISRNOOSL = 0 / No. of out-of-soft-limit errors
ISRNOOHL = 0 / No. of out-of-hard-limit errors
ISRNMW = 0 / No. of monitor warnings
ISRNCVW = 0 / No. of command verification errors
ISRNBTW = 0 / No. of bad telemetry errors
ISRNMVW = 0 / No. of memory verification errors
ISRNSQLA = 0 / No. of severe QLA errors
INSTRA = 200.20242 / Reference instrument J2000 right ascension (deg
INSTDEC = $ -$8.9580700 / Reference instrument J2000 declination (deg)
INSTROLL = 292.04000 / Reference instrument J2000 roll angle (deg)
CINSTRA = 200.20250 / Corrected reference instrument J2000 right asce
CINSTDEC = $ -$8.9579100 / Corrected reference instrument J2000 declinatio
CINSTROL = 292.04000 / Corrected reference instrument J2000 roll angle
AOTVERS = '03.70 ' / AOT-to-OCT logic version
VERS4 = 'ssta62400216' / Version of each input file
VERS5 = 'gehk62400216' / Version of each input file
VERS6 = 'eohi624 ' / Version of each input file
VERS7 = 'swer62400216' / Version of each input file
VERS8 = 'irph62400216' / Version of each input file
VERS10 = 'cal04_010.fits'$ ^1$ / CAL04: isp_drange
VERS11 = 'cal02a_010.fits' / CAL02A: isp_midbit
VERS12 = 'cal02_010.fits' / CAL02: isp_ac_correction
VERS13 = 'cal03_010.fits' / CAL03: isp_ac_correction
VERS14 = 'cal03_010.fits' / CAL03: isp_self_pulse
VERS15 = 'cal05_010.fits' / CAL05: isp_self_pulse
VERS16 = 'cal06_010.fits' / CAL06: isp_self_pulse
VERS17 = 'cal01_010.fits' / CAL01: isp_cross_correction
VERS18 = 'cal03_010.fits' / CAL03: isp_slope
VERS19 = 'cal05_010.fits' / CAL05: isp_slope
VERS20 = 'cal06_010.fits' / CAL06: isp_slope
VERS21 = 'calibration_structure'$ ^2$ / CAL16ET: isp_slope
VERS22 = 'cal03_010.fits' / CAL03: isp_wave
VERS23 = 'cal16a_011.fits' / CAL16A: isp_wave
VERS24 = 'cal16b_010.fits' / CAL16B: isp_wave
VERS25 = 'cal16c_010.fits' / CAL16C: isp_wave
VERS26 = 'calibration_structure' / CAL16ET: isp_wave
VERS27 = 'cal23_011.fits' / CAL23: isp_wave
VERS28 = 'cal24_010.fits' / CAL24: isp_wave
VERS29 = 'cal12_010.fits' / CAL12: isp_fpgap
VERS30 = 'cal18_010.fits' / CAL18: isp_fpwave
END        


Notes:

  1. Calibration file can be listed with their complete path.
  2. Due to architectural mismatch between VAX-VMS doubles and IEEE doubles the calibration file containing the grating polynome was connected to the OLP system somewhat differently than all other calibration files.

A.3.1.2 Records

The SPD file contains records with the fields described in Table A.5. In the FITS file they are defined in the binary header.


Table A.5: Records in SPD file
Field name Number Format Unit Comment
GPSCTKEY 1 I*4   Instrument time key
GPSCRPID 2 I*1   Raster point ID
GPSCFILL 1 I*2   Filler
SWSPSTAT 1 I*4   Status of this record
SWSPGPOS 2 R*4   Average positions for gratings 1/2
SWSPGANG 2 R*4 degrees Angles for SW & LW gratings
SWSPFPOS 1 I*4   Position of FP
SWSPFCUR 3 R*4   Average main current for FP coils
SWSPFGAP 2 R*4 $ \mu $m Gaps for FP
SWSPWAVE 52 R*4 $ \mu $m Detector wavelength
SWSPFLUX 52 R*4 $ \mu V/s$ Detector slopes
SWSPOFFS 52 R*4   Number of 24 Hz samples used to
        calculate the slope
SWSPSTDV 52 R*4 $ \mu V/s$ Standard deviation of the detector slope
SWSPFLAG 52 I*4   Flags per detector


Notes:
  1. One record is generated every reset interval (1, 2 or 4 seconds).
  2. Because SWS has no raster AOTs, the raster point IDs will always be set to 1 except when tracking a Solar System Object.
  3. The I*4 status number SWSPSTAT, one per measurement, can be decoded by referring to Table A.6.
  4. The I*4 flag number SWSPFLAG, one per detector, can be decoded by referring to Table A.7.

A.3.1.3 Status Word (SWSPSTAT and SWAASTAT)

The meaning of the value of the status word SWSPSTAT and SWAASTAT) is listed in Table A.6. Different bits summed together may represent the status word value.


Table A.6: Decoding of status word
Meaning Bits set Value
  10987654 32109876 54321098 76543210  
dark 00000000 00000000 00000000 00000000 0
aperture 1 00000000 00000000 00000000 00000001 1
aperture 2 00000000 00000000 00000000 00000010 2
aperture 3 00000000 00000000 00000000 00000011 3
reset in SW section 00000000 00000000 00000000 00000100 4
reset in LW section 00000000 00000000 00000000 00001000 8
reset all bands 00000000 00000000 00000000 00001100 12
diffuse cal normal 00000000 00000000 00000000 00010000 16
diffuse cal high 00000000 00000000 00000000 00110000 48
fp check normal 00000000 00000000 00000000 01000000 64
fp check high 00000000 00000000 00000000 11000000 192
flusher normal 00000000 00000000 00000001 00000000 256
flusher high 00000000 00000000 00000011 00000000 768
grating check normal 00000000 00000000 00000100 00000000 1024
grating check high 00000000 00000000 00001100 00000000 3072
fp nr 2 active 00000000 00000000 00010000 00000000 4096
band1 requested 00000000 00000000 00100000 00000000 8192
band2 requested 00000000 00000000 01000000 00000000 16384
band3 requested 00000000 00000000 10000000 00000000 32768
band4 requested 00000000 00000001 00000000 00000000 65536
band5 requested 00000000 00000010 00000000 00000000 131072
band6 requested 00000000 00000100 00000000 00000000 262144
fp execute flag 00000000 00001000 00000000 00000000 524288
fp run flag 00000000 00010000 00000000 00000000 1048576
low resolution scan 00000000 00100000 00000000 00000000 2097152
reference scan 00000000 01000000 00000000 00000000 4194304
photometric check 00000000 10000000 00000000 00000000 8388608
defined dark measurement 00000001 00000000 00000000 00000000 16777216
SW grating run flag 00000010 00000000 00000000 00000000 33554432
LW grating run flag 00000100 00000000 00000000 00000000 67108864
SW down scan direction$ ^1$ 00001000 00000000 00000000 00000000 134217728
LW down scan direction$ ^1$ 00010000 00000000 00000000 00000000 268435456


Notes:
  1. If the run flag is set and the down flag is not set, the scanner is moving in the up direction.

A.3.1.4 Flag Word (SWSPFLAG and SWAAFLAG)

The meaning of the value of the flag word SWSPFLAG and SWAAFLAG) is listed in Table A.7. Different bits summed together may represent the flag word value.


Table A.7: Decoding of flag
Meaning Bits set Value
No glitch 00000000000 0
1 glitch 00000000001 1
2 glitches 00000000010 2
3 glitches 00000000011 3
Partly Out of limit 00000000100 4
Totally Out of limit 00000001000 8
No data 00000010000 16
Order 1 00000100000 32
Order 2 00001000000 64
Order 3 00001100000 96
Order 4 00010000000 128
Multiple orders (confused) 00011100000 224
Gain bit 1 $ =$ gain 1 01000000000 512
Gain bit 2 $ =$ gain 4 10000000000 1024
Gain bit 3 $ =$ gain 16 11000000000 1536


Notes:
  1. No order flag set indicates no order could be calculated for the data.
  2. Bit number 31 (value $ 2^{30}$) is used to flag (user selected) suspicious data in post-AAR processing.


A.3.2 SWS Glitch History Data

This product has been produced from OLP Version 5, with the files named swgh*.fits.

A.3.2.1 Headers

The SWGH files contain primary headers described in Table A.8, filled with example information.

Most keywords are self-explanatory, or have been described before.

Table A.8: SWGH primary headers
Header keyword   Contents   Comment
SIMPLE = T /  
BITPIX = 8 /  
NAXIS = 0 /  
EXTEND = T /  
ORIGIN = 'ESA ' / European Space Agency
DATE = '2001-12-17' / Date of writing: YYYY-MM-DD
TELESCOP = 'ISO ' / Infrared Space Observatory
INSTRUME = 'SWS ' / Instrument used
COMMENT SWS Glitch History Data
FILENAME = 'SWGH62400216' / File name
FILEVERS = ' ' / Version ID in ISO archive
OLPVERS = 'OLP-101 ' / SOC OLP system version
USERNAME = ' ' / Unofficial data product
CALGVERS = 'CALG_71 ' / SOC OLP system version
END        

A.3.2.2 Records

The SWGH file contains records with the fields described in Table A.9.


Table A.9: Records in the SWGH file
Field name Number Format Unit Comment
GPSCTKEY 1 I*4   Instrument time key
SAMPLES1 52 I*2   1st Sample start
SAMPLEE1 52 I*2   1st Sample end
HEIGHT1 52 R*4 bits$ ^1$ 1st Sample height
SAMPLES2 52 I*2   2nd Sample start
SAMPLEE2 52 I*2   2nd Sample end
HEIGHT2 52 R*4 bits$ ^1$ 2nd Sample height
GLNUMBER 52 I*2   Total glitches


Notes:
  1. Bits can have values between 0 and 4095.


next up previous contents index
Next: A.4 Second Stage of Up: A. Product Description Previous: A.2 Raw Data Files
ISO Handbook Volume V (SWS), Version 2.0.1, SAI/2000-008/Dc