HTML-IMAGE.nr 0C 0 HTML-IMAGE-END.lf 1 - SPECtrum Processing Routines

Programmers Notes

for UNIX Systems

By

Roger Nelson Clark Jeffrey A. Hoover Rodney K. L. Kam

Planetary Geosciences Division Hawaii Institute of Geophysics University of Hawaii

October 1982

SPECPR Logic Unit Number Assignments

= GFIT restart file = GFIT data transfer file for fitting = Spectrum data file - device letter U = Spectrum data file - device letter Y = CRT Input = CRT Output = Spectrum data file - device letter D = Spectrum data file - device letter V = Spectrum data file - device letter W = Addition Scratch file = Wavelength file = Spooler/list file = Plot scratch file = Wavelength header file = Title storage file = Save command file = Starpack extinction file = Restart Parameter file = Copy mode output file

Random Access SPECPR Files

HTML-IMAGE.nr 3c 0

Logical Unit   Record Size   # Records            File Name





   Number        (bytes)





      1            768            1      GFIT .trans





      2           1536           99      GFIT restart file





      3           1536         2001      User Defined (u file)





      4           1536         2001      User Defined (y file)





      7           1536         2001      User Defined (d file)





      8           1536         2001      User Defined (v file)





      9           1536         2001      User Defined (w file)





     10           1024          257


System generated name .speaddXXXXXX where XXXXXX is a unique number generated by the system

     11           1024           99      .spwav





     13           1536          101


System generated name .specplXXXXXX where XXXXXX is a unique number generated by the system

     14            257           99      .wvhed





     15            128           26      .spttl





     16             80          100      .cmd





     17           2048          101      User Defined (s file)





     18           1024            5      User Defined (restart file)



HTML-IMAGE-END

Sequential Access SPECPR Files

HTML-IMAGE.nr 3c 0

       Logical Unit                File Name





          Number





             5        /dev/tty? (terminal input)





                      or User Defined (redirected input)





             6        /dev/tty? (output to terminal)





            19        User Defined (Copy mode output file)



HTML-IMAGE-END.bp HTML-IMAGE.nr 3c 0

                  SPECtrum Processing Routines





                           Data Format





                                                       length





 variable                description               (16 bit words)






ititle(20)                                               20


40 character title which describes the data. Format: 20A2 (ASCII)

  icta(3)                                                 3


Civil or Universal time when data was last processed. 3A2 Format (ASCII) HHMMSS

  ictb(3)                                                 3


Civil or Universal time at the start of the spectral run 3A2 Format (ASCII) HHMMSS

  ista(3)                                                 3


Siderial time when data collection was completed and written. 3A2 Format (ASCII) HHMMSS

  istb(3)                                                 3


Siderial time when the spectral run started. 3A2 Format (ASCII) HHMMSS

 idatea(3)                                                3


Date when data was last processed. 3A2 Format (ASCII) MMDDYY

 idateb(3)                                                3


Date when the spectral run began. 3A2 Format (ASCII) MMDDYY

   irevs                                                  1


The number of independent spectral scans which were added to make the spectrum (integer number).

  irecno                                                  1


The record number within the file where the data is located (integer number).

  ira(3)                                                  3


Right ascension coordinates of an astronomical object, or longitude on a planetary surface (integer numbers). (hours min sec)

  idec(3)                                                 3


Declination coordinates of an astronomical object, or latitude on a planetary surface (integer numbers) (deg min sec)

   irmas                                                  1


The equivalent atmospheric thickness through which the observation was obtained (=1.0 overhead). (integer times 1000)

HTML-IMAGE-END.TS

 iband(2)                                                  2


The channel numbers which define the band normalization (scaling to unity). (integers)

   ichan                                                   1


The number of spectral channels in the data set (integer).

   irwav                                                   1


The record number within the file where the wavelengths are found (integer).

  ifut(3)                                                  3


3 unused integer variables.

  itimch                                                   1


The time observed in the sample beam for each half chop in milliseconds (for chopping spectrometers only). (integer)

 ihist(30)                                                30


The program automatic 60 character history (30A2 Format). (ASCII)

mhist(148)                                               148


Manual history (4 lines of 74 characters each, ASCII, 148A2 Format). Program automatic for large history requirements

   nruns                                                   1


The number of independent spectral runs which were summed or averaged to make this spectrum (integer).

   ieros                                                   1


Flag to indicate whether or not the data for the error bar (1 sigma standard deviation of the mean) is in the next record (integer). =0: no errors, =1: errors in next record.

  iwtrns                                                   1


Weighted number of runs (the number of runs of the spectrum with the minimum runs which was used in processing this spectrum). integer

   xnrm                                                    2


The band normalization factor. For data scaled to 1.0, multiply by this number to recover photometric level. (32 bit real number)

  scatime                                                  2


The time it takes to make one scan of the entire spectrum in seconds. (32 bit real #)

HTML-IMAGE-END.TS

  timint                                                   2


Total integration time (=scatime * nruns) (32 bit real number)

  xfut(7)                                                 14


Seven unused real variables for the future

 data(256)                                               512


The spectral data (256 channels of 32 bit real data numbers)

               total (16 bit words):                     768



HTML-IMAGE-END