PDS_VERSION_ID                 = PDS3
RECORD_TYPE                    = STREAM
OBJECT                         = TEXT
   INTERCHANGE_FORMAT             = ASCII
   PUBLICATION_DATE               = 2003-03-31
   NOTE                           = "Description of software provided with 
   the SSI Calibration CD"
END_OBJECT = TEXT
END

1. Introduction

This directory contains a VICAR procedure that provides the capability to 
radiometrically correct Galileo SSI flight images.  It is designed to be 
used in conjunction with the calibration files on GO_0001 CD volume.

2. Software Description

GALSOS2 is a flat ASCII text VICAR procedure to be used with the SSI REDR 
images located on CD-ROM or SSI UDR and REDR images that are on disk and the 
calibration files located on the SSI CD-ROM GO_0001.  The procedure will 
radiometrically decalibrate the input image (INP parameter) using the program 
GALSOS and place the results in the filename specified by the parameter OUT. 

GALSOS2 will figure out the location and file names of the necessary
calibration files located on the Galileo CD-ROM GO_0001 to use by the program
GALSOS automatically.  If the user has copied the calibration files to other
locations on disk the user should use the parameters DIR, DIRCAL, CAL, DIRDC,
DC, DIRBLM, BLEM, DIROFF, and OFFSETS to tell the procedure GALSOS2 where to
locate the calibration files. 

GALSOS2 will also make a correction for all XCM files that were received
before the IDA encounter.  The XCM problem applies to the data set contained 
on GO_0002 through GO_0015. All XCM data starts one line off.  Line 1 should
really be line 2.  A VICAR program XCMFIX will shift the image down 1 line 
before radiometric correction is done.  GALSOS2 runs the program XCMFIX 
before applying the radiometric correction with GALSOS.  The VICAR program 
XCMFIX is available through the VICAR software system at MIPS.

GALSOS2 will modify the label of the final GALSOS'ed image with keywords
identifying the calibration files used. 

2.1 Software Limitations

GALSOS2 is a VICAR Procedure Definition File (PDF) that defines the parameters
for the procedure and can only be executed within VICAR environment.  It is a 
flat ASCII text file and should have a .PDF file extension.  The file 
extension was changed to .EXE to avoid conflict with PDS Standards reserved 
file extension of the same name.  Users need to rename GALSOS2.EXE to 
GALSOS2.PDF before attempting to execute the procedure.  


2.2 Execution of GALSOS2 

  GALSOS2  INP=string  OUT=string  user-parameters...
where 
  INP  is the image to be radiometrically corrected (byte image).
  OUT  is the radiometrically corrected output image (16-bit integer).
  user_parameters... are the same parameters defined for GALSOS

The input image (INP) may be an SSI UDR, REDR, or ground calibration image.
If the input is a UDR or REDR, the output image (OUT) is an SSI EDR.
If the input is a ground calibration image, the output will not be in EDR
format and will not include any binary labels.

EXAMPLE
--------

VICAR>/home/user/galsos2  +
   INP=/cdrom/go_0005/earth/c006145/5700r.img OUT=61455700.sos 

This is the simplest way to call GALSOS2. Only an input and an output are
specified.  This example assumes that GALSOS2 is being run from user's 
current home directory on a Unix machine and GO_0005 are mounted on the 
system.  

VICAR>/home/user/galsos2  INP=/cdrom/go_0005/earth/c006145/5700r.img +
   OUT=61455700.sos DIR=/home/user/calib DIRDC=/home/user/calib/dark 

This example assumes that you have copied the procedure GALSOS2 and the
calibration files into the directories /home/user/calib and 
/home/user/calib/dark.

VICAR>/home/user/galsos2  INP=61455700.img OUT=61455700.sos 

This example assume that the user has copied the file GO_0005:[EARTH.
C006145]5700R.IMG into the file 61455700.img of the user's current directory 
and are getting the calibration files from the GO_0001 CD-ROM which should be 
mounted.