NAME

HiColorInit

SUMMARY

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.

SYNOPSIS

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

OPTIONS

-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.

-Verbose

Show ISIS commands before they are run.

-Help

Prints the command usage help.

DESCRIPTION

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 HiColor.pm for definitions of the other exit codes.

Author

Guy McArthur, UA/HiROC

Copyright

Copyright (C) 2007-2020 Arizona Board of Regents on behalf of the Lunar and Planetary Laboratory at the University of Arizona.

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

   http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

Version

1.40 2023/07/26 01:15:24