Official websites use .gov
A .gov website belongs to an official government organization in the United States.

Secure .gov websites use HTTPS
A lock ( ) or https:// means you’ve safely connected to the .gov website. Share sensitive information only on official, secure websites.

ISIS Documentation

map2cam

Convert map projected image to a raw camera image

This program will geometrically transform a map projected image (ISIS level2 cube or mosaic) into an ISIS level1 cube using a level1 cube as input to match. This allows for example a Viking base map to be converted to a MOC raw geometry image.

The main purpose of this program is to facilitate control point selection between a level1 cube and a base map. The MATCH image and the resulting TO file can be opened in the program qnet along with other level1 cubes for building a control network with ties to ground.

Categories

Related Applications to Previous Versions of ISIS

This program replaces the following applications existing in previous versions of ISIS:
  • lev2tolev1
  • base2l1
  • base

History

Kay Edwards1987-09-02 Original version
Jeff Anderson2003-06-06 Converted to Isis 3.0
Jacob Danton2005-12-05 Fixed a bug in BandChange, added appTest
Elizabeth Miller2006-03-23 Fixed appTest to reflect changes made to all camera models
Steven Lambright2006-06-22 Fixed typo in user documentation
Steven Lambright2008-05-13 Removed references to CubeInfo
Lynn Weller and Debbie A. Cook2012-01-17 Updated documentation text, added glossary links, and improved compatability with Isis documentation.
Travis Addair2012-04-23 SPICE tables are now propagated from the MATCH cube to the output.
Debbie A. Cook2012-12-06 Changed to use TProjection instead of Projection. References #775
Steven Lambright2013-02-12 Fixed an issue that caused this program to trim output images erroneously. This problem, and the recommended solution, was provided by Jeff Anderson. Fixes #984.

Parameters

Files

The specification of the input cube to be projected. The cube must contain a valid Mapping group in the labels.
Type cube
File Mode input
Filter *.cub

This cube defines the raw instrument geometry to be matched. The output file will have the same labels (Kernels and Instrument group). Note the Band group will represent data from the raw camera and the content of the cube may not match. For example, using the MOLA base as the FROM file and a MOC Wide Angle Red cube as the MATCH, will have labels which indicate geometry for the MOC WA red camera but the pixels will contain MOLA elevations.
Type cube
File Mode input
Filter *.cub

This cube will contain data whose geometric properties are identical to those of the MATCH cube.
Type cube
File Mode output
Filter *.cub

Options

This is the type of interpolation to be performed on the input.
Type string
Default CUBICCONVOLUTION
Option List:
Option Brief Description
NEARESTNEIGHBORNearest Neighbor Each output pixel will be set to the pixel nearest the calculated input pixel.
BILINEARBi-Linear interpolation Each output pixel will be set to the value calculated by a bi-linear interpolation of the calculated input pixel.
CUBICCONVOLUTIONCubic Convolution interpolation Each output pixel will be set to the value calculated by a cubic convolution interpolation of the calculated input pixel.

Example 1

Typical usage

In this example, the map2cam application is used to map a base map into the same geometry as the matching Messenger level 1 image. The output file can then be used to select control points. Sometimes matching features can be found easier when features when a comparing level 1 image to another level 1 image.

Command Line

This is what to type to run this example in command line mode.
map2cam from=M10_Equi_1000meters_Clon180.cub match=EN0108821402M.cal.cub to=M10_match_EN0108821402M.cub interp=CUBICCONVOLUTION

GUI Screenshot

Example GUI

Screen shot of GUI with parameters filled in to create a level 1 version of a base map for selecting control in a Messenger image.

Input Images

Basemap image from Mariner 10

Input level 2 image (map)

Basemap image from Mariner 10

Parameter Name: FROM

This is the image that will be mapped into a level 1 image using the geometry of the MATCH image.

Messenger image to match

Image to match

Messenger image to match

Parameter Name: MATCH

The geometry of this image will be used to create the level 1 version of the FROM image, which will be output as the TO image.

Output Image

Mariner 10 basemap mapped into Messenger level 1 space

Output image

Mariner 10 basemap mapped into Messenger level 1 space

Parameter Name: TO

The level 1 version of the FROM image