Help

This page includes documentation, descriptions, and examples of the data and software included in this Peer Review, as well as the tools that can be used to view and access the data. If you require further assistance, please contact Cristina De Cesare.

• What is PDS4?
• Validating the Data
• Inspecting the Labels
• Viewing the Images

What is PDS4?

PDS has adopted XML for PDS4. The Extensible Markup Language (XML) is an international standard that is widely used by many online data systems to document their data. It provides a standard syntax and structure for describing data for many different industries. A significant number of vendors and programming languages provide support for reading and writing XML files. XML integrates directly with web-based applications allowing for the metadata, described in XML, to be rendered in a number of different formats. See the following pages for more detailed information regarding the PDS4 standard:

• What is PDS4? - Overview of PDS4.
• PDS4 Concepts Document - Introduction to PDS4 key concepts - the view from 10,000 feet, avoiding gory details.
• PDS4 Model Specification - Detailed descriptions of each attribute and class in the PDS4 standard.
• PDS4 Standards Reference v1.10.1 - One of the two fundamental reference documents for PDS4. You will need this as you work your way through the Data Provider's Handbook and as you prepare an archive.
• The Small Bodies Node Wiki contains a ton of useful information about XML standards, schemas, and PDS4 intricacies.
• Other PDS4 Documentation - Other PDS4 documentation including Data Provider's Handbook, Data Dictionary, Information Model Specification, and Policies.

Validating the Data

The PDS4 Validate Tool is software developed by the PDS Engineering Node for validating PDS4 product labels and product data. The associated specific schema for the product label specifies syntactic and semantic constraints. The product label itself specifies the constraints for the data.

Download and Installation

• Download tool (development version): (tar) (zip)
• The downloaded package includes Installation and Operation instructions in the /doc directory.
• Download JunoCam configuration - right click the link and click "Save Link As..."

JunoCam-specific Examples

Assumptions

• Using Mac OSX or Cygwin on Windows
• You have downloaded and unpackaged the JunoCam PDS4 Bundle to $HOME/junocam_bundle.
• Validate Tool has been installed per the downloaded instructions. See doc directory in the Validate Tool downloaded software.
• You have downloaded the Validate Tool Configuration File and placed it alongside the junocam_bundle bundle under your $HOME directory ($HOME/validate_config.txt)

To validate a single product against the dictionaries in the bundle and output the report to validate-report.txt (update $HOME if path to bundle differs)

    # go to the location of the bundle
    cd $HOME
    
    # run validate with the config file
    validate data/JNOJNC_0001/EDR/JUPITER/ORBIT_00/JNCE_2016129_00C00158_V01.xml -c validate_config.txt
    
    # check the report
    cat validate_report.txt

To validate the entire sample bundle and output the report to validate-report.txt:

    # go to the location of the bundle
    cd $HOME
    
    # run validate with the config file
    validate junocam_bundle -c validate_config.txt
    
    # check the report
    cat validate_report.txt

Inspecting the Products

PDS4 labels are in XML format, so in order to inspect the labels in this review's sample archive, you'll need to have some software to view XML. The simplest solution is to install a browser extension and follow the links below to open the labels in your browser. You may prefer to download the sample archive and then open the label files in a viewer/editior application, such as Eclipse. We provide links below to recommended XML tools.

XML Tools

• XV Chrome Extension - view/search XML in the browser
• Eclipse IDE - open source Integrated Development Environment, with extensions to act as XML editor and viewer
• The Small Bodies Node Wiki contains a lot of documentation for setting up and using Eclipse.
• oXygen XML Editor - XML editor and viewer (requires license)
• The Small Bodies Node Wiki may be used for some of this setup and configuration.

JunoCam Bundle Organization

• Bundle Label
  • archive/bundle_v1.0.xml
• Context Collection -- Contains context products.
  • archive/context/
• Data Collection -- Contains cameras data products.
  • archive/data/
  • EDR:
    • archive/data/JNOJNC_0001/EDR/CRUISE/
    • archive/data/JNOJNC_0001/EDR/EFB/
    • archive/data/JNOJNC_0001/EDR/JUPITER/ORBIT_00/
  • RDR:
    • archive/data/JNOJNC_0001/RDR/CRUISE/
    • archive/data/JNOJNC_0001/RDR/EFB/
    • archive/data/JNOJNC_0001/RDR/JUPITER/ORBIT_00/
• Document Collection -- Contains documentation files, including SIS documents and example PDS4 labels.
  • archive/document/
• Miscellaneous Collection -- Contains PDS3 catalog, index & errata files.
  • archive/miscellaneous/
• Schema Collection -- Contains the PDS4 XML Schema used in the production of this bundle.
  • archive/xml_schema/

Viewing the Images

There are a few options for viewing the image products in PDS4:

• Browse Images - these quick-look products are part of the bundle but only available for Raw Data products
• PDS4 Viewer - can be used to view all viewable data products on the fly. Note: some data products (i.e. XYZ) are not viewable images
• Transform Tool

Browse Images

• browse/JNOJNC_0001/BROWSE/EDR/JUPITER/ORBIT_00/

PDS4 Viewer

The PDS4 Viewer is a visualization tool for PDS4 data. PDS4 Viewer is a tool that allows uers to open a PDS4 label (XML) and view metadata in a human-readable format, and also view the image file described by the label. Here's an example of how to use the PDS4 viewer:

1. Download & install the PDS4 Viewer as discussed on the SBN Wiki.
2. Launch PDS4 viewer.
3. Click File >> Open
4. Select a PDS4 XML label.
5. View label information
   
   
   
   
6. Click the "Image" button to view the image.
   
   
   
   

Transform Tool

Developed by the PDS Engineering Node, the Transform Tool is the PDS-wide command-line tool used for transforming PDS3 and PDS4 product labels and product data into other formats. The following is an example of transforming a PNG browse image into a JPEG.

% transform junocam_bundle/browse/JNOJNC_0002/BROWSE/EDR/JUPITER/ORBIT_01/JNCE_2016213_01C03606_V01.PNG.xml -f jpg

Last updated Monday October 29, 2018 10:09 PM