Frequently Asked Questions (FAQ)

Getting Started

Starting JMARS manually

  1. To manually launch JMARS on a Linux machine, change to the directory containing the jmars.jar file (which you have already downloaded) and type:
> jmars 
  • If you would like to open JMARS from a different directory, just replace "jmars.jar" with "path/jmars.jar".

Starting JMARS with additional arguments

The startup behavior of JMARS can be modified by including additional command-line arguments. (Note: Only one of these command-line arguments can be used at a time.)

  1. Specify the Starting Position

By default, JMARS starts with the viewing window centered at 0E, 0N. This starting location can be changed by adding latitude and longitude arguments to the jmars command.

> jmars Longitude Latitude

  • Longitude - the value is assumed to be East longitude unless a "W" is used after the numerical value. (e.g., 120W)
  • Latitude - the value is assumed to be North latitude unless a "S" is used after the numerical value. (e.g., 120S)
  1. Starting with Session Files 

Session files allow users to restart JMARS in a previously saved configuration by specifying a startup file. See the Session Files page for more information.

> jmars path/session_file_name.jmars 


Starting JMARS with flags

The startup behavior of JMARS can also be modified by including any of the following command line flags. Unlike the command-line arguments described above, multiple command-line flags can be used at one time, and they can be used in conjunction with command-line arguments.

  1. Clean: The "clean" flag will clear out the map tile cache before startup.
  2. > jmars clean

  3. Slideshow: The "slideshow" flag will enable the JMARS slideshow mode. See the Slideshow Mode page for more information
  4. > jmars slideshow

  5. Version: The "-version" flag (with lower case v) will list some information about the JMARS version being used. The "-Version" (with upper case V) flag will list much more detailed information about the JMARS version being used.
  6. > jmars -version

    > jmars -Version

  7. Help: The "-help" flag will list the available command-line arguments and flags in the terminal window.
  8. > jmars -help

If you have additional problems with the Linux Installer, please contact the JMARS team.

JMARS functionality allows users to send diagnostic information to the JMARS team. This information can be helpful in finding, understanding and replicating an issue that the user is seeing. The user also has the opportunity to send any useful information about the issue such as steps to re-create the problem. This functionality may also be used to send general JMARS questions to the team.

To send a help request from within JMARS:

    • Select Help -> Report a Problem (shortcut key combination is "alt + h" to get help menu, then "r" to bring up the "Report a Problem" dialog)
    • Enter your email address in the "Email Address" text input field
    • Enter any relevant information, questions, steps to re-create the issue, etc., in the "How to Recreate the Problem" input text area
    • Click the "Send" button

The JMARS team will receive and process your help report.


The following is not for users who are currently using JMARS version 3.0.0 or newer


Windows Firewall issues


Trouble with Java WebStart and Comodo Firewall

When trying to launch JMARS, Java WebStart may return the error "splash recv failed".

Solution: Add Java WebStart to the list of authorized applications in the Comodo Firewall.


Ubuntu Java Installation

Find out if you have the IcedTea JRE or the Oracle JRE by executing java -version


If you have IcedTea you should see something like: me@ubuntu:~$ java -version java version "1.7.0_07" OpenJDK Runtime Environment (IcedTea7 2.3.2) (7u7-2.3.2a-0ubuntu0.12.04.1) OpenJDK 64-Bit Server VM (build 23.2-b09, mixed mode) If you have the Oracle JRE they should see something like: me@ubuntu:~$ java -version java version "1.7.0_09" Java(TM) SE Runtime Environment (build 1.7.0_09-b05) Java HotSpot(TM) 64-Bit Server VM (build 23.5-b02, mixed mode)

If you have the IcedTea JRE, you should install the Oracle generic Linux JRE

 

To install it, run the following commands:

  • sudo add-apt-repository ppa:webupd8team/java
  • sudo apt-get update
  • sudo apt-get install oracle-java7-installer

 

MacOS Java Installation

For MacOS 10.7 (Lion) and 10.8 (Mountain Lion), to install Java, follow the instructions on the Apple Lion/Mountain Lion Java website.

For MacOS 10.6 (Snow Leopard) or lower, Java may be included in the OS. If not, visit the Apple Snow Leopard website for help installing Java.

Windows Java Installation

To install Java, follow the instructions on the Oracle Java website.




If you have problems installing Java or running JMARS, please contact us by sending an email to help@jmars.mars.asu.edu

or

send us a message using our contact us page.

JMARS needs access to the following sites:

  • Port 80 access to *.mars.asu.edu, themis-data.asu.edu, jmars.asu.edu, ms.mars.asu.edu
  • Port 443 access to secure.mars.asu.edu

 


Privacy

The JMARS Web site is governed by the Arizona State University Privacy Policy, available at http://www.asu.edu/privacy.


Citation Policy

Acknowledgement of the JMARS site and its resources in your papers will help ensure the continuing support necessary to maintain, develop, and improve JMARS, including the addition of new datasets.

For news media or educational purposes, please credit images created through JMARS as: NASA/JPL-Caltech/Arizona State University.

