User Documentation

Getting Started
Learn More
Explore in Detail
Get Inspired

Contributor Documentation

Getting Started
Learn More
Explore in Detail
Get Inspired

Quick Links

Software Manual
API Reference

Documentation Versions


Technical Documents

ISIS Application Documentation


Printer Friendly View | TOC | Home

Import HRSC image

Overview Parameters Example 1


This program imports Mars Express HRSC files. This includes both the HRSC Stereo and the SRC instruments with procesing level of "1" or "2" (not "3"). The program populates all label keywords necessary to create the corresponding camera models.

For the stereo instrument there is always prefix data. The prefix data is collected and used to look for "gaps" aka missing lines. The line prefix data for HRSC files contain time and exposure duration for each line. We look for occurrences where the time + exposure duration is not equal to the next line's time to find missing lines. This program uses two passes, the first reads the PDS file into a cube, the second inserts lines where gaps were identified.

For the SRC instrument, this program reads the PDS file and converts it to an ISIS cube. The PDS file for the SRC instrument is much simpler than the stereo instrument files and requires no special processing.


Related Applications to Previous Versions of ISIS

This program replaces the following applications existing in previous versions of ISIS:
  • mex2isis.pl
  • readpfx


Steven Lambright2008-01-16 Original version
Christopher Austin2008-03-18 Checks if input file is rdr based on whether or not the input file has prefix data.
Steven Lambright2008-05-13 Removed references to CubeInfo
Steven Lambright2008-07-28 Updated to support the HRSC camera model. The Kernels group now has the IK code properly added, the summing keyword is propagated, the times table is now compressed into only having entries on time changes, and the times no longer have a 'Z' at the end of them once imported.
Adam Paquette2016-10-05 Updated the error messages thrown when hrsc2isis trys to ingest an image that is not an HRSC image, and when hrsc2isis trys to ingest a map projected image. Fixes #4259.
Stuart Sides2020-03-31 Added ability to read HRSC SRC images

Parameter Groups


Name Description
FROM Input HRSC Stereo or SRC Image
TO Output Isis cube

Files: FROM


Use this parameter to select the PDS filename. This file must contain the PDS labels, however the image data can be detached and will be automatically obtained from the PDS image pointer keyword. If the pointer is incorrect then use the IMAGE parameter to specify the file containing the binary image data.

Type filename
File Mode input
Filter *.lbl *.LBL *.img *.IMG
Close Window

Files: TO


Use this parameter to select the output filename

Type cube
File Mode output
Filter *.cub
Close Window

Example 1

Import an HRSC stereo instrument image with gaps


This example covers importing an HRSC stereo instrument image and shows what happens when gaps are found.

Command Line

hrsc2isis from=h0279_0000_re2.img to=h0279_0000_re2.cub
Run this program on "h0279_0000_re2.img"

Input Images

Input HRSC Image

This is the raw input image, not imported with this program

This image was imported with pds2isis and then exported with isis2std, in order to get a good idea of what the raw input image looks like.

Output HRSC Gap

Input discontinuity from this example

This is a zoomed in region of what will become a gap from this example. Notice the features aren't aligned in the middle of the image, as if there are missing lines.

Output Images

Output HRSC Image

Output image from this example

This is the output from this example. The large "black" areas are NULL lines where data was missing, according to the prefix data on the raw input image.

Output HRSC Gap

A gap from this example

This is a zoomed in region of a gap from this example. Notice the features on the top and bottom would not normally line up if the gap did not exist.