Dictionary:PDS4 Keyword

VICAR Property.VICAR Keyword

General Definition

InSight-Specific Information

XPath

Valid Values (attribute)
Children (class)

Data Type
Units

msn_surface:application_name

TELEMETRY.APPLICATION_PROCESS_NAME

The application_name attribute provides the name associated with the source or process which created the data.
InSight Specific:
Indicates the Application ID (APID) name for this product. APID's are used to distinguish types of telemetry products.

ASCII_Short_String_Collapsed

geom:selected_instrument_id

ARM_ARTICULATION_STATE.ARTICULATION_DEV_INSTRUMENT_ID

The selected_instrument_id attribute specifies an abbreviated name or acronym that identifies the selected instrument mounted on the articulation device.

ASCII_Short_String_Collapsed

geom:device_id

GRAPPLE_ARTICULATION_STATE.ARTICULATION_DEVICE_ID

The device_id attribute specifies the abbreviated identification of an articulation device.

ASCII_Short_String_Collapsed

geom:device_mode

GRAPPLE_ARTICULATION_STATE.ARTICULATION_DEVICE_MODE

The device_mode attribute specifies the deployment state (i.e., physical configuration) of an articulation device at the time of data acquisition. Examples include 'Arm Vibe', 'Deployed', 'Free Space', 'Stowed'. Note: the value set for this attribute is mission-specific and should be declared in a mission-specific dictionary.
InSight Specific:
State of the grapple fingers. The value is determined by the IDA FSW by reading the state of the two limit switches on the grapple. It affects when the grapple opening algorithm completes. Bit 0 is the "fingers closed" switch, with 0=fingers-not-closed and 1=fingers-closed. Bit 1 is the "fingers open" switch, with 0=fingers-open and 1=fingers-not-open. This translates to the 4 states in the valid values list.

ASCII_Short_String_Collapsed

geom:device_name

GRAPPLE_ARTICULATION_STATE.ARTICULATION_DEVICE_NAME

The device_name attribute specifies the common name of an articulation device.

ASCII_Short_String_Collapsed

geom:device_phase

GRAPPLE_ARTICULATION_STATE.ARTICULATION_DEVICE_PHASE

The device_phase attribute specifies the current phase of the mission, from an articulation-device-centric point of view.
InSight Specific:
Current mission phase from a grapple-centric perspective. This affects whether the IDA_OPEN_GRAPPLE command is accepted (only in OK_TO_OPEN phase), and the assumed force on the end of the arm (based on which instrument the phase says is grappled) during arm deflection computation. Only human operators (via spacecraft command) can change this value.

ASCII_Short_String_Collapsed

img:sample_fov

INSTRUMENT_STATE_PARMS.AZIMUTH_FOV
INSTRUMENT_STATE_PARMS.AZIMUTH_FOV__UNIT

The sample_fov attribute specifies the angular measure of the field of view of an imaged scene, as measured in the image sample direction (generally horizontal).
InSight Specific:
Computed by projecting rays from the left and right edges of the image at the center through the camera model, and computing the angle subtended by those rays.

ASCII_Real

Units_of_Angle

img:bayer_algorithm

INSTRUMENT_STATE_PARMS.BAYER_METHOD

The bayer_algorithm specifies the algorithm used to remove the Bayer pattern in order to create color.

  1) None

  2) Raw Bayer

  3) Malvar

  4) Zhang-Wu

  5) Red Averaged

  6) Green Averaged

  7) Blue Averaged

  8) Red Bilinear

  9) Green Bilinear

  10) Blue Bilinear

  11) Averaged

  12) Bilinear

  13) Panchromatic

  14) Identity

ASCII_Short_String_Collapsed

img:color_filter_array_type

INSTRUMENT_STATE_PARMS.CFA_TYPE

Defines the type of Color Filter Array (CFA) used to encode multiple colors in a single exposure. The most common example of this is the Bayer pattern. This is optional if there is no CFA. Additional attributes, specific to each CFA type, define whether or not the CFA pattern has been removed, and if so, how (e.g. bayer_algorithm).

  1) Bayer RGGB

ASCII_Short_String_Collapsed

img:color_filter_array_venue

INSTRUMENT_STATE_PARMS.CFA_VENUE

For instruments using a Color Filter Array (CFA) (such as the Bayer pattern), this attribute defines where the CFA pattern was removed from the data. It is optional if there is no CFA. Valid values: 'Onboard', 'Ground', 'None'. In the case of instruments using the Bayer pattern, use the bayer_algorithm to specify the algorithm used to remove the pattern.

  1) Onboard

  2) Ground

  3) None

ASCII_Short_String_Collapsed

img:color_space

DERIVED_IMAGE_PARMS.COLOR_SPACE

Defines the color space in which this product is expressed. Some color spaces (e.g. XYZ or xyY) are independent of illuminant, while for others (e.g. sRGB or pRGB) the illuminant matters. It is expected that the defined color spaces will increase over time.

  1) iRGB

  2) sRGB

  3) pRGB

  4) wRGB

  5) CIE_XYZ

  6) CIE_xyY

  7) HSI

ASCII_Short_String_Collapsed

geom:coordinate_space_frame_type

ARM_COORDINATE_SYSTEM.COORDINATE_SYSTEM_NAME

The coordinate_space_frame_type attribute identifies the type of frame being described, such as SITE, LOCAL_LEVEL, LANDER, ROVER, ARM, etc. When combined with Coordinate_Space_Index and the optional solution_id in the Coordinate_Space_Indexed class, this serves to fully name an instance of a coordinate space.

ASCII_Short_String_Collapsed

img_surface:derived_image_type_name

DERIVED_IMAGE_PARMS.DERIVED_IMAGE_TYPE

The derived_image_type_name attribute specifies how to interpret the pixel values in a derived image (or colloquially, the type of the derived image itself). Valid values vary per mission depending on the products produced.
InSight Specific:
Additional types may be added throughout the mission. See the SIS for a table of current valid values.

ASCII_Short_String_Collapsed

img:detector_erase_count

OBSERVATION_REQUEST_PARMS.DETECTOR_ERASE_COUNT

The detector_erase_count specifies the number of times a detector has been or will be flushed of data in raw counts, dependent on the parent class for the attribute.
InSight Specific:
Number of fast flushes

ASCII_NonNegative_Integer

img:detector_to_image_rotation

INSTRUMENT_STATE_PARMS.DETECTOR_TO_IMAGE_ROTATION

The detector_to_image_rotation attribute specifies the clockwise rotation, in degrees, that was applied to an image along its optical path through an instrument, from detector to final image orientation.
InSight Specific:
The IDC EDR is rotated 270 degrees, so the arm/grapple is at the top of the image. The ICC requires no rotation.

ASCII_Real

Units_of_Angle

msn_surface:download_priority

TELEMETRY.DOWNLOAD_PRIORITY

The download_priority attribute specifies which data to downlink/transmit, based on order of importance. The lower numerical priority (higher-ranked number) data products are transmitted before higher numerical priority (lower-ranked number) data products. For example, an image with a downlink priority of 1 will be transmitted before an image with a downlink priority of 6. Value of 0 specifies use of on-board default.
InSight Specific:
Values are 1-6 for InSight.

ASCII_NonNegative_Integer

msn_surface:earth_received_start_date_time

TELEMETRY.EARTH_RECEIVED_START_TIME

The earth_received_start_date_time attribute provides the earliest time at which any component telemetry data for a particular product was received.

ASCII_Date_Time_YMD_UTC

msn_surface:earth_received_stop_date_time

TELEMETRY.EARTH_RECEIVED_STOP_TIME

The earth_received_stop_date_time attribute provides the latest time at which any component telemetry data for a particular product was received.

ASCII_Date_Time_YMD_UTC

img:line_fov

INSTRUMENT_STATE_PARMS.ELEVATION_FOV
INSTRUMENT_STATE_PARMS.ELEVATION_FOV__UNIT

The line_fov attribute specifies the angular measure of the field of view of an imaged scene, as measured in the image line direction (generally vertical).
InSight Specific:
Computed by projecting rays from the top and bottom edges of the image at the center through the camera model, and computing the angle subtended by those rays.

ASCII_Real

Units_of_Angle

img:encoded_display_gamma

DERIVED_IMAGE_PARMS.ENCODED_DISPLAY_GAMMA

Defines the gamma value encoded in this image. Gamma correction is used to nonlinearly compress the intensities in an image, and most display systems assume that images are encoded with an sRGB gamma. Note that this is a string value because the most common gamma correction ("sRGB") is not precisely expressible as a gamma exponent. A numeric value indicates a gamma exponent.

ASCII_Short_String_Collapsed

img_surface:error_model_name

DERIVED_IMAGE_PARMS.ERROR_MODEL_NAME

