PDS Marsviewer

The Mars Image Viewer (Marsviewer) is an image viewing tool tailored to Mars in-situ missions. It makes it easy to view original images (EDRs) as well as all derived image products (RDRs), such as XYZ maps, slope, reachability, mosaics, etc. Originally designed as a quality control tool for the MER image processing team, it sees wide use throughout the MER, MSL, and PHX ops and science teams (with InSight and Mars 2020 coming soon). Leveraging webification (w10n) on the backend, Marsviewer has now been extended to work with the PDS Imaging archive data.


Installation

Native installations are available for supported platforms (i.e. Windows, Mac OSX). These installation programs setup the environment with necessary executables and libraries.

Windows Windows (XP/Vista/Win7/Win8)


Installation:

  1. Download marsviewer-install.zip containing the marsviewer-installer.exe installation executable.


  2. Once downloaded, double-click the .zip file to reveal the marsviewer-installer.exe installation executable.
  3. Run the installation wizard, specifying the location to which the application suite will be installed on your computer.The default installation location is %PROGFILES%\JPL\Marsviewer\. (where %PROGFILES% should be replaced with the suitable ‘Program Files’ directory of your system).

    NOTE: If you received an error while attempting to write files to new directories, ensure that your account has appropriate permissions set for writing to that location. In Windows 7 and 8, you may try right clicking on the installer and selecting ‘Run as Administrator’. This allows the installation to create new directories in otherwise protected locations (i.e. ‘C:\Program Files\’).

Running application:

In that install directory you will find two executables ( marsviewer.exe and jadeviewer.exe). Double click on either to run the respective application. Marsviewer is used for browsing Mars images that reside on PDS servers. Jadeviewer is used for looking at a specific image data product on your computer.
windows start
Shortcuts: During the install process, there is an option to install shortcuts. If enabled, these shortcuts can be found on your Desktop and/or the Start Menu.

windows shortcuts

Note: You can also edit the shortcut properties to provide command line arguments for the application (i.e. set default file finder type and location).

Macosx Mac OSX


Installation:

  1. Download the Marsviewer DMG file.


  2. Once downloaded, the DMG file should be expanded. If not, then double-click on the file to expand it.
  3. Select and drop the Marsviewer (for search and display) and Jadeviewer (image viewer only) apps into your Applications folder. Marsviewer is used for browsing Mars images that reside on PDS servers. Jadeviewer is used for looking at a specific image data product on your computer.

Mac Install

Running application:

To run, double-click the application icon.

unix Unix/Linux


There is currently no native support for installing marsviewer applications on Unix and Linux platforms. Instead, configuration and launcher scripts are used via the command line. These files and the associated libraries are packaged in a .Tar and .Zip files.


Installation:

  1. Download the marsviewer.tar file:


  2. Create a deployment directory on your computer.
  3. Expand the archive into the new deployment directory.

Execution:

Run the marsviewer (for search and display)
$ marsviewer.sh
or jadeviewer (image viewer only) launcher.
$ jadeviewer.sh

Note: The launchers can be edited to include an initial file finder location and type if the same product repository is used regularly.

Getting Started

The following section includes a few video tutorials to help you get started. You can also check out the remaining sections below for more info on how to use Marsviewer, deciphering product listings, and what all those acronyms mean.

Tutorials

Using Marsviewer

When Marsviewer starts up, it asks you to select a File Finder. The easiest way is to use the Presets, which set up the file finder type and the correct server.

Mission and Instruments Supported

There are currently 3 mission/instruments with PDS archive data supported by PDS Marsviewer:

  • Mars Science Laboratory (MSL) ECAM
  • Mars Exploration Rovers (MER) Spirit and Opportunity
  • Phoenix
  • Mars Science Laboratory (MSL) MMM - Coming Soon

Categories Of Data

There are two basic categories of data that are available:

  • Single-frame products: This includes everything derived from a single image or stereo pair: imagery, XYZ, surface normal, etc.
  • Mosaics: More complex data products generated by the MIPL OPGS.

File Finder Presets

The Marsviewer file finder presets that appear when the application opens, allow access to various combinations of the above:

File Finder Name Description
Mars Science Laboratory ECam (single-frame products and mosaics) Includes all single-frame and mosaic products from the MSL Engineering Cameras.
Mars Science Laboratory ECam (single-frame products only) Includes only single-frame products from the MSL Engineering Cameras.
MER Opportunity (single-frame products and mosaics) Includes all single-frame and mosaic products from the MER Opportunity rover cameras.
MER Spirit (single-frame products and mosaics) Includes all single-frame and mosaic products from the MER Spirit rover cameras.
MER Opportunity (single-frame products only) Includes only single-frame products from the MER Opportunity rover cameras.
MER Spirit (single-frame products only) Includes only single-frame products from the MER Spirit rover cameras.
Phoenix Includes single-frame products from the Phoenix Lander.

