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

If the balance cube is gzipped, it will be decompressed. The binning and TDI for each CCD will be determined by examing the label portion of the HiStitch balance cube. The number of lines and samples for RED or SYN products will be obtained.

Check Halves

Check the sizes of the left and right RED (or SYN) halves, if both exist. Resize (rebin in bilinear interp mode) the smaller to match the larger.

Calculate CCD offsets

Determine the offsets for proper color alignment.

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 multiplied by a pre-determined 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.

If a synthetic RED is being used, and is a different binning than the other RED half, it will be rebinned to match.

Exit Status

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

Author

Guy McArthur, UA/HiROC

Copyright

Copyright (C) 2007-2024 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.48 2024/05/16 21:01:50