The error_model_name attribute specifies the method or algorithm used to create the error estimate. Each mission will define their own set of possible values. Algorithms will be added over time. The initial value is MIPL_CONST_DISPARITY_PROJECTED_V1, which means an arbitrary constant disparity error is assumed (in ERROR_MODEL_PARMS), which is projected through the camera models to approximate an error ellipse, which is then projected to the XYZ or range/crossrange axes depending on the file type.

ASCII_Short_String_Collapsed

msn_surface:expected_packets

TELEMETRY.EXPECTED_PACKETS

The expected_packets attribute provides the total number of telemetry packets which constitute a complete data product, i.e., a data product without missing data.

ASCII_NonNegative_Integer

img:exposure_count

INSTRUMENT_STATE_PARMS.EXPOSURE_COUNT

The exposure count attribute provides the number of exposures taken during a certain interval, such as the duration of one command. For example, this may include the number of exposures needed by an autoexpose algorithm.
InSight Specific:
Actual number of auto exposure iterations

ASCII_NonNegative_Integer

img:exposure_duration

INSTRUMENT_STATE_PARMS.EXPOSURE_DURATION
INSTRUMENT_STATE_PARMS.EXPOSURE_DURATION__UNIT

The exposure_duration attribute provides the amount of time the instrument sensor was gathering light from the scene, such as between opening and closing of a shutter, or between flushing and readout of a CCD.

ASCII_Real

Units_of_Time

img:exposure_duration_count

OBSERVATION_REQUEST_PARMS.EXPOSURE_DURATION_COUNT

The exposure_duration_count attribute specifies the value, in raw counts, for the amount of time the instrument sensor was gathering light from the scene, such as between opening and closing of a shutter, or between flushing and readout of a CCD. This is the raw count either commanded or taken directly from telemetry as reported by the spacecraft. This attribute is the same as the exposure_duration but in DN counts versus time, and the translation of exposure_duration_count to exposure_duration will differ by mission. The attribute can be specified in the context of both Imaging_Instrument_State_Parameters (actual value) and Command_Parameters (commanded value). Both commanded and actual because it's possible for the actual to not match the commanded. For example the exposure might fault out early, or there might be a deadband (for example, pointing backlash) where changes in the input do not actually affect the output.

ASCII_NonNegative_Integer

img:exposure_type

OBSERVATION_REQUEST_PARMS.EXPOSURE_TYPE

The exposure_type attribute indicates the exposure setting on a camera. Valid values: 'Manual' - manual exposure setting, 'Auto' - autoexposure is applied by the camera, 'Test' - test exposure setting telling the camera to return a fixed-pattern test image.

  1) Manual

  2) Auto

  3) Test

ASCII_Short_String_Collapsed

img:first_line

IMAGE_DATA.FIRST_LINE

The first_line attribute indicates the line within a source image that corresponds to the first line in a sub-image.
InSight Specific:
InSight does not support subframing, so this value is always 1.

ASCII_NonNegative_Integer

img:first_sample

IMAGE_DATA.FIRST_LINE_SAMPLE

The first_sample attribute indicates the sample within a source image that corresponds to the first sample in a sub-image.
InSight Specific:
InSight does not support subframing, so this value is always 1.

ASCII_NonNegative_Integer

msn_surface:flight_software_version_id

TELEMETRY.FLIGHT_SOFTWARE_VERSION_ID

The flight_software_version_id attribute identifies the version of the instrument flight software used to acquire the image.

ASCII_Short_String_Collapsed

img:frame_id

IDENTIFICATION.FRAME_ID

The frame_id attribute specifies an identification for a particular instrument measurement frame. A frame consists of a sequence of measurements made over a specified time interval, and may include measurements from different instrument modes. These sequences repeat from cycle to cycle and sometimes within a cycle.
InSight Specific:
Used to denote the commanded camera eye for stereo. InSight has no stereo camera but the IDC is commanded with some images marked "left" and "right" for ease of stereo processing. Note that any given image can be used either as a left or right eye image in special processing; this value reflects only the commanded intent (via IMAGE_ID).

ASCII_Short_String_Collapsed

img:frame_type_name

IDENTIFICATION.FRAME_TYPE

The frame_type_name attribute specifies whether the image was commanded as part of a stereo pair or as a single left or right monoscopic image. If frame_type = 'Stereo', a left and a right image should be present.

ASCII_Short_String_Collapsed

img_surface:geometry_projection_type

IDENTIFICATION.GEOMETRY_PROJECTION_TYPE

The geometry_projection_type attribute specifies how pixels in a file have been reprojected to correct for camera distortion, linearization, or rubber-sheeting (it is not the intent of this field to capture map projections). "Raw" indicates no projection has been done.
InSight Specific:
RAW means the image uses a CAHVOR or one of the CAHVORE camera models. LINEARIZED means that reprojection has been performed to linearize the camera model (thus removing things like lens distortion). This means the image uses a CAHV camera model.

  1) Raw

  2) Linearized

ASCII_Short_String_Collapsed

msn_surface:surface_gravity

ARM_ARTICULATION_STATE.GRAVITY_ACCELERATION

The surface_gravity attribute specifies the acceleration of gravity (magnitude, not direction).

ASCII_Real

Units_of_Acceleration

img:illuminant

DERIVED_IMAGE_PARMS.ILLUMINANT

Defines the illuminant that was used in order to process this image. The valid values are open-ended but currently used values include: None, 5000K.

  1) NONE

  2) 5000K

  3) null

ASCII_Short_String_Collapsed

msn_surface:data_size

TELEMETRY.IMAGE_DATA_SIZE

The data_size specifies number of bytes in the compressed data stream, not including headers.

ASCII_NonNegative_Integer

img_surface:image_id

IDENTIFICATION.IMAGE_ID

The image_id is an arbitrary string identifier that is associated with this image. The specific interpretation of it is mission-dependent, and it need not be unique to this image. For example, missions may use it as an image counter, a round-trip token indicating how to process the image, or a FSW-assigned value identifying the image.
InSight Specific:
The image_id is a 32-bit integer token set in the command sent from the ground, and returned in the image telemetry. It contains five subfields, each of which has its own label attributes: sequence_id, mesh_id, mosaic_id, stereo_id, and camera eye (frame_id). See each attribute for its usage. Note that image_id values are not unique (multiple images may share the same ID).

ASCII_Short_String_Collapsed

img_surface:image_type

IDENTIFICATION.IMAGE_TYPE

The image_type attribute specifies the type of image acquired. The intent is to distinguish between different kinds of image-related data that may differ in how they are interpreted. Some types are not standard images, but they are stored in an image structure. Examples include Regular, Thumbnail, Reference Pixels, Histogram, Row Sum, and Column Sum.

  1) REGULAR

  2) THUMBNAIL

  3) REF_PIXELS

  4) HISTOGRAM

  5) ROW_SUM

  6) COL_SUM

  7) SPECTRA

  8) HEALTH

ASCII_Short_String_Collapsed

img:color_subsampling_mode

COMPRESSION.INST_CMPRS_COLOR_MODE

The color_subsampling_mode attribute specifies the JPEG color subsampling mode used during compression. Valid values: '4:2:2' - 4:2:2 chroma subsampling, which is the typical case, '4:4:4' - 4:4:4 chroma sampling, which indicates no subsampling, 'Grayscale' - indicates a grayscale image
InSight Specific:
Note that the VICAR valid values are different from PDS 4 but mean the same: COLOR_MODE_GRAY, COLOR_MODE_422, COLOR_MODE_444

  1) 4:4:4

  2) 4:2:2

  3) Grayscale

ASCII_Short_String_Collapsed

img:compression_type

COMPRESSION_PARMS.INST_CMPRS_NAME

The compression_type attribute identifies the type of on-board compression used for data storage and transmission. Valid Values: 'ICER', 'LOCO', 'JPEG', 'JPEG Progressive', 'MSSS Lossless', 'None'.

  1) ICER

  2) ICT

  3) LOCO

  4) JPEG

  5) JPEG Progressive

  6) MSSS Lossless

  7) None

ASCII_Short_String_Collapsed

img:jpeg_quality

COMPRESSION.INST_CMPRS_QUALITY

The jpeg_quality attribute is a JPEG specific variable which identifies the resultant or targeted image quality index for on-board data compression.

ASCII_NonNegative_Integer

img:compression_rate

COMPRESSION.INST_CMPRS_RATE

The compression_rate attribute provides the average number of bits needed to represent a pixel for an on-board compressed image.
InSight Specific:
Represents actual results (not commanded value)

ASCII_Real

img:compression_ratio

COMPRESSION.INST_CMPRS_RATIO

The compression_ratio attribute provides the ratio of the size, in bytes, of the original uncompressed data object to its compressed form (original size / compressed size).
InSight Specific:
Represents actual results (not commanded value)

ASCII_Real

