Mars Pathfinder Rover Camera MIDR Dataset Description


Table of Contents

Data Set Overview

Mars Pathfinder bounced down and rolled to a stop on the surface of Mars on July 4, 1997. After a slight delay in deployment due to airbags draped over one of the lander's petals, the Rover rolled down onto the surface of Mars at 5:37am, July 6, 1997 (UTC).

627 images were collected by the three cameras mounted on the Microrover Flight Experiment (also known as the Mars Pathfinder Rover or Sojourner). The rover had two monochromatic cameras mounted in front which provided stereo viewing, and a separate 'color' camera mounted in the rear. The rear camera obtained color pictures through the use of red, green, and blue pixels arranged in a 'field-staggered 3G' mosaic filter pattern on the CCD.

The Rover Camera MIDR data set is composed of four different kinds of products: uncorrected black and white mosaics, uncorrected color mosaics, CAHV-corrected color mosaics, and stereo anaglyphs. The 'uncorrected' mosaics have had some limited radiometric corrections applied to them but no geometric corrections. The CAHV-corrected mosaics have had both corrections applied.

Parameters

The Rover Camera MIDRs are images; the main parameter is light, measured in units of data numbers or DNs. Each CCD pixel (picture element) is represented by a byte value ranging from 0 (dark) to 255 (saturated). The wavelength sensitivity of the front (black and white) cameras was 830 to 890 nm; the aft (color) camera sensitivity was 500 to 900 nm. Since the MIDRs combine multiple EDRs acquired at varying light levels and exposure durations, the MIDR pixels can have light levels greater than 255. (See the more detailed explanation in the 'Processing' section below.)

Processing

The input products used to generate the Rover Camera Mosaicked Image Data Records (MIDRs) were the Rover Camera Experiment Data Records (EDRs), (data set id MPFR-M-RVRCAM-2-EDR-V1.0), also archived on this CD. The identity of individual EDRs used as input to a specific MIDR can be determined using the COMMAND_SEQUENCE_NUMBER item in the PDS label of each MIDR.

The Rover Camera MIDRs consist of the reconstruction of multiple subframes acquired at approximately the same time, from the same physical location. In other words, there was no movement of the rover between subframes; there were radiometric but no spatial changes from one subframe to another. The purpose of subframing was to optimize the exposure times in different portions of a reconstructed image, while utilizing the full dynamic range of the CCD. For example, the top half of a Rover image may have received significantly more light than the shadowed lower half, and would therefore benefit from a shorter exposure time.

The lowest level MIDR products are the black and white uncorrected mosaics. These products were created using the VICAR (Video Image Communication and Retrieval) program MPFRVRMOS. MPFRVRMOS mosaicked multiple rover subframes from one image. It applied rudimentary dark current and exposure corrections to the mosaic. It did this first by subtracting a dark level from the DN values of all component frames. (This value is indicated by the DARK_LEVEL_CORRECTION keyword in the labels.) It then synthetically generated an 'output' exposure duration equal to the longest exposure duration of any input subframe. It equalized the exposures of the various subframes by multiplying the DN values in each input frame by the ratio of the synthetically generated exposure duration over the input exposure duration. The entire DN range of every input frame was retained by converting the byte data to half word data at this stage. Finally, the program applied a dark current correction to the mosaic. This could be done in one of two ways indicated by the DARK_CURRENT_CORRECTION_TYPE keyword in the PDS labels. The valid types of correction were PRIME and BOTH; PRIME applied only a vertical correction on the front camera images, or only a horizontal correction on the rear camera images. BOTH meant that both a vertical and a horizontal correction were applied.

The products generated by this process were the '.HAF' images in the RVR_MIDR/RVR_MOS/ directory. These images were then converted back to byte data using the VICAR program CFORM. This resulted in the '.IMG' images in the same directory.

The next level of MIDR products are the color uncorrected mosaics, produced from EDRs acquired by the rear rover camera. These products were essentially created through the same process as the black and white mosaics, except that after the mosaic had been radiometrically corrected, it was run through the program MPFRVRCLR, which generated three separate color bands from the single input band. (In one case only, for image RVR_MIDR_CLR-1253414310-S076054-REAR-B, the image was split into three separate bands before being radiometrically corrected.) As described elsewhere (see RCRRINST.CAT on this CD), the rear camera CCD contained pixels sensitive to different wavelengths of light, enabling it to obtain a 'color' picture with a single exposure. This single band was split up by using a color map, and applying bilinear spatial interpolation to fill in the 'missing' pixels.

