INP=(PIC,C1,C2,...,D1,D2,...) The input files consist of the image to be corrected (PIC), radiometric files (C1,C2,...) as generated by the program MJSPFCF, and dark-current files (D1,D2,...). PIC must appear as the first input. The remaining input files may appear in any order. At least one radiometric and dark-current file must be specified. PIC must be an 800x800 (geometrically uncorrected) Voyager image in byte data format. The dark-current may consist of a single frame or the sum of multiple dark-current exposures (byte or halfword format). If a summed dark-current is input, the parameter NUMDC must be used to specify the number of frames summed together. If more than one radiometric file are specified, "ficor77" will select the correct file by matching the camera serial number and filter position, as extracted from the VGR frame label. If more than one dark-current file are specified, "ficor77" will select the correct file by matching the camera serial number and scan-rate.
Ex: OUT=OPIC The output file (OPIC) consists of the radiometrically corrected image. OPIC is normally output in halfword format. Use the OFORMAT parameter to specify BYTE or REAL output.
Ex: SIZE=(sl,ss,nl,ns) The standard Vicar size field (starting line, starting sample, number of lines, number of samples).
Ex: FILTER=4 Specifies the camera filter position for the input image. The filters are mounted on an 8-position filter wheel as follows: # Narrow-Angle Wide-Angle - ------------ ---------- 0 Clear Methane (J-S-T) 1 Violet Blue 2 Blue Clear 3 Orange Violet 4 Clear Na-D 5 Green Green 6 Green Methane (U) 7 Ultraviolet Orange This parameter overrides the filter position extracted from the label of the input image. Note that the filter position must agree with the filter position of the radiometric file.
Ex: SCAN=5 (specifies 5:1 scan-rate) Specifies the scan-rate of the input image. Valid scan-rates are 1,2,3,5, and 10. This parameter overrides the scan-rate extracted from the label of the input image. Note that the scan-rate of the input image must agree with the scan-rate of the dark-current frame.
Ex: DCSCAN=5 (specifies 5:1 scan-rate) Specifies the scan-rate of the dark-current frame. Valid scan-rates are 1,2,3,] 5, and 10. This parameter overrides the scan-rate extracted from the label of the dark-current frame.
Ex: CAMERA=4 Specifies the camera ID (serial number) of the input image (PIC). This overrides the camera ID extracted from the image's picture label. The camera serial numbers of the Voyager spacecraft are: 4 = VGR-2 WA 6 = VGR-1 WA 5 = VGR-2 NA 7 = VGR-1 NA The camera ID for the input image must agree with the camera ID of the radiometric file and dark-current frame.
Specifies the camera gain-state of the input image (PIC). This overrides the camera ID extracted from the image's picture label. Valid values are: GAIN = 0 for low gain GAIN = 1 for high gain The calibration data in the radiometric file are stored for the low-gain state only. If high-gain images or dark-current frames are input, the DN values are converted to equivalent low-gain DN by dividing by the gain-ratio between high and low gain for the appropriate camera: S/N 4 - 3.7642 S/N 5 - 4.2531 S/N 6 - 3.9424 S/N 7 - 3.9240
Ex: CAMERA=4 Specifies the camera ID (serial number) of the dark-current frame. This overrides the camera ID extracted from the picture label of the dark-current frame. The camera serial numbers of the Voyager spacecraft are: 4 = VGR-2 WA 6 = VGR-1 WA 5 = VGR-2 NA 7 = VGR-1 NA
Specifies the camera gain-state of the dark-current frame. This overrides the camera ID extracted from the picture label of the dark-current frame. Valid values are: GAIN = 0 for low gain GAIN = 1 for high gain
Specifies that all resultant DNs which are negative will be set to zero. This keyword is a relic of the IBM days. At one time, GEOMA would die whenever it ingested a negative DN.
Overrides the camera mode extracted from the input picture label. Valid values are: MODE TITLE 1 NOSHUT 2 NA ONLY 3 WA ONLY 4 BOTALT 5 BSIMAN 6 BODARK 7 BOTSIM
Overrides the camera mode extracted from the picture label of the dark- current frame. Valid values are: MODE TITLE 1 NOSHUT 2 NA ONLY 3 WA ONLY 4 BOTALT 5 BSIMAN 6 BODARK 7 BOTSIM
NUMDC=n Specifies that the input dark-current represents the sum of n dark-current exposures.
Specifies the exposure time of the input frame in milliseconds. This value overrides the exposure time extracted from the input picture label.
IOF=r where r specifies the output DN scale in number of 'I over F' units per DN. 10,000 'I over F' units would be produced by normal incidence of sunlight on a Lambert disk at Jupiter's distance from the sun (5.2 A.U.). Default is IOF = 1.0. If CONV is specified, do not specify IOF.
CONV=r where r specifies the output DN scale in number of nanowatts per cm**2 per steradian per nanometer wavelength per DN. The default is IOF=1.0 and CONV is calculated. If IOF is specified, do not specify CONV.
KEYWORD--OPTIONAL Specifies the planet-of-encounter. Valid values are Jupiter, Saturn, Uranus, or Neptune. For Voyager 1, the planet-of-encounter is always set to Jupiter, and this keyword is ignored (only Jupiter scale factors are available for VGR-1). If defaulted for Voyager 2, the planet-of-encounter is determined by searching the frame label for a valid PICNO, Spacecraft-Event-Time (SCET) or Earth-Received-Time (ERT), in that order. If the fifth character of the PICNO is a 'J','S','U', or 'N', this is accepted as a valid planet ID. Otherwise, if the SCET or ERT year is greater than 74, the planet is determined as follows: YEAR PLANET VGR-1 Encounter VGR-2 Encounter -------- ------ --------------- --------------- less than 80 Jupiter Mar 5 79 Jul 9 79 80 to 84 Saturn Nov 12 80 Aug 25 81 85 to 87 Uranus Jan 24 86 88 and beyond Neptune Aug 24 89
SCALE=s Used to specify the output DN scale. SCALE is currently not implemented as either IOF or CONV is in effect.
Specifies automatic scaling of the output DNs. AUTO is currently not implemented as either IOF or CONV is in effect. AUTO activates a FICOR77 mode which scans the input picture, sampling every tenth line to determine the mean DN of the picture. The program selects the appropriate value of SCALE in order to output a picture with a mean DN approximating the mean DN of the input picture.
THRESH is an integer specifying the lower threshold to be used in the computation of the mean DN (see AUTO keyword). Since AUTO is not implemented, THRESH has no effect.
OFORMAT is a keyword which specifies the data format of the output picture. Valid values are BYTE, HALF, and REAL, where BYTE specifies 8 bit integer format. HALF specifies 16 bit integer format. REAL specifies floating point format. The default is HALF.
MAXDN specifies the maximum DN in the output picture. Default is : 255 for byte data 32767 for 16-bit or real data
LC specifies the xenon light-cannon as the light source for the input image. (The light-cannon was used during ground camera calibration). If not specified, solar illumination is assumed.
NOCHECK specifies that no label checking will be done to match the camera parameters between the input frame (PIC) and the radiometric file and dark- current frame. The radiometric file is assumed to be the second input file and the dark-current frame is assumed to be the third input file: Ex: INP=(PIC,CAL,DC) If defaulted, "ficor77" will attempt the find a radiometric file from the same camera and filter, and a dark-current frame from the same camera and scan-rate. The program will terminate (ABEND) if unsuccessful.
The DN values in the radiometric file are scaled by a factor n due to application of a low-pass filter (of unit weights) on the frames input to program MJSPFCF. DIV is used to specify this scaling: DIV=n where n is an integer specifying the number of pixels in the filter area. Normally, a 3x3 filter window is used so DIV=9. If DIV is not specified, the scale factor is determined from the picture label of the radiometric file.
KEYWORD--OPTIONAL Valid: 'NOCORREC Specifies that no scale correction is to be done. If both 'NOCORRECT and 'NONEG are specified, the output image is the same as the input image except that all negative DNs have been set to zero. If 'NOCORRECT is specified but 'NONEG is not specified, the output image is an exact copy of the input image. In practice, the NONEG and NOCORRECT keywords are no longer used.
STRING--OPTIONAL Ex: SCF="MIPL:[MIPL.VGR]VGRSCF.DAT" Specifies the Scale Correction File, as generated by program "ficorgen". Note that since this file is rarely updated, the default usually points to the most recent file and this parameter is normally not specified.