moclev0 Documentation

moclev0 - Convert PDS MOC images to ISIS format
MOCLEV0 is a TAE procedure which calls PERL scripts to convert
MOC images from PDS format to ISIS format.  The PDS input files
can either be compressed (.imq) or decompressed (.img).

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 ".img" or ".imq" input filenames.

Output filenames are built from the 'root' name with the .imq/.img
extension "stripped" off and .lev0.cub appended.

When DELNPUT="YES", the input PDS file will be deleted after it
has been successfully converted to ISIS.


***TRACKING ERRORS***

The PERL scripts called generates two files that will give details
on problems encountered during the process:

         moclev0.err - File name and brief error description
         moclev0.prt - ISIS program log file
If FROMLIST is used, then a more detailed error log file
is generated:  moclev0_prt.err


***PROGRAM DETAILS***


Perl Scripts included:
     moclev0.pl
     moclev0_batch.pl

ISIS Programs excuted:
   1) PDS compressed - .imq file extension
          readmocisis
          pds2isis
          moc_fixlabel
          levinit

   2) PDS uncompressed - .img file extension
         pds2isis
         moc_fixlabel
         levinit


***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

      moclev0.pl -delete=yes input.img

(-delete=yes is an optional delete flag to remove the
 input PDS files)

             -or to run a list of file names thru in batch-

      moclev0_batch.pl -delete=yes filenames.lis

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

Input filename
 (".img" or ".imq" file
   extention required)

--

List of input filenames

--

Delete input file
    (YES/NO)

NO

Name of translation
table file

--

File containing target
defintions

--

File containing kernel list

--

File containing instrument
parameters

--

Longitude system
(180 or 360-default)

--

Latitude system
(default OCENTRIC)

OCENTRIC

ADDITIONAL NOTES:

Parm	Description
FROM	The individual filename in this parameter must have the ".img" or the ".imq" file extension to indicate that it is the original PDS format. The output file name will be the 'root' name (without the PDS extension) and .lev0.cub appended.
FROMLIST	The input list can be a single column file that contains the input image filenames. The ".img" or the ".imq" file extension is required for the input image filenames to indicate that the files are the original PDS format. The output filenames will be the 'root' name (without the PDS extension) and .lev0.cub. appended.
DELINPUT	DELINPUT = "YES" will delete all the .img/.imq input files after the conversion to ISIS if no errors were encountered.
TRANSTAB	Translation table for pds2isis.
TARGDEF	This parameter is used to specify different target parameters (radius, omega 0, etc). The default is to read the target from the cube labels and construct a filename of the form "target.def.version". For example, if Mars is the target in the labels then the default value will be "$ISISDATA/targets/mars.def.1". Actually, the version will be the highest version number found under the $ISISDATA directory. If the user needs to define their own target parameters simply copy a file from $ISISDATA/targets and modify as needed.
KERNLST	This parameter is used to specify a file containing a list of SPICE kernels. The program will select a sub-set of these kernels which covers the time-range for the input cube. The names of the selected kernels will be written to the labels of the cube. The default is $ISISMGSDATA/moc_kernels.def.1
INSTPARS	This parameter is used to specify a file containing instrument parameters (boresight, focal length, etc). The default is instrument specific. For example, MGS/MOC may attempt to open "$ISISMGSDATA/moc.def.1". This file is versioned identically to the method defined under TARGDEF. If the user needs to define their own instrument parameters simply copy the appropriate instrument file from the mission data area (e.g., $ISISCLEMDATA) and modify as needed.
LONSYS	This parameter is used to define the longitude system computed by "lev1" programs. Valid values are either 180 or 360. The default is 360 which implies longitudes will be output in the range of 0 to 360. The value 180 implies longitudes will be output in the range of -180 to 180. This has definite effects on programs like "lev1stats" and "lev1tolev2", both of which compute and utilize longitude ranges.
LATSYS	This parameter is used to define the latitude system computed by "lev1" programs. Valid values are either OGRAPHIC or OCENTRIC. The default is OCENTRIC.