Official websites use .gov
A .gov website belongs to an official government organization in the United States.

Secure .gov websites use HTTPS
A lock ( ) or https:// means you’ve safely connected to the .gov website. Share sensitive information only on official, secure websites.

ISIS Documentation

lopdsgen

Convert from Isis Lunar Orbiter cubes to the PDS format

Program to convert Isis cubes for Lunar Orbiter strips and level 1 products to PDS image files.

Categories

History

Travis Addair2009-12-16 Original version
Travis Addair2009-12-18 Updated test and example for changes to PVL.
Travis Addair2010-02-16 Added support for reexporting the cubes generated from PDS files produced by this application.

Parameters

Files

The LO strip or level 1 Isis cube to be converted to PDS format.
Type cube
File Mode input
Filter *.cub

The resulting PDS file.
Type filename
File Mode output
Filter *.img

Output Settings

Bit type of output: 8 bit (0=black, 255=white) 16 bit unsigned (0=black, 65535=white) 16 bit signed (-32767=black, 32768=white) 32 bit (1.17549435e-38=black, 3.40282347e+38=white)
Type string
Default 32BIT
Option List:
Option Brief Description
8BIT8-bit data Pixels are in 8-bit data range (0 to 255).

Exclusions

  • ENDIAN
U16BIT 16-bit unsigned data Pixels are in the 16-bit data range (0 to 65535)
S16BIT 16-bit signed data Pixels are in 16-bit signed data range (-32768 to 32767)
32BIT 32-bit data Pixels are in the 32-bit floating point data range (-3.40282347e+38 to 3.40282347e+38)

Exclusions

  • STRETCH
  • MINPERCENT
  • MAXPERCENT
  • NULL
  • LRS
  • LIS
  • HIS
  • HRS

If set to true, the minimum value of the raw output data will be reserved for null pixels. The actual value used for null pixels will be denoted in the print.prt file as well as displayed onscreen.
Type boolean
Default true

If set to true, then an output DN value is set aside for the LRS input pixels. The actual DN value used for LRS pixels will be denoted in the print.prt file as well as displayed onscreen.
Type boolean
Default false

If set to true, then an output DN value is set aside for the LIS input pixels. The actual DN value used for LIS pixels will be denoted in the print.prt file as well as displayed onscreen.
Type boolean
Default false

If set to true, then an output DN value is set aside for the HIS input pixels. The actual DN value used for HIS pixels will be denoted in the print.prt file as well as displayed onscreen.
Type boolean
Default false

If set to true, then an output DN value is set aside for the HRS input pixels. The actual DN value used for HRS pixels will be denoted in the print.prt file as well as displayed onscreen.
Type boolean
Default false

Stretch Options

This parameter is used to select one of three ways to stretch (or map) the input pixels. They are NONE, LINEAR, or MANUAL.
Type string
Default NONE
Option List:
Option Brief Description
NONE No stretch No stretch is performed.

Exclusions

  • MINIMUM
  • MAXIMUM
  • MINPERCENT
  • MAXPERCENT
LINEAR Linear stretch A minimum and maximum are automatically computed based on the statistics of the selected input band. A histogram of the band is used to pick the minimum at 0.5% of the data and the maximum at 99.5% of the data. Input pixels less than or equal to the minimum are stretched to black while pixels greater than the or equal to the maximum are stretched to white. A linear mapping occurs between the minimum and maximum.

Exclusions

  • MINIMUM
  • MAXIMUM
MANUAL Manual stretch This option allows you to pick your own stretch. You must enter a value for MINIMUM and MAXIMUM input pixel.

Exclusions

  • MINPERCENT
  • MAXPERCENT

Inclusions

  • MINIMUM
  • MAXIMUM

The minimum input pixel value which will be mapped to black.
Type double
Less Than MAXIMUM

The maximum input pixel value which will be mapped to white.
Type double
Greater Than MINIMUM

The percentage of data in the histogram used to compute the minimum pixel value in the stretch.
Type double
Default 0.5
Less Than MAXPERCENT

The percentage of data in the histogram used to compute the maximum pixel value in the stretch.
Type double
Default 99.5
Greater Than MINPERCENT

Output Data Storage Order

This parameter is used to select one whether the output will be streamed starting with the most significant byte (MSB) or starting with the least significant bytes (LSB). The choice should be made by the user depending upon the format read by the system architecture from which they plan to read the raw data.
Type string
Default LSB
Option List:
Option Brief Description
LSBLeast significant byte The least significant byte will be the first byte output.
MSBMost significant byte The most significant byte will be the first byte output.

Special Keyword

This parameter allows the user to specify the value of the standard PDS keyword NOTE within the output PDS label. This keyword will be located in the Root of the PDS PVL label.
Type string
Internal Default None

Example 1

Export Level 1 cube to 32-bit PDS

This example shows a typical conversion of an Isis Lunar Orbiter cube to a PDS format image. The default settings produce 32-bit data with least significant byte first order.

Command Line

In this example, lopdsgen will convert a cube to a pds format image with all settings left at their defaults.
lopdsgen from=lev1.cub to=lev1.pds.img

GUI Screenshot

lopdsgen gui

Example GUI

lopdsgen gui

Screenshot of GUI with parameters set to export a level1 LO cube to a PDS image.

Input Image

lev1.cub

Input cube for lopdsgen

lev1.cub

Parameter Name: FROM

This is an Isis cube, specifically a level 1 LO product, that will be exported to a standard PDS format image.

Data Files

Links open in a new window.
Click here for the labels of the input image This PVL contains the labels of the Isis, level 1 LO input image that will be exported to a PDS.
Click here for the labels of the output image This PVL contains the labels of the PDS format image that has been generated from an Isis, level 1 LO cube.

Output Image

lev1.pds.img

Output pds image from lopdsgen

lev1.pds.img

Parameter Name: TO

This is a PDS format image that has been produced by exporting the input Isis, level 1 LO cube with default settings.