Advanced users can select the 'Advanced' checkbox to view more detailed file finders options. While a greater set of file finder types might be available, only the ones with "PDS_W10N" in the name will work with our servers.


Product Listing

  • After you have selected a File Finder, and you get a main screen type a sol number in the Sol box and press Refresh List.
  • You should see a list of EDR's on the left panel. Select one to see it.
  • The tabs across the top then select the RDR to view, while the tabs on the left allow you to select left vs. right eye and thumbnail vs. full images.
  • If you hover over a tab with your mouse, a pop-up tooltip describes what the tab is.

If no EDR's show up, try a different sol; some actually had no imagery. If you still can't see anything, contact the Imaging Node for troubleshooting.

MSL

The following table details some tips to help determine the product type based on the filename prefix. For more information on the products, check out the MSL Camera SIS.

Prefix Camera
FL, FR Front hazcam
N_ Navcam mosaic
NA Navcam anaglyphs
NL, NR Navcam
RL, RR Rear hazcam

MER

The following table details some tips to help determine the product type based on the filename prefix. For more information on the products, check out the MER Camera SIS.

For single-frame and mosaic:
First character represent the specific MER rover, where:
1 opportunity
2 spirit
Second character represents the instrument:
e ecam (EDL camera)
p pancam
n navcam
f front-hazcam
r rear-hazcam
m microimager
[optional] For single-frame products, the 24th character indicates eye:
l Left
r Right
a Anaglyph
m Monoscopic
n None

Phoenix

The following table details some tips to help determine the product type and instrument based on the filename prefix. For more information on the products, check out the Phoenix Camera SIS.

First character represents the instrument:
o MECA-OM
r RAC
s SSI
[optional] The 24th character indicates eye:
l Left
r Right
a Anaglyph
m Monoscopic
n None

Note that EDRs are grouped; red letters in the filename show what letters are different among members of the group (generally, stereo images along with their thumbnails). The tabs on the left select different members of the group; hovering over the EDR shows the matching products. In particular, if the eye field is a red L, that indicates it is a stereo product.


Product Descriptions

For more details on each of missions and their products produced, check out the Software Interface Specification (SIS) for each:


Acronyms

Acronym Meaning Definition
ECAM Engineering Cameras A shorthand name for the engineering cameras on MSL
EDR Experiment Data Record Original image products without any processing
MMM MAHLI, Mastcam, and MARDI A shorthand name for the color science cameras on MSL
OPGS Operations Product Generation Subsystem The group at JPL on the MSL Project responsible for image and data product processing
RDR Reduced Data Record Products derived from EDRs via image processing techniques
SCLK Spacecraft Clock Time on the spacecraft clock in seconds
SIS Software Interface Specification Document that describes the data products
W10N Webification A protocol for serving data remotely over the web

FAQs

  • At startup, the error log shows "WARNING: Could not open/create prefs root node Software\JavaSoft\Prefs at root 0x80000002. Windows RegCreateKeyEx(...) returned error code 5." How do I resolve this?

    Why does this happen? Unfortunately, this problem is not currently solvable programmatically on the Windows OS. The Windows implementation of Marsviewer preferences uses the Windows registry. When instantiated, that implementation tries to access/create a system-wide entry in the table. If the user does not have Administrative access to the system, the system-wide attempt results in an warning message being printed by the Preferences underlying logger. There are 2 possible workarounds for this problem:

    Easiest Workaround: Run the application as Admin by right-clicking the app icon and selecting 'Run as administrator'. Note: This should only be required for first run of software. Also, see Installation and Getting Started sections above for video tutorials of how to complete installation.

    Other Workaround: Add the entry in the registry explicitly:

    • Go into your Start Menu and type regedit into the search field.
    • Navigate to the following path
      HKEY_LOCAL_MACHINE\Software\JavaSoft
    • Right click on the JavaSoft folder and click on New -> Key
    • Name the new key 'Prefs' and everything should work.

  • Why can't I see MSL Mastcam data? (or MAHLI, or MARDI)

    Due to the way MSL images from Mastcam, MAHLI, and MARDI are formatted in PDS, Marsviewer is currently unable to read them. We are working on the issue and expect to have it resolved soon.

Copyright 2015, by the California Institute of Technology. ALL RIGHTS RESERVED. United States Government Sponsorship acknowledged.