geom:instrument_azimuth

SITE_DERIVED_GEOMETRY_PARMS.INSTRUMENT_AZIMUTH
SITE_DERIVED_GEOMETRY_PARMS.INSTRUMENT_AZIMUTH__UNIT

The instrument_azimuth attribute specifies the value for an instrument's rotation in the horizontal direction. It is usually measured from a low hard stop. Although it may be used for any instrument where it makes sense, it is primarily intended for use in surface-based instruments that measure pointing in terms of azimuth and elevation. When in a group, defines the azimuth (horizontal rotation) at which the instrument is pointed. This value is expressed using the coordinate system referred to by Coordinate_Space_Reference class. The interpretation of exactly what part of the instrument is being pointed is mission-specific. It could be the boresight, the camera head direction, the CAHV camera model A vector direction, or any of a number of other things. As such, for multimission use this value should be used mostly as an approximation, e.g. identifying scenes which might contain a given object.
InSight Specific:
The interpretation is the boresight of the camera, defined as projecting the center of the nominal image (before downsampling or subframing) through the camera model. Azimuth is measured in Site frame.

ASCII_Real

Units_of_Angle

geom:instrument_elevation

SITE_DERIVED_GEOMETRY_PARMS.INSTRUMENT_ELEVATION
SITE_DERIVED_GEOMETRY_PARMS.INSTRUMENT_ELEVATION__UNIT

The instrument_elevation attribute specifies the value for an instrument's rotation in the vertical direction. It is usually measured from a low hard stop. Although it may be used for any instrument where it makes sense, it is primarily intended for use in surface-based instruments that measure pointing in terms of azimuth and elevation. When in a group, defines the elevation (vertical rotation) at which the instrument is pointed. This value is expressed using the coordinate system referred to by Coordinate_Space_Reference class. The interpretation of exactly what part of the instrument is being pointed is mission-specific. It could be the boresight, the camera head direction, the CAHV camera model A vector direction, or any of a number of other things. As such, for multimission use this value should be used mostly as an approximation, e.g. identifying scenes that might contain a given object.
InSight Specific:
The interpretation is the boresight of the camera, defined as projecting the center of the nominal image (before downsampling or subframing) through the camera model. Elevation is measured in Site frame.

ASCII_Real

Units_of_Angle

lid_reference

IDENTIFICATION.INSTRUMENT_ID

The lid_reference attribute provides the logical_identifier for a product.

ASCII_LID

img_surface:instrument_mode_id

INSTRUMENT_STATE_PARMS.INSTRUMENT_MODE_ID

The instrument_mode_id attribute provides an instrument-dependent designation of operating mode. This may be simply a number, letter or code, or a word such as 'normal', 'full resolution', 'near encounter', or 'fixed grating'. These types may vary by mission so the permissible values should be set by the mission dictionaries.

ASCII_Short_String_Collapsed

img_surface:instrument_serial_number

IDENTIFICATION.INSTRUMENT_SERIAL_NUMBER

The instrument serial number element provides the manufacturer's serial number assigned to an instrument. This number may be used to uniquely identify a particular instrument for tracing its components or determining its calibration history, for example.

ASCII_Short_String_Collapsed

img:temperature_value

INSTRUMENT_STATE_PARMS.INSTRUMENT_TEMPERATURE
INSTRUMENT_STATE_PARMS.INSTRUMENT_TEMPERATURE__UNIT

The temperature_value attribute provides the temperature, in the specified units, of some point on an imaging instrument or other imaging instrument device.

ASCII_Real

Units_of_Temperature

img:device_name

INSTRUMENT_STATE_PARMS.INSTRUMENT_TEMPERATURE_NAME

The device_name attribute supplies the formal name for an imaging instrument, an imaging instrument device, or some point on the instrument or device.

ASCII_Short_String_Collapsed

img_surface:instrument_version_number

IDENTIFICATION.INSTRUMENT_VERSION_ID

The instrument_version_number element identifies the specific model of an instrument used to obtain data. For example, this keyword could be used to distinguish between an engineering model of a camera used to acquire test data, and a flight model of a camera used to acquire science data during a mission.

ASCII_Short_String_Collapsed

invalid_constant

IMAGE_DATA.INVALID_CONSTANT

The invalid_constant attribute provides a value that indicates the original value was outside the valid range for the parameter.
InSight Specific:
The value should be 0.0 for most MIPL-generated products.

ASCII_Short_String_Collapsed

cart:line

SURFACE_PROJECTION_PARMS.LINE_PROJECTION_OFFSET

The line attribute specifies the line number in the image.

ASCII_Real

img:samples

IMAGE_DATA.LINE_SAMPLES

The samples attribute indicates the total number of data instances along the horizontal axis of an image or sub-image.

ASCII_NonNegative_Integer

img_surface:linearization_mode

DERIVED_IMAGE_PARMS.LINEARIZATION_MODE

The linearization_mode attribute specifies what kind of stereo partner was used to linearize the image (the process requires two camera models).

  1) Nominal

  2) Actual

  3) None

ASCII_Short_String_Collapsed

img_surface:linearization_mode_fov

DERIVED_IMAGE_PARMS.LINEARIZATION_MODE

The linearization_mode_fov attribute specifies how the linearized camera model's field of view (FOV) as constructed (corresponding to the "cahv_fov" parameter in MIPL software).

  1) Minimum

  2) Maximum

  3) Linear

  4) None

ASCII_Short_String_Collapsed

img:lines

IMAGE_DATA.LINES

The lines attribute indicates the total number of data instances along the vertical axis of an image or sub-image.

ASCII_NonNegative_Integer

local_mean_solar_time

IDENTIFICATION.LOCAL_MEAN_SOLAR_TIME

The local_mean_solar_time attribute provides the hour angle of the fictitious mean Sun at a fixed point on a rotating solar system body.
InSight Specific:
The valid value is embedded with a Sol value that can be different than the Sol (see PLANET_DAY_NUMBER) associated with LTST (see LOCAL_TRUE_SOLAR_TIME). The time portion of the valid value is expressed in terms of a 24-hour clock. So, in an example using Sol 27, the valid value range for the 24-hour clock would be represented as 00027M00:00:00.000 to 00027M23:59:59.999.

ASCII_Short_String_Collapsed

local_true_solar_time

IDENTIFICATION.LOCAL_TRUE_SOLAR_TIME

The local_true_solar_time (LTST) attribute provides the local time on a rotating solar system body where LTST is 12 h at the sub-solar point (SSP) and increases 1 h for each 15 degree increase in east longitude away from the SSP for prograde rotation.
InSight Specific:
The valid value is expressed in terms of a 24-hour clock, so the acceptable range is 00:00:00.000 to 23:59:59.999. See also LOCAL_TRUE_SOLAR_TIME_SOL for the sol number.

ASCII_Short_String_Collapsed

msn:start_local_true_solar_time_sol

IDENTIFICATION.LOCAL_TRUE_SOLAR_TIME_SOL

The start_local_true_solar_time_sol element specifies the number of solar days elapsed since a reference day (e.g. the day on which a landing vehicle set down) for local true solar time (LTST). Days are measured in rotations of the planet in question from midnight to midnight. The reference day is '0', as Landing day is Sol 0. If before Landing day, then value will be less than or equal to '0'and can be negative.
InSight Specific:
The reference day is 0, as Landing day is Sol 0. If before Landing day, then value will be less than or equal to 0 and can be negative.

ASCII_Integer

img_surface:mesh_id

IDENTIFICATION.MESH_ID

The mesh_id attribute specifies which terrain mesh this image should be automatically included in. This does not constrain which mesh(es) the image may be included in outside a pipeline environment.
InSight Specific:
Value is extracted from the image_id attributes value. Meshes combine images with matching mesh_id, sequence_id, and Epoch values. A mesh_id of 0 means do not include in a mesh. Values 1-9 mean to match within the same Sol only. Values 10-63 match globally across the entire mission. For non-raw products, any two characters, including non-numeric characters, may be used.

ASCII_Short_String_Collapsed

missing_constant

IMAGE_DATA.MISSING_CONSTANT

The missing_constant attribute provides a value that indicates the original value was missing, such as due to a gap in coverage.
InSight Specific:
The value should be 0.0 for most MIPL-generated products.

ASCII_Short_String_Collapsed

msn:mission_phase_name

IDENTIFICATION.MISSION_PHASE_NAME

The mission_phase_name attribute provides the commonly recognized name for a mission phase.

ASCII_Short_String_Collapsed

geom:model_type

GEOMETRIC_CAMERA_MODEL.MODEL_TYPE

The model_type attribute specifies an identifier for the type or kind of model. The value should be one of a well defined set, providing an application program with sufficient information to know how to handle the rest of the parameters within the model. This value will correlate directly with the specific camera model class that is a subclass of the Camera_Model_Parameters class.

