Help for LABLIST

PURPOSE:

LABLIST will print the project label of an image followed by either a simple 
listing of history label program/task names or a complete listing of all 
history labels.

Projects supported by LABLIST are Galileo, Voyager, Viking Orbiter, and all 
previous missions using the IBM "LABxx" label convention (e.g. LAB01, LABO2, 
LAB03,... ).  For reference of a similar program, see program LABEL-LIST.

REFERENCE:
  MSD:384-89-165, "Galileo SSI Picture Label", Revision 2, Gary Yagi,
    6 June 1989.

EXECUTION:

	LABLIST  INP  user-parameter

where INP is a flight image in standard VICAR format.  User-parameter specifies
whether or not the user desires a full display of the history labels of an 
image.  The default for user-parameter is NULL.

OPERATION:

LABLIST will first identify the input file organization, data format, and
image size:

  Ex:  BYTE FORMAT  NB=XX  NL=XXXXX  NS=XXXXX  FILE ORGANIZATION=BSQ

LABLIST will then read the input image label and identify the project and label
type.  Keywords "LABxx" and "MISSION" are used to identify IBM format and 
Galileo SSI format labels, respectively.
LABELS OF IBM FORMAT

If the project label is in the old IBM format (LAB01, LAB02, etc.), the label is
printed with the LABxx identifier deleted (this permits the label to fit on an 
80 character terminal screen).  An example is shown below.

   VGR-2   FDS 11412.51   PICNO 1347N2+000   SCET 89.237 21:55:09         
   WA CAMERA  EXP  111360.0 MSEC FILT 2(CLEAR )  LO GAIN  SCAN RATE  5:1  
   ERT 89.238 02:05:23   1/ 1 FULL    RES   VIDICON TEMP  -80.00 DEG C    
   IN/xxxxxx/xx OUT/xxxxxx/xx                 DSS #14   BIT SNR   26.383  
    60000 A/E10005EF B/907F C/917F D/007F0000 ETLM/C5C6D58BA0C4E1DE1910S A
   NA OPCAL xx(111360.0*MSEC)PIXAVG 048/0 OPERATIONAL MODE 7(BOTSIM)     A
   CAM ECAL CYCLE BEAM  RESET OPEN  CLOSE FLOOD AEXPM  FIL G1 SHUT MODE  A
   NA   NO   PREP  NO    YES   NO    NO    NO    NO    0 P  * NORMAL     A
   WA   NO   READ  YES   NO    NO    NO    NO    NO    2 P  6 NORMAL     A
   LSB_TRUNC=OFF  TLM_MODE=IM-O  COMPRESSION=ON                           

FLIGHT LABELS FOR GALILEO SSI

If the input image is ICT compressed, the label items will be organized and
printed in the following format:

  GLL/SSI  PICNO=12A0001    FILTER=3(VIO)  TLMFMT=XXX    TARGET=CALLISTO
  RIM=1/16777215:90:9:7     EXP=51200.00   FIBE=1001     TCA=-003 23:13:00  
  SCET=95.123 12:23:56      GAIN=1(400K)   COMP=ICT      COMP RATIO=24.23
  PA=NNIOOOOOO#MMSSSSXXXX   RATE=60 2/3    ENTROPY=2.23  HUF=ABCDEFG
  QSTEP=20      QM=ABCDEFG  ZZ=ABCDEFG     TW=(353,353)  ROI=(101,101,600,500)
  INA= 89.12  TWST=359.99   SUNAZ=359.99   BOOM=NO       HSCL=1.2345E5 M/PXL   
  EMA=180.00  CONE=179.99   SMRAZ=359.99   SMEAR=99.99   VSCL=1.2345E5 M/PXL   
  PHA=179.33  RA=359.99     S/CAZ=359.99   LAT=-90.00    PLANETRNG=123456789
  HRA=130.31  DEC=-90.00    NORAZ=359.99   LON=359.99    SLANT RNG=123456789
  CAL=RADIOMETRIC-FILENAME  IOF=1.0000E-3  UBWC=YES      SOLAR RNG=123456789
  DC=DARKCURRENT-FILENAME   CNV=3.5135E-2
  BLM=BLEMISH-FILENAME      SO=SHUT-OFFSET-FILENAME      EDR=GES006622/066

