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


ISIS 2

Documentation
Tutorials
Technical Documents
USGS

ISIS Application Documentation


hicalproc

Standard View | TOC | Home

Generate radiometrically (cosmetic) corrected HiRISE Channel products.

Description
Categories
Groups
History


Description

Hicalproc is one of the pipelines in the list of HiROC pipelines. This pipeline is used to process images after the EDRs are produced. This pipeline generates radiometrically (cosmetic) corrected HiRISE Channel products. The input is a raw HiRISE channel image.The output will be a radiometrically corrected channel image. This procedure continues to go through considerable evolution as the instrument calibration procedures are improved. The application is version 1.42 of the hical pipeline from UofA perl script.

Hicalproc is a pipeline application which processes the image through a series of Isis apps depending on the options.
Following are the applications that are run by default irrespective of the image type:
hical - Run caliberation steps
gaindrift - Apply gaindrift corrections. Uses HiGainFx procedure
hicubenorm - Apply highpass Cubenorm correction

Following options are provided which can be chosen depending on the input image:
Ingestion - Import and initialize a raw HiRISE image into Isis format running the apps hi2isis and spiceinit
Furrows - Run hifurrows to remove furrows in the image
NoiseFilter - Run hinoise to remove noise
Destripe - Run hidestripe to remove stripes
Mapping - Finally process the input file through the map projection phase

This application requires a configuration file, if none provided a system default will be used.

If ingestion and/or mapping are chosen, then respective parameters need to be configured.


Categories


Parameter Groups

Files

Name Description
FROMInput image to be corrected
TORadiometrically caliberated and corrected image
CONFUser specific configuration for caliberation
REMOVERemove Intermediate Files

Level Processing

Name Description
INGESTIONImport and initialize a HiRISE image
FURROWSRemove furrows
NOISE_FILTERFilter out noise
DESTRIPERemove stripes
MAPPING Process the input file through the map projection phase.

SpiceInit 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
MODEL User defined ISIS cube shape model.

Mapping parameters

Name Description
MAP File containing mapping parameters
PIXRESPixel resolution in meters

Files: FROM

Description

Input HiRISE image in isis or raw format that needs to be radiometrically corrected.

Type cube
File Mode input
Filter *.cub | *.img

Files: TO

Description

Radiometrically caliberated and corrected isis image

Type cube
File Mode output
Filter *.cub

Files: CONF

Description

User specific configuration for caliberation else Isis default will be used

Type filename
File Mode input
Internal Default $mro/calibration/hical.????.conf

Files: REMOVE

Description

Remove Intermediate Files created by the pipeline

Type boolean
Default false

Level Processing: INGESTION

Description

Import and initialize a raw HiRISE image into Isis format running the apps hi2isis and spiceinit

Type boolean
Default false

Level Processing: FURROWS

Description

Run hifurrows to remove the furrows which runs trimfilter and lowpass filter there after

Type boolean
Default false

Level Processing: NOISE_FILTER

Description

Run hinoise2 to filter out noise

Type boolean
Default false

Level Processing: DESTRIPE

Description

Run hidestripe which uses combination of low and high pass filters to destripe the image

Type boolean
Default false

Level Processing: MAPPING

Description

Process the input file through level2. This includes cam2map.

Type boolean
Default NO
Inclusions
  • MAP
  • PIXRES

SpiceInit 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

SpiceInit Parameters: CK

Description

Naif kernel file to be used for the spacecraft pointing.

Type filename
File Mode input
Default Path $mro/kernels/ck/
Internal Default none

SpiceInit Parameters: SPK

Description

Naif kernel file to be used for the spacecraft position.

Type filename
File Mode input
Default Path $mro/kernels/spk/
Internal Default none

SpiceInit Parameters: CKNADIR

Description

Compute nadir pointing if no other kernels exist

Type boolean
Default false

SpiceInit 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

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

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

History

Sharmila Prasad2011-02-10 Original Version
Sharmila Prasad2011-02-22 Use updated hinoise instead of hinoise2
Jacob Cain2022-11-22 Changed TO type to cube. Fixes #4780.