ASCII_Short_String_Collapsed

img_surface:mosaic_id

IDENTIFICATION.MOSAIC_ID

The mosaic_id attribute specifies which mosaic this image should be automatically included in. This does not constrain which mosaic(s) the image may be included in outside a pipeline environment.
InSight Specific:
For InSight, value is extracted from the image_id value. Mosaics combine iages with matching mosaic_id, sequence_id, and Epoch values. A mosaic_id of0 means do not include in a mesh. Values 1-9 mean to match within the same Sol only. Values 10-63 match globally across the entire mission. For non-raw products, any two characters, including non-numeric characters, may be used.

ASCII_Short_String_Collapsed

img:analog_offset

INSTRUMENT_STATE_PARMS.OFFSET_MODE_ID

The analog_offset attribute identifies the analog value that is subtracted from the signal prior to the analog/digital conversion.
InSight Specific:
This value is the video offset, and has a range 0-4095.

ASCII_Integer

img:responsivity_r

INSTRUMENT_STATE_PARMS.ONBOARD_RESPONSIVITY

Specifies the factor that has been applied to the R cell of the Bayer pattern, before de-Bayering (demosaicking) takes place.

ASCII_Real

img:responsivity_g

INSTRUMENT_STATE_PARMS.ONBOARD_RESPONSIVITY

Specifies the factor that has been applied to the G cell of the Bayer pattern, before de-Bayering (demosaicking) takes place.

ASCII_Real

img:responsivity_b

INSTRUMENT_STATE_PARMS.ONBOARD_RESPONSIVITY

Specifies the factor that has been applied to the B cell of the Bayer pattern, before de-Bayering (demosaicking) takes place.

ASCII_Real

img:height_pixels

INSTRUMENT_STATE_PARMS.PIXEL_AVERAGING_HEIGHT

The height_pixels attribute provides the vertical dimension, in pixels.
InSight Specific:
InSight does not support downsampling, so this value is always 1.

ASCII_NonNegative_Integer

Units_of_Misc

img:width_pixels

INSTRUMENT_STATE_PARMS.PIXEL_AVERAGING_WIDTH

The width_pixels attribute provides the horizontal dimension, in pixels.
InSight Specific:
InSight does not support downsampling, so this value is always 1.

ASCII_NonNegative_Integer

Units_of_Misc

msn:start_sol_number

IDENTIFICATION.PLANET_DAY_NUMBER

The start_sol_number is the number of the Mars day on which an observation began. Landing day is Sol 0.

ASCII_Integer

geom:positive_azimuth_direction

LANDER_COORDINATE_SYSTEM.POSITIVE_AZIMUTH_DIRECTION

The positive_azimuth_direction attribute specifies the direction in which azimuth is measured in positive degrees for an observer on the surface of a body. The azimuth is measured with respect to the elevation reference plane. A value of 'clockwise' indicates that azimuth is measured positively clockwise, and 'counterclockwise' indicates that azimuth increases positively counter-clockwise.
InSight Specific:
For operational coordinate frames, which follow the Mars Pathfinder convention, increasing azimuth moves in a clockwise (CLOCKWISE) direction as viewed from above.

  1) Clockwise

  2) Counterclockwise

  3) CW

  4) CCW

ASCII_Short_String_Collapsed

geom:positive_elevation_direction

LANDER_COORDINATE_SYSTEM.POSITIVE_ELEVATION_DIRECTION

The positive_elevation_direction attribute provides the direction in which elevation is measured in positive degrees for an observer on the surface of a body. The elevation is measured with respect to the azimuthal reference plane. A value of UP or ZENITH indicates that elevation is measured positively upwards, i.e., the zenith point would be at +90 degrees and the nadir point at -90 degrees. DOWN or NADIR indicates that the elevation is measured positively downwards; the zenith point would be at -90 degrees and the nadir point at +90 degrees.
InSight Specific:
For operational coordinate frames, which follow the Mars Pathfinder convention, the positive elevation direction is UP.

  1) Up

  2) Zenith

  3) Down

  4) Nadir

ASCII_Short_String_Collapsed

msn_surface:product_completion_status

TELEMETRY.PRODUCT_COMPLETION_STATUS

The product_completion_status attribute indicates whether or not a product is complete or is in one of a number of incomplete states. Sample values might indicate that all portions of the product have been downlinked and received correctly, that all portions have not yet been received, or that the product contains transmission errors. The specific values are mission-dependent.

  1) PARTIAL

  2) COMPLETE

ASCII_Short_String_Collapsed

creation_date_time

IDENTIFICATION.PRODUCT_CREATION_TIME

The creation_date_time attribute provides a date and time when the object was created.
InSight Specific:
This represents the Earth time when the product was created, not the time the spacecraft acquired the data.

ASCII_Date_Time_YMD

alternate_id

IDENTIFICATION.PRODUCT_ID

The alternate_id attribute provides an additional identifier supplied by the data provider.
InSight Specific:
This is the filename minus the extension (including the version number).

ASCII_Short_String_Collapsed

file_name

IDENTIFICATION.PRODUCT_ID

The file_name attribute provides the name of a file.
InSight Specific:
This is the filename minus the extension (including the version number).

ASCII_Short_String_Collapsed

value_offset

DERIVED_IMAGE_PARMS.RADIANCE_OFFSET

The value_offset attribute is the offset to be applied to each stored value in order to recover an original value. The observed value (Ov) is calculated from the stored value (Sv) thus: Ov = (Sv * scaling_factor) + value_offset. The default value is 0.

ASCII_Real

unit

DERIVED_IMAGE_PARMS.RADIANCE_OFFSET__UNIT
DERIVED_IMAGE_PARMS.RADIANCE_SCALING_FACTOR__UNIT

The unit attribute provides the unit of measurement.

UTF8_Short_String_Collapsed

scaling_factor

DERIVED_IMAGE_PARMS.RADIANCE_SCALING_FACTOR

The scaling_factor attribute is the scaling factor to be applied to each stored value in order to recover an original value. The observed value (Ov) is calculated from the stored value (Sv) thus: Ov = (Sv * scaling_factor) + value_offset. The default value is 1.

ASCII_Real

img:radiometric_correction_type_name

DERIVED_IMAGE_PARMS.RADIOMETRIC_CORRECTION_TYPE

The radiometric_correction_type_name identifies the method used for radiometric correction.

ASCII_Short_String_Collapsed

img_surface:x_position

DERIVED_IMAGE_PARMS.RANGE_ORIGIN_VECTOR

The x component of a Cartesian position vector.

ASCII_Real

Units_of_Length

img_surface:y_position

DERIVED_IMAGE_PARMS.RANGE_ORIGIN_VECTOR

The y component of a Cartesian position vector.

ASCII_Real

Units_of_Length

img_surface:z_position

DERIVED_IMAGE_PARMS.RANGE_ORIGIN_VECTOR

The z component of a Cartesian position vector.

ASCII_Real

Units_of_Length

msn_surface:received_packets

TELEMETRY.RECEIVED_PACKETS

The received_packets attribute provides the total number of telemetry packets actually used to construct this data product. cf. expected_packets.

ASCII_NonNegative_Integer

local_identifier_reference

LANDER_DERIVED_GEOMETRY_PARMS.REFERENCE_COORD_SYSTEM_INDEX
LANDER_DERIVED_GEOMETRY_PARMS.REFERENCE_COORD_SYSTEM_NAME

The local_identifier_reference attribute provides the value of the local_identifier of the entity described by the referencing class. Note that a local_identifier attribute, with the same value as this local_identifier_reference, must be present within the label.

ASCII_Local_Identifier_Reference

img:sample_bit_mask

IMAGE_DATA.SAMPLE_BIT_MASK

The sample_bit_mask attribute Specifies the active bits in a sample. Any bit mask is valid in an non-raw product. Any 8-bit product, whether a scaled raw product or other, will have the value "2#11111111" and be stored in one byte. Any 12-bit product, whether an unscaled raw product, or an ILUT partially-processed product (see companding_method), will have the value "2#0000111111111111" and be stored in two bytes. A 15-bit product (e.g. Radiometrically-corrected Calibrated product type) will have the value "2#0111111111111111" and be stored in two bytes. Any 32-bit integer product (e.g. Histogram Raw product) will have the value "2#11111111111111111111111111111111" and be stored in four bytes. For floating-point data, sample_bit_mask is not valid and may be absent. If present, it should be ignored. NOTE: In the PDS, the domain of sample_bit_mask is dependent upon the currently-described value in the sample_bits attribute and only applies to integer values.

ASCII_Short_String_Collapsed

img:companding_venue

INSTRUMENT_STATE_PARMS.SAMPLE_BIT_METHOD

