mocaspect Documentation

mocaspect - Perform aspect ratio correction of MOC Level1 image
MOCASPECT is a TAE procedure which calls PERL scripts to perform
the aspect ratio correction on Level 1 (radiometrically
corrected) MOC images.  This process does NOT require spice
data, but instead will use the aspect ratio provided in the image
index file supplied by the PDS formatted data products (IMGINDX
parameter).  Aspect ratio is stored in field (11) in the Image
index file.

The Image index file also indicates whether or not the input
image needs to be flipped left-to-right.  If field (39) of the
Image index file contains "F", this script will flip the input
image.

The user has the choice to run one image at a time using the
FROM parameter or multiple files through an ascii file that
contains a list of input image filenames (FROMLIST parameter).
The 'FROMLIST' input file can be a single column file containing
the input filenames.  Input filenames MUST HAVE '.lev1.cub' for
the file extension.

Output filenames are built from the 'root' name with the .lev1.cub
extension replaced with .asp.cub.

When DELNPUT="YES", the input .lev1.cub input file(s) will be
deleted if no errors were encountered during processing.


****IMPORTANT NOTES*****

1) The CROSSTRACK_SUMMING keyword from the input image labels is
tested for the value of 13 or 27.  These values indicate global
mapping with is currently NOT supported in ISIS.  This scenario
is considered an Error in this process. (As of May,2000).

2) The aspect ratio correction is considered to use "poor-man"
geometry.  Therefore, no further processing will be allowed that
involves "true" geometry (lev1geoplane, lev1tolev2/geom, etc.).
The output "asp.cub" files are considered an "end" product for
feature measurements, etc.


***TRACKING ERRORS***

The PERL scripts called generate an ascii file that gives details
on problems encountered during the process:

         mocaspect.err - File name and brief error description

(This file is not generated if no errors were encountered)

***PROGRAM DETAILS***


Perl Scripts included:
     mocapect.pl
     mocaspect_batch.pl

ISIS Programs excuted:
    magcube - Performs the image scaling
    mirror - Flips the image left-to-right when necessary



***EXECUTION ALTERNATIVES***

The Perl scripts mentioned above that are included in this
procedure can run within the ISIS environment, but outside
TAE.  At the unix prompt the following commands can be
entered

      mocaspect.pl -delete=yes input.lev1.cub

-delete=yes is an optional delete flag to remove the
 input level 1 (.lev1.cub) files

                     ~or~
 to run a list of file names thru in batch:

      mocaspect_batch.pl -delete=yes filenames.lis

Programmer:  Tammy Becker, U.S.G.S., Flagstaff, 08 May 2000

Input filename
 (".lev1.cub" file
   extention required)

--

List of input filenames

--

Image index file from
   PDS products

$ISISMGSDATA/cumindex.tab

Delete input file
    (YES/NO)

NO

ADDITIONAL NOTES:

Parm	Description
FROM	The individual filename in this parameter must have the ".lev1.cub" file extension to indicate that the input successfully has been processed thru MOCLEV1. The output file name will be the 'root' name (without the .lev1.cub extension) and .asp.cub appended.
FROMLIST	The input list can be a single column file that contains the input image filenames. The ".lev1.cub" file extension is required for the input image filenames to indicate that the files have successfully been processed thru MOCLEV1. The output filenames will be the 'root' name (without the PDS extension) and .asp.cub appended.
IMGINDX	The default $ISISMGSDATA/cumindex.tab supplied by ISIS was retrieved from the PDS CD-ROM volume (MGSC_1048). The information in this table file covers image dates (1997-09-15 to 1999-08-31) and CD-ROM volumes (MGSC_0001 to MGSC_1048). In order to use the most recent information supplied by PDS, the user can retrieve the cumindex.tab off the latest distributed CR-ROM and set this IMGINDX parameter to that file. The next public release of MOC image data is scheduled for October, 2000.
DELINPUT	DELINPUT = "YES" will delete all the .lev1.cub input files if no errors were encountered during the process.