If you use JMARS in a research work, please mention it in any relevant captions and put the following in your references: Christensen, P.R.; Engle, E.; Anwar, S.; Dickenshied, S.; Noss, D.; Gorelick, N.; Weiss-Malik, M.; JMARS – A Planetary GIS, http://adsabs.harvard.edu/abs/2009AGUFMIN22A..06C


Citation Page

If you have have cited JMARS and would like it added to the citation page please send your citation to mesmith@mars.asu.edu

Sometimes the Linux Installer is not executable after it is downloaded due to changes made by various virus scanners. To change this, open a terminal window and change to the directory where the installer was downloaded. Run the command:

>chmod 777 jmars-public_setup_linux 

Now you should be able to run the installer from either the terminal window or your desktop environment.

Map Layer

If you want the numeric value for a single location, do the following:

  1. Go to Advanced map
  2. Find the map you want to see single pixel values for and drag it to the 'Plots' area in the lower right.
  3. Expand the list of available maps and find one you want to see, drag it to the upper right area under 'Single', or change that combo box to 'None' if you don't want to see a map.
  4. Hit OK.
  5. Hover the mouse over the point of interest in the map, and wait there; a tooltip will come up to show you the values for all Plot maps at that position.

Other pages that you may be interested in

Advanced Custom Map Tutorial

Sometimes custom maps load with the background black (not transparent) due to the range of values used in the custom map data. To display the map with the background transparent:

    • In the Layer Manager, delete the custom map.
    • Reload the custom map as before, but in the upload box type "0" (zero) in the ignore field.
    • Continue opening the map as normal.

Your custom map will now have the background set to transparent.

Shape Layer

Image:cratercrop.png

It is not possible to draw "doughnut" polygons with the JMARS shape layer, however, the same effect may be achieved by drawing the inner (yellow in example above) and outer polygons (orange) and then arranging the display order of your polygons. To arrange the display order, left click on the row with the polygon of interest and drag it up or down.

In the "Features" section of the Shape Layer focus panel, users can edit a particular field for multiple rows simultaneously by:

  1. Highlight the rows you want to edit.
  2. Right-click on the column you want to edit for the selected rows.
  3. Select "Edit Column of Selected Row"
  4. Enter either a value or text in the pop-up input window and click "Ok"
  5. All of the highlighted rows will reflect the change in the selected column.
Stamp Layer

Projected Brightness Temperature (IR-PBT) and De-correlation Stretch (IR-DCS) products must be processed for each THEMIS IR observation in order for all of the THEMIS Stamp Layer's new IR rendering options to work properly. As progress has been made generating these products, it has been discovered that the disk-space saving "Rectified" format originally applied to all projected products significantly compromises the quality of the images when viewed in JMars. Therefore, only the IR-GEO and the 4-Panel-DCS products will be saved in the RECTIFIED format, while all IR-PBT & IR-DCS images will be saved in FULL PROJECTION format.

The table below summarizes the current processing status by orbit range

Orbit Range Release Status PBT/DCS Processing Status PBT/DCS Format
816 - 2399 Team Access Nominal mapping should be available;

still validating that off-nadir images collected during these orbits are being handled appropriately

FULL PROJECTION
2400 - 5799 Public Completed FULL PROJECTION
5800 - 8599 Team Access In Validation FULL PROJECTION
8600 - 8699 Not Available Not Started (off-nadir) N/A
8700 - 24599 Team Access In Validation FULL PROJECTION
24600 - 26799 Team Access In Process FULL PROJECTION
26800 - 28999 Team Access Available, but will be revised for projection parameter change RECTIFIED
29000 - 34499 Public Completed FULL PROJECTION
34500 - present Team Access
Completed
New images available with standard weekly processing
FULL PROJECTION

Last Updated: 2010-Mar 26 12:00:00 MST


Definition of Processing Status Description:

  • Not Started: Processing of PBT and DCS data products has not yet begun for the given orbit range.
  • In Process: PBT and DCS are currently being processed for the given orbit range and will be available soon.
    • Any images visible in the THEMIS Stamp Layer should be considered incomplete and should not be used.
  • In Validation: PBT and DCS have been produced for the given orbit range and are being validated by the archivist.
    • Most images should be available in the THEMIS Stamp Layer and ready for use.
    • If you see any wacky images, please report the file-id to the archivist (Thanks!)
  • Completed: PBT and DCS products have been produced for the given orbit range and can be rendered in the THEMIS Stamp Layer.
  • Rectified / Full Projection: Products should be available in JMars in either format;
    • RECTIFIED format shows horizontal offsets (at zoom >= 512) which are corrected in FULL PROJECTION format

JMars THEMIS Stamp layer hint:

  • Observation --> Processing Stage --> D###
    • use to return images that have DCS band combinations available to be rendered in JMars
  • Observation --> Processing Stage --> DCS
    • use to return images that have the 4-Panel-DCS images appropriate for viewing in the Mars Image Explorer

In the Stamp Layer focus panel, click on the settings tab and then click on the "Customize Webbrowser..." button. A web browser preferences window will open. Users can either enter the path to their preferred browser or use the "Browse" button to manually located their preferred browser. Once the web browser has been chosen, click "OK" to make the change.

 

Image:browser_preference.png