The companding_venue attribute specifies where companding or expanding of the data was completed either onboard or on the ground. Valid values: 'Hardware' - companding was done by hardware, for example inside the camera. 'Software' - companding was done by flight software. 'None' - data was not companded

  1) Hardware

  2) Software

  3) None

ASCII_Short_String_Collapsed

img:companding_method

INSTRUMENT_STATE_PARMS.SAMPLE_BIT_MODE_ID

The companding_method attribute specifies how data was companded. Generally this will either be via a lookup table (such as a square root encoding), or by shifting bits to preserve the high order bits and discard the low order bits. The value of this keyword is mission specific but there are recommended values that should apply across missions when possible: NONE - no scaling. LUTn - use the numbered lookup table. Lookup tables are defined in the mission SIS. It is preferred for "n" to be a number but it could be a name, for example LUT_MMM_3 to indicate LUT 3 for the MMM instruments (on MSL). MSB_BITn - Shift to make bit "n" the most significant. Bits start numbering at 0 so MSB_BIT7 means no shift for a 12->8 bit companding, while MSB_BIT11 means to shift right 4 bits for a 12->8 bit companding. AUTOSHIFT - Data should be shifted to preserve the highest value. This value should only appear in a command echo; one of the MSB_BITn values should be used in downlinked data to specify what the actual shift was.

ASCII_Short_String_Collapsed

cart:sample

SURFACE_PROJECTION_PARMS.SAMPLE_PROJECTION_OFFSET

The sample attribute specifies the sample number

ASCII_Real

msn_surface:sequence_id

IDENTIFICATION.SEQUENCE_ID

The sequence_id identifies the command sequence used to acquire this product.
InSight Specific:
Value is extracted from the IMAGE_ID field and indicates the purpose for which the image was acquired.

ASCII_Short_String_Collapsed

geom:solar_azimuth

SITE_DERIVED_GEOMETRY_PARMS.SOLAR_AZIMUTH
SITE_DERIVED_GEOMETRY_PARMS.SOLAR_AZIMUTH__UNIT

The solar_azimuth attribute specifies one of two angular measurements indicating the direction to the Sun as measured from a specific point on the surface of a planet (eg., from a lander or rover). The positive direction of the elevation is set by the positive_azimuth_direction attribute in the reference coordinate space. The azimuth is measured positively in the clockwise direction (as viewed from above) with the meridian passing through the positive spin axis of the planet (i.e., the north pole) defining the zero reference.
InSight Specific:
Computed using SPICE.

ASCII_Real

Units_of_Angle

geom:solar_elevation

SITE_DERIVED_GEOMETRY_PARMS.SOLAR_ELEVATION
SITE_DERIVED_GEOMETRY_PARMS.SOLAR_ELEVATION__UNIT

The solar_elevation attribute specifies one of two angular measurements indicating the direction to the Sun as measured from a specific point on the surface of a planet (eg., from a lander or rover). The positive direction of the elevation is set by the positive_elevation_direction attribute in the reference coordinate space. The elevation is measured from the plane which is normal to the line passing between the surface point and the planet's center of mass, and that intersects the surface point.
InSight Specific:
Computed using SPICE.

ASCII_Real

Units_of_Angle

solar_longitude

IDENTIFICATION.SOLAR_LONGITUDE

The solar_longitude attribute provides the angle between the body-Sun line at the time of interest and the body-Sun line at its vernal equinox.
InSight Specific:
This provides a measure of season on a target body, with values of 0 to 90 degrees representing northern spring, 90 to 180 degrees representing northern summer, 180 to 270 degrees representing northern autumn and 270 to 360 degrees representing northern winter.

ASCII_Real

Units_of_Angle

msn:solar_longitude

IDENTIFICATION.SOLAR_LONGITUDE

solar_longitude is the solar longitude, as defined in the main PDS4 data dictionary.
InSight Specific:
This provides a measure of season on a target body, with values of 0 to 90 degrees representing northern spring, 90 to 180 degrees representing northern summer, 180 to 270 degrees representing northern autumn and 270 to 360 degrees representing northern winter.

ASCII_Real

Units_of_Angle

geom:solution_id

LANDER_COORDINATE_SYSTEM.SOLUTION_ID

The solution_id attribute specifies the unique identifier for the solution set to which the values in the group belong. For certain kinds of information, such as pointing correction (pointing models) and rover localization (coordinate system definitions), the "true" value is unknown and only estimates of the true value exist. Thus, more than one set of estimates may exist simultaneously, each valid for its intended purpose. Each of these sets is called a "solution" to the unknown true value. The solution_id attribute is used to identify which solution is being expressed by the containing group. No specific naming convention is defined here, however it is recommended that projects adopt one. The intent is to be able to identify who created the solution, and why. Possible components of the naming convention include user, institution, purpose, request ID, version, program, date/time.
InSight Specific:
Must be globally unique across all coordinate system instances, i.e. it cannot be reused to define the same coordinate system instance differently. Different coordinate system instances (for example, different values of the RMC index) may share the same SOLUTION_ID. See also REFERENCE_COORD_SYSTEM_NAME and REFERENCE_COORD_SYSTEM_SOLN_ID. The SOLUTION_ID should be the same identifier used in the PLACES rover localization database. The special name "telemetry" is used for values telemetered from the rover. If SOLUTION_ID is absent, "telemetry" should be assumed.

ASCII_Short_String_Collapsed

msn:spacecraft_clock_partition

IDENTIFICATION.SPACECRAFT_CLOCK_CNT_PARTITION

The spacecraft_clock_partition provides the clock partition active for the spacecraft_clock attribute.
InSight Specific:
Always 1 for InSight.

ASCII_Integer

msn:spacecraft_clock_start

IDENTIFICATION.SPACECRAFT_CLOCK_START_COUNT

The spacecraft_clock_start is the value of the spacecraft clock at the beginning of the observation.

ASCII_Short_String_Collapsed

msn:spacecraft_clock_stop

IDENTIFICATION.SPACECRAFT_CLOCK_STOP_COUNT

The spacecraft_clock_stop is the value of the spacecraft clock at the end of the observation. spacecraft_clock_stop should only be used if there's also a spacecraft_clock_start value.

ASCII_Short_String_Collapsed

geom:spice_kernel_file_name

TELEMETRY.SPICE_FILE_NAME

The spice_kernel_file_name attribute provides the file name of a SPICE kernel file used to process the data or to produce geometric quantities given in the label.

ASCII_File_Name

start_date_time

IDENTIFICATION.START_TIME

The start_date_time attribute provides the date and time appropriate to the beginning of the product being labeled.
InSight Specific:
The time period of interest is returned from SPICE suburoutines and is based on the beginning of data acquisition.

ASCII_Date_Time_YMD_UTC

img_surface:stereo_baseline_length

DERIVED_IMAGE_PARMS.STEREO_BASELINE

The stereo_baseline_length attribute specifies the separation between the two cameras used for processing of the stereo image.

ASCII_Real

Units_of_Length

img_surface:stereo_match_id

IDENTIFICATION.STEREO_MATCH_ID

The stereo_match_id attribute specifies which other image this image matches with for stereo processing. If used for a mission, the two images making up a stereo pair should share the same stereo_match_id value.
InSight Specific:
The image_id is a 32-bit integer token set in the command sent from the ground, and returned in the image telemetry. It contains five subfields, each of which has its own label attributes: sequence_id, mesh_id, mosaic_id, stereo_id, and camera eye (frame_id). See each attribute for its usage. Note that image_id values are not unique (multiple images may share the same ID).

ASCII_Short_String_Collapsed

stop_date_time

IDENTIFICATION.STOP_TIME

The stop_date_time attribute provides the date and time appropriate to the end of the product being labeled.
InSight Specific:
The time period of interest is returned from SPICE suburoutines and is based on the end of data acquisition.

ASCII_Date_Time_YMD_UTC

msn_surface:provider_id

TELEMETRY.TELEMETRY_PROVIDER_ID

The provider_id attribute identifies the organization or subsystem that supplied the telemetry data product to the producer of the raw (EDR) PDS data product. This is typically (but not always) the organization responsible for reassembling packetized data into a single product. These may vary by mission so the permissible values should be set by the mission dictionaries.

ASCII_Short_String_Collapsed

msn_surface:telemetry_source_name

TELEMETRY.TELEMETRY_SOURCE_NAME

The telemetry_source_name specifies the name source of the telemetry data described in the parent class.

ASCII_Short_String_Collapsed

msn_surface:telemetry_source_sclk_start

TELEMETRY.TELEMETRY_SOURCE_SCLK_START

The telemetry_source_sclk_start attribute specifies the value of the spacecraft clock (in seconds) at the creation time of the source product from which this product was derived.
InSight Specific:
This is the time in the CCSDS header. Used to find all the matching packets for one product.

ASCII_Short_String_Collapsed

msn_surface:telemetry_source_start_time

