L1A_VIS_Science Interface Specification

Interface Specification Version 2.1.5.2

June 4, 2001

Swath Name = "L1A_VIS_Science"

Level = "level1A"

# Footprints = 90

# scanlines per scanset = 3

Dimensions

These fields define all dimensions that can be used for HDF-EOS swath fields.

The names "GeoTrack" and "GeoXTrack" have a special meaning for this document: "Cross-Track" data fields have a hidden dimension of "GeoXTrack"; "Along-Track" data fields have a hidden dimension of "GeoTrack"; "Full Swath Data Fields have hidden dimensions of both "GeoTrack" and "GeoXTrack".

Name Value Explanation
GeoXTrack 90 Dimension across track for footprint positions. Same as number of footprints per scanline.
GeoTrack # of scan lines in swath Dimension along track for footprint positions. Same as number of scanlines in granule. (Nominally 45 for Level-2, AMSU, and AIRS/Vis low-rate engineering; 135 for AIRS/Vis and HSB high-rate quantities)
SubTrack 9 VIS detector elements per AIRS footprint along track (9)
SubXTrack 8 VIS samples per AIRS footprint across track (8)
Bulb 3 Number of photometric calibration sources (light bulbs) that can be used as sources for photometric calibration (3)
GainHistory 5 Number of photometric gain calculations to store for use in smoothing of gain (5)
GeoLocationsPerSpot 4 Geolocations for the 4 corner pixels in the order: trailing first scanned; trailing last-scanned; leading first-scanned; leading last-scanned. Each footprint also has a central geolocation associated with the swath geolocation lat/lon/time of the footprint.
Channel 4 Dimension of radiance array

Geolocation Fields

These fields appear for every footprint (GeoTrack * GeoXTrack times) and correspond to footprint center coordinates and "shutter" time.

Name Explanation
Latitude Footprint boresight Latitude in degrees North (-90.0 ... 90.0)
Longitude Footprint boresight Longitude in degrees East (-180.0 ... 180.0)
Time Footprint "shutter" TAI Time: floating-point elapsed seconds since Jan 1, 1993
Size: 291600 bytes (0.3 MB) per 45-scanset granule

Attributes

These fields appear only once per granule

