Difference between revisions of "Questions"

From The SBN Wiki
Jump to navigation Jump to search
(Moved Standard Values list to separate page)
Line 27: Line 27:
 
:Unfortunately, none of these currently has definitions for any of the standard values.
 
:Unfortunately, none of these currently has definitions for any of the standard values.
 
-----
 
-----
<div id="stdValueList"></div>
 
 
=== What Do I Put For...? ===
 
 
A number of attributes in the PDS common classes have standard value lists.  You can look the standard values up in either the ''Data Dictionary - Abridged'' document or the Schematron file that comes with the PDS4 master schema.  Both can be rather tedious to sort through.  Following are the most commonly used standard value lists for quick reference.  We'll try to keep these updated.
 
 
Note that spelling counts - including capitalization and use of underscores vs. blanks.  Type these values '''exactly''' as they're shown below or you will get a validation error from the Schematron file.
 
 
==== In ''&lt;Primary_Result_Summary&gt;'' ====
 
 
===== &lt;data_regime&gt; =====
 
{|
 
|-
 
| valign="top" |
 
* Dust
 
* Electric_Field
 
* Electrons
 
* Far_Infrared
 
* Gamma_Ray
 
* Infrared
 
| valign="top" |
 
* Ions
 
* Magnetic_Field
 
* Microwave
 
* Millimeter
 
* Near_Infrared
 
* Particles
 
| valign="top" |
 
* Radio
 
* Sub-Millimeter
 
* Ultraviolet
 
* Visible
 
* X-Ray
 
|}
 
 
===== &lt;type&gt; =====
 
{|
 
|-
 
| valign="top" |
 
* Altimetry
 
* Astrometry
 
* Count
 
* E/B-Field_Vectors
 
* Gravity_Model
 
| valign="top" |
 
* Image
 
* Magnetometry
 
* Map
 
* Null_Result
 
* Occultation
 
| valign="top"|
 
* Photometry
 
* Polarimetry
 
* Radiometry
 
* Shape_Model
 
* Spectrum
 
|}
 
 
===== &lt;purpose&gt; =====
 
{|
 
|-
 
| valign="top |
 
* Calibration
 
* Checkout
 
* Engineering
 
* Navigation
 
* Science
 
|}
 
 
===== &lt;processing_level_id&gt; =====
 
{|
 
|-
 
| valign="top" |
 
* Calibrated
 
* Derived
 
* Raw
 
* Reduced
 
|}
 
 
==== In &lt;Observing_System_Component&gt; ====
 
 
===== &lt;observing_system_component_type&gt; =====
 
{|
 
|-
 
| valign="top" |
 
* Analyst &larr; ''Never use this.  Credit authors and editors in the Citation class.
 
* Artificial_Illumination
 
* Ground-based_Laboratory
 
* Ground-based_Observatory
 
* Ground-based_Telescope
 
* Instrument
 
* Literature_Search
 
* PDS_Archived_Data &larr; ''Never use this. It's logically ridiculous.''
 
* Spacecraft
 
|}
 
 
===== &lt;reference_type&gt; =====
 
{|
 
|-
 
| valign="top" |
 
* is_instrument
 
* is_instrument_host
 
|}
 
 
''Note:'' Clearly these values are not sufficient for groundbased data, or indeed anything other than a spacecraft-mounted instrument.  Following are some additional fake values we'll use until the above problem is fixed.  These values ''will'' generate validation errors:
 
{|
 
|-
 
| valign="top" |
 
* ''is_observatory''
 
* ''is_telescope''
 
|}
 
 
Let me know if you run across anything else that doesn't fit.
 
 
==== In &lt;Target_Identification&gt; ====
 
 
===== &lt;type&gt; =====
 
 
{|
 
|-
 
| valign="top" |
 
* Asteroid
 
* Comet
 
* Dust
 
* Dwarf_Planet
 
* Galaxy
 
* Globular_Cluster
 
* Meteorite
 
| valign="top" |
 
* Meteoroid
 
* Meteoroid_Stream
 
* Nebula
 
* Open_Cluster
 
* Planet
 
* Planetary_Nebula
 
* Planetary_System
 
* Plasma_Cloud
 
| valign="top" |
 
* Ring
 
* Satellite
 
* Star
 
* Star_Cluster
 
* Sun
 
* Terrestrial_Sample
 
* Trans-Neptunian_Object
 
|}
 
 
Clearly this list is not sufficient for small bodies, but at the moment a target is only allowed to have one ''&lt;type&gt;'' designation anyway, which is also problematic.  So if you have an issue with target types, contact your PDS node consultant.
 
 
==== For &lt;data_type&gt; in ... ====
 
 
===== ...Character table fields (fixed width or delimited): =====
 