TELEMETRY.TELEMETRY_SOURCE_START_TIME

The telemetry_source_start_time specifies the creation time of the source product from which this product was derived. It is the same as the telemetry_source_sclk_start converted to Spacecraft Event Time (SCET).

ASCII_Date_Time_YMD_UTC

msn_surface:transport_protocol

TELEMETRY.TELEMETRY_SOURCE_TYPE

The transport_protocol attribute specifies the protocol used in the creation of the telemetry data products by the subsystem which generates the telemetry stream.

  1) SFDU

  2) Data Product

ASCII_Short_String_Collapsed

img:active_flag

The active_flag attribute indicates whether or not the data correction described by the parent class is active.

ASCII_Boolean

img:Algorithm_Parameter

The Algorithm_Parameter class provides a name and value(s) use for input into the autoexposure algorithm.

  1) name

  2) value

Alias

The Alias class provides a single alternate name and identification for this product in this or some other archive or data system.

  1) alternate_id

  2) alternate_title

  3) comment

Alias_List

The Alias_List class provides a list of paired alternate names and identifications for this product in this or some other archive or data system.

  1) alias

Array_2D_Image

The Array 2D Image class is an extension of the Array 2D class and defines a two dimensional image.

  1) offset

  2) axes

  3) name

  4) local_identifier

  5) axis_index_order

  6) md5_checksum

  7) description

  8) has_Display_2d_Image

  9) has_Axis_Array

  10) has_Element_Array

  11) associated_Special_Constants

  12) associated_Statistics

  13) data_object

  14) local_internal_reference

Array_3D_Image

The Array 3D Image class is an extension of the Array 3D class and defines a three dimensional image.

  1) offset

  2) axes

  3) name

  4) local_identifier

  5) axis_index_order

  6) md5_checksum

  7) description

  8) has_Axis_Array

  9) has_Element_Array

  10) associated_Special_Constants

  11) associated_Statistics

  12) data_object

  13) local_internal_reference

geom:Articulation_Device_Parameters

The Articulation_Device_Parameters class contains those attributes and sub-classes that describe an articulation device. An articulation device is anything that can move independently of the spacecraft to which it is attached. Examples include mast heads, wheel bogies, arms, filter wheel, scan platforms.

  1) device_id

  2) device_name

  3) device_mode

  4) device_phase

  5) selected_instrument_id

  6) Coordinate_Space_Present

img:autoexposure_algorithm_name

The autoexposure_algorithm_name attribute provides the algorithm used for histograwm thresholding or autoexposure of the image. Some example algorithms from past missions are, 'Maki 2003' used on MER cameras, MSL ECAMs, M2020 EECAMs; 'Maurice 2012' used on MSL ChemCam; 'Smith 1997' used on Mars Pathfinder Imager.

ASCII_Short_String_Collapsed

img:Autoexposure_Parameters

The Autoexposure_Parameters class contains attributes used to identify or describe the histogram thresholding algorithm and applicable attributes required for those algorithms. The input parameters for the algorithm can be specified using the Algorithm_Parameter class or via a Local_Internal_Reference to a mission-specific parameter definition.

  1) autoexposure_algorithm_name

  2) Algorithm_Parameter

Axis_Array

The Axis Array class is used as a component of the array class and defines an axis of the array.

  1) axis_name

  2) local_identifier

  3) elements

  4) unit

  5) sequence_number

  6) has_Band_Bin_Set

axis_name

The axis_name attribute provides a word or combination of words by which the axis is known.

ASCII_Short_String_Collapsed

disp:blue_channel_band

The blue_channel_band attribute identifies the number of the band, along the band axis, that should be loaded, by default, into the blue channel of a display device. The first band along the band axis has band number 1.

ASCII_Integer

geom:CAHV_Model

The CAHV camera model is equivalent to the standard linear photogrammetric model for a pinhole camera, It is useful for very small field of view cameras and as a building block for more complex camera models. The CAHV model consists of four 3-vectors: C, A, H, and V. Vector C gives the location of the pinhole. Vector A gives the camera axis, defined as the normal to the image plane. Vector H encodes the horizontal axis of the image plane (H'), the coor- dinate (Hc) of the image column at the optical center of the image plane, and the horizontal focal length (Hs) of the camera, in pixels. Vector V encodes corresponding information (V', Vc, Vs) in the vertical direction. The angle (theta) between horizontal and vertical vectors H' and V' is about 90 degrees. (Taken from Camera Response Simulation for Planetary Exploration, by Dr. Richard Madison, Marc Pomerantz, and Dr. Abhinandan Jain, http://trs-new.jpl.nasa.gov/dspace/bitstream/2014/37771/1/05-1692.pdf)

  1) Vector_Center

  2) Vector_Axis

  3) Vector_Horizontal

  4) Vector_Vertical

geom:CAHVOR_Model

The CAHVOR model describes a camera with radial lens distortion about the lens axis. In addition to the CAHV parameters, it includes 3-vectors O and R. Vector O is the optical axis of the lens, slightly different from vector A due to imperfect lens mounting. A ray from a point in space, passing through the pinhole, bends at the pinhole according to a function of the angle between the ray and optical axis O. The function is a polynomial whose coefficients are stored in vector R. (Taken from Camera Response Simulation for Planetary Exploration, by Dr. Richard Madison, Marc Pomerantz, and Dr. Abhinandan Jain, http://trs-new.jpl.nasa.gov/dspace/bitstream/2014/37771/1/05-1692.pdf)

  1) Optical_Terms

  2) Vector_Center

  3) Radial_Terms

  4) Vector_Axis

  5) Vector_Horizontal

  6) Vector_Vertical

geom:CAHVORE_Model

A third model, CAHVORE, describes more general cameras including those with fisheye or otherwise wide field of view lenses. An additional vector, E, describes the apparent motion of the camera entrance pupil. (Taken from Camera Response Simulation for Planetary Exploration, by Dr. Richard Madison, Marc Pomerantz, and Dr. Abhinandan Jain, http://trs-new.jpl.nasa.gov/dspace/bitstream/2014/37771/1/05-1692.pdf)

  1) cahvore_model_type

  2) cahvore_model_parameter

  3) Vector_Entrance

  4) Optical_Terms

  5) Vector_Center

  6) Radial_Terms

  7) Vector_Axis

  8) Vector_Horizontal

  9) Vector_Vertical

geom:cahvore_model_parameter

The cahvore_parameter_type attribute is a scalar floating-point number used for CAHVORE Type 3 models (see cahvore_model_type). If the parameter is 1.0, the model is identical to type 1; if 0.0, it is identical to type 2. Most fish-eye lenses use a value in between.

ASCII_Real

geom:cahvore_model_type

The cahvore_model_type attribute indicates which variant of the CAHVORE model to use. Type 1 is a perspective-projection model, similar to CAHV and CAHVOR except for the moving entrance pupil. Type 2 is a fish-eye lens model reflecting fundamentally different geometry. Type 3 is a generalization that includes the first two, and is used for most fisheye-type lenses (see cahvore_model_parameter).

  1) 1

  2) 2

  3) 3

ASCII_Integer

geom:Camera_Model_Parameters

A camera model describes the mathematical relationship between the coordinates of a point in 3-dimensional space and its projection onto a 2-dimensional image plane. There are numerous types of camera models, only two of which are currently implemented.

  1) model_type

  2) calibration_source_id

  3) solution_id

  4) Internal_Reference

  5) CAHVORE_Model

  6) Coordinate_Space_Reference

  7) Quaternion_Model_Transform

  8) Vector_Model_Transform

cart:Cartography

The Cartography class provides a description of how a 3D sphere, spheroid, or elliptical spheroid or the celestial sphere is mapped onto a plane.

  1) has_Spatial_Domain

  2) has_Spatial_Reference_Information

Citation_Information

The Citation_Information class provides specific fields often used in citing the product in journal articles, abstract services, and other reference contexts.

  1) author_list

  2) editor_list

  3) publication_year

  4) keyword

  5) description

disp:color_display_axis

The color_display_axis attribute identifies, by name, the axis of an Array (or Array subclass) that is intended to be displayed in the color dimension of a display device. I.e., bands from this dimension will be loaded into the red, green, and blue bands of the display device. The value of this attribute must match the value of one, and only one, axis_name attribute in an Axis_Array class of the associated Array.

ASCII_Short_String_Collapsed

disp:Color_Display_Settings

The Color_Display_Settings class provides guidance to data users on how to display a multi-banded Array object on a color-capable display device.

  1) color_display_axis

  2) comment

  3) red_channel_band

  4) green_channel_band

  5) blue_channel_band

img:Color_Filter_Array_Parameters

