NAME

RedMosaic

The RedMosaic pipeline is responsible for mosaicking map-projected CCDs into a single mosaic. The input file *.mosaic.pvl file identifies which files are to be processed. The resulting mosaic is located in directory tree $HiRISE_ROOT/Data/RedMosaic. This RedMosaic pipeline was designed to run under the Conductor environment but may be run from the command line.

SYNOPSIS

RedMosaic -File <pathname> -Configuration <conf_file> -Help

-File <pathname>

The full pathname of the *.redmosaic.pvl file. This file, created by the HiGeomInit pipeline, contains a list of all the files used to construct the mosaic. This file should be located in the /HiRISE/Data/RedMosaic directory tree.

-Configuration <conf_file>

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

-help

Get help on how to run the program

DESCRIPTION

Using the ISIS himos and hicolormos programs, mosaic together map-projected images identified in the input *.redmosaic.pvl file. The resulting mosaic is located in directory tree $HiRISE_ROOT/Data/RedMosaic. The script was designed to run under the Conductor environment but may be run from the command line.

The file passed to the pipeline (*.redmosaic.pvl) contains a list of ISIS file names used to create the mosaicked product.

Environment Variables

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

Configuration file

RedMosaic must have a configuration file. It can be optionaly specified with the -Configruation parameter. If not specified in the command line, RedMosaic looks for the file $HiRISE_ROOT/Configuration/RedMosaic/RedMosaic.conf. If the configuration file can not be found then RedMosaic will terminate.

Please note:

Because the RedMosaic pipeline uses ISIS, its peferences file should be set for pipeline processing to the following parameters:

 Group=UserInterface
   HistoryPath        = $PWD
   HistoryRecording   = Off
 EndGroup

 Group = SessionLog
  TerminalOutput = On
  FileOutput     = Off
 EndGroup

 Group=ErrorFacility
  FileLine = on
  Format = PVL
 EndGroup

ISIS Programs called himos hicolormos

Return Codes

The following codes are returned by RedMosaic:

   0  # Success value
   1  # Command line error parameter
   2  # Can not create a directory file
   3  # Can not create subdirectory specifation with Data_Location
   4  # Something wrong with the *.mosaic.pvl file
   5  # ISIS program failure
   6  # HiRISE_ROOT environment variable not defined
   7  # Configuration file can not be found
   8  # Bad configuration parameter
   9  # Can not delete the lock file
   10 # Error in perl copy function
 

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.22 2023/09/19 18:11:37