Image viewer measurement tools

MERApplies to the
MER AN
MSLApplies to the
MSL AN

The Image viewer includes tools for finding locations in an image, as well as making measurements and viewing elevation profiles. Measurement tools are available only for images with associated XYZ data. Currently, only some MSL Hazcam and Navcam and MER Hazcam, Navcam, and Pancam images fall into this category.

There are three measurement tools available as described below. Select a tool from the Measure menu in the controls toolbar. Instructions for using the tool appear above the image.

Location tool

Use this tool to find location information for individual pixels in the image.

Measurements include:

  • Location number - used to label the point on the image
  • Image pixel coordinate in i,j space (lines, samples), with the origin at 0,0 in the upper left corner
  • Ground location in x,y,z space in meters in local, rover, or site frame. Values are given in meters.
  • The distance from the point to the rover, in meters.
  • The azimuth and elevation, in degrees. For MER, these values are relative to the PMA head frame. For MSL, these values are relative to the RSM head frame.

You can set the style of a location by clicking on the settings icon in the Location list.

Delete a location measurement by clicking the corresponding delete icon in the location list.

Distance tool

Use this tool to find distance information between two locations. A distance measurement is made of one or more contiguous segments (a polyline) that is defined by left-clicking on vertices of a polyline. After selecting at least two points, right click to complete the polyline.

Measurements include:

  • Distance number - used to group one or more segments that comprise the measurement
  • Segment number - individual segment within a polyline
  • From/to location numbers - reference to the labeled locations along the polyline; numbers match entries in the location table
  • Distance between locations, in meters
  • Compass bearing from the first to second location in the segment in site frame, in degrees
  • Average slope from the first to second location in the segment, in degrees

By default, the distance between locations is displayed on the line. You can set the styles of distance measurements by clicking on the settings button () in the Distance list. Note that styles for the vertices are set in Locations settings.

Delete a distance measurement by clicking the corresponding delete icon () in the Distance list.

Profile tool

Use this tool to find the elevation profile between two locations. A profile measurement is made of one or more contiguous segments (a polyline) that is defined by left-clicking on vertices of a polyline. After selecting at least two points, right click to complete the polyline. Measurements listed are the same as described for the Distance tool above.

A graph of the profile is displayed after it is defined. There is one graph for all segments a given profile. Click on the graph icon () at the right side of the profile table to the graph for a different profile.

The profile calculated returns the elevations along a path as if it were "dropped on the ground" between the two points. The profile is not simply the elevation values of the image pixels under the line drawn on the image.

By default, the distance between locations is displayed on the line drawn on the image between the vertices. You can set the styles of the profile by clicking on the settings icon () in the profile list. Note that styles for the vertices are set in Locations settings.

Delete a profile by clicking the corresponding delete icon () in the Profile list.

XYZ mask overlay

When viewing a single frame image with XYZ data, an XYZ mask is overlaid on the image when a measurement tool is selected. The purple shaded portions of the mask represent areas without XYZ data. The mask can be toggled off and on from the Measure menu.

The archived XYZ data products are used as sources for measurements.

Saving measurements

Measurements are automatically saved when you create them. As long as you log in with the same account, your measurements will automatically be loaded the next time you open the Image viewer for the same image.

Downloading the results

Download the measurement data and annotated image from the File menu. See Downloading the results in the Image viewer topic.

Styles

Locations, distances, and profiles are drawn on the image as annotations that can be styled using the Settings button under each table in the controls area. In addition, styles for an individual measurement can be changed by clicking on the corresponding settings icon () in the measurement list.