DATA DICTIONARY: HIRS 1B* DATA RECORD
ANALOG_DATA Sixteen selected Digital "A" temperature sensor and
voltage outputs from the 16 and 32 second subcoms and fourteen
Digital "B" one_bit status telemetry points from the 3.2 second
subcom. Descriptions of the Digital "A" points and the
Digital "B" points can be found in Figures 18.2-9 and 18.2-10 of
the HIRS/3 Analog Telemetry in chapter 18 of the NOAA-K P & C
Handbook, respectively.
Type: I*1
ANALOG_GROUND_1 HIRS element 62, bits 261-273.
ANALOG_GROUND_2 HIRS element 62, bits 274-286.
ANALOG_INVALID_BIT_FLAGS Sixteen bit flags associated with the
sixteen HIRS Digital-B analog items. If the associated invalid
bit flag is set for an analog telemetry item, It means that the
telemetry word was not updated during the most recent cycle,
probably due to a dropped minor frame. The telemetry word thus
retains its last update value, and the invalid bit for that word
is set to let users know that the telemetry word is suspect.
type: I*4 (bits 1- 16)
APITCH The value provided in the TIP's CPU parameter APITCH.
It represents the Euler error angle. See the Programming and
Control Handbook (Reduction of CPU Telemetry) for instructions
for the conversion of this integer value to an angular measure.
AROLL The value provided in the TIP's CPU parameter AROLL. It
represents the Euler error angle. See the Programming and Control
Handbook (Reduction of CPU Telemetry)for instructions for the
conversion of this integer value to an angular measure.
ATTITUDE_CONTROL Indicates whether the earth location
fields in this record where corrected for deviations in
spacecraft attitude. A value of 1 indicates the correction has
been made; a value of 0 indicates it has not. Currently this
field will always be set to 0.
******currently working on this definition*************
See NAVIGATION_STATUS_BIT_FIELD for 1b file format.
AYAW The value provided in the TIP's CPU parameter AYAW. It
represents the Euler error angle. See the Programming and Control
Handbook (Reduction of CPU Telemetry) for instructions for the
conversion of this integer value to an angular measure.
BASEPLATE_TEMP Analog telemetry point. {note 2}
Measures the output of the thermistor located on the baseplate.
CALIBRATION_CHAN_QUALITY_FLAGS A 2-dimensional array of Boolean
codes -- one column for each of the IR channels -- indicating
the occurrence (1--> yes, 0 --> no) of the channel specific
conditions that follow:
(1) all bad black body counts for this
scan line.
(2) all bad space view counts for
this scan line.
(3) all bad PRTs for this scan line.
(4) marginal blackbody view counts for
this line.
(5) marginal space view counts for this
line.
(6) marginal PRT temperatures on this line.
CALIBRATION_PROBLEM_CODE An array of Boolean codes
indicating the occurrence ( 1--> yes, 0 --> no) of the conditions
given below. These indicators apply to the scan line as a
whole. Indicators for specific channel conditions are given by
the CALIBRATION_CHAN_QUALITY_FLAGS.
(1) scan line was not calibrated
because of bad time.
(2) scan line was calibrated
using fewer than the preferred
number of scan lines because of
proximity to start or end of
data set or to a data gap.
(3) scan line was not calibrated
because of bad or insufficient
PRT data.
(4) scan was calibrated but with
marginal PRT data channel
indicators.
(5) some uncalibrated channels
for this scan line (see channel
indicators).
(6) uncalibrated due to
instrument mode.
CLOCK_DRIFT_CORRECTION Indicates whether the scan time given in
this record has been corrected for the drift in the spacecraft
clock. A value of 0 indicates no correction has been made, and
a value of 1, that the time in TIME_OF_DAY_OF_SCAN has been
corrected for drift.
CLOCK_DRIFT_DELTA The difference between the time reported on
the data record and that reported by the spacecraft. The time
reported on the data record has been corrected for the drift of
the spacecraft's clock. If the CLOCK_DRIFT_DELTA is added to
TIME_OF_DAY_OF_SCAN, the time reported by the spacecraft will
result.
COLD_TARGET_PRT The PRT readings in counts of the cold
calibration target. Note that these are included merely for
completeness; these readings are not used in the calibration.
HIRS element 59, bits 27-286. {note 1} {note 4}
COOLER_HOUSING_TEMP One reading of the patch temperature. HIRS
element 62, bits 131-143. {note 1} {note 4}
DATA_FILL Indicates whether any of the constituent minor frames
of the current HIRS scan were missing (1 --> yes ). (See
HIRS_ELEMENT_QUALITY below.) See Quality_Indicator_Bit_Field for
1b format.
DATA_VERIFICATION_BINARY_CODE Verification codes as sent from the
spacecraft in HIRS element 63.
DAY_OF_YEAR_OF_SCAN The day of the year on which the scan
began, set by the PDP based upon the date and time information
provided in the data stream.
DIG_B_DATA One_bit staus telemetry generated by the TIP every
3.2 seconds. In the HIRS/3 instrument, the Digital "B" outputs are
discrete bilevel signals of 0 or 5V nominal relating to a Logic 1
or zero.
DIG_B_INVALID_BIT_FLAGS Fourteen bit flags associated with the
fourteen HIRS Digital-B telemetry items. If the associated
invalid bit flag is set for an analog telemetry item, It means
that the telemetry word was not updated during the most recent
cycle, probably due to a dropped minor frame. The telemetry
word thus retains its last update value, and the invalid bit
for that word is set to let users know that the telemetry word
is suspect.
type: I*4 (bits 2- 15)
DO_NOT_USE_SCAN Is a general quality indicator set by the PDP.
If its value is 1, the scan line should be treated by the
product processors as though it were missing. This flag will be
set if the calibration cannot be performed, or if the earth
location information is missing or erroneous, or if the scan
contains a corrupt time code and a valid time can not be
inferred. <<1b: bytes 29-32, bit 31>> {note 8}
DWELL Indicates whether the HIRS instrument has been commanded
into Dwell Mode (1 --> yes). Set by the PDP. << TBC: We
determine whether the instrument is in the Commnaded Position
Mode by looking at bits 50-52, & 58 of HIRS element 63 (see
UIIS). If any of these bits is 0, the instrument has been
commanded to the corresponding position. This condition should
disable calibration and earth location. The DO_NOT_USE_SCAN flag
should be set.>> See Quality_Indicator_Bit_Field for 1b format.
EARTH_LOC_ATTITUDE_CORRECTED A value of one indicates that earth
location was corrected for TIP Euler angles. See Navigation
Status Bit Field. See NAVIGATION_STATUS_BIT_FIELD for 1b file
format.
EARTH_LOC_INDICATOR Normally zero, this indicator indicates
the occurrence of a problem in earth location. See Navigation
Status Bit Field. See NAVIGATION_STATUS_BIT_FIELD for 1b file
format.
0 = earth location available
1 = user ephemeris file greater than 24 hours old
2 = no earth location available
EARTH_LOC_PROBLEM_CODE Provides information about the status
of earth location if NO_EARTH_LOC_THIS_SCAN is set to "TRUE".
(1) not earth-located because of bad
time.
(2) questionable earth location
because of questionable time
code.
(3) questionable earth location
because of marginal agreement with
reasonableness check.
(4) earth location probably bad --
fails reasonableness check.
ELECTRONICS_POWER Indicates if electronic power is being supplied
to all electronic and data handling systems not provided by the
"Instrument On" command.
ELECTRONICS_TEMP Measures the output of the thermistor located
inside the electronics box. {note 6}
ELEC_CAL_DIG2ANALOG_CONV_VOLTS << was _TEMP>> Five readings of
a voltage associated with the electronic calibration digital
to analog converter. HIRS element 61, bits 222-286. {note 1}
{note 4}
FILTER_MOTOR_CURRENT Supplies electrical power to the filter wheel
motor
FILTER_WHEEL_HOUSING_HEATER_CURR Five readings of the filter
wheel housing's heater current. HIRS element 61, bits 27-91.
{note 1} {note 4}
FILTER_WHEEL_HOUSING_TEMP The PRT counts for the filter wheel
housing. There are five samples from each of 4 PRTs. HIRS
element 60, bits 27-286. {note 1} {note 4}
FILTER_WHEEL_MOTOR_TEMP Measures the output from the temperature
sensor located on the filter wheel motor.
FIRST_AFTER_DATA_GAP The current scan line immediately succeeds
a gap of one or more scan lines. The scan line number will take
into account the missing scans. Set by the PDP based upon
major/minor frame accounting and the availability of information
from the spacecraft.<<1b: bytes 29-32, bit 29>> {note 8}
FIRST_GOOD_TIME_AFTER_UPDATE The spacecraft clock has been
updated. This scan is the first subsequent scan whose time is
judged good. Set by the PDP. <<1b: bytes 29-32, bit 26>>
{note 8}
FIRST_STAGE_RADIATOR_TEMP Five readings of the first stage
radiator PRT in counts. HIRS element 61, bits 27-91. {note 1}
FIRST_STATUS_WORD The first of two status words {note 5} from
the digital A data, this field contains bits 40-52 {note 1} of
element 63 left justified; i.e., the 13 most significant bits
contain the status word; the 3 remaining bits are all zero.
FRAME_TIME_ERROR Sixty-four item array of indicators associated
with the sixty-four minor frames in a scan line. A value of one
indicates this frame is suspect due to a time error.
See Quality_Indicator_Bit_Field for 1b format.
GDTIME Geometric Data Time taken from the TIP CPU telemetry.
INSTRUMENT_STATUS_CHANGE One byte indicator, if set to one
indicates instrument status changed with this scan. {note 8}
INSUFFICIENT_DATA_FOR_CALIBRATION One byte indicator, if set
to one indicates this scan line was not calibrated. {note 8}
See CALIBRATION_PROBLEM_CODE for possible reasons scan line was
not calibrated.
LAT_LON_DEGREES The geodetic latitude and longitude, in that
order, of each of the fields of view along the scan line. The
latitude's range is +/- 90 degrees, with 0 at the equator and
positive angles to the north. The longitude is measured from
Greenwich, with positive values to the east; its range is +/-
180 degrees.
LINE_COUNTER The line counter taken from HIRS element 63.
Normally this will cycle from 0 to 39 indicating the position
within the superswath, i.e., the number of scan since the last
calibration. For HIRS/3 line 0 is the space view, line 1 is the
view of the internal warm target (IWT), and lines 3 through 39
are scans of the earth. The HIRS calibration cycle can be
commanded off, in which case the instrument continuely scans the
earth and does not look either at the black body or space. In
this case LINE_COUNTER will cycle 0, 1, ..., 8191, 0,..., and
the field CAL_DISABLE will contain 1.
LOCAL_AZIMUTH_ANGLE The angle between the projections onto
the tangent plane of lines drawn from the viewed point to the
sun and from the viewed point to the satellite. It is measured
from sun to satellite and has a range of +/- 180 degrees; angles
eastward from the sun are positive.
LOCAL_ZENITH_ANGLE The angle from a line drawn from the viewed
point to the satellite and one from the viewed point normal to its
tangent plane. The range of satellite zenith angle is 0 to 90
degrees.
MAJOR_FRAME_COUNTER The TIP major frame counter of the major
frame from which this scan line was extracted. Set by the PDP
directly from the raw data.
MINOR_FRAME_BIT_FLAGS -- The minor frame quality
bit flags as provided by the ingester. Each of the 64 elements
corresponds to one of the constituent TIP minor frames used to
construct the HIRS scan. (See the AIP 1a requirements document
for the meaning of each of the bits.)
MINOR_FRAME_HEADER_ELEMENTS A sixty-four word array that contains
header elements for minor frames 0 - 63.
(1) bits 31-24: scan encoder position
(2) bits 23-19: electronic cal level indicator
(3) bits 18_13: <zero fill>
(4) bits 12-7: channel 1 period monitor
(5) bits 6-1: element number
(6) bit 0: filter sync disignator
MIRROR_LOCKED The mirror was locked during this frame. Normal
earth scanning was disrupted. See Quality_Indicator_Bit_Field for
1b format.
MIRROR_POSITION_ERROR There was a mirror reposition error during
this frame. See Quality_Indicator_Bit_Field for 1b format.
MIRROR_REPOSITION The mirror was moving during this frame.
See Quality_Indicator_Bit_Field for 1b format.
NAVIGATION_STATUS_BIT_FIELD This field contains the following
navigation status information:
(1) bits 31-17: <zero fill>
(2) bit 16: 1 = earth location corrected for TIP
Euler Angles.
(3) bits 15-12: earth location indicator (0 =
earth location available; 1 = user ephemeris
files greater than 24 hours old; 2 = no earth
location available).
(4) bits 11-8: spacecraft attitude control (0 =
operating in YGC or NOMINAL mode; 1 = operating
in another mode; 2 = attitude exceeds nominal
tolerance; 3= both 1 and 2).
(5) bits 7-4: attitude SMODE (0 = NOMINAL mode; 1 =
rate nulling mode; 2 = YGC mode; 3 = search
mode; 4 = coast mode).
(6) bits 3-0: attitude PWTIP$AC
(0 = NOMINAL mode/no test; 1 = yaw axis test in
progress; 2 = roll axis test in progress;
3 = pitch axis test in progress)
in progress).
NEG_CAL The counts resulting from the negative electronic
calibration as reported by the spacecraft. HIRS element 56,
bits 27-286. {note 1}
NO_EARTH_LOC_THIS_SCAN The location of the FOVs of this scan
line are unavailable. See EARTH_LOC_PROBLEM_CODE for reason.
Set by the PDP. <<1b: bytes 29-32, bit 27>> {note 8}
OBSERVATIONS The radiometric counts from the instrument during
the current scan of space, the warm target, or the earth.
ORBIT_NODE This field indicates the direction of the spacecraft
at the time of the scan. A value of zero indicates the
spacecraft is heading north (ascending), a value of one that it
is going south (descending).
PACS_ERROR PACS QC errors have been detected in at least one
of the minor frames that comprise this scan. Set by the PDP
based upon the Minor Frame Quality Indicators in the 1a stream,
this flag summarizes the quality indicators for all the TIP
minor frames that were used to generate this HIRS scan line.
In particular if the PACS reported any of the following in any
of the constituent minor frames, PACS_ERROR will be set to 1:
time error, data gap, bit sync status, frame sync word,
frame_sync lock, flywheeling, bit slip, AIP parity.
<<Was DACS_ERROR.>> See Quality_Indicator_Bit_Field for
1b format.
PATCH_CONTROL_POWER HIRS element 62, bits 144-156. {note 1}
PATCH_TEMP_EXPANDED Five readings of the patch PRT, in counts.
HIRS element 61, bits 27-91. {note 1}
PATCH_TEMP_FULL_RANGE HIRS element 62, bits 92 104
PITCH_ERROR_CORRECTION The value provided in the TIP's CPU
parameter APITCH. It represents the Euler error angle. See the
Programming and Control Handbook (Reduction of CPU Telemetry)
for instructions for the conversion of this integer value to an
angular measure.
POS_CAL The counts resulting from the positive electronic
calibration as reported by the spacecraft.
PRIMARY_CAL_COEFS The calibration coefficients computed by the
PDP for the HIRS IR channels using the primary calibration
algorithm. These are the calibration coeffieints that should be
used to convert radiometric counts from channels 1 - 19 in the
current scan line to radiance. (See OBSERVATIONS.)
COEFFICIENT:0 IS INTERCEPT
1 IS SLOPE
2 IS QUADRATIC
PRIMARY_TELESCOPE_TEMP HIRS element 62, bits 40 - 62.
PWTIP$AC The "passive wheel test in progress" indicator from
the TIP CPU telemetry. The two-byte hex code given in the
telemetry has been stored as a one-byte indicator that can be
interpreted as follows:
0 --> normal (no test)
1 --> yaw axis test inprogress
2 --> roll axis test in progress
3 --> pitch axis test in progress
-1 --> attitude monitoring locked out
(reference: KLM Telemetry List, Figure 27)
See NAVIGATION_STATUS_BIT_FIELD for 1b file format.
QUALITY_INDICATOR_BIT_FIELD Integer*4 word, for bits 7 through
1, if bit is on(=1) then the statement is true. Corresponding
one-byte indicators are also defined for these flags.
bit7: this frame suspect due to a time error.
bit6: this frame contains data gap data fill.
bit5: this frame contains TIP dwell data fill.
bit4: data suspect due to PACS QC error.
bit3: mirror locked during this frame.
bit2: mirror position error during this frame.
bit1: mirror was moving during this frame.
bit0: minor word odd parity bit.
ROLL_ERROR_CORRECTION The value provided in the TIP's CPU
parameter AROLL. It represents the Euler error angle. See the
Programming and Control Handbook (Reduction of CPU Telemetry)
for instructions for the conversion of this integer value to an
angular measure.
S/C_ALTITUDE The spacecraft altitude in kilometers. Computed
by AELDS, rounded by PDP to nearest km, and stored as an integer.
SCAN_LINE_NUMBER The relative scan number within the period of
the 1b data set, starting with 1. Scan_line_number will take
into account missing scans and thus attempt to give an accurate
count of the number of scan lines generated by the spacecraft.
Set by the PDP.
SCAN_MIRROR_TEMP Output of thermal sensor attached to the scan mirror.
SCAN_MOTOR_CURRENT Electrical power applied to the scan motor to
provide required stepping torque levels.
SCAN_MOTOR_TEMP Output of a thermistor attached to the scan motor and
connected to a passive conditioning circuit supplied by the +28Vdc
Telemetry Power.
SCAN_SEQUENCE_COUNTER The line number of the scan within a
major frame. This number will vary from 1 to 5.
<<1b: bytes 17 & 18>>
SCAN_TYPE A code indicating what the instrument is viewing.
0 --> earth
1 --> space
2 --> ICT (generally not applicable for HIRS/3)
3 --> IWT
Set by the PDP based on the same logic that sets
SCAN_SEQUENCE_COUNTER.
SECONDARY_CAL_COEFS Calibration resulting from the implementation of
the primary calibration algorithm and alternative CPIDS database
parameters.
SECONDARY_TELESCOPE_TEMP Output of sensor used to monitor the
temperature of secondary telescope.
SECOND_STATUS_WORD The second of two status words {note 5} from
the digital A data, this field contains bits 53-65 {note 1} of
element 63 left justified; i.e., the 13 most significant bits
contain the status word; the 3 remaining bits are all zero.
SMODE The attitude control submode word from the TIP CPU
telemetry. The two-byte hex code given in the telemetry has
been stored as a one-byte indicator that can be interpreted as
follows:
+
0 --> nominal
1 --> rate nulling
2 --> yaw gyrocompass
3 --> search
4 --> coast
+
(reference: KLM Telemetry List, Figure 27)
See NAVIGATION_STATUS_BIT_FIELD for 1b file format.
SOLAR_ZENITH_ANGLE The angle between a line drawn from the
viewed point to the sun and one from the viewed point normal to
its tangent plane. The range of solar zenith angle is 0 to
180 degrees. {note 4}
SECONDARY_CAL_COEFS The calibration coefficients computed by the
PDP for the IR channels using a secondary calibration
algorithm. These coeffieints are experimental and most users
should ignore them. Currently, identical to primary calibration.
TIME_OF_DAY_OF_SCAN The time of day in milliseconds of the start
of the scan. Set by the PDP based upon the date and time
information provided in the data stream. For HIRS, scan times
are inferred from the time of the TIP major frame. If the time
of the TIP major is not known and in the case of embedded AIP or
TIP, the time will be inferred from the AVHRR frame (GAC or
HRPT).
TIME_PROBLEM_CODE Provides an array of boolean codes
indicating the occurrence (or not) of the following conditions:
(1) time received from the s/c was
obviously bad. The time on this scan
can proably be inferred from those on nearby
scan lines.
(2) bad time received from s/c and can't
infer one reliably.
(3) pattern of scan times changed. May or may not be
related to clock update.
(4) start of a sequence that apparently repeats scan
times that have been previously accepted.
(5) spare.
TIME_SEQUENCE_ERROR One-byte indicator, if set to one then a time
sequence error was detected within this scan. See TIME_PROBLEM_CODE
for possible reasons. {note 8}
TIP_PARITY One_byte indicator, if set to one then minor word odd
parity bit is set. See Quality_Indicator_Bit_Field for 1b format.
VDC_NEGATIVE_15 -15-volt power supply provided by dc to dc converter
connected to the +28-volt bus input.
VDC_NEGATIVE_7P5 -7P5-volt power supply provided by dc to dc converter
connected to the +28-volt bus input.
VDC_PLUS15 +15-volt power supply provided by dc to dc converter
connected to the +28-volt bus input.
VDC_PLUS_10 +10-volt power supply provided by dc to dc converter
connected to the +28-volt bus input.
VDC_PLUS_5 +5-volt power supply provided by dc to dc converter
connected to the +28-volt bus input.
VDC_PLUS_7P5 +5-volt power supply provided by dc to dc converter
connected to the +28-volt bus input.
WARM_TARGET_PRT The PRT counts for the warm calibration target.
There are five samples of each from the 4 PRTs. HIRS element 58,
bits 27-286. {note 1} {note 4}
YAW_ERROR_CORRECTION The value provided in the TIP's CPU
parameter AYAW. It represents the Euler error angle. See the
Programming and Control Handbook (Reduction of CPU Telemetry)
for instructions for the conversion of this integer value to an
angular measure.
YEAR_OF_SCAN The year in which the scan began. It will contain
the year as a four-digit number. It is set by the PDP based upon
the date and time information provided in the data stream.
----------------------------------------------------------------
notes +++++
{note 1} Bits contained in HIRS elements are numbered from left
to right (most to least significant) and go from 1 to 288.
{note 2} See {UISHIR} for channel number, range, and resolution.
{note 3} Tip analog telemetry is provided in counts. There is a
two step conversion process: first the counts are converted to a
voltage by applying the multiplication factor 0.02 volts/count
{P&C Handbook, Section 15}. The resulting voltage is converted
to the desired engineering units by applying the appropriate
polynomial coefficients, given in the header. These coefficients
are supplied by the manufacturer (in this case ITT) in the specific
instrument in question (e.g., HIRS/3 S/N H302).
{note 4} The housekeeping data provided in counts. To be
converted to engineering units the appropriate polynomial
coefficients from the 1b* header must be applied.
{note 5} The bits in the two status words are defined in the P&C
Handbook, Figure 18.2-13.
{note 6} These data items come from the TIP analog telemetry as
specified in the HIRS's UIIS (Section 3.1.5.4 and Table 11) and
the KLM Telemetry List (Table II).
{note 7} Two one-byte fields in the 1b* are represented in the
1b file format by bit flag settings in the Scan Line Bit Field
described below:
bit 15: 0 = north bound data; 1 = southbound data
bit 14: 1 = scan time corrected for clock drift
bits 13-0: <zero fill>
{note 8} Several one-byte items in the the 1b* are represented
in the 1b file format by bit flag settings in the Quality Indicator
Bit Field described below:
bit 31: do not use scan for product generation
bit 30: time sequence error detected within this scan
bit 29: data gap precedes this scan
bit 28: insufficient data for calibration
bit 27: earth location data not available
bit 26: first good time following a clock update
(nominally 0)
bit 25: instrument status changed with this scan
bits 24-0: <zero fill>