HiccdStitch
Stitch together the same HiRISE color-filter CCDs from an observation to create a single mosaicked image file. The mosaicked CCD file goes into the directory tree $HiRISE_ROOT/Data/HiccdStitch
HiccdStitch -File <pathname> -Configuration <conf_file> -cat <catalog> -Id <Unique_Id>
The full pathname of the *.hiccdstitch.pvl
Specify the name of the configuration file such as HiccdStitch.conf. If not specified then the default is $HiRISE_ROOT/Configuration/HiccdStitch/HiccdStitch.conf
Specify the name of the HiRISE catalog. If none specified then HiRISE is used.
Optionally specify a unique ID for temporary file names created in the /tmp files.
Stitch together the same HiRISE color-filter CCDs from an observation to create a single mosaicked image file. The ISIS mosaicked CCD file goes into the directory tree $HiRISE_ROOT/Data/HiccdStitch/...
The Jpeg2000, browse, and thumbnail products go into the directory tree $HiRISE_ROOT/Data/Extras/RDR/...
The file passed to the pipeline (*.hiccdstitch.pvl) contains a list of ISIS file names used to create the mosaicked CCD product. The file contains PVL keywords that specifies if the cubenorm processing is to occur (Cubnorm_Option) and a Cubenorm training area (Start_Line, End_Line). The Porduct_File parameters identifies the channel filest to stitch together.
If the *.hiccdstitch.pvl file is not found then the script will terminate with an error.
The script uses the ISIS program ``hiccdstitch'' for mosaicking the CCDs together. See the ISIS documentation for details.
The pipeline is trained to see if an existing ``shiftdef'' file (with extenstion .hiccdstitch.def) is located in the directory tree. This enables the hiccdstitch program to use a shiftdef file if one was previously created in prior processing.
HiccdStitch expects the HiRISE_ROOT environment variable specifying the root directory of the HiRISE directory tree. HiccdStitch terminates if this environment variable does not exist.
HiccdStitch must have a configuration file. It can be optionally specified with the -Configruation parameter. HiccdStitch adds the output file name to the next pipeline in the sequence. If not specified in the command line, HiccdStitch looks for the file $HiRISE_ROOT/Configuration/HiccdStitch/HiccdStitch.conf. Consult the configuration file for details.
Please note:
Because the HiccdStitch 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
The following codes are returned by HiccdStitch:
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 *.HiccdStitch.pvl file 5; # File does not exists 6; # Can not delete file 7; # ISIS program failure 8; # HiRISE_ROOT environment variable not defined 9; # Error in configuration parameter 10; # Error in ISIS reduce program 11; # Error in Isis2jpeg script 12; # Error in ISIS crop program 13; # Error in Isis2jp2 script 14; # Can not delete the lockfile 15; # Problem with accessing a ISIS cube file 16; # Problem with crop program 17; # Problem with stats program 18; # Problem with algebra program 19; # Problem with perl copy function
Eric Eliason UA/LPL
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.
1.37 2012/01/06 21:43:51