Name Type Extra Dimensions Explanation
processing_level string of 8-bit characters None Zero-terminated character string denoting processing level ("level1A")
instrument string of 8-bit characters None Zero-terminated character string denoting instrument ("VIS")
DayNightFlag string of 8-bit characters None Zero-terminated character string denoting granule as day and/or night: (Always "Day", "Night", or "Both")
AutomaticQAFlag string of 8-bit characters None Zero-terminated character string denoting granule data quality: (Always "Passed", "Failed", or "Suspect")
NumTotalData 32-bit integer None Total number of expected data points
NumProcessData 32-bit integer None Number of data points which are present and can be processed routinely (state = 0)
NumSpecialData 32-bit integer None Number of data points which are present and can be processed only as a special test (state = 1)
NumBadData 32-bit integer None Number of data points which are present but cannot be processed (state = 2)
NumMissingData 32-bit integer None Number of expected data points which are not present (state = 3)
NumLandSurface 32-bit integer None Number of data points for which the surface is more than 90% land
NumOceanSurface 32-bit integer None Number of data points for which the surface is less than 10% land
node_type string of 8-bit characters None Zero-terminated character string denoting whether granule is ascending, descending, or pole-crossing: ("Ascending" and "Descending" for entirely ascending or entirely descending granules, or "NorthPole" or "SouthPole" for pole-crossing granules)
start_year 32-bit integer None Year in which granule started, UTC (e.g. 1999)
start_month 32-bit integer None Month in which granule started, UTC (1 ... 12)
start_day 32-bit integer None Day of month in which granule started, UTC (1 ... 31)
start_hour 32-bit integer None Hour of day in which granule started, UTC (0 ... 23)
start_minute 32-bit integer None Minute of hour in which granule started, UTC (0 ... 59)
start_sec 32-bit floating-point None Second of minute in which granule started, UTC (0.0 ... 59.0)
start_orbit 32-bit integer None Orbit number of mission in which granule started
end_orbit 32-bit integer None Orbit number of mission in which granule ended
orbit_path 32-bit integer None Orbit path of start orbit (1 ... 233? as defined by EOS project)
granule_number 32-bit integer None Number of granule within orbit (1 ... 17?)
num_scansets 32-bit integer None Number of scansets in granule (1 ... 45)
num_scanlines 32-bit integer None Number of scanlines in granule (3 * num_scansets)
start_Latitude 64-bit floating-point None Latitude of spacecraft at start of granule
start_Longitude 64-bit floating-point None Longitude of spacecraft at start of granule
start_Time 64-bit floating-point None TAI Time at start of granule
end_Latitude 64-bit floating-point None Latitude of spacecraft at end of granule
end_Longitude 64-bit floating-point None Longitude of spacecraft at end of granule
end_Time 64-bit floating-point None TAI Time at end of granule
eq_x_longitude 32-bit floating-point None Longitude of spacecraft at southward equator crossing nearest granule start
eq_x_tai 64-bit floating-point None Time of eq_x_longitude in TAI units
orbitgeoqa 32-bit integer None Orbit Geolocation QA: bit 0 (LSB): bad input value (last scanline); bit 1: bad input value (first scanline); bit 2: PGS_EPH_GetEphMet() returned PGSEPH_E_NO_SC_EPHEM_FILE; bit 3: PGS_EPH_GetEphMet() returned PGSEPH_E_BAD_ARRAY_SIZE; bit 4: PGS_EPH_GetEphMet() returned PGSTD_E_TIME_FMT_ERROR; bit 5: PGS_EPH_GetEphMet() returned PGSTD_E_TIME_VALUE_ERROR; bit 6: PGS_EPH_GetEphMet() returned PGSTD_E_SC_TAG_UNKNOWN; bit 7: PGS_EPH_GetEphMet() returned PGS_E_TOOLKIT; bit 8: PGS_TD_UTCtoTAI() returned PGSTD_E_NO_LEAP_SECS; bit 9: PGS_TD_UTCtoTAI() returned PGSTD_E_TIME_FMT_ERROR; bit 10: PGS_TD_UTCtoTAI() returned PGSTD_E_TIME_VALUE_ERROR; bit 11: PGS_TD_UTCtoTAI() returned PGS_E_TOOLKIT; bit 12: PGS_CSC_DayNight() returned PGSTD_E_NO_LEAP_SECS; bit 13: PGS_CSC_DayNight() returned PGSCSC_E_INVALID_LIMITTAG; bit 14: PGS_CSC_DayNight() returned PGSCSC_E_BAD_ARRAY_SIZE; bit 15: PGS_CSC_DayNight() returned PGSCSC_W_ERROR_IN_DAYNIGHT; bit 16: PGS_CSC_DayNight() returned PGSCSC_W_BAD_TRANSFORM_VALUE; bit 17: PGS_CSC_DayNight() returned PGSCSC_W_BELOW_HORIZON; bit 18: PGS_CSC_DayNight() returned PGSCSC_W_PREDICTED_UT1; bit 19: PGS_CSC_DayNight() returned PGSTD_E_NO_UT1_VALUE; bit 20: PGS_CSC_DayNight() returned PGSTD_E_BAD_INITIAL_TIME; bit 21: PGS_CSC_DayNight() returned PGSCBP_E_TIME_OUT_OF_RANGE; bit 22: PGS_CSC_DayNight() returned PGSCBP_E_UNABLE_TO_OPEN_FILE; bit 22: PGS_CSC_DayNight() returned PGSMEM_E_NO_MEMORY; bit 24: PGS_CSC_DayNight() returned PGS_E_TOOLKIT; bit 25-31: not used
num_satgeoqa 16-bit integer None Number of scans with problems in satgeoqa
num_glintgeoqa 16-bit integer None Number of scans with problems in glintgeoqa
num_moongeoqa 16-bit integer None Number of scans with problems in moongeoqa
num_ftptgeoqa 16-bit integer None Number of footprints with problems in ftptgeoqa
num_zengeoqa 16-bit integer None Number of footprints with problems in zengeoqa
num_demgeoqa 16-bit integer None Number of footprints with problems in demgeoqa
num_fpe 16-bit integer None Number of floating point errors
LonGranuleCen 16-bit integer None Longitude of the center of the granule in degrees (-180 ... 180)
LatGranuleCen 16-bit integer None Latitude of the center of the granule in degrees (-90 ... 90)
LocTimeGranuleCen 16-bit integer None Local time at the center of the granule in minutes past midnight (0 ... 1439)
xtrack_err 32-bit floating-point Channel (= 4) cross-track pixel location error estimate per channel (km)
track_err 32-bit floating-point Channel (= 4) Along-track pixel location error estimate per channel (km)
align_1_2_nadir 32-bit floating-point None Expected error (km) between the pixel locations for the corner locations of near-nadir AIRS footprints (45 & 46) between VIS channels 1 & 2
align_2_3_nadir 32-bit floating-point None Expected error (km) between the pixel locations for the corner locations of near-nadir AIRS footprints (45 & 46) between VIS channels 2 & 3
align_2_4_nadir 32-bit floating-point None Expected error (km) between the pixel locations for the corner locations of near-nadir AIRS footprints (45 & 46) between VIS channels 2 & 4
align_1_2_maxang 32-bit floating-point None Expected error (km) between the pixel locations for the corner locations of near-limb AIRS footprints (1 & 90) between VIS channels 1 & 2
align_2_3_maxang 32-bit floating-point None Expected error (km) between the pixel locations for the corner locations of near-limb AIRS footprints (1 & 90) between VIS channels 2 & 3
align_2_4_maxang 32-bit floating-point None Expected error (km) between the pixel locations for the corner locations of near-limb AIRS footprints (1 & 90) between VIS channels 2 & 4
align_vis_airs 32-bit floating-point None Expected error (km) between the pixel locations for the corner locations of near-nadir AIRS footprints (45 & 46) between the AIRS center and all VIS channels
apid_414_cnt AIRS Engineering Packet Counts (see below) None Counts of packets of APID 414 (AIRS fixed high-rate engineering 1) by condition
apid_415_cnt AIRS Engineering Packet Counts (see below) None Counts of packets of APID 415 (AIRS fixed high-rate engineering 2) by condition
apid_416_cnt AIRS Engineering Packet Counts (see below) None Counts of packets of APID 416 (AIRS flexible high-rate engineering 1) by condition
apid_417_cnt AIRS Engineering Packet Counts (see below) None Counts of packets of APID 417 (AIRS flexible high-rate engineering 2) by condition
reflector_dev Unlimited Engineering Struct (see below) GeoXTrack (= 90) Statistics describing deviations of the viewing angle "scanang" from expected scan position for each footprint position averaged over the scanlines in the granule (degrees)
apid_404_cnt AIRS Science/Calibration Packet Counts (see below) None Counts of packets of APID 404 (AIRS Science) by condition
PHOPOWERVOLT Limited Engineering Struct (see below) None Photo calibrator power voltage (not redundant) (volts)
PSTEMPSTATUS1 Limited Engineering Struct (see below) None Power supply temperature status 1 (active A or B) (Kelvins)
RAD1TEMP Limited Engineering Struct (see below) None 1st stage radiator temperature (active A or B) (Kelvins)
RAD2TEMPVA Limited Engineering Struct (see below) None 2nd stage radiator temperature voltage A (Kelvins)
RAD2TEMPVB Limited Engineering Struct (see below) None 2nd stage radiator temperature voltage B (Kelvins)
CHDRIVECURRVA Limited Engineering Struct (see below) None Chopper drive current voltage A (Amps)
CHDRIVECURRVB Limited Engineering Struct (see below) None Chopper drive current voltage B (Amps)
FPDETREFTMPVA Limited Engineering Struct (see below) None Focal plane IR detector reference temperature voltage A (volts)
FPDETREFTMPVB Limited Engineering Struct (see below) None Focal plane IR detector reference temperature voltage B (volts)
PSCURRVG1SA Limited Engineering Struct (see below) None Power Supply current voltage for group 1 A (amps)
PSCURRVG1SB Limited Engineering Struct (see below) None Power Supply current voltage for group 1 A (amps)
PSCURRVG2S1A Limited Engineering Struct (see below) None Power Supply current voltage for group 2-1 A (amps)
PSCURRVG2S1B Limited Engineering Struct (see below) None Power Supply current voltage for group 2-1 B (amps)
PSCURRVG2S2A Limited Engineering Struct (see below) None Power Supply current voltage for group 2-2 A (amps)
PSCURRVG2S2B Limited Engineering Struct (see below) None Power Supply current voltage for group 2-2 B (amps)
PSCURRVG2S3A Limited Engineering Struct (see below) None Power Supply current voltage for group 2-3 A (amps)
PSCURRVG2S3B Limited Engineering Struct (see below) None Power Supply current voltage for group 2-3 B (amps)
SCMOTORTEMPA Limited Engineering Struct (see below) None Scannner motor temperature A (Kelvins)
SCMOTORTEMPB Limited Engineering Struct (see below) None Scannner motor temperature B (Kelvins)
SPSMATEMP Limited Engineering Struct (see below) None Spectrometer SMA motor support temperature (active A or B) (Kelvins)
SPTEMP Limited Engineering Struct (see below) None Spectrometer temperature (active A or B) (Kelvins)
STADMTEMP Limited Engineering Struct (see below) None Structure ADM temperature output (active A or B) (Kelvins)
STSEMLOCTEMP Limited Engineering Struct (see below) None Structure SEM location temperature output (Kelvins)
FPDETTEMPVA Limited Engineering Struct (see below) None Focal plane IR detector temperature voltage A (Kelvins)
FPDETTEMPVB Limited Engineering Struct (see below) None Focal plane IR detector temperature voltage B (Kelvins)
SPGRATNGTMP1 Limited Engineering Struct (see below) None Spectrometer grating temperature 1 (active A or B) (Kelvins)
SPGRATNGTMP2 Limited Engineering Struct (see below) None Spectrometer grating temperature 2 (active A or B) (Kelvins)
CLTTHRM1A Limited Engineering Struct (see below) None Cooler A Electronics Temperature 1
CLTTHRM1B Limited Engineering Struct (see below) None Cooler B Electronics Temperature 1
CLCURRPRIMA Limited Engineering Struct (see below) None Cooler A Average Peak Input Current
CLCURRPRIMB Limited Engineering Struct (see below) None Cooler B Average Peak Input Current
CLTHEXCHA Limited Engineering Struct (see below) None Cooler A Baseplate Temperature
CLTHEXCHB Limited Engineering Struct (see below) None Cooler B Baseplate Temperature
CLTCHDPCA Limited Engineering Struct (see below) None Cooler A Cold Head Temperature
CLTCHDPCB Limited Engineering Struct (see below) None Cooler B Cold Head Temperature
CLVBACCELPA Limited Engineering Struct (see below) None Cooler A Active Accel Output
CLVBACCELPB Limited Engineering Struct (see below) None Cooler B Active Accel Output
Size: 8263 bytes (0.0 MB) per granule

