PDS_VERSION_ID = PDS3 RECORD_TYPE = FIXED_LENGTH RECORD_BYTES = 80 OBJECT = TEXT INTERCHANGE_FORMAT = ASCII PUBLICATION_DATE = 1999-08-24 NOTE = "Description of contents of SOFTWARE directory." END_OBJECT = TEXT END Following files are included in the SOFTWARE directory. NB: Following common Unix practice, all file names should be converted to lower case before use, except that Makefile should have a leading upper case "M". NB: Files in this directory, except for this file, do not have PDS labels. SOFTINFO.TXT Description of contents of the SOFTWARE directory (this file). MAIN PROGRAMS ============= RDHDR.F ------- FORTRAN 77 source code for program that reads and displays contents of individual RSC-11-6 header records. Useful if familiarizing yourself with parameters stored in header and their typical values. Requires subroutines get_hdr and prt_hdr0. Usage rdhdr pathname [n] where pathname is path to RSC-11-6 data file n is optional record number to display [default 1] UNPK.F ------ FORTRAN 77 source code for program that separates header data from samples. Header information is sent to file unpk.hdr and data samples are sent to file unpk.dat. Requires subroutines get_hdr and prt_hdr1. Usage unpk pathname where pathname is path to RSC-11-6 data file CRS2ASC.F --------- FORTRAN 77 source code for program that reads Univac binary CRS (Celestial Reference Set) file and converts it to ASCII. CRS files contained position and velocity vectors as a function of time for Voyager encounters. Binary was the nominal interchange format through the Uranus encounter, and ASCII was used for Neptune. CRS2ASC was used to convert the Titan, Saturn, and Uranus binary files to the Neptune format. Requires routines doy_mmdd, get_bits, uni2ascii, uni2ieee_dp, and uni2ieee_int. This program is included in the archive for historical interest; there are no binary CRS files in the archive. CRS2LBL.F --------- FORTRAN 77 source code for program that reads ASCII CRS file and extracts parameters useful in making PDS label. Output goes to file crs2lbl.dat. Calls subroutine doy_mmdd. PREP_11_6.F ----------- FORTRAN 77 source code for program that reformats Voyager Saturn VJnnnn series data for use in quick-look and other processing. Major functions are: converts 8-bit samples in 5056-byte records to 16-bit samples in 1024-byte records (standard PREP format) corrects for missing/gained samples (optional) generates PREP-style header for output file Usage: prep_11_6 labelfile tref [-s] where labelfile is the name of the PDS label file (must be in directory where program is run) tref is reference time for positioning samples (often taken to be 0. if no midnight crossing) -s option to correct for missing/gained samples (default is no correction). Note that the correction algorithm only handles small losses or gains; if the sample counter reports more than 300000 samples lost, for example, the correction fails (and so does the program). In these cases it is appropriate for the user to investigate; it may be that the sample count is erroneous and that the "no correction" mode is the better choice. SUBROUTINES =========== DOY_MMDD.F ---------- FORTRAN 77 source code for subroutine that converts year/month/day to and year/day-of-year. DTCVT.F ------- FORTRAN 77 source code for subroutine that normalizes date-time yyyy, dd, hh, mm, ss if any value is out of range (too large). Converts to YYYY-MM-DDThh:mm:ss in 19-character string. Valid for non-leap-years. GET_BITS.F ---------- FORTRAN 77 source code for function that extracts up to 32 sequential bits from an integer array. Used to extract bits when the bit stream crosses word boundaries. Calls the FORTRAN 77 library routine mvbits. GET_HDR.F --------- FORTRAN 77 source code for subroutine that unpacks RSC-11-6 header. Header content is returned as 42-element integer array. PRT_HDR0.F ---------- FORTRAN 77 source code for subroutine that gives detailed listing of RSC-11-6 record header. Header content is listed at one line per parameter. Useful when a small number of headers are being examined, as in program RDHDR. PRT_HDR1.F ---------- FORTRAN 77 source code for subroutine that gives compressed listing of RSC-11-6 record header. Useful when listing a large number of headers, as in program UPNK. SLIP.F ------ FORTRAN 77 source code for function that returns the number of slipped samples for RSC-11-6 data. See note regarding use of "-s" option on PREP_11_6.F above. UNI2ASC.F --------- FORTRAN 77 source code for character function that converts one 6-bit Univac character to the equivalent 8-bit ASCII character. Calls function get_bits. UNI2DP.F -------- FORTRAN 77 source code for double precision function that converts one 72-bit Univac floating point number to the equivalent 64-bit IEEE floating point number. Calls function get_bits. UNI2INT.F --------- FORTRAN 77 source code for integer function that converts one 36-bit Univac integer to the equivalent 32-bit IEEE integer. Calls function get_bits. XFR_11_6.F ---------- FORTRAN 77 source code for subroutine that moves 8-bit unsigned samples from array a to array b, where they are stored as 16-bit samples. OTHER FILES =========== MAKEFILE.CMD File containing instructions for compiling and linking programs and subroutines under Solaris 2.5.1. This file name should be converted to "Makefile" before use.