The Color_Filter_Array_Parameters class describes whether or not an image was acquired using a Color Filter Array (CFA) and if so, whether and how the CFA pattern was removed. A CFA is a method for making color images using one exposure on a single sensor plane, where microfilters of different wavelengths are put in front of pixels in a specific pattern. The most common pattern is the Bayer pattern, which has a red, blue, and two green pixels in every 2x2 pixel square. Although generally used for RGB color, CFA filters can be of any number and wavelength (see color_filter_array_type).

  1) color_filter_array_type

  2) color_filter_array_state

  3) color_filter_array_venue

  4) bayer_algorithm

img:color_filter_array_state

Specifies whether the image still has a CFA pattern ("Encoded"), the CFA pattern has been removed ("Decoded") or it never had a pattern ("No CFA").

  1) Encoded

  2) Decoded

  3) No CFA

ASCII_Short_String_Collapsed

img:Color_Parameters

The Color_Parameters class contains parameters describing color correction or processing and how the image is represented in color.

  1) color_space

  2) color_component

  3) illuminant

  4) encoded_display_gamma

  5) Onboard_Responsivity

  6) Onboard_Color_Matrix

msn_surface:Command_Execution_Information

The Command_Execution_Information class contains information about how the command that acquired this data was executed, such as sequence or activity.

  1) sequence_id

  2) sequence_version_id

  3) sequence_execution_count

  4) command_sequence_number

  5) command_source_id

  6) observation_id

  7) request_id

img:Command_Parameters

The Command_Parameters class contains attributes used to identify or describe the commands sent to a spacecraft to perform one or more actions resulting in the acquisition of the current data product.

  1) description

  2) detector_erase_count

  3) Autoexposure_Parameters

  4) Exposure_Parameters

  5) Data_Correction_Parameters

comment

The comment attribute is a character string expressing one or more remarks or thoughts relevant to the object.

ASCII_Text_Preserved

img:Companding_Parameters

The Companding_Parameters class describes whether or not data is or has had its bit depth reduced (for example conversion from 12 to 8 bits via a lookup table or bit scaling), the venue where it occurred (Software or Hardware), and the method used to complete the companding.

  1) companding_state

  2) companding_venue

  3) companding_method

img:companding_state

The companding_state attribute specifies whether the data is or has had its bit depth reduced, for example conversion from 12 to 8 bits via a lookup table or bit scaling. Valid values: None - values have not been companded. Companded - values are currently companded. Expanded - values have been companded but are now expanded back to original size.

  1) None

  2) Companded

  3) Expanded

ASCII_Short_String_Collapsed

img:compression_class

The compression_class attribute identifies the type of on-board compression used for data storage and transmission. Note that the compression_type identifies the specific compression algorithm used (for example, ICER), whereas the compression_class gives a simple indicator of the type of compression mode. Valid values: 'Lossless', 'Lossy', 'Uncompressed'

  1) Lossless

  2) Lossy

  3) Uncompressed

ASCII_Short_String_Collapsed

geom:Coordinate_Space_Definition

The Coordinate_Space classes are typically used for lander/rover geometry while the Coordinate_System construction is used for orbiter/flyby geometry.

  1) local_identifier

  2) positive_azimuth_direction

  3) positive_elevation_direction

  4) Coordinate_Space_Present

  5) Vector_Origin_Offset

  6) Quaternion_Plus_Direction

  7) Coordinate_Space_Reference

geom:Coordinate_Space_Index

Identifies a coordinate space using an index value given in an identified list.

  1) index_value_number

  2) index_id

geom:Coordinate_Space_Indexed

The Coordinate_Space_Indexed class contains the attributes and classes identifying the indexed coordinate space.

  1) coordinate_space_frame_type

  2) solution_id

  3) Coordinate_Space_Index

geom:Coordinate_Space_Present

The Coordinate_Space_Present class includes the attributes that identifies the spacecraft's present coordinate space.

  1) Coordinate_Space_Indexed

geom:Coordinate_Space_Reference

The Coordinate_Space_Reference class includes the attributes that identify the reference coordinate space to be used in relation to the spacecraft's present coordinate space. The reference coordinate space is the space in which the present coordinate space is defined.

  1) Coordinate_Space_Indexed

cart:Cylindrical

null

  1) pixel_scale_x

  2) pixel_scale_y

  3) maximum_elevation

  4) minimum_elevation

  5) start_azimuth

  6) stop_azimuth

  7) zero_elevation_line

  8) Vector_Projection_Origin

img:Data_Correction

The Data_Correction class specifies describes details regarding the calibration and/or processing performed on the data product. This class can be used to describe various data corrections, such as antiblooming, bad pixel replacement, blemish protection, dark current correction, or shutter correction. This can be specified multiple times in order to detail numerous corrections, and should be used to designate PDS3-like flag attributes, such as dark_current_correction_flag and flat_field_correction_flag.

  1) active_flag

  2) data_correction_type

  3) data_correction_venue

  4) Data_Correction_File

  5) Flat_Field_Correction_Parameters

  6) Radiometric_Correction_Parameters

  7) Shutter_Subtraction_Parameters

img:Data_Correction_File

The Data_Correction_File class specifies a file containing explicit details regarding the calibration and/or processing performed on the data product. The enclosing class and surrounding attribute provide the necessary context to interpret this file. As a subclass of the Data_Correction_Parameters class, this specifies calibration applied to the science data as opposed to calibration the instrument before launch. As a subclass of the Derived_Product_Parameters class, this specifies a file describing the post processing of the product after radiometric and photometric calibrations.

  1) description

  2) External_Reference

img:Data_Correction_Parameters

The Data_Correction_Parameters class describes data processing steps applied to data, either on-board a spacecraft or after receipt of the data on the ground, to remove artifacts introduced into the data by the instrument. As a child of the Command_Parameters class, these attribute values are those that were commanded to the spacecraft.

  1) Data_Correction

img:data_correction_type

The data_correction_type attribute specifies the type of data correction to be applied using the accompanying file or constants. Valid values: 'Antiblooming', 'Bad Pixel', 'Blemish Protection', 'Brightness', 'Dark Current', 'Flat Field', 'Inverse LUT', 'Light Flood', 'Responsivity', 'Shutter'

  1) Antiblooming

  2) Bad Pixel

  3) Blemish Protection

  4) Brightness

  5) Dark Current

  6) Flat Field

  7) Inverse LUT

  8) Light Flood

  9) Radiometric

  10) Responsivity

  11) Shutter Subtraction

ASCII_Short_String_Collapsed

img:data_correction_venue

The data_correction_venue attribute specifies where data correction was performed. Valid values: 'Onboard' - data correction was performed onboard the spacecraft. 'Ground' - data correction was performed by software on the ground.

  1) Onboard

  2) Ground

ASCII_Short_String_Collapsed

data_type

The data_type attribute provides the hardware representation used to store a value in Element_Array.

  1) ComplexLSB16

  2) ComplexLSB8

  3) ComplexMSB16

  4) ComplexMSB8

  5) IEEE754LSBDouble

  6) IEEE754LSBSingle

  7) IEEE754MSBDouble

  8) IEEE754MSBSingle

  9) SignedBitString

  10) SignedByte

  11) SignedLSB2

  12) SignedLSB4

  13) SignedLSB8

  14) SignedMSB2

  15) SignedMSB4

  16) SignedMSB8

  17) UnsignedBitString

  18) UnsignedByte

  19) UnsignedLSB2

  20) UnsignedLSB4

  21) UnsignedLSB8

  22) UnsignedMSB2

  23) UnsignedMSB4

  24) UnsignedMSB8

ASCII_Short_String_Collapsed

geom:Derived_Geometry

The Derived_Geometry class is a container for surface based observations (lander or rover). It is used to provide some geometric quantities relative to a specific Reference Coordinate Space.

  1) emission_angle

  2) Coordinate_Space_Reference

img_surface:Derived_Product_Parameters

The Derived_Product_Parameters class contains attributes used to identify and describe processing performed on products in order to produce a higher level product.

  1) derived_image_type_name

  2) horizon_mask_elevation

  3) Placement_Target_Instrument

  4) Vector_Range_Origin

  5) Pointing_Correction_Parameters

description

The description attribute provides a statement, picture in words, or account that describes or is otherwise relevant to the object.

UTF8_Text_Preserved

geom:Device_Angle

The Device_Angle class is a container for the set of angles between the various components or devices of the spacecraft.

  1) local_identifier

  2) Device_Angle_Index

geom:Device_Angle_Index

The Device_Angle class is a container for the set of angles the spacecraft device specified in the parent Articulation_Device_Parameters class.

  1) index_value_angle

  2) index_id

geom:Device_Temperature

The Device_Temperature class is a container for all available device temperatures of an articulated device and/or part(s) of a device.

  1) local_identifier

  2) Device_Temperature_Index

geom:Device_Temperature_Index

