Operation

The following topics can be found in this section:

Tool Setup

In order to execute pds2jpeg, the user's environment must first be configured appropriately. This section describes how to setup the user environment on UNIX-based and Windows machines.

UNIX-Based Setup

This section details the environment setup for UNIX-based machines. Setting the PATH environment variable to the location of the tool, enables it to be executed from any location on the user's machine.

The following command demonstrates how to set the PATH environment variable, by appending to its current setting:

% setenv PATH ${PATH}:$HOME/pds2jpeg-6.0.0/bin
        

The tool can now be executed as demonstrated in the following example:

% pds2jpeg <command-line arguments>
        

Windows Setup

This section details the environment setup for Windows machines. Setting the PATH environment variable to the location of the tool, enables it to be executed from any location on the user's machine.

The following command demonstrates how to set the PATH environment variable, by appending to its current setting:

C:\> set PATH = %PATH%;C:\pds2jpeg-6.0.0\bin
        

The tool can now be executed as demonstrated in the following example:

C:\> pds2jpeg <command-line arguments>
        

Tool Execution

This tool provides a simple command-line interface for converting PDS images. The resulting JPEG image is directed to standard out and can be captured in file form by using a UNIX redirection.

Command-Line Options

This section details the command-line option flags available for the tool:

Flag Description
-if <PDS-image-file> Specify the 8-bit PDS image file to convert into a JPEG image.
-m Specifies that the target image file is a compressed MOC image.

Running pds2jpeg

This section demonstrates how to run the tool using the command-line option flags. There is really only one way to run the tool and that is with the -if flag and redirecting the output to the target JPEG file as follows:

% pds2jpeg -if c1634202.img > c1634202.jpg
        

If you are converting a MOC image, add the -m flag before the -if flag.