Difference between revisions of "Filling Out the Imaging Dictionary Classes"

From The SBN Wiki
Jump to navigation Jump to search
m ()
(: Update for IMG 1.9.0.0)
 
(3 intermediate revisions by the same user not shown)
Line 1: Line 1:
 
The imaging dictionary is a ''discipline dictionary'', which means that its classes will appear in the ''<Discipline_Area>'' at the bottom of the ''<Observation_Area>'' in observational product labels (and in the ''<Context_Area>'', if appropriate, in non-observational products).  The classes in this dictionary provide parameters and processing information specific to image-type data, which includes data produced by imagers, but also instrument like imaging spectrometers.
 
The imaging dictionary is a ''discipline dictionary'', which means that its classes will appear in the ''<Discipline_Area>'' at the bottom of the ''<Observation_Area>'' in observational product labels (and in the ''<Context_Area>'', if appropriate, in non-observational products).  The classes in this dictionary provide parameters and processing information specific to image-type data, which includes data produced by imagers, but also instrument like imaging spectrometers.
  
''Begin: 12 January 2017 for version 1.7.0.0''
+
The standard abbreviation for the namespace defined by this dictionary is "'''img:'''".
 +
 
 +
''Begin: 13 August 2017 for version 1.7.0.0''
 +
''Working: 24 June 2018 for version 1.9.0.0''
  
 
== <Imaging> ==
 
== <Imaging> ==
Line 28: Line 31:
  
 
This attribute must contain a string that appears in the ''&lt;local_identifier&gt;'' attribute of an image-type object elsewhere in this label.
 
This attribute must contain a string that appears in the ''&lt;local_identifier&gt;'' attribute of an image-type object elsewhere in this label.
 +
 +
{| class="wikitable" style="background-color: yellow"
 +
| '''Note:''' ''There is no validation that checks if the ''local_identifier'' belongs to an image-type object.  Type carefully.''
 +
|}
  
 
==== <pds:local_reference_type> ====
 
==== <pds:local_reference_type> ====
Line 33: Line 40:
 
''REQUIRED''
 
''REQUIRED''
  
'''No standard values are defined for this required attribute.'''
+
This attribute must have the value '''imaging_parameters_to_image_object'''.
 +
 
 +
=== <Command_Parameters> ===
 +
 
 +
''OPTIONAL''
 +
 
 +
The attributes in this class define the commands sent to the spacecraft.  These commanded values may or may not correspond to the actual, observational values. The actual values should be provided in the ''&lt;Image_Product_Information&gt;'' class, following.
 +
 
 +
* [[Filling Out the Command_Parameters Class]]
  
 
=== <Image_Product_Information> ===
 
=== <Image_Product_Information> ===
Line 43: Line 58:
 
* [[Filling Out the Image_Product_Information Class]]
 
* [[Filling Out the Image_Product_Information Class]]
  
=== <Imaging_Instrument_Parameters> ===
+
=== <Imaging_Instrument_State_Parameters> ===
  
 
''OPTIONAL''
 
''OPTIONAL''
Line 49: Line 64:
 
This class contains attributes describing the instrument that obtained the data, including field of view, various mode settings, commanding, and telemetry parameters.
 
This class contains attributes describing the instrument that obtained the data, including field of view, various mode settings, commanding, and telemetry parameters.
  
* [[Filling Out the Imaging_Instrument_Parameters Class]]
+
* [[Filling Out the Imaging_Instrument_State_Parameters Class]]
  
 
=== <Image_Compression_Parameters> ===
 
=== <Image_Compression_Parameters> ===
Line 58: Line 73:
  
 
* [[Filling Out the Image_Compression_Parameters Class]]
 
* [[Filling Out the Image_Compression_Parameters Class]]
 
=== <Processing_History> ===
 
 
''OPTIONAL''
 
 
This class provides a way to document the production and provenance of the image data object specifically (as opposed to the PDS product).
 
 
* [[Filling Out the Processing_History Class]]
 

Latest revision as of 20:12, 24 June 2018

The imaging dictionary is a discipline dictionary, which means that its classes will appear in the <Discipline_Area> at the bottom of the <Observation_Area> in observational product labels (and in the <Context_Area>, if appropriate, in non-observational products). The classes in this dictionary provide parameters and processing information specific to image-type data, which includes data produced by imagers, but also instrument like imaging spectrometers.

The standard abbreviation for the namespace defined by this dictionary is "img:".

Begin: 13 August 2017 for version 1.7.0.0 Working: 24 June 2018 for version 1.9.0.0

<Imaging>

REQUIRED

This is the wrapper class for the Imaging Dictionary. It must be used whenever you want or need to include imaging acquisition or processing parameters in your product label. It has four subclasses, listed below, each of which may be omitted or repeated as appropriate for your data product. The subclasses are fairly complex, so each is described on its own page.

<pds:Local_Internal_Reference>

REQUIRED

This class ties the imaging descriptions following to a specific image-type object described elsewhere in the product label. This class and its attributes are in the core PDS namespace, and so are described here using the standard "pds:" prefix. How you reference them in your product label depends on the conventions you're using for namespace references. If you're not sure what that means, see Schema Referencing in PDS Labels: Namespace References elsewhere on this wiki.

Repeat this class once for each image-type object that you want to tie to this <Imaging> class.

<pds:comment>

OPTIONAL

If there are any caveats or special circumstances about this reference that you want to note for end-users, this is the place to do it.

<pds:local_identifier_reference>

REQUIRED

This attribute must contain a string that appears in the <local_identifier> attribute of an image-type object elsewhere in this label.

Note: There is no validation that checks if the local_identifier belongs to an image-type object. Type carefully.

<pds:local_reference_type>

REQUIRED

This attribute must have the value imaging_parameters_to_image_object.

<Command_Parameters>

OPTIONAL

The attributes in this class define the commands sent to the spacecraft. These commanded values may or may not correspond to the actual, observational values. The actual values should be provided in the <Image_Product_Information> class, following.

<Image_Product_Information>

OPTIONAL

This class contains attributes describing the image itself, including parameters for exposure, filter description, sampling, framing, and so on.

<Imaging_Instrument_State_Parameters>

OPTIONAL

This class contains attributes describing the instrument that obtained the data, including field of view, various mode settings, commanding, and telemetry parameters.

<Image_Compression_Parameters>

OPTIONAL

This class contains attributes describing onboard compression.