Difference between revisions of "Questions"

From The SBN Wiki
Jump to navigation Jump to search
(→‎What Do I Put For...?: Added Data Type standard value lists)
Line 30: Line 30:
  
 
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.
 
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 ''<Primary_Result_Summary>'' ====
 
==== In ''<Primary_Result_Summary>'' ====

Revision as of 15:41, 10 October 2012

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 versions numbers...
PDS2010 Software
http://pds.nasa.gov/pds4/software/index.shtml
At the moment, the only thing posted is the validator, but watch this space.
Standard Value Lists for PDS4 keywords?
There are two 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.
Unfortunately, neither of these currently have definitions for any of the standard values.

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 <Primary_Result_Summary>

<data_regime>
  • Dust
  • Electric_Field
  • Electrons
  • Far_Infrared
  • Gamma_Ray
  • Infrared
  • Ions
  • Magnetic_Field
  • Microwave
  • Millimeter
  • Near_Infrared
  • Particles
  • Radio
  • Sub-Millimeter
  • Ultraviolet
  • Visible
  • X-Ray
<type>
  • Altimetry
  • Astrometry
  • Count
  • E/B-Field_Vectors
  • Gravity_Model
  • Image
  • Magnetometry
  • Map
  • Null_Result
  • Occultation
  • Photometry
  • Polarimetry
  • Radiometry
  • Shape_Model
  • Spectrum
<purpose>
  • Calibration
  • Checkout
  • Engineering
  • Navigation
  • Science
<processing_level_id>
  • Calibrated
  • Derived
  • Raw
  • Reduced

In <Observing_System_Component>

<observing_system_component_type>
  • Analyst ← 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 ← Never use this. It's logically ridiculous.
  • Spacecraft
<reference_type>
  • 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:

  • is_observatory
  • is_telescope

Let me know if you run across anything else that doesn't fit.

For <data_type> in ...

...Character table fields (fixed width or delimited):
  • 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
  • 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


...Binary table fields:
  • IEEE754LSBDouble
  • IEEE754LSBSingle
  • IEEE754MSBDouble
  • IEEE754MSBSingle
  • ComplexLSB16
  • ComplexLSB8
  • ComplexMSB16
  • ComplexMSB8
  • SignedBitString
  • SignedByte
  • SignedLSB2
  • SignedLSB4
  • SignedLSB8
  • SignedMSB2
  • SignedMSB4
  • SignedMSB8
  • UnsignedBitString
  • UnsignedByte
  • UnsignedLSB2
  • UnsignedLSB4
  • UnsignedLSB8
  • UnsignedMSB2
  • UnsignedMSB4
  • UnsignedMSB8
  • 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
  • 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

<Element_Array> (Array Elements)

<data_type>
  • IEEE754LSBDouble
  • IEEE754LSBSingle
  • IEEE754MSBDouble
  • IEEE754MSBSingle
  • ComplexLSB16
  • ComplexLSB8
  • ComplexMSB16
  • ComplexMSB8
  • SignedBitString
  • SignedByte
  • SignedLSB2
  • SignedLSB4
  • SignedLSB8
  • SignedMSB2
  • SignedMSB4
  • SignedMSB8
  • UnsignedBitString
  • UnsignedByte
  • UnsignedLSB2
  • UnsignedLSB4
  • UnsignedLSB8
  • UnsignedMSB2
  • UnsignedMSB4
  • UnsignedMSB8