{|
 
|-
 
| valign="top" |
 
* ASCII_AnyURI
 
* ASCII_Boolean
 
* ASCII_DOI
 
* ASCII_Date
 
* ASCII_Date_DOY
 
* ASCII_Date_Time
 
* ASCII_Date_Time_DOY
 
| valign="top" |
 
* ASCII_Date_Time_UTC
 
* ASCII_Date_Time_YMD
 
* ASCII_Date_YMD
 
* ASCII_Directory_Path_Name
 
* ASCII_File_Name
 
* ASCII_File_Specification_Name
 
* ASCII_Integer
 
| valign="top" |
 
* ASCII_LID
 
* ASCII_LIDVID
 
* ASCII_LIDVID_LID
 
* ASCII_MD5_Checksum
 
* ASCII_NonNegative_Integer
 
* ASCII_Numeric_Base16
 
* ASCII_Numeric_Base2
 
| valign="top" |
 
* ASCII_Numeric_Base8
 
* ASCII_Real
 
* ASCII_String
 
* ASCII_Time
 
* ASCII_VID
 
* UTF8_String
 
|}
 
 
 
===== ...Binary table fields: =====
 
{|
 
|-
 
| valign="top" |
 
* IEEE754LSBDouble
 
 
* IEEE754LSBSingle
 
* IEEE754MSBDouble
 
* IEEE754MSBSingle
 
* ComplexLSB16
 
 
* ComplexLSB8
 
* ComplexMSB16
 
 
* ComplexMSB8
 
| valign="top" |
 
* SignedBitString
 
 
* SignedByte
 
* SignedLSB2
 
 
* SignedLSB4
 
* SignedLSB8
 
 
* SignedMSB2
 
 
* SignedMSB4
 
 
* SignedMSB8
 
 
* UnsignedBitString
 
 
* UnsignedByte
 
 
* UnsignedLSB2
 
 
* UnsignedLSB4
 
 
* UnsignedLSB8
 
 
* UnsignedMSB2
 
 
* UnsignedMSB4
 
 
* UnsignedMSB8
 
| valign="top" |
 
* ASCII_AnyURI
 
 
* ASCII_Boolean
 
 
* ASCII_DOI
 
 
* ASCII_Date
 
 
* ASCII_Date_DOY
 
 
* ASCII_Date_Time
 
* ASCII_Date_Time_DOY
 
* ASCII_Date_Time_UTC
 
* ASCII_Date_Time_YMD
 
* ASCII_Date_YMD
 
* ASCII_Directory_Path_Name
 
* ASCII_File_Name
 
 
* ASCII_File_Specification_Name
 
* ASCII_Integer
 
| valign="top" |
 
* ASCII_LID
 
* ASCII_LIDVID
 
 
* ASCII_LIDVID_LID
 
 
* ASCII_MD5_Checksum
 
* ASCII_NonNegative_Integer
 
 
* ASCII_Numeric_Base16
 
* ASCII_Numeric_Base2
 
 
* ASCII_Numeric_Base8
 
 
* ASCII_Real
 
* ASCII_String
 
* ASCII_Time
 
 
* ASCII_VID
 
* UTF8_String
 
|}
 
 
==== In &lt;Element_Array&gt; (Array Elements) ====
 
 
===== &lt;data_type&gt; =====
 