If the input image was losslessly compressed via the Huffman compressor,
the output format is the same as above except that the line containing
label items QSTEP, QM, ZZ, TW, and ROI is not printed. 

If the input image is not ICT compressed or losslessly compressed using the
Huffman compressor, the output format is as follows:

  GLL/SSI  PICNO=12A0001    FILTER=3(VIO)  TLMFMT=XXX    TARGET=CALLISTO
  RIM=1/16777215:90:9:7     EXP=51200.00   FIBE=1001     TCA=-003 23:13:00  
  SCET=95.123 12:23:56      GAIN=1(400K)   COMP=RC       TRUNC BITS/PXL=2.34
  PA=NNIOOOOOO#MMSSSSXXXX   RATE=60 2/3    ENTROPY=2.23  TRUNC PXLS/LNE=123
  INA= 89.12  TWST=359.99   SUNAZ=359.99   BOOM=NO       HSCL=1.2345E5 M/PXL   
  EMA=180.00  CONE=179.99   SMRAZ=359.99   SMEAR=99.99   VSCL=1.2345E5 M/PXL   
  PHA=179.33  RA=359.99     S/CAZ=359.99   LAT=-90.00    PLANETRNG=123456789
  HRA=130.31  DEC=-90.00    NORAZ=359.99   LON=359.99    SLANT RNG=123456789
  CAL=RADIOMETRIC-FILENAME  IOF=1.0000E-3  UBWC=YES      SOLAR RNG=123456789
  DC=DARKCURRENT-FILENAME   CNV=3.5135E-2
  BLM=BLEMISH-FILENAME      SO=SHUT-OFFSET-FILENAME      EDR=GES006622/066

ERROR HANDLING FOR GALILEO SSI FLIGHT LABELS

If any of the label items are not found in the input file specified by the
user, asterisks are printed in place of the value.  If a vicar command error 
is encountered, "ERRxxx" is printed after the keyword.  xxx is the VICAR error 
message number found in appendix B of the VICAR Run-Time Library Reference 
Manual.


LABELS FOR GALILEO NIMS  (TBD, as of June-12, 1992)

UNRECOGNIZABLE LABELS

If the label does not possess a "LABxx" or "MISSION" keyword, LABLIST prints a 
message stating that the program cannot properly identify the label.  LABLIST
continues with the processing of history labels.


PROGRAMS IN PROCESSING HISTORY

After the flight project labels have been printed, a list of every program in 
the processing history is printed:

	EX:  FICOR77 - RESSAR77 - PHOTFUNC - LGEOM - COPY
 
If the keyword FULL is specified as a user-parameter, the program list is 
replaced by a printout of all the history labels, including task name, user
name, and date for each label.

PROGRAM HISTORY:

Written by: Justin McNeill, September 27, 1989
Current cognizant programmer: Justin McNeill

Revisions:
  1990-12-07 JFM  "ENTRPY" changed to "ENTROPY" in output display
	           and frame rate 2 1/2 changed to 2 1/3.
  1991-03-21 SXP - Allow EDRTAPE name to be up to 12 chars.
  1992-06    W.P. Lee - 1. Eliminated the original subroutine FLIGHTLABEL.
                           Instead, interfaced with FLIGHT_LABEL that was
                           already ported
                        2. Shortened NIMS comments in PDF
                        3. Ported to UNIX
  1995-02-22 G. Connor  - Add SSI Phase 2 capability.
  1996-07-08 O. Montoya - Modified FLIGHT_LABEL to display phaseII labels
                          correctly (FR89392).

  2019-08-01 W. Bunch - IDS-7923 - Replaced sprintf calls with snprintf and zvnprintf.
                        Misc -Wall warning cleanup. Added NOUSRTIM param to help 
			automated regression testing.

PARAMETERS: