Difference between revisions of "Filling Out the Imaging Instrument State Parameters Class"

From The SBN Wiki
Jump to navigation Jump to search
(Safety Save)
 
(Safety Save - Still editing)
 
(3 intermediate revisions by the same user not shown)
Line 1: Line 1:
 
The ''Imaging_Instrument_Parameters'' class contains attributes describing the dynamic physical or operating characteristics of an instrument.
 
The ''Imaging_Instrument_Parameters'' class contains attributes describing the dynamic physical or operating characteristics of an instrument.
  
== <azimuth_fov> ==
+
== <analog_offset> ==
  
 
''OPTIONAL''
 
''OPTIONAL''
  
== <elevation_fov> ==
+
== <azimuth_fov> ==
  
 
''OPTIONAL''
 
''OPTIONAL''
  
== <camera_serial_number> ==
+
== <elevation_fov> ==
  
 
''OPTIONAL''
 
''OPTIONAL''
Line 38: Line 38:
 
|}
 
|}
  
== <instrument_mode_id> ==
+
== <gain_number> ==
 
 
''OPTIONAL''
 
 
 
{| class="wikitable" style="background-color: yellow"
 
|
 
This attribute has no defined standard values.
 
|}
 
 
 
== <offset_mode_id> ==
 
 
 
''OPTIONAL''
 
 
 
{| class="wikitable" style="background-color: yellow"
 
|
 
This attribute has no defined standard values and is actually defined as an integer, not a character string (not consistent with "ID").
 
|}
 
 
 
{| class="wikitable" style="background-color: lavenderblush"
 
|
 
This attribute is repeatable.  What does it mean to repeat it?
 
|}
 
 
 
 
 
== <Command_Parameters> ==
 
 
 
''OPTIONAL''
 
 
 
{| class="wikitable" style="background-color: lavenderblush"
 
|
 
Is the intention that each occurrence of this class should correspond to one command?  Why is this a property of an image generally, and not something that would be documented in a mission dictionary?  Is there a standard set of commands that all spacecraft use?  If so, is there an analog for groundbased telescope commanding?
 
|}
 
 
 
=== <name> ===
 
 
 
''OPTIONAL''
 
 
 
{| class="wikitable" style="background-color: yellow"
 
|
 
Name of what?
 
|}
 
 
 
=== <description> ===
 
 
 
''OPTIONAL''
 
 
 
=== <command_sequence_number> ===
 
 
 
''OPTIONAL''
 
 
 
=== <detector_erase_count> ===
 
 
 
''OPTIONAL''
 
 
 
=== <Auto_Exposure_Parameters> ===
 
 
 
''OPTIONAL''
 
 
 
{| class="wikitable" style="background-color: lavenderblush"
 
|
 
Is it really necessary to repeat the class name in each one of its attributes?
 
 
 
What is the ground-based analog for telescope imagery?
 
|}
 
 
 
==== <auto_exposure_data_cut> ====
 
 
 
''OPTIONAL''
 
 
 
==== <auto_exposure_max_iteration_count> ====
 
 
 
''OPTIONAL''
 
 
 
{| class="wikitable" style="background-color: yellow"
 
|
 
The definition for this attribute makes it sound like it is an attribute of a specific instrument, not of the data product.
 
|}
 
 
 
==== <auto_exposure_percent> ====
 
 
 
''OPTIONAL''
 
 
 
{| class="wikitable" style="background-color: yellow"
 
|
 
It's not clear if this has implications for the other exposure metadata elsewhere in this label, especially if the value is less than 100.
 
|}
 
 
 
==== <auto_exposure_pixel_fraction> ====
 
 
 
''OPTIONAL''
 
 
 
{| class="wikitable" style="background-color: yellow"
 
|
 
This attribute appears to require that ''&lt;auto_exposure_data_cut&gt;'' also be present, but there is no such constraint in either the schema or Schematron files.
 
|}
 
 
 
 
 
=== <Exposure_Parameters> ===
 
 
 
''OPTIONAL''
 
 
 
{| class="wikitable" style="background-color: yellow"
 
|
 
This class is identical to that in the ''&lt;Imaging_Parameters&gt;'' class, which appears previously in the label.  How can these have different content? 
 
|}
 
 
 
=== <Data_Correction> ===
 
 
 
''OPTIONAL''
 
 
 
{| class="wikitable" style="background-color: yellow"
 
|
 
This class is identical to that in the ''&lt;Imaging_Parameters&gt;&lt;Data_Correction_Parameters&gt;'' class, which appears previously in the label.  How can these have the same definition but different content? 
 
|}
 
 
 
 
 
 
 
== <Telemetry_Parameters> ==
 
 
 
''OPTIONAL''
 
 
 
{| class="wikitable" style="background-color: lavenderblush"
 
|
 
This class description even says its content is "used primarily during mission operations".  Why is this in a general imaging dictionary?  What are the ground-based, balloon-based, sounding-rocket, and aircraft-based imagery equivalents?
 
|}
 
 
 
=== <command_source_id> ===
 
 
 
''OPTIONAL''
 
 
 
=== <download_priority> ===
 
 
 
''OPTIONAL''
 
 
 
{| class="wikitable" style="background-color: yellow"
 
|
 
The definition for this attribute does not indicate whether low numbers or high numbers correspond to "high" priority.
 
|}
 
 
 
