;*****************************************************************************
;				NICST TOOL
;
;  Readme file for RC5 Test.
;  Version 2: updates to portability and output.
;  Version 3: updates to error analysis and gain drift correction.
;*****************************************************************************

First create directories on the server for the data in the format /Plateau/Voltage/Source/.
Next create in each of these directories subdirectories ADF/, GSE/, and LRV/;
place the appropriate files for this test in each folder. Then place the dumped
data in the main directory (/Plateau/Voltage/Source/). Use the format of one file
per band and sector (regardless of whether binary or ASCII format is used). Use 
the naming convention (UAID_sector_Cxxx_band.dmp) for the dump files. Dump only the 
sweetspot for the BCS and TMC views.

Make a similar series of directories in your home directory for the output
data (/Plateau/Voltage/Source/). Place the Input.txt file in this directory.

To run any of the files: first compile, then run

IDL> procedure,'/path/Input.txt'

Notes:
1) compile Planck and Planck_deriv subroutines first.
2) place sav files for the general band info, RSR, RVS, and general coefficients
in the folder with the code.
3) currently, version 3 only reads ASCII dump files.

;*****************************************************************************
;  General procedure.
;*****************************************************************************

1) RC5_p1.v3.tar.gz

Contains the code to analyze RC-05 Part 1 high gain. This is the BCS calibration.
Calculates temperature, radiances, dn, radiometric fits, snr fits, and retrieved 
radiances.

2) RC5_p1_lg.v3.tar.gz

Contains the code to analyze RC-05 Part 1 low gain for M13. This is the TMC calibration.
Calculates temperature, radiances, dn, radiometric fits, snr fits, and retrieved 
radiances.

3) RC5_gain_switch.v3.tar.gz

Contains the code to analyze RC-05 Part 1 gain switching for M13. This uses the TMC.
Calculates gain switching dn, radiance, and temperature.

4) RC5_p2.v3.tar.gz

Contains the code to analyze RC-05 Part 2. This is the OBC calibration.
Calculates temperature, radiances, dn, radiometric fits, snr fits, and retrieved 
radiances. Calculations are seperate for warm-up and cool-down.

5) RC5_p3.v3.tar.gz

Contains the code to analyze RC-05 Part 3. This is the BCS / OBC comparison.
Calculates temperature, radiances, emissivities, dn, and retrieved radiances.

;*****************************************************************************
;  Input file
;*****************************************************************************

1) Input.txt

Contains the following:

1) header with description.
2) Inpath
3) Outpath
4) general coefficient sav file name
5) RVS sav file name
6) RSR sav file name
7) Number of scans
8) First sample number
9) number of samples

;*****************************************************************************
;  Library files.
;*****************************************************************************

1) RC5_library.v3.tar.gz

Contains the subroutines required by the general procedure.

;*****************************************************************************
;  Misc files.
;*****************************************************************************

1) RC5_misc.v3.tar.gz

Contains some code used to generate some of the auxcillary files 
(sav files for the general band info, RSR, RVS, and general coefficients).