Along-Track Data Fields

These fields appear once per scanline (GeoTrack times)

Name Type Extra Dimensions Explanation
satheight 32-bit floating-point None Satellite altitude at nadirTAI in km above reference ellipsoid (e.g. 725.2)
satroll 32-bit floating-point None Satellite attitude roll angle at nadirTAI (-180.0 ... 180.0 angle about the +x (roll) ORB axis, +x axis is positively oriented in the direction of orbital flight completing an orthogonal triad with y and z.)
satpitch 32-bit floating-point None Satellite attitude pitch angle at nadirTAI (-180.0 ... 180.0 angle about +y (pitch) ORB axis. +y axis is oriented normal to the orbit plane with the positive sense opposite to that of the orbit's angular momentum vector H.)
satyaw 32-bit floating-point None Satellite attitude yaw angle at nadirTAI (-180.0 ... 180.0 angle about +z (yaw) axis. +z axis is positively oriented earthward parallel to the satellite radius vector R from the spacecraft center of mass to the center of the Earth.)
satgeoqa 32-bit integer None Satellite Geolocation QA flags: bit 0 (LSB): bad input value; bit 1: PGS_TD_TAItoUTC() returned PGSTD_E_NO_LEAP_SECS; bit 2: PGS_TD_TAItoUTC() returned PGS_E_TOOLKIT; bit 3: PGS_EPH_EphemAttit() returned PGSEPH_W_BAD_EPHEM_VALUE; bit 4: PGS_EPH_EphemAttit() returned PGSEPH_E_BAD_EPHEM_FILE_HDR; bit 5: PGS_EPH_EphemAttit() returned PGSEPH_E_NO_SC_EPHEM_FILE; bit 6: PGS_EPH_EphemAttit() returned PGSEPH_E_NO_DATA_REQUESTED; bit 7: PGS_EPH_EphemAttit() returned PGSTD_E_SC_TAG_UNKNOWN; bit 8: PGS_EPH_EphemAttit() returned PGSEPH_E_BAD_ARRAY_SIZE; bit 9: PGS_EPH_EphemAttit() returned PGSTD_E_TIME_FMT_ERROR; bit 10: PGS_EPH_EphemAttit() returned PGSTD_E_TIME_VALUE_ERROR; bit 11: PGS_EPH_EphemAttit() returned PGSTD_E_NO_LEAP_SECS; bit 12: PGS_EPH_EphemAttit() returned PGS_E_TOOLKIT; bit 13: PGS_CSC_ECItoECR() returned PGSCSC_W_BAD_TRANSFORM_VALUE; bit 14: PGS_CSC_ECItoECR() returned PGSCSC_E_BAD_ARRAY_SIZE; bit 15: PGS_CSC_ECItoECR() returned PGSTD_E_NO_LEAP_SECS; bit 16: PGS_CSC_ECItoECR() returned PGSTD_E_TIME_FMT_ERROR; bit 17: PGS_CSC_ECItoECR() returned PGSTD_E_TIME_VALUE_ERROR; bit 18: PGS_CSC_ECItoECR() returned PGSCSC_W_PREDICTED_UT1; bit 19: PGS_CSC_ECItoECR() returned PGSTD_E_NO_UT1_VALUE; bit 20: PGS_CSC_ECItoECR() returned PGS_E_TOOLKIT; bit 21: PGS_CSC_ECRtoGEO() returned PGSCSC_W_TOO_MANY_ITERS; bit 22: PGS_CSC_ECRtoGEO() returned PGSCSC_W_INVALID_ALTITUDE; bit 23: PGS_CSC_ECRtoGEO() returned PGSCSC_W_SPHERE_BODY; bit 24: PGS_CSC_ECRtoGEO() returned PGSCSC_W_LARGE_FLATTENING; bit 25: PGS_CSC_ECRtoGEO() returned PGSCSC_W_DEFAULT_EARTH_MODEL; bit 26: PGS_CSC_ECRtoGEO() returned PGSCSC_E_BAD_EARTH_MODEL; bit 27: PGS_CSC_ECRtoGEO() returned PGS_E_TOOLKIT; bit 28-31: not used
glintgeoqa 16-bit integer None Glint Geolocation QA flags: bit 0 (LSB): bad input value; bit 1: PGS_CBP_Earth_CB_Vector() returned PGSCBP_W_EARTH_CB_ID; bit 2: PGS_CBP_Earth_CB_Vector() returned PGSCBP_E_INVALID_CB_ID; bit 3: PGS_CBP_Earth_CB_Vector() returned PGSTD_E_BAD_INITIAL_TIME; bit 4: PGS_CBP_Earth_CB_Vector() returned PGSCBP_E_BAD_ARRAY_SIZE; bit 5: PGS_CBP_Earth_CB_Vector() returned PGSCBP_E_UNABLE_TO_OPEN_FILE; bit 6: PGS_CBP_Earth_CB_Vector() returned PGSCBP_E_TIME_OUT_OF_RANGE; bit 7: PGS_CBP_Earth_CB_Vector() returned PGSTD_E_NO_LEAP_SECS; bit 8: PGS_CBP_Earth_CB_Vector() returned PGSCBP_W_BAD_CB_VECTOR; bit 9: PGS_CBP_Earth_CB_Vector() returned PGS_E_TOOLKIT; bit 10: PGS_CSC_ECItoECR() returned any 'W' class return code (for Glint); bit 11: PGS_CSC_ECItoECR() returned any 'E' class return code (for Glint); bit 12: PGS_CSC_ECRtoGEO() returned any 'W' class return code (for Glint); bit 13: PGS_CSC_ECRtoGEO() returned any 'E' class return code (for Glint); bit 14: PGS_CSC_ECItoECR() returned any 'W' class return code (for Sun); bit 15: PGS_CSC_ECItoECR() returned any 'E' class return code (for Sun)
moongeoqa 16-bit integer None Moon Geolocation QA flags: bit 0: bad input value; bit 1: PGS_TD_TAItoUTC() returned PGSTD_E_NO_LEAP_SECS; bit 2: PGS_TD_TAItoUTC() returned PGS_E_TOOLKIT; bit 3: PGS_CBP_Sat_CB_Vector() returned PGSCSC_W_BELOW_SURFACE; bit 4: PGS_CBP_Sat_CB_Vector() returned PGSCBP_W_BAD_CB_VECTOR; bit 5: PGS_CBP_Sat_CB_Vector() returned PGSCBP_E_BAD_ARRAY_SIZE; bit 6: PGS_CBP_Sat_CB_Vector() returned PGSCBP_E_INVALID_CB_ID; bit 7: PGS_CBP_Sat_CB_Vector() returned PGSMEM_E_NO_MEMORY; bit 8: PGS_CBP_Sat_CB_Vector() returned PGSCBP_E_UNABLE_TO_OPEN_FILE; bit 9: PGS_CBP_Sat_CB_Vector() returned PGSTD_E_BAD_INITIAL_TIME; bit 10: PGS_CBP_Sat_CB_Vector() returned PGSCBP_E_TIME_OUT_OF_RANGE; bit 11: PGS_CBP_Sat_CB_Vector() returned PGSTD_E_SC_TAG_UNKNOWN; bit 12: PGS_CBP_Sat_CB_Vector() returned PGSEPH_E_BAD_EPHEM_FILE_HDR; bit 13: PGS_CBP_Sat_CB_Vector() returned PGSEPH_E_NO_SC_EPHEM_FILE; bit 14: PGS_CBP_Sat_CB_Vector() returned PGS_E_TOOLKIT; bit 15: not used
nadirTAI 64-bit floating-point None TAI time at which instrument is nominally looking directly down. (between footprints 15 & 16 for AMSU or between footprints 45 & 46 for AIRS/Vis & HSB)
sat_lat 64-bit floating-point None Satellite latitude in degrees (-90.0 ... 90.0)
sat_lon 64-bit floating-point None Satellite longitude in degrees (-180.0 ... 180.0)
scan_node_type 8-bit integer None 'A' for ascending, 'D' for descending, 'N' for North-Polar, 'S' for South-Polar
glintlat 32-bit floating-point None Solar glint latitude in degrees at nadirTAI (-90.0 ... 90.0)
glintlon 32-bit floating-point None Solar glint longitude in degrees at nadirTAI (-180.0 ... 180.0)
EngDataFormt1 16-bit integer None Data field format used for multiple alternate lists from HR Eng packet 1 (=0 for default; see AIRS THB Table 4-2)
EngDataFormt2 16-bit integer None Data field format used for multiple alternate lists from HR Eng packet 2 (=0 for default; see AIRS THB Table 4-2)
EdABIndic1 32-bit floating-point None EDC A/B Powered on Indicator (A=2.5 B=0) (Volts)
EdABIndic2 32-bit floating-point None EDC A/B Powered on Indicator (A=2.5 B=0) (Volts)
OpMode 16-bit integer None Instrument Operations Mode. See AIRS Command Handbook, section 7.2.4, for a definition of each bit.
ScOpModeCurr 8-bit integer None Scanner Operating Mode - current mode
ScOpModeCmded 8-bit integer None Scanner Operating Mode - commanded mode
RTShrdMemFail 8-bit integer None Flag indicating test of remote term mem failed - bit 15 (msb) of sw status wd 1
MemoryFail 8-bit integer None RAM failure detected by Perform Memory Test - bit 12 of software status word 1
ROMCksumError 8-bit integer None ROM checksum error detected by Perform Memory Test - bit 11 of sw status word 1
RTMessgeError 8-bit integer None Summit chip reported remote terminal message error - bit 9 of sw status word 1
MissingEDTC 8-bit integer None End of Data Transfer Cycle msg not recvd in time - bit 8 of sw status word 1
MissngTimSync 8-bit integer None S/C time code or sync signals missing several times - bit 7 of sw status word 1
VCXOConstrErr 8-bit integer None VCXO Constr Error - bit 6 of software status word 1
InsClkHldgOvw 8-bit integer None Flag indicating inst clock holding reg overwritten - bit 5 of sw status word 1
InstClkAdjust 8-bit integer None Flag indicating inst clock adjusted to s/c time signal - bit 3 of sw status wd 1
ResetCause 8-bit integer None Cause of the latest software reset - bits 2 - 0 (lsbs) of software status word 1
ICIProtFault 8-bit integer None ICI Protection Fault - bit 14 of software status word 2
ICIInvalRange 8-bit integer None ICI Invalid Range - bit 13 of software status word 2
ICIInvChannel 8-bit integer None Flag indicating invalid port number in a serial cmd - bit 11 of sw status word 2
RTBITFail 8-bit integer None Flag indicating remote terminal BIT test failed - bit 10 of sw status word 2
AmaRelayFaild 8-bit integer None Flag indicating AMA actuator selection failed - bit 14 of software status word 3
AmaStepFailed 8-bit integer None Actuator failed to move requested number of steps - bit 13 of sw status word 3
Ama3EndState 8-bit integer None AMA end state for actuator #3 - bits 12 - 10 of software status word 3
Ama2EndState 8-bit integer None AMA end state for actuator #2 - bits 9 - 7 of software status word 3
ScnrOpnFail 8-bit integer None Flag indicating scanner failed to perform as expected - bit 5 of sw status wd 2
Ama1EndState 8-bit integer None AMA end state for actuator #1 - bits 6 - 4 of software status word 3
AmaSwStatus 8-bit integer None AMA software processing state - bits 3 - 1 of software status word 3
ScannrAtPoint 8-bit integer None Flag indicating scanner is pointing in cmded direction - bit 0 of sw status wd 3
AmaInvSwState 8-bit integer None Flag indicating AMA reached an illegal state - bit 15 (msb) of sw status word 3
spacecraft_state 8-bit integer None Spacecraft state (0=LNCH; 1=STBY; 2=SCI; 3=SAFE; 4=SRVL; 5-7=UNDF)
Size: 13095 bytes (0.0 MB) per 45-scanset granule

Full Swath Data Fields

These fields appear for every footprint of every scanline in the granule (GeoTrack * GeoXTrack times)

Name Type Extra Dimensions Explanation
scanang 32-bit floating-point None Scanning angle of AIRS instrument for this footprint (-180.0 ... 180.0)
ftptgeoqa 32-bit integer None Footprint Geolocation QA flags: bit 0 (LSB): bad input value; bit 1: PGS_TD_TAItoUTC() returned PGSTD_E_NO_LEAP_SECS; bit 2: PGS_TD_TAItoUTC() returned PGS_E_TOOLKIT; bit 3: PGS_CSC_GetFOV_Pixel() returned PGSCSC_W_MISS_EARTH; bit 4: PGS_CSC_GetFOV_Pixel() returned PGSTD_E_SC_TAG_UNKNOWN; bit 5: PGS_CSC_GetFOV_Pixel() returned PGSCSC_W_ZERO_PIXEL_VECTOR; bit 6: PGS_CSC_GetFOV_Pixel() returned PGSCSC_W_BAD_EPH_FOR_PIXEL; bit 7: PGS_CSC_GetFOV_Pixel() returned PGSCSC_W_INSTRUMENT_OFF_BOARD; bit 8: PGS_CSC_GetFOV_Pixel() returned PGSCSC_W_BAD_ACCURACY_FLAG; bit 9: PGS_CSC_GetFOV_Pixel() returned PGSCSC_E_BAD_ARRAY_SIZE; bit 10: PGS_CSC_GetFOV_Pixel() returned PGSCSC_W_DEFAULT_EARTH_MODEL; bit 11: PGS_CSC_GetFOV_Pixel() returned PGSCSC_W_DATA_FILE_MISSING; bit 12: PGS_CSC_GetFOV_Pixel() returned PGSCSC_E_NEG_OR_ZERO_RAD; bit 13: PGS_CSC_GetFOV_Pixel() returned PGSMEM_E_NO_MEMORY; bit 14: PGS_CSC_GetFOV_Pixel() returned PGSTD_E_NO_LEAP_SECS; bit 15: PGS_CSC_GetFOV_Pixel() returned PGSTD_E_TIME_FMT_ERROR; bit 16: PGS_CSC_GetFOV_Pixel() returned PGSTD_E_TIME_VALUE_ERROR; bit 17: PGS_CSC_GetFOV_Pixel() returned PGSCSC_W_PREDICTED_UT1; bit 18: PGS_CSC_GetFOV_Pixel() returned PGSTD_E_NO_UT1_VALUE; bit 19: PGS_CSC_GetFOV_Pixel() returned PGS_E_TOOLKIT; bit 20: PGS_CSC_GetFOV_Pixel() returned PGSEPH_E_BAD_EPHEM_FILE_HDR; bit 21: PGS_CSC_GetFOV_Pixel() returned PGSEPH_E_NO_SC_EPHEM_FILE; bit 22-31: not used
zengeoqa 16-bit integer None Satellite zenith Geolocation QA flags: bit 0 (LSB): (Spacecraft) bad input value; bit 1: PGS_CSC_ZenithAzimuth(S/C) returned PGSCSC_W_BELOW_HORIZON; bit 2: PGS_CSC_ZenithAzimuth(S/C) returned PGSCSC_W_UNDEFINED_AZIMUTH; bit 3: PGS_CSC_ZenithAzimuth(S/C) returned PGSCSC_W_NO_REFRACTION; bit 4: PGS_CSC_ZenithAzimuth(S/C) returned PGSCSC_E_INVALID_VECTAG; bit 5: PGS_CSC_ZenithAzimuth(S/C) returned PGSCSC_E_LOOK_PT_ALTIT_RANGE; bit 6: PGS_CSC_ZenithAzimuth(S/C) returned PGSCSC_E_ZERO_INPUT_VECTOR; bit 7: PGS_CSC_ZenithAzimuth(S/C) returned PGS_E_TOOLKIT; bit 8: (Sun) bad input value; bit 9: (suppressed) PGS_CSC_ZenithAzimuth(Sun) returned PGSCSC_W_BELOW_HORIZON (This is not an error condition - the sun is below the horizon at night); bit 10: PGS_CSC_ZenithAzimuth(Sun) returned PGSCSC_W_UNDEFINED_AZIMUTH; bit 11: PGS_CSC_ZenithAzimuth(Sun) returned PGSCSC_W_NO_REFRACTION; bit 12: PGS_CSC_ZenithAzimuth(Sun) returned PGSCSC_E_INVALID_VECTAG; bit 13: PGS_CSC_ZenithAzimuth(Sun) returned PGSCSC_E_LOOK_PT_ALTIT_RANGE; bit 14: PGS_CSC_ZenithAzimuth(Sun) returned PGSCSC_E_ZERO_INPUT_VECTOR; bit 15: PGS_CSC_ZenithAzimuth(Sun) returned PGS_E_TOOLKIT
demgeoqa 16-bit integer None Digital Elevation Model (DEM) Geolocation QA flags: bit 0 (LSB): bad input value; bit 1: Could not allocate memory; bit 2: Too close to North or South pole. Excluded; bit 3: Layer resolution incompatibility. Excluded; bit 4: Any DEM Routine (elev) returned PGSDEM_E_IMPROPER_TAG; bit 5: Any DEM Routine (elev) returned PGSDEM_E_CANNOT_ACCESS_DATA; bit 6: Any DEM Routine (land/water) returned PGSDEM_E_IMPROPER_TAG; bit 7: Any DEM Routine (land/water) returned PGSDEM_E_CANNOT_ACCESS_DATA; bit 8: Reserved for future layers; bit 9: Reserved for future layers; bit 10: PGS_DEM_GetRegion(elev) returned PGSDEM_M_FILLVALUE_INCLUDED; bit 11: PGS_DEM_GetRegion(land/water) returned PGSDEM_M_FILLVALUE_INCLUDED; bit 12: Reserved for future layers; bit 13: PGS_DEM_GetRegion(all) returned PGSDEM_M_MULTIPLE_RESOLUTIONS; bit 14: PGS_CSC_GetFOV_Pixel() returned any 'W' class return code; bit 15: PGS_CSC_GetFOV_Pixel() returned any 'E' class return code
satzen 32-bit floating-point None Spacecraft zenith angle (0.0 ... 180.0 degrees from zenith GEO)
satazi 32-bit floating-point None Spacecraft azimuth angle (-180.0 ... 180.0 degrees E of N GEO)
solzen 32-bit floating-point None Solar zenith angle (0.0 ... 180.0 degrees from zenith GEO)
solazi 32-bit floating-point None Solar azimuth angle (-180.0 ... 180.0 degrees E of N GEO)
sun_glint_distance 16-bit integer None Distance (km) from footprint center to location of the sun glint
topog 32-bit floating-point None Mean topography in meters above reference ellipsoid
topog_err 32-bit floating-point None Error estimate for topog
landFrac 32-bit floating-point None Fraction of spot that is land (0.0 ... 1.0)
landFrac_err 32-bit floating-point None Error estimate for landFrac
counts 16-bit integer Channel (= 4) * SubTrack (= 9) * SubXTrack (= 8) Raw counts (data numbers) for each channel (Channel 1: ~0.40 micron; Ch 2: ~0.6 micron; Ch 3: ~0.8 micron; Ch 4: broadband)
state 32-bit integer None Data state: 0:Process, 1:Special, 2:Erroneous, 3:Missing
cornerlats 32-bit floating-point GeoLocationsPerSpot (= 4) * Channel (= 4) Latitudes at the centers of the pixels at the corners of the IR footprint by channel
cornerlons 32-bit floating-point GeoLocationsPerSpot (= 4) * Channel (= 4) Longitudes at the centers of the pixels at the corners of the IR footprint by channel
Size: 9161100 bytes (9.2 MB) per 45-scanset granule

Total File Size (plus storage for dimensions and other HDF-EOS overhead): 9474058 bytes (9.5 MB) per 45-scanset granule = 2273.8 MB per day


Special AIRS Types

Limited Engineering Struct: This type is used for engineering data fields for which there are known "yellow" limits

Field Name Type Explanation
min 32-bit floating-point Minimum value field takes on in granule (not valid when num_in = 0)
max 32-bit floating-point Maximum value field takes on in granule (not valid when num_in = 0)
mean 32-bit floating-point Mean of in-range values field takes on in granule (not valid when num_in = 0)
dev 32-bit floating-point Standard Deviation of in-range values field takes on in granule (not valid when num_in = 0)
num_in 32-bit integer Count of in-range values field takes on in granule
num_lo 32-bit integer Count of out-of-range low values field takes on in granule
num_hi 32-bit integer Count of out-of-range high values field takes on in granule
num_bad 32-bit integer Count of occassions on which field takes on invalid flag value (-9999) in granule
range_min 32-bit floating-point Minimum in-range value. Any value less than this is counted in num_lo and is not used in the calculation of mean & dev.
range_max 32-bit floating-point Maximum in-range value. Any value greater than this is counted in num_hi and is not used in the calculation of mean & dev.
missing 8-bit integer Missing limits flags. Bit 0 (LSB) is 1 when yellow low (range_min) limit is missing; Bit 1 is high when yellow high (range_max) limit is missing; other bits unused, set to 0.
max_track 32-bit integer GeoTrack index (counting from 1) where max was found
max_xtrack 32-bit integer GeoXTrack index (counting from 1) where max was found
min_track 32-bit integer GeoTrack index (counting from 1) where min was found
min_xtrack 32-bit integer GeoXTrack index (counting from 1) where min was found

Unlimited Engineering Struct: This type is used for engineering data fields for which there are NOT known "yellow" limits

Field Name Type Explanation
min 32-bit floating-point Minimum value field takes on in granule (not valid when num = 0)
max 32-bit floating-point Maximum value field takes on in granule (not valid when num = 0)
mean 32-bit floating-point Mean of values field takes on in granule (not valid when num = 0)
dev 32-bit floating-point Standard Deviation of values field takes on in granule (not valid when num = 0)
num 32-bit integer Count of occurrences of field in granule (not including those counted in num_bad)
num_bad 32-bit integer Count of occassions on which field takes on invalid flag value (-9999) in granule
max_track 32-bit integer GeoTrack index (counting from 1) where max was found
max_xtrack 32-bit integer GeoXTrack index (counting from 1) where max was found
min_track 32-bit integer GeoTrack index (counting from 1) where min was found
min_xtrack 32-bit integer GeoXTrack index (counting from 1) where min was found

AIRS Engineering Packet Counts: This type tracks counts of packets received during an interval by conditions under which they were received

Field Name Type Explanation
missing_in 16-bit integer Count of packets missing between packets that are present
missing_ends 16-bit integer Count of packets missing at beginning or end of granule timespan: missing packets for which there are either no existing packets before them or no existing packets after them. (When all data is missing all packets will be counted here)
good 16-bit integer Count of packets not counted in any other category

AIRS Science/Calibration Packet Counts: This type tracks counts of packets received during an interval by conditions under which they were received

Field Name Type Explanation
missing_in 16-bit integer Count of packets missing between packets of any AIRS APID that are present
missing_ends 16-bit integer Count of packets missing at beginning or end of granule timespan: missing packets for which there are either no existing packets before them or no existing packets after them. (When all data is missing all packets will be counted here)
at_noop 16-bit integer Count of packets for which the spacecraft mode is not operational for some or all of the packet interval
illegal_mode 16-bit integer Count of packets for which there was an illegal instrument mode
special_cal 16-bit integer Count of packets for which the instrument was in a special calibration mode
invalid_data 16-bit integer Count of invalid packets (includes missing engineering)
good 16-bit integer Count of packets not counted in any other category