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.


=item -Configuration E<lt>B<conf_file>E<gt>

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
 
=head1 Author

Eric Eliason UA/LPL


Copyright

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

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.


Version

1.19 2011/09/09 17:43:28