=== <earth_received_start_date_time> ===
 
 
 
''OPTIONAL''
 
 
 
=== <earth_received_stop_date_time> ===
 
 
 
''OPTIONAL''
 
 
 
=== <flight_software_version_id> ===
 
 
 
''OPTIONAL''
 
 
 
=== <image_data_size> ===
 
 
 
''OPTONAL''
 
 
 
{| class="wikitable" style="background-color: yellow"
 
|
 
This attribute gives no indication of how "size" should be measured and no required units of measure.
 
|}
 
 
 
=== <product_completion_status> ===
 
  
 
''OPTIONAL''
 
''OPTIONAL''
  
{| class="wikitable" style="background-color: yellow"
 
|
 
There are no standard values defined for this attribute.
 
|}
 
  
=== <surface_gravity> ===
+
== <Instrument_Device_Current> ==
  
 
''OPTIONAL''
 
''OPTIONAL''
  
{| class="wikitable" style="background-color: lavenderblush"
+
=== <Instrument_Device_Current_Index> ===
|
 
How is this an '''''imaging''''' or telemetry parameter?!?
 
|}
 
  
=== <telemetry_application_id> ===
+
''REQUIRED''
  
''OPTIONAL''
+
This class may be repeated.
  
=== <telemetry_application_name> ===
+
==== <device_name> ====
  
''OPTIONAL''
+
''REQUIRED''
  
=== <telemetry_application_subtype_id> ===
+
==== <current_value> ====
  
''OPTIONAL''
+
''REQUIRED''
  
=== <telemetry_provider_id> ===
+
== <Instrument_Device_Temperature> ==
  
 
''OPTIONAL''
 
''OPTIONAL''
  
=== <telemetry_source_name> ===
+
=== <Instrument_Device_Temperature_Index> ===
  
''OPTIONAL''
+
''REQUIRED''
  
=== <telemetry_transport_protocol> ===
+
==== <device_name> ====
  
''OPTIONAL''
+
''REQUIRED''
  
Values: CFDP, Data Product, SFDU
+
==== <raw_count> and/or <temperature_value> ====
  
=== <Error_Pixel> ===
+
''REQUIRED''
  
''OPTIONAL''
+
At least one is required; both may be included; either may be repeated once (for a total of two attributes in the containing class).
 
 
{| class="wikitable" style="background-color: yellow"
 
|
 
The attributes of this class are all optional. Seems like they should all be required - how else can you specify a pixel?
 
|}
 
 
 
==== <line> ====
 
  
''OPTIONAL''
 
  
==== <sample> ====
+
== <Instrument_Device_Voltage> ==
  
 
''OPTIONAL''
 
''OPTIONAL''
  
=== <Packet_Parameters> ===
+
=== <Instrument_Device_Voltage_Index> ===
  
''OPTIONAL''
+
''REQUIRED''
  
==== <creation_sclk> ====
+
==== <device_name> ====
  
''OPTIONAL''
+
''REQUIRED''
  
==== <creation_date_time> ====
+
==== <voltage_value> ====
  
''OPTIONAL''
+
''REQUIRED''
 
 
{| class="wikitable" style="background-color: yellow"
 
|
 
The definition of this field says it is in UTC, but the data type does not require UTC.
 
|}
 
 
 
==== <expected_packets> ====
 
 
 
''OPTIONAL''
 
 
 
==== <received_packets> ====
 
 
 
''OPTIONAL''
 
 
 
==== <missing_packet_flag> ====
 
 
 
''OPTIONAL''
 
 
 
==== <packet_map_mask> ====
 
 
 
''OPTIONAL''
 
 
 
{| class="wikitable" style="background-color: yellow"
 
|
 
The definition of this field says it can be either "a binary or hexadecimal number".  This is not possible under PDS4 - it must be one or the other.  It is defined as hexadecimal, and since there is no syntactic indication of numeric base, this can only contain hex numbers.
 
|}
 

Latest revision as of 21:20, 24 June 2018

The Imaging_Instrument_Parameters class contains attributes describing the dynamic physical or operating characteristics of an instrument.

<analog_offset>

OPTIONAL

<azimuth_fov>

OPTIONAL

<elevation_fov>

OPTIONAL

<detector_first_line>

OPTIONAL

<detector_first_sample>

OPTIONAL

<detector_lines>

OPTIONAL

<detector_to_image_rotation>

OPTIONAL

<gain_mode_id>

OPTIONAL

This attribute has no defined standard values.

<gain_number>

OPTIONAL


<Instrument_Device_Current>

OPTIONAL

<Instrument_Device_Current_Index>

REQUIRED

This class may be repeated.

<device_name>

REQUIRED

<current_value>

REQUIRED

<Instrument_Device_Temperature>

OPTIONAL

<Instrument_Device_Temperature_Index>

REQUIRED

<device_name>

REQUIRED

<raw_count> and/or <temperature_value>

REQUIRED

At least one is required; both may be included; either may be repeated once (for a total of two attributes in the containing class).


<Instrument_Device_Voltage>

OPTIONAL

<Instrument_Device_Voltage_Index>

REQUIRED

<device_name>

REQUIRED

<voltage_value>

REQUIRED