Difference between revisions of "Imaging Dictionary"

From The SBN Wiki
Jump to navigation Jump to search
()
()
Line 449: Line 449:
  
 
= <Onboard_Compression> =
 
= <Onboard_Compression> =
 +
'''''ELEMENT''''''
 +
 +
Parameters related to onboard compression
  
 
== <onboard_compression_class> ==
 
== <onboard_compression_class> ==
 
''OPTIONAL''
 
''OPTIONAL''
 +
 +
''Lossless'', ''Lossy'', or ''Uncompressed''
  
 
== <onboard_compression_mode> ==
 
== <onboard_compression_mode> ==
 
''OPTIONAL''
 
''OPTIONAL''
 +
 +
Appears to be some sort of integer code that is expected to correspond to compression method somehow, but how is not well-specified.
  
 
== <onboard_compression_type> ==
 
== <onboard_compression_type> ==
 
''OPTIONAL''
 
''OPTIONAL''
 +
 +
Must be one of:
 +
* GZIP
 +
* ICER
 +
* H.264 Frame
 +
* LOCO
 +
* LZO
 +
* JPEG
 +
* JPEG Pogressive
 +
* MSSS Lossless
 +
* Lossless
 +
* None
 +
* StarPixel Lossless
 +
* StarPixel Flexible
  
 
== <onboard_compression_rate> ==
 
== <onboard_compression_rate> ==
 
''OPTIONAL''
 
''OPTIONAL''
 +
 +
Average number of bits needed to represent a pixel in compression. [Not really a rate - no units]
  
 
== <onboard_compression_ratio> ==
 
== <onboard_compression_ratio> ==
 
''OPTIONAL''
 
''OPTIONAL''
 +
 +
Ratio of size of original object to compressed size.
  
 
== <onboard_compression_quality> ==
 
== <onboard_compression_quality> ==
 
''OPTIONAL''
 
''OPTIONAL''
 +
 +
"1.0" = uncompressed or losslessly compressed. Everything else depends on the compression algorithm, though higher numbers are better.
  
 
== <onboard_compression_venue> ==
 
== <onboard_compression_venue> ==
 
''OPTIONAL''
 
''OPTIONAL''
 +
 +
String indicating where the onboard compression was performed
  
 
== <deferred_flag> ==
 
== <deferred_flag> ==
 
''OPTIONAL''
 
''OPTIONAL''
 +
 +
Supposed to indicate when compression was applied (at acquisition or prior to downlink), but it's not clear what the boolean values correspond to.
  
 
== <error_pixel_count> ==
 
== <error_pixel_count> ==
 
''OPTIONAL''
 
''OPTIONAL''
 +
 +
Number of pixels outside value DN range after decompression processing.
  
  
 
== <ICER_Parameters> ==
 
== <ICER_Parameters> ==
 
''OPTIONAL''
 
''OPTIONAL''
 +
 +
Parameters used for ICER compression used on Mars Rovers.
  
 
=== <wavelet_filter> ===
 
=== <wavelet_filter> ===
Line 526: Line 561:
 
== <LOCO_Parameters> ==
 
== <LOCO_Parameters> ==
 
''OPTIONAL''
 
''OPTIONAL''
 +
 +
Parameters related to LOCO compression, a subtype of ICER compression, used in Mars data.
  
 
=== <wavelet_filter> ===
 
=== <wavelet_filter> ===
Line 549: Line 586:
 
== <JPEG_Parameters> ==
 
== <JPEG_Parameters> ==
 
''OPTIONAL''
 
''OPTIONAL''
 +
 +
Parameters specific to JPEG compression.
  
 
=== <color_sampling_mode> ===
 
=== <color_sampling_mode> ===
Line 566: Line 605:
 
== <JPEG_Progressive_Parameters> ==
 
== <JPEG_Progressive_Parameters> ==
 
''OPTIONAL''
 
''OPTIONAL''
 +
 +
JPEG Pogressive compression parameters
  
 
=== <color_sampling_mode> ===
 
=== <color_sampling_mode> ===
Line 605: Line 646:
 
=== <Image_Compression_Segment> ===
 
=== <Image_Compression_Segment> ===
 
''OPTIONAL, REPEATABLE''
 
''OPTIONAL, REPEATABLE''
 
 
  
 
= <Optical_Filter> =
 
= <Optical_Filter> =

Revision as of 16:04, 25 December 2022

This is for version 1J00_1870 of the imaging namespace. Note that the "Imaging" superclass is optional.

Contents

<Companding>

ELEMENT

Parameters related to data that had its bit depth reduced.

<active_flag>

OPTIONAL

True if companding was applied.

<processing_venue>

OPTIONAL

Free-form string indicating where the companding was performed

<processing_algorithm>

OPTIONAL

Name of companding algorithm.

<sequence_number>

OPTIONAL

(definition not meaningful in this context)

<companding_state>

OPTIONAL

None, Companded, or Expanded

<early_scaling>

OPTIONAL

<Companding_File>

OPTIONAL

<description>

OPTIONAL

<pds:Internal_Reference> or <pds:External_Reference>

OPTIONAL

<name>

OPTIONAL


<Companding_Table>

OPTIONAL

<description>

OPTIONAL

<pds:Internal_Reference> or <pds:External_Reference>

OPTIONAL

<name>

OPTIONAL

<Companding_Table_Mapping>

REQUIRED, REPEATABLE

<input_dn_min>

REQUIRED

<input_dn_max>

REQUIRED

<output_dn>

REQUIRED

<Detector>

ELEMENT

Describes the state of the detector, not onboard processing.

<first_line>

OPTIONAL

<first_sample>

OPTIONAL

<lines>

OPTIONAL

<samples>

OPTIONAL

<detector_to_image_rotation>

OPTIONAL

Clockwise rotation from detector orientation to final image orientation

<detector_to_image_flip>

OPTIONAL

Indicates mirror image flip from detector orientation to final image orientation. Horizontal = left-to-right flip; Vertical = top-to-bottom flip.

Flip is applied before rotation.

<erase_count>

OPTIONAL

<readout_rate>

OPTIONAL

Frequency (Hz) of clock rate at which values were read from the sensor

<gain_mode_id>

OPTIONAL

String identifier for gain mode (permissible values to be set by label designer)

<gain_number>

OPTIONAL

Gain value (floating point multiplicative factor) used in analog to digital conversion (ADC).

<analog_offset>

OPTIONAL

Vakue subtracted from signal prior to ADC

<bad_pixel_replacement_flag>

OPTIONAL

True if bad pixel replacement was requested/completed.

<bad_pixel_replacement_table_id>

OPTIONAL

Name of table used to replace bad pixels. [doesn't appear actionable - not resolvable]

<instrument_idle_timeout>

OPTIONAL

<early_image_return>

OPTIONAL

<parameter_table_id>

OPTIONAL

<Special_Point>

OPTIONAL

<name>

OPTIONAL

<description>

OPTIONAL

<special_line>

OPTIONAL

<special_sample>

OPTIONAL

<pds:Internal_Reference>

OPTIONAL

Not clear what the point of this is. Only valid reference_type is data_to_raw_source_product.

<Exposure>

ELEMENT

<exposure_count>

OPTIONAL

Number of exposures taken during some relevant interval

<exposure_duration>

OPTIONAL

Amount of time a sensor was gathering light

<exposure_duration_count>

OPTIONAL

exposure_duration in DN rather than seconds

<exposure_type>

OPTIONAL

Camera exposure setting: Manual, Auto, Test

<exposure_scale_factor>

OPTIONAL

Multiplier applied to exposure_duration when that number reflects one of a series of exposures obtained to create the data object

<exposure_coadd_count>

OPTIONAL

Number of images co-added to produce the image

<exposure_readout_time>

OPTIONAL

Number of times an exposure (or part) has been read from the camera

<Autoexposure>

OPTIONAL

<active_flag>

OPTIONAL

<processing_venue>

OPTIONAL

<processing_algorithm>

OPTIONAL

<sequence_number>

OPTIONAL

<auto_exposure_data_cut>

OPTIONAL

<auto_exposure_percent>

OPTIONAL

<auto_exposure_pixel_fraction>

OPTIONAL

<auto_exposure_lower_threshold>

OPTIONAL

<auto_exposure_lower_limit>

OPTIONAL

<auto_exposure_roi_first_line>

OPTIONAL

<auto_exposure_roi_first_sample>

OPTIONAL

<auto_exposure_roi_lines>

OPTIONAL

<auto_exposure_roi_samples>

OPTIONAL

<auto_exposure_upper_threshold>

OPTIONAL

<auto_exposure_upper_limit>

OPTIONAL

<max_auto_exposure_iteration_count>

OPTIONAL

<exposure_table>

OPTIONAL

<exposure_table_update_flag>

OPTIONAL

<valid_maximum_pixel>

OPTIONAL

<valid_minimum_pixel>

OPTIONAL

<Focus>

ELEMENT

Parameters describing focus

<focus_mode>

OPTIONAL

<focus_position>

OPTIONAL

<focus_position_count>

OPTIONAL

<autofocus_step_size>

OPTIONAL

<autofocus_step_count>

OPTIONAL

<focus_distance>

OPTIONAL

<focus_initialization_flag>

OPTIONAL

<minimum_focus_distance>

OPTIONAL

<best_focus_distance>

OPTIONAL

<maximum_focus_distance>

OPTIONAL

<High_Dynamic_Range>

ELEMENT

Parameters related to processing in which multiple exposures of different lengths into a single product with greater dynamic range

<active_flag>

OPTIONAL

<processing_venue>

OPTIONAL

<processing_algorithm>

OPTIONAL

<sequence_number>

OPTIONAL

<hdr_acquisition_mode>

OPTIONAL

<hdr_frame_count>

OPTIONAL

<hdr_clipping_threshold>

OPTIONAL

<High_Dynamic_Range_Exposure>

OPTIONAL, REPEATABLE

Specifies exposure parameters for each constituent exposure used

<exposure_duration>

OPTIONAL

<exposure_duration_count>

OPTIONAL

<exposure_time_delta>

OPTIONAL

<pds:Internal_Reference>

OPTIONAL

<Instrument_State>

ELEMENT

Classes providing lists of parameters related to instrument state and operating conditions.

<Device_Component_States>

OPTIONAL

<Device_Component_State>

REQUIRED, REPEATABLE

<device_name>

OPTIONAL

<device_id>

OPTIONAL

<sequence_number>

OPTIONAL

<device_state>

OPTIONAL


<Device_Currents>

OPTIONAL

<Device_Current>

REQUIRED, REPEATABLE

<device_name>

OPTIONAL

<device_id>

OPTIONAL

<sequence_number>

OPTIONAL

<current_value>

OPTIONAL


<Device_Motor_Counts>

OPTIONAL

<Device_Motor_Count>

REQUIRED, REPEATABLE

<device_name>

OPTIONAL

<device_id>

OPTIONAL

<sequence_number>

OPTIONAL

<motor_count>

OPTIONAL


<Device_Temperatures>

OPTIONAL

<Device_Temperature>

REQUIRED, REPEATABLE

<device_name>

OPTIONAL

<device_id>

OPTIONAL

<sequence_number>

OPTIONAL

<raw_count>

OPTIONAL

<temperature_value>

OPTIONAL

<temperature_status>

OPTIONAL


<Device_Voltages>

OPTIONAL

<Device_Voltage>

REQUIRED, REPEATABLE

<device_name>

OPTIONAL

<device_id>

OPTIONAL

<sequence_number>

OPTIONAL

<voltage_value>

OPTIONAL

<Onboard_Compression>

ELEMENT'

Parameters related to onboard compression

<onboard_compression_class>

OPTIONAL

Lossless, Lossy, or Uncompressed

<onboard_compression_mode>

OPTIONAL

Appears to be some sort of integer code that is expected to correspond to compression method somehow, but how is not well-specified.

<onboard_compression_type>

OPTIONAL

Must be one of:

  • GZIP
  • ICER
  • H.264 Frame
  • LOCO
  • LZO
  • JPEG
  • JPEG Pogressive
  • MSSS Lossless
  • Lossless
  • None
  • StarPixel Lossless
  • StarPixel Flexible

<onboard_compression_rate>

OPTIONAL

Average number of bits needed to represent a pixel in compression. [Not really a rate - no units]

<onboard_compression_ratio>

OPTIONAL

Ratio of size of original object to compressed size.

<onboard_compression_quality>

OPTIONAL

"1.0" = uncompressed or losslessly compressed. Everything else depends on the compression algorithm, though higher numbers are better.

<onboard_compression_venue>

OPTIONAL

String indicating where the onboard compression was performed

<deferred_flag>

OPTIONAL

Supposed to indicate when compression was applied (at acquisition or prior to downlink), but it's not clear what the boolean values correspond to.

<error_pixel_count>

OPTIONAL

Number of pixels outside value DN range after decompression processing.


<ICER_Parameters>

OPTIONAL

Parameters used for ICER compression used on Mars Rovers.

<wavelet_filter>

OPTIONAL

<icer_quality>

OPTIONAL

<decomposition_stages>

OPTIONAL

<segment_count>

OPTIONAL

<Image_Compression_Segment>

OPTIONAL, REPEATABLE

<segment_number>

REQUIRED

<first_line>

REQUIRED

<first_sample>

REQUIRED

<lines>

REQUIRED

<samples>

REQUIRED

<segment_quality>

OPTIONAL

<segment_status>

OPTIONAL

<segment_corrupted_flag>

OPTIONAL

<missing_pixel_count>

OPTIONAL


<LOCO_Parameters>

OPTIONAL

Parameters related to LOCO compression, a subtype of ICER compression, used in Mars data.

<wavelet_filter>

OPTIONAL

<missing_pixel_count>

OPTIONAL

<segment_count>

OPTIONAL

<Image_Compression_Segment>

OPTIONAL, REPEATABLE

<segment_corrupted_flag>

OPTIONAL

<missing_pixel_count>

OPTIONAL


<JPEG_Parameters>

OPTIONAL

Parameters specific to JPEG compression.

<color_sampling_mode>

OPTIONAL

<jpeg_quality>

OPTIONAL

<jpeg_parameter>

OPTIONAL

<Image_Compression_Segment>

OPTIONAL, REPEATABLE"


<JPEG_Progressive_Parameters>

OPTIONAL

JPEG Pogressive compression parameters

<color_sampling_mode>

OPTIONAL

<jpeg_quality>

OPTIONAL

<jpeg_parameter>

OPTIONAL

<Image_Compression_Segment>

OPTIONAL, REPEATABLE"

<progressive_stage>

OPTIONAL


<StarPixel_Flexible_Parameters>

OPTIONAL

<starpixel_initial_sampling_interval>

OPTIONAL

<starpixel_degradation>

OPTIONAL

<Image_Compression_Segment>

OPTIONAL, REPEATABLE"


<StarPixel_Lossless_Parameters>

OPTIONAL

<starpixel_initial_sampling_interval>

OPTIONAL

<Image_Compression_Segment>

OPTIONAL, REPEATABLE

<Optical_Filter>

ELEMENT

<filter_name>

OPTIONAL

<filter_id>

OPTIONAL

<filter_number>

OPTIONAL

<filter_position_count>

OPTIONAL

<bandwidth>

OPTIONAL

<center_filter_wavelength>

OPTIONAL

<array_band_number>

OPTIONAL

<comment>

OPTIONAL

<pds:Local_Internal_Reference>

OPTIONAL


<Sampling>

ELEMENT

<crosstrack_summing>

OPTIONAL

<downtrack_summing>

OPTIONAL

<missing_pixel_count>

OPTIONAL

<original_sample_bits>

OPTIONAL

<sample_bits>

OPTIONAL

<sample_bit_mask>

OPTIONAL

<sampling_factor>

OPTIONAL

<saturated_pixel_count>

OPTIONAL

<valid_pixel_count>

OPTIONAL

<Companding>

OPTIONAL


<Subframe>

ELEMENT

<first_line>

OPTIONAL

<first_sample>

OPTIONAL

<lines>

OPTIONAL

<sample>

OPTIONAL

<line_fov>

OPTIONAL

<sample_fov>

OPTIONAL

<name>

OPTIONAL

<description>

OPTIONAL

<subframe_type>

OPTIONAL



<Imaging>

ELEMENT

<pds:Local_Internal_Reference>

REQUIRED, REPEATABLE

<Brightness_Correction>

OPTIONAL

<Col_Sum>

OPTIONAL

<Color_Filter_Array>

OPTIONAL

<Color_Processing>

OPTIONAL

<Dark_Current_Correction>

OPTIONAL

<Data_Quality>

OPTIONAL

<Detector>

OPTIONAL

<Downsampling>

OPTIONAL

<Exposure>

OPTIONAL

<Flat_Field_Correction>

OPTIONAL

<Focus>

OPTIONAL

<Focus_Stack>

OPTIONAL

<Frame>

OPTIONAL

<High_Dynamic_Range>

OPTIONAL

<Histogram>

OPTIONAL

<Illumination>

OPTIONAL

<Image_Filter>

OPTIONAL

<Image_Mask>

OPTIONAL

<Onboard_Compression>

OPTIONAL

<Optical_Filter>

OPTIONAL

<Optical_Properties>

OPTIONAL

<Pointing_Correction>

OPTIONAL

<Radiometric_Correction>

OPTIONAL

<Reference_Pixel>

OPTIONAL

<Row_Sum>

OPTIONAL

<Sample>

OPTIONAL

<Shutter_Subtraction>

OPTIONAL

<Spatial_Filter>

OPTIONAL

<Subframe>

OPTIONAL

<Thumbnail>

OPTIONAL

<Video>

OPTIONAL

<Instrument_State>

OPTIONAL

<Commanded_Parameters>

OPTIONAL