This step of the process also resulted in both half word and byte data files, stored in the directory RVR_MIDR/RVR_CLR/ on the CD. (Technically, since the CFORM program only worked on single-banded files, the images were split into three separate red, green, and blue files using COPY, converted to byte using CFORM, and recombined into a single file using MPFCOMBO.)

The next step of process involved the application of a geometric correction to the mosaics using the CAHV camera model. This step was applied to both the black and white and the color mosaics. The half word data files were used as input. This step was accomplished using the VICAR program MPFCAHV. This program converted the images from distorted (CAHVOR) to linear (CAHV) coordinates. The coordinates of each pixel in the output image were transferred from CAHV to CAHVOR space. If the pixel fell within the input image, its DN value was bilinearly interpolated and placed within the output image. A full output image was created even if the input image was only a subframe. The output image was converted to byte data by the MPFCAHV program. These images are stored in the RVR_MIDR/RVR_CAHV/ directory on the CD.

All of the above products were generated at the Multimission Imaging Processing Laboratory, at the Jet Propulsion Laboratory. The highest level of MIDR products, the stereo anaglyphs, were generated by the Microrover Flight Experiment Team, also at JPL.

The Sojourner Rover anaglyphs were created using the left and right images captured by the rover on Mars. The following text, provided by Tam Nguyen of the MFEX Team, describes the conversion process which involved two platforms: a Sun Sparc20 and a Mac PowerPC.

  1. The Sun Sparc20 process:

    1. The input left and right images had been previously camera corrected by MIPL, applying the CAHV camera model.

    2. These CAHV image files were then converted to PIC format using the 'cahv2pic' command (developed by Todd Litwin for the Mars Pathfinder Project). The 'fisheye' warping effect caused by the rover cameras' wide angle lenses was corrected using the 'dowarp' command (also developed by Todd Litwin).

    3. The unwarped images were then converted to GIF format using the 'pic2gif' command (again developed by Todd Litwin) for compatibility with Adobe PhotoShop format constraints.

  2. The Mac PowerPC process:

    The creation of the rover anaglyph was performed using the Adobe PhotoShop Version 3.0 program on a Mac PowerPC, employing the following steps:

    1. A pair of left and right rover images in GIF format were opened. The right image was converted to RGB format by selecting 'Mode: RGB image'.

    2. The 'FrameImage' (a dashed box) in the top left corner Tool palmlet was selected, then used to frame the left image by holding down the left mouse button and dragging the mouse to identify the selected area of the image.

    3. The 'Edit: Copy' menu item was selected to copy the selected image to a buffer.

    4. The right image was selected by clicking on it.

    5. The Layers/Channels/Paths palmlet was opened by selecting 'Windows: Show Channels'.

    6. The 'Channels' option in the Layers/Channels/Paths palmlet was selected, then the 'Red' channel only was selected (identified by an eye in the left hand side box). The 'Edit: Paste' command was used to paste the left image (in the buffer) into the 'Red' channel of the right image.

    7. The 'Green' and 'Blue' channels of the Layers/Channels/Paths palmlet, identified by the eyes in the left hand side boxes, were selected to bring the green and blue colors of the right image back.

    8. Wearing red and blue stereo viewing goggles, the 'Move' icon (a hand in the top left corner of the Tool palmlet) was selected. The arrow cursor then became a hand cursor. The cursor was moved into the selected red image area, then the left mouse button was held down. The red image was dragged until the anaglyph showed the desired results, then the left mouse button was released.

    9. The 'FrameImage' feature was used to eliminate the unwanted area of the anaglyph, and then the image was saved.

The anaglyph PDS labels were created using the PDS information from the CAHV files. The 'cahvlbl' command (developed by Todd Litwin) extracted the PDS information from the CAHV files, which was then converted into the correct PDS format using the 'greppds' command (developed in the Tcl language by Tam Nguyen for the Mars Pathfinder Project).

Since the process of creating an anaglyph required the left and right images, the PDS label of an anaglyph could contain the information from either the left or the right image, but not both. The unwarping and anaglyph creation processes resulted in anaglyphs with image sizes smaller than their original images. The rover camera models of all of the pds labels were the same.

The anaglyph creation technique described above was developed by Tim Parker for the Mars Pathfinder Project.

