NASA - National Aeronautics and Space Administration

+ NASA Homepage
+ NASA en Español
+ Contact NASA
Go
Planetary Data System - Engineering Node Banner

Operation

The following topics can be found in this section:

Note: The command-line examples in this section have been broken into multiple lines for readability. The commands should be reassembled into a single line prior to execution.

Tool Execution

Generate Tool can be executed in various ways. This section describes how to run the tool, as well as its behaviors and caveats.

Command-Line Options

The following table describes the command-line options available:

Command-Line OptionDescription
-c, --conf-homeSpecify the path for the configuration files
-d, --debugDirects output to screen, not file.
-f, --file-listSpecify the path for a file containing a list of file paths for PDS3 Labels
-h, --helpDisplay usage.
-o, --output-fileSpecify an output filename. Default is PDS3 label name with _pds4 suffix.
-p, --pds3-labelSpecify the file path for the PDS3 Label to be converted to PDS4
-t, --templateSpecify the file path for the Velocity template for PDS3 -> PDS4 conversion
-V, --versionDisplay application version.

Execute Generate Tool

This section demonstrates execution of the tool using the command-line options. The examples below execute the tool via the batch/shell script.

The following command demonstrates how to run the Generate Tool to convert from a PDS3 Label to a PDS4 Label using a Velocity template file and output to standard out:

% PDS4Generate -d -p <pds3-label-path> -t <velocity-template-path>
        

The following command demonstrates how to run the Generate Tool to convert from a PDS3 Label to a PDS4 Label using a Velocity template file and output to a file:

% PDS4Generate -p <pds3-label-path> -t <velocity-template-path>
        

The output would go into a file <pds3-label-path>.xml (i.e. $HOME/mpf123.img -> $HOME/mpf123.xml


FirstGov Logo
+ Freedom of Information Act
+ NASA 2003 Strategic Plan
+ NASA Privacy Statement, Disclaimer, and
   Accessiblity Certification

+ Copyright/Image Use Policy
NASA Logo
Curator: Emily.S.Law
Webmaster: Maryia Sauchanka-Davis
NASA Official: William Knopf
Last Updated:
+ Comments and Questions