The Device_Temperature_Index class specifies the attributes describing the temperature of one device or some part of a device.

  1) index_value_temperature

  2) index_value_number

  3) index_id

Discipline_Area

The Discipline area allows the insertion of discipline specific metadata.

disp:Display_Direction

The Display_Direction class specifies how two of the dimensions of an Array object should be displayed in the vertical (line) and horizontal (sample) dimensions of a display device.

  1) comment

  2) horizontal_display_axis

  3) horizontal_display_direction

  4) vertical_display_axis

  5) vertical_display_direction

disp:Display_Settings

The Display_Settings class contains one or more classes describing how data should be displayed on a display device.

  1) local_internal_reference

  2) has_display_direction

  3) has_color_display_settings

  4) has_movie_display_settings

domain

The radial "zone" or "shell" of the target for which the observations were collected or which are represented in the product(s). The value may depend on wavelength_range and size of the target.

  1) Atmosphere

  2) Dynamics

  3) Heliosphere

  4) Interior

  5) Interstellar

  6) Ionosphere

  7) Magnetosphere

  8) Rings

  9) Surface

ASCII_Short_String_Collapsed

img:Downsampling_Parameters

The Downsampling_Parameters class describes whether or not downsampling occurred, the venue where it occurrected (Software or Hardware), the method used to downsample, and the pixel averaging dimensions. A downsampled image is a smaller version of the image, resulting in reduced resolution of the same coverage area

  1) downsampling_flag

  2) downsampling_venue

  3) downsampling_method

  4) Pixel_Averaging_Dimensions

Element_Array

The Element Array class is used as a component of the array class and defines an element of the array.

  1) data_type

  2) unit

  3) scaling_factor

  4) value_offset

elements

The elements attribute provides the count of the number of elements along an array axis.

ASCII_NonNegative_Integer

Encoded_Image

The Encoded Image class is used for ancillary images in standard formats, such as JPEG.

  1) name

  2) offset

  3) encoding_standard_id

  4) local_identifier

  5) object_length

  6) md5_checksum

  7) description

  8) data_object

encoding_standard_id

The encoding_standard_id attribute provides the formal name of a standard used for the structure of an Encoded Byte Stream digital object.

  1) GIF

  2) J2C

  3) JPEG

  4) PDF

  5) PDF/A

  6) PNG

  7) TIFF

ASCII_Short_String_Collapsed

img_surface:Error_Model_Information

The Error_Model_Information class specifies the name of the error model used, a reference to the algorithm descriptions, and the parameters needed for that algorithm. The specific set of values is determined by each individual missions.

  1) error_model_name

  2) Error_Model_Parameter

  3) Internal_Reference

img_surface:Error_Model_Parameter

The Error_Model_Parameter class specifies name and value for a parameter defined by the error model described by the parent class.

  1) name

  2) value

img:Exposure_Parameters

The Exposure_Parameters class contains attributes identifying the image instrument exposure configuration and image exposure values. As a child of the Image_Product_Information class, these attribute values identify the actual exposure values when the image was taken. As a child of the Command_Parameters class, these attribute values are those that were commanded to the spacecraft at the time the image was taken.

  1) exposure_count

  2) exposure_duration

  3) exposure_duration_count

  4) exposure_type

Field_Delimited

The Field_Delimited class defines a field of a delimited record or a field of a delimited group.

  1) name

  2) field_number

  3) data_type

  4) maximum_field_length

  5) field_format

  6) unit

  7) scaling_factor

  8) value_offset

  9) description

  10) associated_Special_Constants

  11) associated_Statistics

field_delimiter

The field_delimiter attribute provides the character that marks the boundary between two fields in a delimited table.

  1) Comma

  2) Horizontal Tab

  3) Semicolon

  4) Vertical Bar

  5) comma

  6) horizontal tab

  7) semicolon

  8) vertical bar

ASCII_Short_String_Collapsed

File

The File class consists of attributes that describe a file in a data store.

  1) file_name

  2) local_identifier

  3) creation_date_time

  4) file_size

  5) records

  6) md5_checksum

  7) comment

  8) data_object

File_Area_Browse

The File Area Browse class describes a file and one or more tagged_data_objects contained within the file.

  1) has_File

  2) has_tagged_data_object

File_Area_Observational

The File Area Observational class describes, for an observational product, a file and one or more tagged_data_objects contained within the file.

  1) has_File

  2) has_composite_structure

  3) has_tagged_data_object

File_Area_Observational_Supplemental

The File Area Observational Supplemental class describes, for an observational product, additional files and tagged_data_objects contained within the file.

  1) has_File

  2) has_composite_structure

  3) has_tagged_data_object

File_Area_Text

The File Area Text class describes a file that contains a text stream object.

  1) has_File

  2) has_tagged_data_object

file_size

The file_size attribute provides the size of the file.

ASCII_NonNegative_Integer

Units_of_Storage

img:Filter

The Filter class describes the filter associated with a particular observation. The filter may be identified by name, identifier, number or some combination of these.

  1) filter_name

  2) filter_id

  3) filter_number

  4) bandwidth

  5) center_filter_wavelength

  6) comment

img:Frame_Parameters

The Frame_Parameters class contains attributes providing information specific to an image frame. A frame consists of a sequence of measurements made over a specified time interval, and may include measurements from different instrument modes.

  1) frame_id

  2) frame_type_name

  3) interframe_delay

geom:Geometry

The Geometry class is a container for all geometric information in the label. The Image_Display_Geometry class should have one instance if the primary data object is an Array object for which two of the dimensions are suitable for display in the vertical (line) and horizontal (sample) dimensions of a display device. Multiple instances of the Image_Display_Geometry class are only appropriate if the data product contains multiple Array objects and the orientations of the various objects are not the same.

  1) SPICE_Kernel_Files

  2) Expanded_Geometry

  3) Image_Display_Geometry

  4) Geometry_Orbiter

  5) Geometry_Lander

geom:Geometry_Lander

The Geometry_Lander class is a container for all geometric information in the label relating to a landed spacecraft, including rovers.

  1) Articulation_Device_Parameters

  2) Camera_Model_Parameters

  3) Coordinate_Space_Definition

  4) Derived_Geometry

  5) Motion_Counter

img_surface:Geometry_Projection_Parameters

The Geometry_Projection_Parameters describes the geometric projection or warping the image has undergone. It is not the intent of this class to describe map projections, but rather image warps such as linearization (stereo epipolar alignment), geometric sensor correction, or rubber-sheeting. If present, a linearization partner image can be referenced using either an Internal_Reference or External_Reference.

  1) linearization_mode

  2) linearization_mode_fov

  3) geometry_projection_type

  4) External_Reference

disp:green_channel_band

The green_channel_band attribute identifies the number of the band, along the band axis, that should be loaded, by default, into the green channel of a display device. The first band along the band axis has band number 1.

ASCII_Integer

Header

The Header class describes a data object header.

  1) name

  2) object_length

  3) offset

  4) local_identifier

  5) parsing_standard_id

  6) md5_checksum

  7) description

  8) data_object

cart:Horizontal_Coordinate_System_Definition

The Horizontal_Coordinate_System_Definition class provides the reference frame or system from which linear or angular quantities are measured and assigned to the position that a point occupies.

  1) has_Geographic

  2) has_Geodetic_Model

disp:horizontal_display_axis

The horizontal_display_axis attribute identifies, by name, the axis of an Array (or Array subclass) that is intended to be displayed in the horizontal or "sample" dimension on a display device. The value of this attribute must match the value of one, and only one, axis_name attribute in an Axis_Array class of the associated Array.

ASCII_Short_String_Collapsed

disp:horizontal_display_direction

The horizontal_display_direction attribute specifies the direction across the screen of a display device that data along the horizontal axis of an Array is supposed to be displayed.

  1) Left to Right

  2) Right to Left

ASCII_Short_String_Collapsed

Identification_Area

The identification area consists of attributes that identify and name an object.

  1) logical_identifier

  2) version_id

  3) title

  4) information_model_version

  5) product_class

  6) alias_list

  7) citation_information

  8) modification_history

img:Image_Compression_Parameters

The Image_Compression_Parameters class contains attributes describing onboard compression parameters used for data storage and transmission.

  1) compression_class

  2) compression_mode

  3) compression_type

  4) compression_rate

  5) compression_ratio

  6) compression_quality

  7) deferred_flag

  8) error_pixel_count

  9) ICER_Parameters

img_surface:Image_Identifiers

The Image_Identifiers class contains items that help to identify the image or guide how processing should be done to the image.

  1) image_id

  2) mosaic_id

  3) mesh_id

  4) stereo_match_id

img:Image_Product_Information

The Image_Product_Information class contains classes and attributes that describe the image product itself, including information about the exposure duration, filters, data correction, sampling, frame, sub-frames, and how the product was derived.

  1) Autoexposure_Parameters