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.
Native installations are available for supported platforms (i.e. Windows, Mac OSX). These installation programs setup the environment with necessary executables and libraries.
- Download marsviewer-install.zip containing the marsviewer-installer.exe installation executable.
- Once downloaded, double-click the .zip file to reveal the marsviewer-installer.exe installation executable.
- 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\’).
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.
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.
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).
- Download the Marsviewer DMG file.
- Once downloaded, the DMG file should be expanded. If not, then double-click on the file to expand it.
- 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.
To run, double-click the application icon.
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.
Run the marsviewer (for search and display)$ marsviewer.shor 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.
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.
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.
There are currently 3 mission/instruments with PDS archive data supported by PDS Marsviewer:
There are two basic categories of data that are available:
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.
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.
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.
|FL, FR||Front hazcam|
|RL, RR||Rear hazcam|
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:|
|Second character represents the instrument:|
|e||ecam (EDL camera)|
|[optional] For single-frame products, the 24th character indicates eye:|
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:|
|[optional] The 24th character indicates eye:|
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.
For more details on each of missions and their products produced, check out the Software Interface Specification (SIS) for each:
|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|
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:
Why does this happen? MacOSX has new application security that requires an application to belong to the App Store to be run and Marsviewer has yet to be released through the App Store.
Resolution: As admin user, allow this application to be run:
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.