Difference between revisions of "Questions"

From The SBN Wiki
Jump to navigation Jump to search
(→‎Where's the Master Schema?: Update for Release 1)
Line 56: Line 56:
 
Discipline dictionaries can be referenced by any label in the <Discpline_Area>, but in order to reference them in the label you need to download the schema that defines that discipline namespace and the classes and attributes within it - in other words, you need the schema form of the discipline dictionary (as opposed to a human-readable form, say).
 
Discipline dictionaries can be referenced by any label in the <Discpline_Area>, but in order to reference them in the label you need to download the schema that defines that discipline namespace and the classes and attributes within it - in other words, you need the schema form of the discipline dictionary (as opposed to a human-readable form, say).
  
The discipline dictionaries can be found listed on the same schema page as the Master Schema:
+
The discipline dictionaries will be found listed on the same schema page as the Master Schema (once they are officially configured, that is):
 
:http://pds.nasa.gov/pds4/schema/index.shtml
 
:http://pds.nasa.gov/pds4/schema/index.shtml
  

Revision as of 14:47, 23 May 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.


How do I translate FITS Header values into PDS label values?

Here is a set of Notes for Labelling FITS files covering how to deal with the NAXISn values, for a start, and the other reserved FITS keywords relating to the primary data as well as IMAGE, TABLE, and BINTAB extensions.


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. If you're working on labels for archiving, look for the best available version under the Released subheading. Use Development versions only if you have a specific reason to.
PDS4 Schemas
http://pds.nasa.gov/pds4/schema/index.shtml
Here, too, look for the Released subheading.
PDS2010 Software
http://pds.nasa.gov/pds4/software/index.shtml
This includes the PDS validator software, which you should probably learn to use sooner rather than later.
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. Note: This is the only source for the standard values that includes the description or definition for each of the standard values.
  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. Make sure you're looking at the correct context. If you have questions about how to read a Schematron file, ask your Friendly Neighborhood PDS Consultant.
  3. On the Standard Values Quick Reference page of this wiki, maintained for the convenience of SBN data preparers.

Where's the Master Schema?

The PDS Engineering Node maintains a page for downloading the system schemas here:

http://pds.nasa.gov/pds4/schema/index.shtml

It contains the PDS master schema (XSD and Schematron parts). Look for the released version at the top of the page unless you have a specific reason for using a development version, listed lower down. As discipline dictionaries are developed, they will be included on this page as well. For the moment, the master schema set is the only one listed.

Once you locate the schema version you want, you will see three files with the same file name but different extensions. As of this writing, for example, the current version is '1.0.0.0'. The files available for download are:

PDS4_PDS_1000.xsd
This is the Master Schema File. It is an XML Schema file containing all the data structure classes, meta data classes, and data types that define the core PDS requirements. You use it to create and validate labels, Validating XML editors that understand XML Schema will be able to use this file.
PDS4_PDS_1000.sch
This is the companion Schematron file to the Master Schema. It contains a series of rules that enforce additional requirements, over and above what the Master Schema itself can enforce, on the attribute values and cross-relationships (like, you must use either this attribute or that one but not both). Try to find yourself a validating editor that also knows how to apply Schematron validation, and you'll save yourself some trouble later on. The PDS validation tool references both of these files.
PDS_4_PDS_1000.xml
This is a label for the previous two schemas. If for some reason you want to reference either the Master Schema or the Schematron file in some other product label, you'll find the logical ID for them in this label. You can also use this label if you want to include the schemas as documents in a collection you're building. You don't need this file for creating or validating product labels, so you can ignore it for your own label development and validation processing.

You'll find a similarly named set of three files for all the lastest versions of the schemas on this page, serving the same functions for their respective namespaces as the above files do for the pds namespace.


Where are the Discipline Dictionaries?

Discipline dictionaries can be referenced by any label in the <Discpline_Area>, but in order to reference them in the label you need to download the schema that defines that discipline namespace and the classes and attributes within it - in other words, you need the schema form of the discipline dictionary (as opposed to a human-readable form, say).

The discipline dictionaries will be found listed on the same schema page as the Master Schema (once they are officially configured, that is):

http://pds.nasa.gov/pds4/schema/index.shtml

The format for file naming follows the conventions mentioned above for the Master Schema, although not all discipline schemas will have a Schematron file (all will have an XML Schema file).

In some cases, your PDS consultant may direct you to use a pre-release version of a discipline schema. In this case the corresponding file(s) will be sent directly to you by the consultant or by the discipline node.