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

thmproc

Printer Friendly View | TOC | Home

Runs a Themis cube through the processing for levels 0 and/or 2

Overview Parameters Example 1

Description

Runs Mars Odyssey Themis images through the applications necessary to create a map projected product. There are two stages of processing, ingestion and mapping (radiometric calibration is assumed as Themis RDRs are available). 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. Their names will be the name of the application appended to the original file name followed by a 6 digit unique number.

Categories

History

Stuart Sides2004-01-16 Original version
Jeff Anderson2004-02-26 Changed mocproc into thmproc
Jeff Anderson2004-03-01 Added Bands parameter and utilized IsisProcessExecutable class
Elizabeth Miller2005-12-08 Fixed bug in output file naming
Elizabeth Miller2005-12-15 Modified to output number of bands specified even when just doing ingestion
Elizabeth Miller2006-05-18 Modified UI and parameters to be consistent with changes made to spiceinit
Elizabeth Miller2006-07-25 Removed the AUTOLON parameter (no longer a parameter in cam2map)
Elizabeth Miller2006-09-08 Added support for the themisVis camera model
Brendan george2006-09-26 Documentation fixes
Elizabeth Miller2006-09-26 Fixed bug in PIXRES use caused by changes in cam2map
Steven Lambright2007-11-06 Added CKNADIR parameter for spiceinit.
Steven Lambright2008-06-13 Updated to use new themis vis functionality. Instead of the themis images being split into a framelet per cube, they are now split into even and odd cubes.
Steven Lambright2008-07-16 Updated to guarantee vis images have matching mapping groups, changed tempory file naming conventions, enabled thmvistrim on rdr files.
Steven Lambright2008-07-24 Updated to fix problem with BANDS parameter. Before, the bands option would sometimes cause an error incorrectly. Also fixed a case where the input file would be deleted.
Steven Lambright2008-07-28 Updated to fix problem with BANDS parameter with IR images. This parameter had a chance to not take effect.
Steven Lambright2008-08-04 Updated to use new pipeline class.
Jeannie Backer2014-08-22 Updated vis test truth data for the RDR cube due to a modified in the THEMIS VIS distortion map. Added vis test for EDR data with MAPPING=true. Added error test. Improved test coverage to 95/98/100%. References #1659.
Jeffrey Covington2015-01-27 Removed unreachable code.
Makayla Shepherd and Andrew Stebenne2015-07-14 Updated to fix a crash that occurs when invalid files are passed in as parameters. Fixes #1025.
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 21:48:40
X

Files: FROM

Description

Input filename. This file can be in one of two stages. A raw PDS Themis RDR or an ISIS Level 0/1 cube. The level 0/1 cube is assumed to have been run through thm2isis and spiceinit.

Type filename
File Mode input
Filter *.QUB *.imq *.img *.cub
Close Window
X

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 = "lev1" or MAPPING = "lev2"). For ThemisVIS images, if processing is stopped at the ingestion phase, there will be an output cube for each frame in the image, with a ".frame#" appended to the end of the filename.

Type cube
File Mode output
Internal Default Automatic
Close Window
X

Files: BANDS

Description

This parameter allows the user to specify a sub-set of bands to process. Enter bands separated by commas (no spaces allowed). For example, 1,3,8 or 1-3,9 or 5

Type string
Internal Default All
Close Window
X

Files: REMOVE

Description

This option allows the user to decide whether the intermediate files created in the thmproc application are to be deleted. The default value is TRUE.

Type boolean
Default TRUE
Close Window
X

Level Processing: Ingestion

Description

Process the input file through all steps. This includes "thm2isis" and "spiceinit"

Type boolean
Default YES
Inclusions
  • PCK
  • CK
  • SPK
  • SHAPE
  • CKNADIR
Close Window
X

Level Processing: Mapping

Description

Process the input file through level2. This includes cam2map.

Type boolean
Default YES
Inclusions
  • MAP
  • PIXRES
Close Window
X

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
Close Window
X

Ingestion Parameters: CK

Description

Naif kernel file to be used for the spacecraft pointing.

Type filename
File Mode input
Default Path $odyssey/kernels/ck/
Internal Default none
Inclusions
  • INGESTION
Close Window
X

Ingestion Parameters: SPK

Description

Naif kernel file to be used for the spacecraft position.

Type filename
File Mode input
Default Path $odyessy/kernels/spk/
Internal Default none
Inclusions
  • INGESTION
Close Window
X

Ingestion Parameters: CKNADIR

Description

Compute nadir pointing if no other kernels exist

Type boolean
Default false
Close Window
X

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
Close Window
X

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
Close Window
X

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
Internal Default Sinusoidal
Inclusions
  • MAPPING
Filter *.map
Close Window
X

Mapping parameters: PIXRES

Description

Specifies the resolution in meters per pixel. If not in the MAP file the resolution will be computed from the themis level 1 cube.

Type double
Internal Default Automatic
Minimum 0.0 (exclusive)
Inclusions
  • MAPPING
Close Window
X

Themis VIS Parameters: VISCLEANUP

Description

thmvistrim removes the overlap between framelets, which often contains both valid and invalid data. Set this to false to preserve this data. thmvisflat applies a flat-field correction to the data.

Type boolean
Default true
Close Window