{|
 
|-
 
| valign="top" |
 
* IEEE754LSBDouble
 
* IEEE754LSBSingle
 
* IEEE754MSBDouble
 
* IEEE754MSBSingle
 
 
* ComplexLSB16
 
 
* ComplexLSB8
 
* ComplexMSB16
 
* ComplexMSB8
 
 
| valign="top" |
 
* SignedBitString
 
* SignedByte
 
 
* SignedLSB2
 
* SignedLSB4
 
* SignedLSB8
 
* SignedMSB2
 
* SignedMSB4
 
* SignedMSB8
 
| valign="top" |
 
* UnsignedBitString
 
* UnsignedByte
 
* UnsignedLSB2
 
* UnsignedLSB4
 
* UnsignedLSB8
 
* UnsignedMSB2
 
* UnsignedMSB4
 
* UnsignedMSB8
 
|}
 
 
==== &lt;reference_type&gt; in... ====
 
 
===== &lt;Observing_System_Component&gt;/&lt;Internal_Reference&gt; =====
 
 
{|
 
|-
 
| valign="top" |
 
* is_instrument
 
* is_instrument_host
 
|}
 
 
{| class="wikitable" style="background-color: thistle"
 
| '''''Note:''''' ''Clearly these values are not sufficient for this context in SBN data (there are no values for ground-based observing, for a start).
 
|}
 
 
===== &lt;Reference_List&gt;/&lt;Internal_Reference&gt; in Bundles =====
 
 
{|
 
|-
 
| valign="top" |
 
* bundle_to_errata
 
* bundle_to_document
 
|}
 
 
===== &lt;Reference_List&gt;/&lt;Internal_Reference&gt; in Collections =====
 
 
{|
 
|-
 
| valign="top" |
 
* collection_to_resource
 
* collection_to_associate
 
* collection_to_calibration
 
* collection_to_geometry
 
* collection_to_spice_kernel
 
* collection_curated_by_node
 
* collection_to_document
 
| valign="top" |
 
* collection_to_browse
 
* collection_to_context
 
* collection_to_data
 
* collection_to_document
 
* collection_to_schema
 
* collection_to_errata
 
* collection_to_bundle
 
|}
 
 
===== &lt;Reference_List&gt;/&lt;Internal_Reference&gt; in Document Products =====
 
 
{|
 
|-
 
| valign="top" |
 
* document_to_associate
 
* document_to_investigation
 
* document_to_instrument_host
 
* document_to_instrument
 
* document_to_target
 
|}
 
 
===== &lt;Reference_list&gt;/&lt;Internal_Reference&gt; in Observational Products =====
 
 
{|
 
|-
 
| valign="top" |
 
* data_to_resource
 
* data_to_calibration_document
 
* data_to_calibration_product
 
* data_to_raw_product
 
* data_to_calibrated_product
 
* data_to_geometry
 
* data_to_spice_kernel
 
* data_to_thumbnail
 
* data_to_document
 
* data_to_browse
 
* data_curated_by_node
 
|}
 
 
 
==== &lt;external_standard_id&gt; in...====
 
 
===== &lt;Document_File&gt; =====
 
 
{|
 
|-
 
| valign="top" |
 
* ASCII
 
* Encapsulated_Postscript
 
* GIF
 
* HTML
 
* JPEG
 
* LaTEX
 
* Microsoft_Word
 
| valign="top" |
 
* PDF
 
* PDF-A
 
* PNG
 
* Postscript
 
* Rich_Text
 
* TIFF
 
* UTF-8
 
|}
 
 
==== &lt;Collection&gt;/&lt;collection_type&gt; ====
 
 
{|
 
|-
 
| valign="top" |
 
* Browse
 
* Calibration
 
* Context
 
* Data
 
* Document
 
* Geometry
 
* Miscellaneous
 
* SPICE
 
* Schema
 
|}
 

Revision as of 03:46, 24 January 2013

Asked Questions

Doesn't matter if they're "frequently asked" at this point - if you have a question, please add it to this page. We'll try to get an answer posted ASAP.


Where Can I Find...?

PDS4 documentation
http://pds.nasa.gov/pds4/doc/index.shtml
This site lists the manuals and guides produced by PDS for PDS4 users. Here you'll find the Standards Reference, the Data Dictionary, the Information Model Specification, and a collection of tutorials and handbooks on various subjects. Be careful of version numbers while PDS4 is still in development!
PDS4 Schemas
http://pds.nasa.gov/pds4/schema/index.shtml
Here, too, be very careful of version numbers...
PDS2010 Software
http://pds.nasa.gov/pds4/software/index.shtml
This includes the PDS validator software, which you should probably learn to use.
Standard Value Lists for PDS4 keywords?
There are three places:
  1. The Data Dictionary document. This is a contextual dictionary, in other words the standard value list will be dependent on what class the keyword appears in, and will be different for different classes. There's a tutorial available from the documentation page, above, on how to use the Data Dictionary.
  2. In the Schematron file. If you prefer reading code to reading the Data Dictionary, or you just find it easier to search ASCII text, open the corresponding Schematron file and look for the class containing the keyword, and then the keyword itself. You should find one rule that enumerates the entire standard value list.
  3. On the Standard Values Quick Reference page of this wiki, maintained for the convenience of SBN data preparers.
Unfortunately, none of these currently has definitions for any of the standard values.