expmrg Documentation

expmrg - level1 / merge exposure pairs for Clementine (any filters)
This procedure takes an input file list that contains the input cube
file names of one orbit and runs it thru CLEMPAIR which divides the
pairs of images into two output lists.  All images are run thru
UVVISCAL and RAW_MAXIMUM, RAW_MEAN, & RAW_STANDARD_DEVIATION values
are collected from the labels of each pair of images. The long exposure
is determined by the RAW_MEAN + RAW_STANDARD_DEVIATION value of one
file that is greater than it's pair.  The merge decision tree is
as follows:

1) If long-exp RAW_MAXIMUM is less than 255, use it only.
2) If long-exp RAW_MEAN + RAW_STANDARD_DEVIATION is greater than
       255, use short-exp only.
3) Otherwise, merge long-exp and short-exp by coregistering the
   two files and using the trim filter approach.

The filter merge process involves running a few trim filters on
the saturated file (long-exp) to allow for "smooth" edges of the
areas that will be replaced with the non-saturated file (short-exp).
The input files are also trimmed at the edges to remove invalid data.

EXPMRG creates an ascii output file in the default directory:
calmrg_fit_(ORBIT #).lis  - contains the filenames of the long and
and the short exposure frames, the gain and offset of each file and the
correlation coeffients [MULT,ADD,R] that were applied in COREG and FIT
to numerically fit the short exposure frame to the long exposure when
necessary. EXPMRG uses a separate procedure called mrgfile to "echo"
the information contained in calmrg_fit_#.lis.  Two more ascii files
are created long_exp_orbit#.lis and short_exp_orbit#.lis that
contain the filenames of the decided long and short exposures.
The program ERRORS is run on the expmrg_orbit#.prt and creates an
output log file ermrg_orbit#.prt that contains all error and warning
messages encountered during the EXPMRG run.

**NOTE:  The default is to automatically delete the uvviscal output
files (lubxxxx.cub.cal).
You can save the input files by setting the DELCAL option to "N".

**NOTE2: The HISAT parameter is set at 250 in UVVISCAL when there
         is an attempt to merge the exposure pairs.  If there is
         only one image without a pair, or if for some reason, only
         the short or long exposure is kept then HISAT = --.
Programmer:  Tammy Becker, U.S.G.S., Flagstaff

List of input cube file names
 (No default file extension)

NONE

Orbit number for log filenames
   only

NONE

Filter A,B,C,D, or E for log
   filenames only (optional)

--

Delete input files (yes/no)

NO

Delete output of UVVISCAL
     (yes/no)


   USE FOLLOWING PARAMETERS
      FOR UVVISCAL ONLY...

YES

Convert to I/F reflectance
   values

YES

Dark current constant
(Optional)

--

Dark current file
(Optional)

--

Array of flat-field
coefficients
(Optional)

--

High_Instrument_Saturation
(Default is ISIS Definition)

--

Minimum saturated pixels in
  column before NULL

4

Output pixel type

3

Output pixel data range

0.0,1.0

User comment

" "

ADDITIONAL NOTES:

Parm	Description
FROMLIST	List of input cube file names. There is no default extension. The input cubes should be all the files contained in an entire orbit that have been thru CLEM2ISIS. If only a portion of an orbit is desired, the user should make sure that complete pairs are included in the list. If processing more than one orbit, make sure the input list is sorted by orbit and pairs. EXPMRG assumes that the pair of images are listed together. Make note that this is a list of file names and that it might be necessary that the list contains the path name for each of the files. The input images are automatically deleted and the output files will go to the same directory that the input files existed. The file extension of the output files will be input + .lev1. The output bit type is 3 (floating point) and dn values will represent absolute radiance units.
ORBIT	This parameter tells the procedure the orbit number of the input cube files for print file name purposes. The assumption is that the input file list contains one orbit. If processing more than one orbit, this parameter can simply be set to 999 (any integer), keeping in mind that all output text files will be named using the parameter value.
FILTER	This parameter tells the procedure the filter value of the images contained in the fromlist. This is an optional parameter and can be left at the default of null. This value is used for the output log filenames only.
DELLEV0	Specify whether or not to delete the input files to CALMRG. These files are contained in the FROMLIST.
DELCAL	Specify whether or not to delete output files from UVVISCAL. The output files of UVVISCAL have the input file name with point and take up four times the space as your 8-bit input files.
CONV	This option allows the output values to be written as absolute radiance or converted to reflectance values (I/F).
DCCONST	This constant will replace the array of dark current coefficients in the derived dark current file. In most cases, the default should be used for this parameter to indicate the derived dark current file is to be used. The name of the derived dark current file is $ISISDATA/dcfile.cub
DCFILE	This parameter allows the user to use an alternate dark current file. In most cases, the default should be used for this parameter to indicate the derived dark current file is to be used. The name of the derived dark current file is $ISISDATA/dark_uv.cub.
FFFILE	This parameter allows the user to use an alternate flat-field file. In most cases, the default should be used for this parameter to indicate the derived flat-field file is to be used. The name of the derived flat-field file is $ISISDATA/flat_"FILTER_NAME"_uv.cub.
HISAT	High_Instrument_Saturation value. The default is the ISIS definition of High_Instrument_Saturation which is 255 for 8-bit data.
MIN	This parameter is used in the program NULLSAT. It is a user specification for the minimum number of pixels that must be saturated in a column before the entire column is set to NULL. This removes the "vertical bright striping" affect of surrounding pixels of the saturated area.
OTYPE	Output pixel data type. Permitted values are: 0 - output type is same as input file pixel type 1 - 8-bit (integer with type conversion parameters) 2 - 16-bit (integer with type conversion parameters) 3 - 32-bit (floating point)
ORANGE	Output pixel data range. If the output pixel type is 1 (8-bit integer with type conversion parameters) or 2 (16-bit integer with type conversion parameters), then the type conversion parameters in the output file will be set to values that allow representing the specified range of output values. Output values outside this range will be stored as the special "representation saturation" value. The ORANGE parameter is ignored if the output pixel type is 3 (32-bit floating point) since type conversion parameters are not applicable to floating point pixel values. If both ORANGE(1) and ORANGE(2) are 0.0, then the type conversion parameters in the output file will automatically be set to allow representing the same range of values as can be represented in the input file. (The user will be required to supply a specific range for ORANGE if the input pixel type is 3 (32-bit floating point) and the output pixel type is 1 (8-bit with type conversion parameters) or 2 (16-bit with type conversion parameters)).
USERNOTE	Comment from the user. This will be recorded in the ISIS session log file and also in the History entry that is put into the History object of the output file.