This dictionary is in development by multiple parties at UMD (NH migration) and SWRI (NH second extended mission). Async releases are anticipated to keep the published dictionary in line with published data. Initials/handles: ACR Anne Raugh, SBN at UMD AGB Adeline Gicquel-Brodtke, SBN at UMD BJH Ben Hirsch, SBN at UMD cgobat Caden Gobat, SwRI MKC M. Kate Crombie, Indigo Information Systems, LLC ======= Modification History: 2024-04-03 ACR Begin history === Version 1.1.0.0 === 2024-04-03 to 2024-04-05 Version 1.1.0 continued updates: ACR Deprecate MVIC_Conversion_Constants class in favor of Radiometric_Conversion_Constants class, with corresponding Schematron rule. Consistently add "nh:" prefix to references in descriptions. Review definitions for completeness, consistency, and style; flag problems. 2024-06-15 ACR Manually resolved conflicts resulting from multiple people editing the the same parts of the file in separate branches. Convert all occurrences of the name to "Alice". Split "scan_type" attribute definition into two occurences, one for MVIC and one for LEISA, to accommodate different permissible value lists. Modified LEISA_Details class definition to not refer to "channels". 2024-06-20 Added schematron rule to enforce correct units for resolved vs. cgobat unresolved sources in nh:units_of_conversion_constants; updated several attribute descriptions and removed [INCOMPLETE] and [CHECK] flags; removed "Spectrograph" as a permissible value for nh:detector_type; added a minimum value of absolute zero for LEISA temperature attribute; added the SOCC to the list of permissible Alice aperture values; removed nh:binning_mode attribute and its parent class nh:LORRI_Details (of which it was the only member). The Alice_Details class collects observational parameters that are specific to the Alice instrument. The nh:Detector class provides observation metadata relevant to the specific detector (an instrument may have more than one detector) used to collect the data. The nh:Frame_Bias_Levels class records the frame number and left/right bias levels for a single frame in a framing observation sequence. In the MVIC detector used for framing observations, the bias level for left and right sides of the detector may vary. Bias levels on each side are measured with every observation through shielded pixels on either side of the detector, the bias values for the pixels from each side them being averaged to return a single median bias level for each side of the detector. These bias levels are reported as left and right median bias levels for each frame. The nh:Framing_Biases class contains one nh:Frame_Bias_Levels class for each individual frame of a framing observation. These classes provide the left and right side bias levels applied in calibrating the data. The nh:LEISA_Details class collects observational parameters that are specific to the LEISA instrument. The nh:LORRI_Target_Information class collects attributes related to the target of the LORRI observation. The nh:MVIC_Calibration_Information class gathers attributes related to the attributes of the detector and other information relevant to the calibration processing performed to produce the current data product. This class is deprecated as of version 1.1.0.0. Please use nh:Radiometric_Conversion_Constants instead. The nh:MVIC_Conversion_Constants class provides the values needed to run the conversion from the calibrated pixel values to physical units. This conversion is dependent on the spectral distribition of the source, the MVIC detector wavelength range, and whether or not the source is resolved. A description of how to convert from data values to physical units is provided in the "New Horizons SOC to Instrument Pipeline ICD" document. The nh:MVIC_Details class collects observational parameters that are specific to the MVIC instrument and its various channels. The nh:Mission_Elapsed_Time class provides spacecraft clock partition and count readings for the start and end of the observation(s) comprising the data product. The nh:Mission_Parameters class presents the various New Horizons-specific metadata for both primary and extended missions. The nh:Observation_Parameters class collects observational metadata that is specific to the mission, spacecraft, and instrument which produced the data product. The nh:Radiometric_Conversion_Constants class provides the values needed to run the conversion from the calibrated pixel values to physical units. This conversion is dependent on the spectral distribition of the source, the detector wavelength range, and whether or not the source is resolved. A description of how to convert from data values to physical units is provided in the "New Horizons SOC to Instrument Pipeline ICD" document. The nh:Ralph_Details class presents Ralph common instrument parameters needed for data calibration. The nh:Resolved_Source class presents radiometric conversion constants for converting calibrated pixel values into physical units for sources which are resolved. The nh:SWAP_Details class collects observational parameters that are specific to the SWAP instrument. The nh:Spacecraft_State class collects observational parameters that are specific to the spacecraft state at the time of the observation. The nh:Unresolved_Source class presents radiometric conversion constants for converting calibrated pixel values into physical units for sources which are not resolved. This section contains the simpleTypes that provide more constraints than those at the base data type level. The simpleTypes defined here build on the base data types. This is another component of the common dictionary and therefore falls within the common namespace. The Alice instrument has two different apertures (i.e., optical paths) through which it can collect data: the "airglow" aperture and the solar occultation channel (SOCC). The nh:aperture attribute indicates which was used for a given data product. The nh:approx_target_line attribute provides the approximate pixel position in the image of the center of the best guess target (as specified by nh:approx_target_name) in one-based absolute units along the "Line" axis as defined in the primary_image Array object. The origin is in the lower left of the image when disp:horizontal_display_direction is "Left to Right" and disp:vertical_display_direction is "Bottom to Top". If there is no best guess at the target position, the attribute will be omitted. The nh:approx_target_name attribute is the best guess of the intended target of the observation made by the automated data processing pipeline. If the best guess at the target is unknown, the attribute will be UNK i.e. unknown. If there was no target, i.e. for some instances of instrument calibration activities, the attribute will be nilled. The nh:approx_target_sample attribute provides the approximate pixel position in the image of the center of the best guess target (as specified by nh:approx_target_name) in one-based absolute units along the "Sample" axis as defined in the primary_image Array object. The origin is in the lower left of the image when disp:horizontal_display_direction is "Left to Right" and disp:vertical_display_direction is "Bottom to Top". If there is no best guess at the target position, the attribute will be omitted. The nh:arrokoth_constant attribute supplies the constant to be used for sources with spectral distribution similar to (486958) Arrokoth (a.k.a., 2014 MU69) to convert calibrated data to physical units. The nh:charon_constant attribute supplies the constant to be used for sources with spectral distribution similar to Pluto I (Charon) to convert calibrated data to physical units. The nh:clock_partition holds the mission clock partition counter. This is a simple integer. The nh:detector_name provides the identifier of the detector that recorded the observation(s) comprising the product. For instruments with multiple detectors, as in the case of MVIC, for example, this string will include both the instrument ID and the specific detector ID. The nh:detector_type attribute provides a brief indication of the type of hardware comprising the detector. The nh:frame_number attribute is used to identify a single frame (or image plane) in an observation that is formatted as a 3D image cube. The first frame is numbered "0" (zero). The nh:gain attribute provides the gain setting applied in collecting the data, in units of electrons/DN. The nh:gc_scan_rate attribute provides the scan rate requested of the Guidance, Navigation, and Control (GNC) system by the Ralph instrument. If the scan rate was not forced, GNC will return the actual scan rate achieved. The nh:hk_packet_is_real attribute describes whether the Ralph housekeeping packet (ApID 0x510) is real (true) or assumed from a gap (false). The nh:jupiter_constant attribute supplies the constant to be used for sources with spectral distribution similar to Jupiter to convert calibrated data to physical units. The nh:left_side_median_bias attribute provides the median bias, in DN, determined by averaging the bias levels for the shielded pixels on the left side of the detector array. The nh:leisa_mode attribute identifies the data collection readout mode of the LEISA instrument, where RAW is for un-subtracted readout mode and SUBTRACTED for correlated double sample (CDS) mode. The nh:leisa_offset_1 attribute provides the voltage offset, in DN, in the first of the four LEISA quadrants. The nh:leisa_offset_2 attribute provides the voltage offset, in DN, in the second of the four LEISA quadrants. The nh:leisa_offset_3 attribute provides the voltage offset, in DN, in the third of the four LEISA quadrants. The nh:leisa_offset_4 attribute provides the voltage offset, in DN, in the fourth of the four LEISA quadrants. The nh:leisa_rate attribute provides the time between LEISA readouts. There is zero dead time between frames, so in practice, this value is equivalent to the per-frame exposure time, and the number of frames per second is exactly its reciprocal. The nh:leisa_side attribute indicates the hardware side in use during the observation sequence. The nh:leisa_temperature attribute provides the temperature of the LEISA instrument. The nh:met510 attribute provides the mission elapsed time (MET) of the Ralph housekeeping packet (ApID 0x510) that marks the start of an observation, used to determine the observation start time and frame rate. The nh:mission_phase_name provides the formal identification of the mission phase. Phases are identified continuously from primary through extended missions. The nh:observation_description element provides a human-readable decoding of the sequence_id string. It provides a basic description of the planned observation activity. Each instrument should have an accompanying ancillary/documentation file that lists all the planned sequences for each instrument for each mission phase. The nh:pholus_constant attribute supplies the constant to be used for sources with spectral distribution similar to (5145) Pholus to convert calibrated data to physical units. The nh:physical_pixel_size attribute gives the hardware dimension of a single, square pixel within the detector. The nh:pivot_wavelength is used in converting the pixel values in the calibrated data into physical units for some instruments. It is wavelength-dependent, but once defined is constant for each detector. A description of how to convert from data values to physical units is provided in the "New Horizons SOC to Instrument Pipeline ICD" document. The nh:pluto_constant attribute supplies the constant to be used for sources with spectral distribution similar to (134340) Pluto to convert calibrated data to physical units. The nh:pointing_method attribute indicates the spacecraft pointing method enabled during the operational sequence. Possible enumerated values are 'CB1', 'CB2', 'CB3', 'EARTH', 'SUN' or 'ORBIT NORMAL', which describe the body or plane used to establish a reference frame onboard the spacecraft for pointing purposes (where 'CB' stands for central body). Alternatively, this value can take the form 'RADEC=[X],[Y]' (where [X] and [Y] represent a numeric right ascension and declination in degrees, respectively) to indicate inertial pointing. This value does *not* indicate that any particular axis of the spacecraft is aligned with the target or direction indicated by the pointing method. This attribute is not applicable if nh:spacecraft_spin_state is 'Spinning'. The nh:read_noise attribute provides the noise level of the detector as a count of electrons. The nh:relative_control_mode_active attribute is a true/false flag that indicates if the relative control mode of the spacecraft was enabled during the operational sequence. The nh:right_side_median_bias attribute provides the median bias, in DN, determined by averaging the bias levels for the shielded pixels on the right side of the detector array. The nh:scan_type attribute indicates what sort of scanning was employed in collecting the data. The nh:sequence_id provides a long string encoding some infomation about the planned observing sequence. A more human-readable description should be provided in the nh:observation_description element. Each instrument should have an accompanying ancillary/documentation file that lists all the planned sequences for each instrument for each mission phase. The nh:solar_constant attribute supplies the constant to be used for sources with spectral distribution similar to the Sun to convert MVIC calibrated data to physical units. The nh:spacecraft_spin_state attribute indicates which of the spacecraft spin states was employed during the observation sequence. The nh:start_clock_count is the Mission Elapsed Time code at the start of the observation(s), formatted as spacecraft clock ticks and indicating whole and fractional seconds. The nh:stop_clock_count is the Mission Elapsed Time code at the end of the observation(s), formatted as spacecraft clock ticks and indicating whole and fractional seconds. The nh:sweep_samples_count attribute is the count of samples during a sweep of the SWAP electro-optics. [INCOMPLETE] The nh:target_motion_rate attribute is the rate of motion of the target with respect to the instrument detector in units of (TBR). The nh:tdi_median_bias_level attribute gives the median bias level of a time-delay integration observation. For TDI mode, bias levels in each detector were determined in-flight during early mission phases. They may vary depending on exposure length. See the "New Horizonz SOC to Instrument Pipeline ICD" document for details. The nh:tdi_rate attribute is the rate at which charge was moved through successive rows of the detector in obtaining the observation. This rate was calculated to match the scan rate of the spacecraft. The nh:telemetry_apid is the application identifier for the observation. The values are specific to instrument and activity. The definitions for apIDs relevant to the archived observations are contained in various tables in the "New Horizons SOC to Instrument Pipeline ICD document. The apID is used in formulating the file name, among other things. Metadata encoded in the apID is contained in separate metadata elements elsewhere in the label. The nh:thruster_x_enabled attribute describes the state of the x thruster. The thruster is either enabled ('true') or disabled ('false'). The nh:thruster_y_enabled attribute describes the state of the y thruster. The thruster is either enabled ('true') or disabled ('false'). The nh:thruster_z_enabled attribute describes the state of the z thruster. The thruster is either enabled ('true') or disabled ('false'). The calibrated data are not converted to physical units, because the conversion applied depends on the general spectrum of the object being converted and whether it is resolved. For resolved sources, the conversion produces data in units of radiance. For unresolved sources, the conversion results in units of flux (irradiance). The nh:units_of_conversion_constants attribute contains the appropriate physical units for the conversion constants in the class in which it is contained to produce either radiance or flux units, as appropriate, when the conversion is applied. A description of how to convert from data values to physical units is provided in the "New Horizons SOC to Instrument Pipeline ICD" document.