Data

The Rover images on this CD are uncompressed, 8- and 16-bit files, labeled in conformance with PDS standards. Both black and white and color images are present in the data set. The color images are stored as three separate bands in a single file.

The Rover Camera MIDRs are contained in the RVR_MIDR/ directory on the CD. The uncorrected black and white mosaics are stored in the RVR_MIDR/RVR_MOS/ subdirectory, the uncorrected color mosaics are stored in the RVR_MIDR/RVR_CLR/ subdirectory, the CAHV-corrected mosaics are stored in the RVR_MIDR/RVR_CAHV/ subdirectory, and the stereo anaglyphs are stored in the RVR_MIDR/RVR_GLYF/ subdirectory.

Individual filenames consist of the instrument identifier 'R', followed by a five digit command sequence number, followed by a single letter, used as a counter. The command sequence number used in each mosaic filename is the lowest of the command sequence numbers from the input EDRs which make up that mosaic. (For the stereo anaglyphs, this is the lowest of the EDRs in the RIGHT frame.) The counter is used to distinguish between multiple mosaics which have identical command sequence numbers. (The only time this occurs is for command sequence '0', used when the rover acquired images autonomously while in an emergency mode, and for command sequence numbers in the 55xx range, which were erroneously repeated.)

For all but the anaglyph images, the filename then contains one of 'L', 'C', or 'R', indicating a LEFT, RIGHT, or COLOR image. (The anaglyphs, obviously, are combinations of both LEFT and RIGHT images.)

Finally, this is followed by one of the two file extensions, '.IMG' or '.HAF'. The '.IMG' extension is used for byte (8-bit) data, and the '.HAF' extension is used for half-word (16-bit) data.

Note that the Rover Team delivered the stereo anaglyphs with different filenames that what have been used on the CD. The files were renamed partly to comply with PDS file naming guidelines, and partly to provide correspondence between these images and the other MIDRs on the CD. A mapping between the old and new names is provided here for reference:

005101-BOTH.{jpg,pds} --> R05101A.{JPG,IMG}
05524A-BOTH.{jpg,pds} --> R05524A.{JPG,IMG}
05524B-BOTH.{jpg,pds} --> R05524B.{JPG,IMG}
14099-BOTH.{jpg,pds} --> R14094A.{JPG,IMG}
15130-BOTH.{jpg,pds} --> R15130A.{JPG,IMG}
24057-BOTH.{jpg,pds} --> R24057A.{JPG,IMG}
27093-BOTH.{jpg,pds} --> R27093A.{JPG,IMG}
32092-BOTH.{jpg,pds} --> R32092A.{JPG,IMG}
37082-BOTH.{jpg,pds} --> R37082A.{JPG,IMG}

(The JPEG versions of the above files have been placed in the BROWSE directory of the CD.)

The filenames can be used to correlate the different kinds of MIDRs. In other words, files in different directories of the CD which have identical filenames, are related. For example:

RVR_MOS/R24057AR.HAF - half-word version of uncorrected black and white mosaic of EDRs in the command sequence number range of 24057 - 24060
RVR_MOS/R24057AR.IMG - byte version of the same mosaic
RVR_CAHV/R24057AR.IMG - CAHV-corrected version of the same mosaic
RVR_GLYF/R24057A.IMG - stereo anaglyph version of the same mosaic; note that this RIGHT frame mosaic is combined with the LEFT frame mosaic of EDRs in the range of 24053 - 24056

(Note that there is NO correspondence between R00000AL.IMG and R00000AR.IMG.) For all of the MIDRs, the command sequence numbers of the input EDRs are included in the PDS label. These values can be used to backtrack to the raw products which make up a mosaic.

For all MIDRs, the SPACECRAFT_CLOCK_STOP_COUNT shown in the label is the SPACECRAFT_CLOCK_START_COUNT from the latest input EDR used in the mosaic.

Note that the EXPOSURE_DURATION used in the MIDR labels has a different meaning than that used in the EDR labels; it is a synthetically generated value as described above in the 'Processing' section.

Some of the keyword values shown in the labels of the anaglyph images are the values for the right frame of the mosaic; the values for the left frame are not included. (However, the COMMAND_SEQUENCE_NUMBER can be used to determine all the input EDRs, and therefore the missing values.)

