NASA Planetary Data System Microwave Subnode of the Geosciences Node Software Interface Specification PDS-GEO-SCVDRCD Magellan Surface Characteristics Vector Data Record on Compact Disk Read-Only Memory prepared by Center for Space Research Massachusetts Institute of Technology 70 Vassar Street Cambridge, MA 02139-4307 617-253-6485 from data supplied by Center for Radar Astronomy Stanford University Durand Building, Room 232 Stanford, CA 94305-4055 415-423-3525 Version 1.0 January 1, 1995 CONTENTS 1. OVERVIEW ........................................................ 1 1.1. Scope ................................................... 1 1.2. Applicable Documents .................................... 1 1.3. System Siting ........................................... 1 1.3.1. Interface Location and Medium ................... 1 1.3.2. Data Sources and Destinations ................... 2 1.3.3. Generation Method and Frequency ................. 2 1.4. Assumptions and Constraints ............................. 2 1.4.1. Usage Constraints ............................... 2 1.4.2. Documentation Conventions ....................... 2 1.4.3. Time Standards .................................. 3 2. INTERFACE CHARACTERISTICS ....................................... 4 2.1. Hardware Characteristics and Limitations ................ 4 2.1.1. Special Equipment and Device Interfaces ......... 4 2.1.2. Special Set-Up Requirements ..................... 4 2.2. Volume and Size ......................................... 4 2.3. Labeling and Identification ............................. 4 2.3.1. External Labels ................................. 4 2.3.2. Internal Labels ................................. 4 2.3.3. Interface Medium Characteristics ................ 4 2.4. Backup and Duplicates ................................... 4 3. STRUCTURE AND ORGANIZATION OVERVIEW ............................. 6 3.1. Disk Organization ....................................... 6 3.1.1. Root Directory .................................. 6 3.1.2. CATALOG Directory ............................... 6 3.1.3. DOCUMENT Directory .............................. 7 3.1.4. GEOMETRY Directory .............................. 7 3.1.5. INDEX Directory ................................. 7 3.1.6. LABEL Directory ................................. 8 3.1.7. SOFTWARE Directory .............................. 8 3.1.8. Data Directories ................................ 9 3.2. Formats ................................................. 9 3.3. File Naming Conventions ................................. 9 3.3.1. PDS Labels ...................................... 10 3.3.2. Document files .................................. 11 3.3.3. Tabular Files ................................... 11 3.3.4. Catalog files ................................... 11 3.3.5. Data files ...................................... 11 4. DETAILED INTERFACE SPECIFICATIONS ............................... 13 4.1. Root Files .............................................. 13 4.1.1. AAREADME.TXT File ............................... 13 4.1.2. ERRATA.TXT File ................................. 13 4.1.3. VOLDESC.CAT File ................................ 14 4.2. Static Directories ...................................... 16 4.2.1. CATALOG Directory ............................... 16 4.2.2. DOCUMENT Directory .............................. 18 PDS-GEO-SCVDRCD v 1.0 Page i 4.2.3. INDEX Directory ................................. 19 4.2.4. LABEL Directory ................................. 20 4.2.5. SOFTWARE Directory .............................. 23 4.3. Data Directories ........................................ 25 4.3.1. ANFnnnnn.v ...................................... 26 4.3.2. ANFnnnnn.LBL .................................... 26 4.3.3. EDFnnnnn.v ...................................... 26 4.3.4. EDFnnnnn.LBL .................................... 26 4.3.5. NFFnnnnn.v ...................................... 27 4.3.6. NFFnnnnn.LBL .................................... 27 4.3.7. OHFnnnnn.v ...................................... 27 4.3.8. OHFnnnnn.LBL .................................... 27 4.3.9. OIFnnnnn.v ...................................... 27 4.3.10. OIFnnnnn.LBL .................................... 27 4.3.11. SIFnnnnn.v ...................................... 28 4.3.12. SIFnnnnn.LBL .................................... 28 5. SUPPORT STAFF AND COGNIZANT PERSONNEL ........................... 29 A. EXAMPLE PDS LABELS .............................................. 31 A.1. ANF00376.LBL Example .................................... 31 A.2. CUMINDEX.LBL Example .................................... 32 A.3. EDF00376.LBL Example .................................... 34 A.4. GMF00376.LBL Example .................................... 35 A.5. INDEX.LBL Example ....................................... 36 A.6. NFF00376.LBL Example .................................... 38 A.7. OHF00376.LBL Example .................................... 39 A.8. OIF00376.LBL Example .................................... 40 A.9. SIF00376.LBL Example .................................... 41 B. FORMAT FILES .................................................... 44 B.1. SCVDRANF.FMT Example .................................... 44 B.2. SCVDRANH.FMT Example .................................... 59 B.3. SCVDREDF.FMT Example .................................... 65 B.4. SCVDREDH.FMT Example .................................... 75 B.5. SCVDRGMF.FMT Example .................................... 82 B.6. SCVDRGMH.FMT Example .................................... 88 B.7. SCVDRIMF.FMT Example .................................... 90 B.8. SCVDRIMH.FMT Example .................................... 101 B.9. SCVDRNFF.FMT Example .................................... 104 B.10. SCVDRNFH.FMT Example .................................... 108 B.11. SCVDROHF.FMT Example .................................... 113 C. EXAMPLES OF OTHER FILES ......................................... 120 C.1. AAREADME.TXT Example .................................... 120 C.2. CATINFO.TXT Example ..................................... 125 C.3. DATASET.CAT Example ..................................... 126 C.4. DOCINFO.TXT Example ..................................... 134 C.5. GEOMINFO.TXT Example .................................... 134 C.6. INDEX.TAB Example ....................................... 135 C.7. INDXINFO.TXT Example .................................... 135 C.8. INST.CAT Example ........................................ 136 C.9. INSTHOST.CAT Example .................................... 140 C.10. LABINFO.TXT Example ..................................... 143 C.11. MISSION.CAT Example ..................................... 145 C.12. PERSONEL.CAT Example .................................... 156 PDS-GEO-SCVDRCD v 1.0 Page ii C.13. REFS.CAT Example ........................................ 158 C.14. VOLDESC.CAT Example ..................................... 164 FIGURES Figure 3-1. Example SCVDRCD Directory Structure ........................ 6 Figure 4-1. Example Label for *.TXT Files .............................. 13 Figure 4-2. Example VOLDESC.CAT File ................................... 14 Figure 4-3. Example SCVDRCD Data Directory Structure ................... 26 PDS-GEO-SCVDRCD v 1.0 Page iii PREFACE __________________________________________________________________________ | | | DOCUMENT CHANGE LOG | |_________________________________________________________________________| | REVISION | REVISION | SECTION | | | NUMBER | DATE | AFFECTED | REMARKS | |________________|_________________|_________________|____________________| | | | | | | 1.0 | 01/01/95 | All | New document | |________________|_________________|_________________|____________________| __________________________________________________________________________ | | | ITEMS TO BE DETERMINED | |_________________________________________________________________________| | REVISION | SECTION | | | | NUMBER | AFFECTED | ITEM DESCRIPTION | RESOLUTION | |______________|________________|_______________________|_________________| | | | | | | none | | | | |______________|________________|_______________________|_________________| PDS-GEO-SCVDRCD v 1.0 Page iv DISTRIBUTION JPL/Magellan Thompson, T.W...........230-260 Thomas.W.Thompson@jpl.nasa.gov Saunders, R.S...........230-260 ssaunders@sl.ms.ossa.hq.nasa.gov Conner, D.L.............230-260 dconner@gllsvc.jpl.nasa.gov Senske, D...............230-260 David.A.Senske@ccmail.jpl.nasa.gov JPL/SFDU Control Authority Grimes, J...............301-345 jimg@bongo.jpl.nasa.gov Khatchadourian, J.......301-345 jacob@binky.jpl.nasa.gov PDS/JPL Joyner, R..............525/3610 rjoyner@jplpds.jpl.nasa.gov PDS/Washington University Arvidson, R.E...Campus Box 1169 arvidson@wuddy.wustl.edu Stanford University Simpson, R...........Durand 232 rsimpson@nova.stanford.edu PDS-GEO-SCVDRCD v 1.0 Page v ACRONYMS AND ABBREVIATIONS ALT-EDR Altimetry Experiment Data Record (tape) ANF Altimetry Inversion File of the SCVDR ANSI American National Standards Institute ARCDR Altimetry and Radiometry Composite Data Record ASCII American Standard Code for Information Interchange BPI Bits Per Inch C-BIDR Compressed Basic Image Data Record (tape) CCSDS Consultative Committee for Space Data Systems CCT Computer Compatible Tape CD-WO Compact Disk - Write Once CD Compact Disk dB Decibel DMAT Data Management and Archive Team DOS Disk Operating System EDF Emissivity Data File of the SCVDR EDR Experiment Data Record EOF End of File F-BIDR Full Resolution Basic Image Data Record (tape) GMF G-Matrix File of the SCVDR IAU International Astronomical Union IEEE Institute of Electrical and Electronic Engineering ISO International Standards Organization J2000 IAU Official Time Epoch JPL Jet Propulsion Laboratory K Degrees Kelvin km Kilometers LSB Least Significant Byte MB Megabytes MGN Magellan (formerly Venus Radar Mapper) MIT Massachusetts Institute of Technology MSB Most Significant Byte NAIF Navigation and Ancillary Information Facility NASA National Aeronautics and Space Administration NFF Altimetry Inversion Fit File of the SCVDR NSI NASA Science Internet NSSDC National Space Science Data Center ODL Object Definition Language (PDS) OHF Orbit Header File of the SCVDR OIF Oblique Sinusoidal Equal Area Image Data File of the SCVDR PDS Planetary Data System PSG Project Science Group ROM Read-Only Memory SAB SAR/Altimeter Burst SAR Synthetic Aperture Radar SCET Spacecraft Event Time (TDB or UTC) SCLK Spacecraft Clock (time) SCVDR Surface Characteristics Vector Data Record SFDU Standard Formatted Data Unit SFOC Space Flight Operations Center (JPL) SIF Sinusoidal Equal Area Image Data File of the SCVDR SIS Software Interface Specification SPARC Sun Scalable Processor Architecture PDS-GEO-SCVDRCD v 1.0 Page vi SU Stanford University tar (UNIX) tape archiver utility TBD To Be Determined TDB Baricentric Dynamical (Ephemeris) Time UNIX operating system UTL Universal Resource Locator (World Wide Web) UTC Coordinated Universal Time VBF85 Venus Body Fixed Coordinates, adopted by the IAU in 1985 VBF Venus Body-Fixed coordinate system VME Venus Mean Equator coordinate system VRM Venus Radar Mapper (now Magellan) VTF Volume Trailer File of the SCVDR PDS-GEO-SCVDRCD v 1.0 Page vii PDS-GEO-SCVDRCD v 1.0 Page viii CHAPTER 1 OVERVIEW This Software Interface Specification (SIS) describes the format and content of the Magellan Surface Characteristics Vector Data Record on Compact-Disk Read-Only Memory Product (SCVDRCD). This product is the permanent archive ver- sion of the Surface Characteristics Vector Data Record (SCVDR) product that was written to 8mm computer tape during the radar mapping phase of the Magel- lan mission. The SCVDRCD combines the data files from the SCVDR tapes with PDS labels, catalog files, and tables. The SCVDRCD is a deliverable product to the Planetary Data System (PDS) and to the National Space Science Data Center (NSSDC). The formats of all files in the SCVDRCD are based on PDS standards (Version 3). 1.1. Scope The specifications in this document apply to all volumes containing SCVDRCD data produced at MIT. This document provides a detailed description of the SCVDRCD interface. 1.2. Applicable Documents (1) ISO 9660-1988. Information Processing - Volume and File Structure on CD- ROM for Information Exchange, April 15, 1988. (2) Planetary Data System Standards Reference, JPL D-7669, version 3.1, August 3, 1994 (3) Planetary Science Data Dictionary, JPL D-7116, Rev. C, November 20, 1992 (4) Planetary Data System, Data Preparation Workbook, JPL Publication D-7669, Part 1, Version 3.0, April 21, 1993. (5) Simpson, R.A., M.J. Maurer, and E. Holmann, Stanford Magellan Data Pro- cessing System, (in preparation). (6) SU-MGN-SCVDR. Surface Characteristics Vector Data Record Software Inter- face Specification, Simpson, R.A., Twicken, J.D., and Maurer, M.J., Center for Radar Astronomy, Stanford University, v 1.0, October 1, 1992. Copies of this document exist in the DOCUMENT directory of all SCVDRCD volumes; in ASCII text as SCVDR.ASC and in PostScript as SCVDR.PS. 1.3. System Siting 1.3.1. Interface Location and Medium SCVDRCD volumes are created at MIT using hardware belonging to the Microwave Subnode of the PDS Geosciences Node, with a Young Minds CD-Studio compact disk authoring subsystem. All volumes intended for delivery to PDS shall be on CD-WO media. PDS-GEO-SCVDRCD v 1.0 Page 1 1.3.2. Data Sources and Destinations Each SCVDRCD volume is a collection of products representing, derived from, or needed to analyze a range of orbits of Magellan surface characteristics vector data. These data were derived from Magellan ALT-EDR, C-BIDR, and F-BIDR pro- ducts by the Surface Property Data Processing Team at Stanford University [5], and were published on SCVDR product tapes [6]. The SCVDR files have been sorted by ascending orbit number, replaced files have been omitted, and the remainder written to CD-WO by ascending volume number. The number of orbits on each SCVDRCD disk is therefore variable. One copy of each CD-WO archive volume is delivered using the most appropriate means to the National Space Science Data Center (NSSDC), a second copy is sent to Stanford University Center for Radar Astronomy, and a third copy is retained at the MIT Microwave Subnode of the Planetary Data System (PDS). 1.3.3. Generation Method and Frequency Each SCVDRCD volume is produced in several stages. First, the SCVDR data files are copied from 8mm archive tape into magnetic disk using the UNIX "tar" pro- gram. Then a PDS detached label is created for each data file using the UNIX perl script "write_cbidr_cd". Next, the CD-WO is pre-mastered using the Young Minds "makedisc" command. Finally, the CD-Studio hardware is commanded to write one or more CD-WO disks. 1.4. Assumptions and Constraints 1.4.1. Usage Constraints Access to the SCVDRCD volumes will be determined by the Planetary Data System (PDS) and by the National Space Science Data Center (NSSDC). 1.4.2. Documentation Conventions 1.4.2.1. Data Format Descriptions Data are stored in fields of 8-, 16-, and 32-bit signed and unsigned integers, 32-bit and 64-bit floats, and as character strings. Integers are stored in most-significant-byte (MSB) format [2]; the first byte contains the most sig- nificant bits, while the last contains the least significant bits. Refer to the applicable documents for details. Floats use IEEE-754 format and are are stored in MSB order (i.e., the most significant mantissa bytes precede the less significant bytes.) If a field is described as containing "n" bytes of ASCII character string data, this implies that the leftmost (lowest numbered) byte contains the first character, the next lowest byte contains the next character, and so forth. Character strings are written to CD-WO with lower numbered bytes preceding higher numbered bytes. 1.4.2.2. Limits of This Document This document applies only to SCVDRCD volumes. 1.4.2.3. Typographic Conventions This document has been formatted for simple electronic file transfer and display. Line lengths are limited to 80 ASCII characters, including line del- imiters. The last two characters on each line are the carriage-return (ASCII PDS-GEO-SCVDRCD v 1.0 Page 2 13) and the line-feed (ASCII 10). No special fonts or structures are included within the file. Constant width characters are assumed for display. Hard copy pagination at the rate of 66 lines per page is assumed. For page numbers consistent with those shown in the Table of Contents, a break in page number- ing immediately before "Chapter 1. OVERVIEW" will be required. 1.4.3. Time Standards Within SCVDRCD label files, times are expressed as a string of 19 or 23 ASCII characters YYYY-MM-DDThh:mm:ss[.fff] where "-", "T", ":", and "." are fixed delimiters; "YYYY" is the year "19nn" or "20nn"; "MM" is a two-digit month of year; "DD" is a two-digit day of month; "T" separates the date and time segments of the string; "hh" is hour of day; "mm" is the minutes of hour (00-59); "ss" is the seconds of minute (00- 59); and ".fff" gives the fractional seconds. The data type "TIME" is assigned to this format. When only the date is required the 10-character string YYYY-MM-DD may be substituted. The data type "DATE" is assigned to this format. PDS-GEO-SCVDRCD v 1.0 Page 3 CHAPTER 2 INTERFACE CHARACTERISTICS 2.1. Hardware Characteristics and Limitations 2.1.1. Special Equipment and Device Interfaces SCVDRCD volumes conform to ISO 9660 standards for CD-ROM [1]. Users of the volumes must have access to systems which can read these media. 2.1.2. Special Set-Up Requirements None. 2.2. Volume and Size Each SCVDRCD volume contains a set of data and ancillary files representing one or more Magellan orbits. The maximum size of SCVDRCD data files will be approximately 600 Mbytes. SCVDRCD disks may be slightly larger than this due to the additional PDS index table and label files. 2.3. Labeling and Identification 2.3.1. External Labels Each SCVDRCD volume bears a label using the following format: ACRONYM.SEQUENCE;VERSION where ACRONYM _ SCVDRCD SEQUENCE _ a three digit number indicating the order in which the CD-WO volumes were produced. VERSION _ A single digit determining version number of the CD-WO volume. "1" is the original version. For example, SCVDRCD.004;2 is the second version of the fourth SCVDRCD volume. 2.3.2. Internal Labels The contents of each SCVDRCD volume will be labeled in accordance with PDS standards. Labeling is described further in subsequent sections. 2.3.3. Interface Medium Characteristics Each SCVDRCD volume conforms to ISO 9660 standards [1]. The quantity of data stored is no more than 650 MB per disk. 2.4. Backup and Duplicates Three copies will be made of each SCVDRCD volume. One copy will be retained at the PDS Microwave Subnode at MIT; a second will be sent to the Center for PDS-GEO-SCVDRCD v 1.0 Page 4 Radar Astronomy at Stanford University; the third copy will be sent to NSSDC for archival. PDS-GEO-SCVDRCD v 1.0 Page 5 CHAPTER 3 STRUCTURE AND ORGANIZATION OVERVIEW 3.1. Disk Organization Each SCVDRCD volume contains a CATALOG directory, a DOCUMENT directory, a GEOMETRY directory, an INDEX directory, a LABEL directory, a SOFTWARE direc- tory, and one or more data directories (Figure 3-1). ROOT | +--+--+----------------+--+-------+------+--+----------------+ | | | | | | | | | | [CATALOG] | [DOCUMENT] | [LABEL] [SOFTWARE] | | | | | | | | | | |- CATINFO.TXT | |- DOCINFO.TXT | |- LABINFO.TXT |- MAKEFILE.MAK | | |- DATASET.CAT | |- SCVDR.ASC | |- SCVDRANF.FMT |- SCV_RDR.C | | |- INSTHOST.CAT | |- SCVDR.PS | |- SCVDRANH.FMT |- SCV_RDR.I | | |- MISSION.CAT | |- SCVDRCD.ASC | |- SCVDREDF.FMT |- SCVDR.H | | |- PERSONEL.CAT | +- SCVDRCD.PS | |- SCVDREDF.FMT |- SCVCDSCN.PL | | |- REFS.CAT | | |- SCVDRGMF.FMT |- SCVPARSE.C | | +- INST.DAT | | |- SCVDRGMH.FMT |- SCVPARSE.H | | | | |- SCVDRIMF.FMT |- SCVPARSE.I | [INDEX] [GEOMETRY] | |- SCVDRIMH.FMT |- SOFTINFO.TXT | | | | |- SCVDRNFF.FMT |- TESTANF.C | |- CUMINDEX.LBL |- GEOMINFO.TXT | |- SCVDRNFH.FMT |- TESTEDF.C | |- CUMINDEX.TAB |- GMFnnnnn.v | +- SCVDROHF.FMT |- TESTGMF.C | |- INDEX.LBL +- GMFnnnnn.LBL | |- TESTIF.C | |- INDEX.TAB | |- TESTNFF.C | +- INDXINFO.TXT | TYPES.H -+- TESTOHF.C | | |- AAREADME.TXT +-------------+-------------+------------+ |- ERRATA.TXT | | | | +- VOLDESC.TXT [Snnnn_vv] [Snnnn_vv] [Snnnn_vv] ... Figure 3-1. Example SCVDRCD Directory Structure 3.1.1. Root Directory The root directory contains the following files: AAREADME.TXT terse description of volume contents [2]. ERRATA.TXT cumulative list of errors on this and on previous SCVDRCD volumes. VOLDESC.CAT volume object definition [2]. 3.1.2. CATALOG Directory The CATALOG directory contains the following files: PDS-GEO-SCVDRCD v 1.0 Page 6 CATINFO.TXT text description of the directory contents [2]. DATASET.CAT PDS data set template. INST.CAT PDS instrument template. INSTHOST.CAT PDS instrument host template. MISSION.CAT PDS mission template. PERSONEL.CAT PDS personnel template. REFS.CAT PDS reference template. 3.1.3. DOCUMENT Directory The DOCUMENT directory contains the following files: SCVDR.ASC a copy of the SCVDR SIS document in ASCII characters, suitable for display or printing at 66 lines per page with up to 78 constant-width characters per line. SCVDR.LBL PDS label for the text of the SCVDR SIS (SCVDR.ASC) and for its PostScript version (SCVDR.PS). SCVDR.PS a copy of the SCVDR SIS document in PostScript format, suitable for previewing on a high-resolution graphics terminal or direct printing on a laser printer or photo-typesetter. SCVDRCD.ASC a copy of this SIS document in ASCII characters, suitable for display or printing at 66 lines per page with up to 78 constant-width characters per line. SCVDRCD.LBL PDS label for the text of this SIS (SCVDRCD.ASC) and for its PostScript version (SCVDRCD.PS). SCVDRCD.PS a copy of this SIS document in PostScript format, suitable for previewing on a high-resolution graphics terminal or direct printing on a laser printer or photo-typesetter. DOCINFO.TXT text description of the directory contents [2]. 3.1.4. GEOMETRY Directory The GEOMETRY directory contains the following files: GEOMINFO.TXT text description of the directory contents [2]. GMFnnnnn.LBL PDS label for the G-matrix data file GMFnnnnn.v. GMFnnnnn.v A data file containing geometrical inversion matrices (G- matrices) that were used to generate one or more ANF data files on this volume. The specific ANF files are those listed in the INDEX.TAB file in the INDEX directory with a GEOMETRY_FILE_NAME column entry of this value. 3.1.5. INDEX Directory The INDEX directory contains the following files: PDS-GEO-SCVDRCD v 1.0 Page 7 CUMINDEX.LBL PDS label for the cumulative volume index (CUMINDEX.TAB) [2]. CUMINDEX.TAB index in tabular form for all volumes in the SCVDRCD [2]. INDEX.LBL PDS label for the volume index (INDEX.TAB). Identifies the volume index and describes structure of the index table [2]. INDEX.TAB volume index in tabular form [2]. INDXINFO.TXT text description of the directory contents [2]. 3.1.6. LABEL Directory The LABEL directory contains the following files: SCVDRANF.FMT Description of the binary data records in the ANFnnnnn.v files. SCVDRANH.FMT Description of the binary header records in the ANFnnnnn.v files. SCVDREDF.FMT Description of the binary data records in the EDFnnnnn.v files. SCVDREDH.FMT Description of the binary header records in the EDFnnnnn.v files. SCVDRGMF.FMT Description of the binary data records in the GMFnnnnn.v files. SCVDRGMH.FMT Description of the binary header records in the GMFnnnnn.v files. SCVDRIMF.FMT Description of the binary data records in the SIFnnnnn.v and OIFnnnnn.v files. SCVDRIMH.FMT Description of the binary header records in the SIFnnnnn.v and OIFnnnnn.v files. SCVDRNFF.FMT Description of the binary data records in the NFFnnnnn.v files. SCVDRNFH.FMT Description of the binary header records in the NFFnnnnn.v files. SCVDROHF.FMT Description of the binary header records in the OHFnnnnn.v files. LABINFO.TXT text description of the directory contents [2]. 3.1.7. SOFTWARE Directory The SOFTWARE directory contains the following files: MAKEFILE.MAK Script used by the UNIX "make" command to generate executables from these source files. SCV_RDR.C Low level routines to read SCVDR data files into the structures defined in SCVDR.H SCV_RDR.I Function definition skeleton for SCV_RDR.C routines. SCVDR.H Definition of SCVDR data structures. PDS-GEO-SCVDRCD v 1.0 Page 8 SCVDRSCN.PL A Perl script to list contents of SCVDR data files. This file also functions as its own UNIX manual and can be printed by the UNIX commands "nroff -man scvdrscn.pl" and "troff -man scvdrscn.pl". SCVPARSE.C Low level routines to parse SFDU structures. SCVPARSE.H Definition of SFDU header structures. SCVPARSE.I Function definition skeleton for SCVPARSE.C routines. SOFTINFO.TXT text description of the directory contents [2]. TESTANF.C A program that illustrates how to read an ANF - altimetry inver- sion file. TESTEDF.C A program that illustrates how to read an EDF - emissivity file. TESTGMF.C A program that illustrates how to read a GMF - G-matrix file. TESTIF.C A program that illustrates how to read a SIF or OIF - image data file. TESTNFF.C A program that illustrates how to read a NFF - inversion fit file. TESTOHF.C A program that illustrates how to read an OHF - orbit header file. TYPES.H Miscellaneous SCVDR definitions. Note: all lines in these files have been padded on the right with blanks and terminated with an ASCII carriage return and linefeed in columns 79 and 80. It may be necessary to remove one or more of these characters in order to compile these sources on particular operating systems. 3.1.8. Data Directories Each SCVDRCD volume contains directories for one or more orbits of altimetry, image, and emissivity data from SCVDR tapes. Data directories are named Snnnn_vv where "nnnn" is the orbit number, and "vv" is the version number inherited from the original SCVDR product. 3.2. Formats SCVDRCD volumes conform to the ISO 9660 level 1 Interchange Standard CD-WO format [1], which is compatible with common computer systems including MS-DOS, Macintosh, SunOS, and VMS. Data that comprise the SCVDRCD volumes are formatted in accordance with Plane- tary Data System specifications [2-4]. 3.3. File Naming Conventions In this document and on the disks themselves, file and directory names are in upper case characters. This ensures compatibility with operating systems in which these names are case insensitive (e.g., VMS and DOS) and operating PDS-GEO-SCVDRCD v 1.0 Page 9 systems in which names are automatically translated into one case or the other (e.g., Unix and MacOS). Within disk directories the characters ";1" are appended to all file names. VMS excepted, most operating systems will hide these suffixes from users. 3.3.1. PDS Labels All files contained on SCVDRCD volumes are accompanied by PDS labels [2-4]. The label can either be prefixed to the associated primary file, or "detached", in which case the label becomes a file in its own right with the same name as the primary file except for the suffix ".LBL". Detached label files will be located in the same directory as the primary file. PDS labels, whether prefixed to or detached from their primary file, provide descriptive information about the associated file. The PDS label is an object-oriented structure consisting of sets of "keyword=value" declarations. The object to which the label refers (e.g. HEADER, TABLE, etc.) is denoted by a statement of the form: ^object = location in which the carat character (^, also called a pointer in this context) indi- cates where to find the object. In a prefixed label, the location is an integer representing the starting record or byte number of the object, where the counting starts from record or byte number 1. In a detached label, the location denotes the name of the file containing the object, along with the starting record or byte number if there is more than one object. For example: ^TABLE_HEADER = ("ANF00376.1",21) ^TABLE = ("ANF00376.1",1025 ) indicates that the TABLE object begins at byte 1025 of the file ANF00376.1, in the same directory as the detached label file. Below is a list of the possi- ble formats for the ^object definition. ^object = n ^object = n ^object = "filename.ext" ^object = ("filename.ext",n) ^object = ("filename.ext",n) where n is the starting record or byte number of the object, counting from the beginning of the file (record 1 or byte 1), indicates that the number given is in units of bytes; default is RECORDS, filename is the (up to) 8 character, alphanumeric upper-case file name, ext is the 3 character upper-case file extension. All lines in detached label files are 80 bytes long, padded on the right with blanks to a length of 78 bytes, and ending with a carriage return character (ASCII 13) followed by a line feed character (ASCII 10) in the last byte. The first two lines are an exception: the first contains a 40-byte SFDU aggregate label, followed by a carriage return and a line feed. The second contains 36 space characters (ASCII 32) followed by a carriage return and a line feed. The first PAIR of lines is therefore 80 bytes long, and all remaining lines are PDS-GEO-SCVDRCD v 1.0 Page 10 offset from the start of the label by a multiple of 80 bytes. 3.3.2. Document files Document files (.TXT suffix) may exist in the root, CATALOG, DOCUMENT, GEOMETRY, INDEX, LABEL, and SOFTWARE directories. These are ASCII files with embedded PDS labels which employ the TEXT object. All records in document files are 80-bytes in length, with a carriage return character (ASCII 13) in the next-to-last byte and a line feed character (ASCII 10) in the last byte. The first two lines are an exception: the first contains a 40-byte SFDU aggre- gate label, followed by a carriage return and a line feed. The second contains 36 space characters (ASCII 32) followed by a carriage return and a line feed. The first PAIR of lines is therefore 80 bytes long, and all remaining lines are offset from the start of the file by a multiple of 80 bytes. 3.3.3. Tabular Files Tabular files (.TAB suffix) exist in the INDEX directory (where they are ASCII files formatted for direct reading into many database management systems). ASCII tabular files consist of data "fields" separated by commas. Character fields are also enclosed in double quotation marks (") and are padded with spaces to keep quotation marks in the same columns of successive records. Character fields are left justified, and numeric fields are right justified. The "start byte" and "bytes" values listed in the labels do not include the commas between fields or the quotation marks surrounding character fields. The records in tabular files have fixed length. Where necessary, a space char- acter (ASCII 32) is appended to the record to make it of even length, and the last two bytes of each record contain the ASCII carriage return and line feed characters. This allows a table to be treated as a fixed length record file on computers that support this file type and as a text file with embedded line delimiters on those that do not. All tabular files are accompanied by descriptive, detached PDS labels. The PDS label has the same name as the data file it describes, except for the extension .LBL. For example, the file INDEX.TAB is accompanied by the detached label file INDEX.LBL in the same INDEX directory. 3.3.4. Catalog files Catalog files (suffix .CAT) exist in the root and in the CATALOG directory. They are formatted in an object-oriented structure consisting of sets of "keyword=value" declarations. VOLDESC.CAT in the root provides an overview of the contents of the volume in the form of a completed PDS template. The files in the CATALOG directory provides a top-level understanding of the mission, instrument and data set. They are presented in the form of completed PDS templates [4]. See section 4.2 for further details. 3.3.5. Data files Data files (numeric suffix) exist in the per-orbit data directories and in the GEOMETRY directory. They are described in detail in section 4.3, below, and in the series of applicable documents listed in section 1.2, above. They have been copied directly from SCVDR product tapes without reformatting, except that ASCII carat characters (ASCII 94) have been appended where necessary to set their length to a multiple of 32500 bytes. PDS-GEO-SCVDRCD v 1.0 Page 11 Within the files, the data fields are written without regard for the 32,500- byte record boundaries, i.e. they are written as a data stream. All data files copied from the SCVDR tapes contain SFDU labels, and varying length data record aggregates are themselves delimited by R-type SFDU marker labels [4]. The data files are as follows: ANFnnnnn.v Altimetry Inversion File EDFnnnnn.v Emissivity Data File GMFnnnnn.v Geometry Matrix (G-Matrix) File NFFnnnnn.v Altimetry Inversion Fit File OHFnnnnn.v Orbit Header File OIFnnnnn.v Oblique Sinusoidal Image File SIFnnnnn.v Sinusoidal Image File All data files are accompanied by detached PDS label files, whose first 8 characters are identical to the data files they represent, and whose last 3 characters are LBL. PDS-GEO-SCVDRCD v 1.0 Page 12 CHAPTER 4 DETAILED INTERFACE SPECIFICATIONS 4.1. Root Files 4.1.1. AAREADME.TXT File The AAREADME.TXT file contains terse volume content and format information. The file has an attached PDS label of the form shown in Figure 4-1. This is an ASCII file with 80-byte records. Each line is terminated with a carriage- return (ASCII 13) line-feed (ASCII 10) pair. The first two lines are an exception: the first contains a 40-byte SFDU aggregate label, followed by a carriage return and a line feed. The second contains 36 space characters (ASCII 32) followed by a carriage return and a line feed. The first PAIR of lines is therefore 80 bytes long, and all remaining lines are offset from the start of the file by a multiple of 80 bytes. CCSD3ZF0000100000001NJPL3IF0PDSX00000001 PDS_VERSION_ID = PDS3 RECORD_TYPE = STREAM SPACECRAFT_NAME = MAGELLAN TARGET_NAME = VENUS OBJECT = TEXT PUBLICATION_DATE = 1995-01-01 NOTE = "MAGELLAN SCVDR ARCHIVE CD-WO" END_OBJECT = TEXT Figure 4-1. Example Label for *.TXT Files Labeling requirements applicable to Figure 4-1 are described in [2]; keywords are defined in [3]. For this application, the only keywords that change are PUBLICATION_DATE the date in YYYY-MM-DD format on which the file was created or last modified (see Section 1.5.3). NOTE a brief description of the file, including a title if avail- able. 4.1.2. ERRATA.TXT File The ERRATA.TXT file contains general information about errors on this, and previous, volumes of the SCVDRCD product. This is an ASCII file with 80 byte records. Each line is terminated with a carriage-return (ASCII 13) line-feed (ASCII 10) pair. The first two lines are an exception: the first contains a 40-byte SFDU aggregate label, followed by a carriage return and a line feed. The second contains 36 space characters (ASCII 32) followed by a carriage return and a line feed. The first PAIR of lines is therefore 80 bytes long, and all remaining lines are offset from the start of the file by a multiple of 80 bytes. PDS-GEO-SCVDRCD v 1.0 Page 13 4.1.3. VOLDESC.CAT File VOLDESC.CAT contains a description of the contents of this volume in a PDS format readable by both humans and computers. This is an ASCII file with 80 byte records. Each line is terminated with a carriage-return (ASCII 13) line-feed (ASCII 10) pair. The first two lines are an exception: the first contains a 40-byte SFDU aggregate label, followed by a carriage return and a line feed. The second contains 36 space characters (ASCII 32) followed by a carriage return and a line feed. The first PAIR of lines is therefore 80 bytes long, and all remaining lines are offset from the start of the file by a mul- tiple of 80 bytes. Figure 4-2 shows a sample VOLDESC.CAT file for the first SCVDRCD volume. CCSD3ZF0000100000001NJPL3IF0PDSX00000001 PDS_VERSION_ID = PDS3 OBJECT = VOLUME VOLUME_SERIES_NAME = "MISSION TO VENUS" VOLUME_SET_NAME = "MAGELLAN RADAR DATA PRODUCT" VOLUME_SET_ID = "USA_NASA_PDS_MG_2101" VOLUMES = UNK VOLUME_NAME = "MAGELLAN SURFACE CHARACTERISTICS VECTOR DATA RECORD" VOLUME_ID = "MG_2101" VOLUME_VERSION_ID = "VERSION 1" PUBLICATION_DATE = 1995-01-01 DATA_SET_ID = "MGN-V-RDRS-5-SCVDR-V1.0" VOLUME_FORMAT = "ISO-9660" MEDIUM_TYPE = "CD-WO" DESCRIPTION = "This volume contains Magellan SCVDR (Surface Characteristics Vector Data Record) products. It also contains documentation files that describe the SCVDRs." MISSION_NAME = "MAGELLAN" SPACECRAFT_NAME = "MAGELLAN" SPACECRAFT_ID = MGN OBJECT = DATA_PRODUCER INSTITUTION_NAME = "STANFORD UNIVERSITY" FACILITY_NAME = "CENTER FOR RADAR ASTRONOMY" FULL_NAME = "DR. G. LEONARD TYLER" ADDRESS_TEXT = "STARLAB DURAND BLDG, ROOM 232 STANFORD, CALIFORNIA, 94305-4055, USA" END_OBJECT = DATA_PRODUCER OBJECT = CATALOG ^DATA_SET_CATALOG = "DATASET.CAT" ^INSTRUMENT_CATALOG = "INST.CAT" ^INSTRUMENT_HOST_CATALOG = "INSTHOST.CAT" ^MISSION_CATALOG = "MISSION.CAT" ^PERSONNEL_CATALOG = "PERSONEL.CAT" ^REFERENCE_CATALOG = "REFS.CAT" END_OBJECT = CATALOG END_OBJECT = VOLUME END Figure 4-2. Example VOLDESC.CAT File PDS-GEO-SCVDRCD v 1.0 Page 14 4.1.3.1. Keywords and Values Keywords in Figure 4-2 are defined in [3]. They are used in this application as follows: PDS_VERSION_ID The version of PDS standards to which this volume adheres; set to "PDS3". VOLUME_SERIES_NAME The formal name that describes a broad categorization of data products. For the SCVDRCD, set to "MISSION TO VENUS" VOLUME_SET_NAME The formal name describing one or more volumes con- taining a single data set or a collection of related data sets. For the SCVDRCD, set to "MAGELLAN RADAR DATA PRODUCT" VOLUME_SET_ID Identification of a data volume or a set of archive data volumes. For the SCVDRCD, set to "USA_NASA_JPL_ACRONYM_SEQUENCE" where ACRONYM and SEQUENCE are defined in Section 2.3.1. See also VOLUME_ID, below. VOLUMES The number of physical volumes in a volume set. Volume sets of SCVDRCD data will generally be single volumes, so this value will be set to "1". VOLUME_NAME The formal name of the individual SCVDRCD volume; a more specific identification than VOLUME_SET_NAME. For the SCVDRCD, set to "MAGELLAN SURFACE CHARAC- TERISTICS VECTOR DATA RECORD". VOLUME_ID A unique identifier for the volume. Usually the last two components of the VOLUME_SET_ID (see also Section 2.3.1). For the SCVDRCD, set to "MG_21nn". VOLUME_VERSION_ID The version of the data volume, starting with "1" for original versions and incrementing by 1 for each sub- sequent version. PUBLICATION_DATE The date in YYYY-MM-DD format on which the volume was published or released (see Section 1.4.3). DATA_SET_ID A unique alphanumeric identifier for the data set. For the SCVDRCD, set to "MGN-V-RDRS-5-SCVDR-V1.0" VOLUME_FORMAT The logical format used in writing the SCVDRCD volume. Set to "ISO-9660". MEDIUM_TYPE The physical storage medium for the SCVDRCD volume. Set to "CD-WO". DESCRIPTION A brief text description of the contents of the SCVDRCD volume. MISSION_NAME The planetary mission or project under which the data were acquired. A single mission may be associated with one or more spacecraft. For the SCVDRCD, set to "MAGELLAN" PDS-GEO-SCVDRCD v 1.0 Page 15 SPACECRAFT_NAME The full name of the spacecraft with which these data are associated. For the SCVDRCD, set to "MAGELLAN" SPACECRAFT_ID A mnemonic uniquely associated with SPACECRAFT_NAME. For the SCVDRCD, set to "MGN" INSTITUTION_NAME The name of the institution under which this SCVDRCD volume was produced. Set to "STANFORD UNIVERSITY". FACILITY_NAME The name of the department, laboratory, or subsystem under which this SCVDRCD volume was produced. Set to "CENTER FOR RADAR ASTRONOMY". FULL_NAME The name of the individual or organization responsi- ble for producing this SCVDRCD volume. For the SCVDRCD, set to "DR. G. LEONARD TYLER". ADDRESS_TEXT Mailing address for the individual or organization responsible for producing this SCVDRCD volume. For the SCVDRCD, set to "STARLAB, DURAND BLDG, ROOM 232, STANFORD, CALIFORNIA, 94305-4055, USA". ^DATA_SET_CATALOG File name in the CATALOG directory under which the PDS data set template is stored. Set to "DATASET.CAT". ^INSTRUMENT_CATALOG File name in the CATALOG directory under which the PDS instrument template is stored. Set to "INST.CAT". ^INSTRUMENT_HOST_CATALOG File name in the CATALOG directory under which the PDS instrument host template is stored. Set to "INSTHOST.CAT". ^MISSION_CATALOG File name in the CATALOG directory under which the PDS mission template is stored. Set to "MISSION.CAT". ^PERSONNEL_CATALOG File name in the CATALOG directory under which the PDS personnel template is stored. Set to "PERSONEL.CAT". ^REFERENCE_CATALOG File name in the CATALOG directory under which the PDS reference template is stored. Set to "REFS.CAT". 4.2. Static Directories Static directories are those which do not change (or change very little) from