Home

User Documentation

Getting Started
Learn More
Explore in Detail
Get Inspired

Contributor Documentation

Getting Started
Learn More
Explore in Detail
Get Inspired

Quick Links

Software Manual
AstroDiscuss
GitHub
API Reference

Documentation Versions

Latest Release
Dev
8.3.0
8.2.0
8.1.0
8.0.0
7.2.0
7.1.0
7.0.0
6.0.0
3.9.0
3.5.0

ISIS 2

Documentation
Tutorials
Technical Documents
USGS

ISIS Application Documentation

mocproc

Standard View | TOC | Home

Processes a MOC image through Levels 0, 1, and/or 2

Description
Categories
Groups
History

Description

Runs Mars Global Surveyer, Mars Obital Camera (MGS/MOC) images through the applications necessary to create a map projected product. There are three stages of processing, ingestion, calibration, and mapping. Each stage can be disabled and runs all the programs necessary to complete that stage if not disabled.

All intermediate files will be generated in the users Isis temporary directory and deleted after they are no longer needed. In case of a catastrophic failure the intermediate files should be deleted.

Categories

Parameter Groups

Files

Name Description
FROM Input MOC EDR, Level0, or Level1 image file
TO Final output filename.

Level Processing

Name Description
Ingestion Import and initialize a moc EDR or RDR file.
Calibration Process the input file through the calibration phase.
Mapping Process the input file through the map phase.

Ingestion Parameters

Name Description
PCK User defined target attitude and shape kernel file.
CK User defined spacecraft pointing kernel file.
SPK User defined spacecraaft position kernel file.
CKNADIR Compute nadir pointing if no other kernels exist
SHAPE Select the definition of the shape model for spiceinit
MODEL User defined ISIS cube shape model.

Mapping parameters

Name Description
MAP File containing mapping parameters
PIXRESPixel resolution in meters

Files: FROM

Description

Input filename. This file can be in one of four stages. A compressed PDS formatted MOC EDR, an uncompressed PDS formatted MOC EDR, a Level0 Isis cube with a complete kernels group in its label, or a Level1 radiometriclly calibrated Isis cube.

Type filename
File Mode input
Filter *.imq *.img

Files: TO

Description

Output filename from the last enabled processing sequence. By default the filename will be generated from the input filename with ".lev#" appended to the name, where "#" is the last level of processing (i.e., INGESTION = "lev0", CALIBRATION = "lev1", or MAPPING = "lev2").

Type filename
File Mode output
Internal Default Automatic

Level Processing: Ingestion

Description

Process the input file through all level0 steps. This includes "moc2isis" and " spiceinit". "moc2isis" will uncompress a compressed EDR automatically.

Type boolean
Default YES
Inclusions
  • PCK
  • CK
  • SPK
  • SHAPE
  • CKNADIR

Level Processing: Calibration

Description

Process the input file through level1. This includes moccal, mocnoise50, and mocevenodd,

Type boolean
Default YES

Level Processing: Mapping

Description

Process the input file through level2. This include cam2map.

Type boolean
Default YES
Inclusions
  • MAP
  • PIXRES

Ingestion Parameters: PCK

Description

Naif kernel file to be used for the target attitude and shape.

Type filename
File Mode input
Default Path $BASE/kernels/pck/
Internal Default none
Inclusions
  • Ingestion

Ingestion Parameters: CK

Description

Naif kernel file to be used for the spacecraft pointing.

Type filename
File Mode input
Default Path $MGS/kernels/ck/
Internal Default none
Inclusions
  • Ingestion

Ingestion Parameters: SPK

Description

Naif kernel file to be used for the spacecraft position.

Type filename
File Mode input
Default Path $MGS/kernels/spk/
Internal Default none
Inclusions
  • Ingestion

Ingestion Parameters: CKNADIR

Description

Compute nadir pointing if no other kernels exist

Type boolean
Default false

Ingestion Parameters: SHAPE

Description

ISIS camera models can use a shape model (a projected ISIS cube that defines the radii for a global or regional area). You can choose to select a shape model or to use the definition of the ellipsoid found in the planetary constants (PCK) file.

Type string
Default SYSTEM
Option List:
Option Brief Description
ELLIPSOIDUse triiaxial ellipsoid from PCK The camera will use the radii defined in the planetary constants file (PCK) when determining intersections of the body surface

Exclusions

  • MODEL
SYSTEMSearch system for a default shape model This option will search the default system data area ($ISISDATA/base/dems) for a shape model that matches the target of the input cube. If none are found then no shape model will be used and the default ellipsoid parameters found in the planetary constants (PCK) file define the shape.

Exclusions

  • MODEL
USERUser specified shape model file The camera will use shape model defined by the parameter MODEL
Inclusions
  • Ingestion

Ingestion Parameters: MODEL

Description

A map projected ISIS cube which contains the radii of the target. The file can cover more than the input cube (FROM) but must minimally cover the data in the input cube.

Type cube
File Mode input
Default Path $base/dems/
Filter *.cub

Mapping parameters: MAP

Description

A file containing the desired output mapping parameters in PVL form. This file can be a simple hand produced label file. It can also be an existing cube label which contains a Mapping group.

Type filename
File Mode input
Internal Default Sinusoidal
Inclusions
  • Mapping
Filter *.map

Mapping parameters: PIXRES

Description

Specifies the resolution in meters per pixel. If not entered the resolution will be obtained from the MAP file. If not in the MAP file the resolution will be computed from the input camera cube.

Type double
Internal Default Automatic
Minimum 0.0 (exclusive)
Inclusions
  • Mapping

History

Eric Eliason2001-01-01 Original version
Stuart Sides2004-01-16 Converted from Perl to C++ for conversion to Isis 3.0
Jeff Anderson2004-02-27 Added extra error messages
Jeff Anderson2004-03-01 Made use of the IsisProcessExecutable class
Jacob Danton2006-02-08 Fixed a filename bug that occured with the no mapping option and crosstrackSumming not equal to 1.
Elizabeth Miller2006-05-18 Fixed UI and parameters to be consistent with changes made to spiceinit
Elizabeth Miller2006-07-25 Removed the AUTOLON parameter (no longer an option in cam2map)
Brendan George2006-09-26 Documentation fixes
Elizabeth Miller2006-09-28 Fixed PIXRES handling issue caused by changes in cam2map
Steven Lambright2006-11-06 Added CKNADIR functionality
Steven Lambright2008-05-13 Removed references to CubeInfo
Steven Lambright2008-10-27 This program now uses the Pipeline class to accomplish its processing. The 'Map' parameter now actually accepts projected cubes, as the documentation specifies. In the past, an error would be thrown if a cube was specified. The 'Map' parameter is also now set to be an input, as it is not being modified. This program also ran "cam2map" with "DEFAULTRANGE=CAMERA," but is now using the default (MINIMIZE).
U.S. Department of the Interior | U.S. Geological Survey
ISIS | Privacy & Disclaimers | Astrogeology Research Program
To contact us, please post comments and questions on the USGS Astrogeology Discussion Board
To report a bug, or suggest a feature go to: ISIS Github
File Modified: 02/21/2025 20:05:58