The best way to identify rover images that can be used as stereo pairs is to find left and right images that have the same values for the ROVER_HEADING and ROVER_POSITION. The 'Flight Rover Image Status Report', put together by the Rover Team, may also be of assistance. This report is contained in the DOCUMENT/ROVERDOC/DOWNLINK/TABLIMAG.HTM file on this CD.

All image files are stored with a fixed length record format. There is an attached PDS label at the beginning of each image file that describes the content and format of the image. If the PDS label size is not an exact multiple of the file record length, padding is added after the end of the PDS label. Thus, the image object always starts on a record boundary.

PDS labels are object-oriented. The object to which the label refers (e.g., IMAGE, TABLE, etc.) is denoted by a statement of the form:

^object = location
in which the carat character ('^', also called a pointer in this context) indicates that the object starts at the given location. For an object in the same file as the label (as is the case for the Rover MIDRs), the location is an integer representing the starting record number of the object (the first record in the file is record 1). For example:

^IMAGE = 22
indicates that the IMAGE object begins at record 22 of the file.

A complete description of the PDS file format is available from the Planetary Data System. (Complete contact information for the PDS is available in the AAREADME file in the root directory of this CD.)

Coordinate Systems

The Rover heading and position are measured in the Martian Local Level coordinate frame. The heading is measured clockwise from north in units of BAMs (Binary Angle Measurements), where 216 BAMs equals one revolution. The position is provided as x and y offsets in meters north and east, respectively, of the Lander.

The Martian Local Level Coordinate Frame is a right handed, orthogonal, frame whose origin is co-incident with the origin of the Lander Coordinate Frame. The XM axis points north, the YM axis points east, and the ZM axis points down. This system is defined relative to the Mars areocentric coordinate system.

For more information on Mars Pathfinder coordinate systems, see the [MELLSTROM&LAU1996], [WELLMAN1996B], and [VAUGHAN1995] references.

Software

The Rover MIDR images can be displayed on UNIX, Macintosh, and PC platforms using the PDS developed program, NASAView. This software is freely available from the PDS Central Node and may be obtained from their web site at http://pds.jpl.nasa.gov/. For more information or help in obtaining the software, contact the PDS operator at the following address:

Address: Planetary Data System, PDS Operator
Jet Propulsion Laboratory
4800 Oak Grove Drive
Pasadena, CA 91109
Phone: (818) 354-4321
Email: pds_operator@jpl.nasa.gov
WWW URL: http://pds.jpl.nasa.gov/

The real time processing of the VICAR-formatted Rover data was done using the VICAR suite of image processing programs. The latest version of the VICAR program XVD may also be used for displaying PDS formatted images. For information on obtaining VICAR, please contact:

Address: Danika Jensen
M/S 168-414
Jet Propulsion Laboratory
4800 Oak Grove Drive
Pasadena, CA 91109
Phone: (818) 354-6269
Email: Danika.Jensen@jpl.nasa.gov
WWW URL: http://www-mipl.jpl.nasa.gov/vicar.html

Media / Format

The Rover Camera MIDR data are stored on compact disc-read only memory (CD-ROM) media. The CD is formatted according to ISO-9660 and PDS standards. The data files do not include extended attribute records (XARs), and are therefore not readable on some older VMS operating systems.

Confidence Level Overview

Since the cameras were not adequately calibrated, some dark current and dark level corrections were done for a 'best appearance', rather for strict scientific purposes, although attempts to minimize data loss were important in the process.

Review

Prior to release, the data will be reviewed by the Rover instrument team and the Planetary Data System.

Data Coverage and Quality

Given that these products were generated from the Rover Camera EDRs, all quality issues affecting the EDRs were inherited by the MIDRs. Most noticeably, the products with command sequence numbers 45054, 49083, and 75077 are all missing values in their labels, since those values were not present in the EDR labels. Full details are provided in the ERRATA.TXT file in the root directory of this CD.

Related Information

Mission

Mars Pathfinder

Instrument Host

Mars Pathfinder Rover (Microrover Flight Experiment)

Instrument

Alpha Proton X-ray Spectrometer
Rover Cameras

Target

PDS Welcome to the Planets: Mars
PDS High Level Catalog: Mars

References

GOLOMBEKETAL1997B
MATIJEVIC1994
MATIJEVICETAL1997A
MATIJEVICETAL1997B
MELLSTROM&LAU1996
WELLMAN1996B
VAUGHAN1995