NAME

HiColorNorm

SYNOPSIS

HiColorNorm -File <pathname> -Cat <Catalog> -Configuration <conf_file> -Id <Unique_Id> -NoCleanup -Help

-File <pathname>

The full pathname of *.hicolornorm.pvl file that contains a list of the two color files that are to be colornomalized.

-Configuration <conf_file>

Specify the name of the configuration file such as HiColorNorm.conf. If not specified then the default is $HiRISE_ROOT/Configuration/HiColorNorm/HiColorNorm.conf

-Catalog <Catalog>

Specify the HiRISE Catalog system, if not specified then HiRISE is used.

-Id <Unique_Id>

Specify unique ID used in the construction of temporary file names located in the /tmp directory. If not specified then the script's process ID is used.

-NoCleanup

If specified the temporary files found in the /tmp director are not purged. This flag is useful when debugging the script.

DESCRIPTION

HiColorNorm is the pipeline subsystem for normalizing HiRISE Color products

Environment Variables

HiColorNorm expects the HiRISE_ROOT environment variable specifying the root directory of the HiRISE directory tree. HiColorNorm terminates if this environment variable does not exist.

Configuration file

HiColorNorm must have a configuration file. It can be optionaly specified with the -Configruation parameter. HiColorNorm adds the output file name to the next pipeline in the sequence. If not specified in the command line, HiColorNorm looks for the file $HiRISE_ROOT/Configuration/HiColorNorm/HiColorNorm.conf. If the configuration file can not be found then HiColorNorm will terminate. See HiColorNorm.conf for details on the contents of the confuguration file.

Please note:

Because the HiColorNorm pipeline uses ISIS, its peferences file should be set for pipeline processing.

 Group=UserInterface
   HistoryPath        = $PWD
   HistoryRecording   = Off
 EndGroup

 Group = SessionLog
  TerminalOutput = On
  FileOutput     = Off
 EndGroup

 Group=ErrorFacility
  FileLine = on
  Format = PVL
 EndGroup

Return Codes

The following codes are returned by HiColorNorm:

   0;  # Success value
   1;  # Command line error parameter
   2;  # Can not create a directory file
   3;  # Error with reading/writing/deleting a file
   4;  # Error with environment variable
   5;  # Error with configuration files
   6;  # Error with Data_Location
   7;  # Error returned from ISIS program
   8;  # Error returned from mysql
 

Author

Eric Eliason UA/LPL

Copyright

Copyright (C) 2006-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.28 2020/04/28 16:17:31