Prepares an observation for color co-registration and processing. Accepts a PVL input file containing the Product IDs to use, these should correspond to existing HiStitch balance cubes.


HiColorInit [-Verbose] [-Help] [-Catalog <name>] [-Configuration <filename>] [-Id <Conductor ID>] [-Next_Pipeline <name>] PVL source file


-Catalog <name>

The name of the database catalog to use if submitting a source to the next pipeline.

-Configuration <filename>

The Configuration file used color processing, contains default search box parameters, number of control columns, control lines, etc.

-Next_Pipeline <name>

Name of the next pipeline. If blank, output source will not be submitted to a pipeline.

-Id <Conductor ID>

Provides the Conductor ID, to use in temporary files. If unset, the process ID of the script will be used.


Show ISIS commands before they are run.


Prints the command usage help.


Color initialization consists of the following steps.

Obtain product list

The PVL file is parsed for the list of Product IDs. The HiStitch data folder will be examined to make sure a balance cube exists for each.

Get binning and TDI

The binning and TDI for each CCD will be determined by examing the label portion of the HiStitch balance cube.

Image Size

Get the number of lines and samples in the red CCD. This will be used to determine the size of the color image.

Calculate Ratios

Calculate the binning, TDI, and magnification ratios. The binning and TDI ratios are the color binning or TDI divided by the corresponding red binning or TDI.

The magnification ratio is the binning ratio divided by a pre-determine constant to correct for differences in field of view between the color and red optics.

Scale the color

Rescale the color by the bin ratio and mag ratio, to match the red. These will be the BG and IR "pre-color" cubes.

Exit Status

Zero on success, see for definitions of the other exit codes.


Guy McArthur, UA/HiROC


Copyright (C) 2007 Arizona Board of Regents on behalf of the Planetary Image Research Laboratory, Lunar and Planetary Laboratory at the University of Arizona.

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License, version 2, as published by the Free Software Foundation.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.


1.37 2011/01/31 20:10:26