PDS_VERSION_ID = PDS3 RECORD_TYPE = FIXED_LENGTH RECORD_BYTES = 80 OBJECT = TEXT PUBLICATION_DATE = 1996-12-23 NOTE = "Software Interface Specification for the Magellan bistatic radar raw data archive. Formatted for display or printing at 58 lines per page with up to 78 constant-width characters per line. " END_OBJECT = TEXT END Stanford Center for Radar Astronomy Software Interface Specification MGN-V-RSS-1-BSR-V1.0 Bistatic Radar Raw Data Archive prepared by Richard A. Simpson Center for Radar Astronomy Stanford University Stanford, CA 94305-9515 415-723-3525 Version 1.0 23 December 1996 PREFACE |================================================================| | | | DOCUMENT CHANGE LOG | | | |================================================================| |REVISION|REVISION| SECTION | REMARKS | | NUMBER | DATE | AFFECTED | | |--------+--------+------------+---------------------------------| | 1.0 |96/10/31| All |Adapted from SIS for Magellan | | | | | Radio Occultation Raw Data | | | | | Archive. | |================================================================| |================================================================| | | | ITEMS TO BE DETERMINED | | | |================================================================| | REVISION | SECTION | ITEM DESCRIPTION | RESOLUTION | | NUMBER | AFFECTED | | | |----------+----------+------------------------+-----------------| | | | | | |================================================================| Distribution PDS/JPL Y. Oliver.............525-389 yfletcher@jplpds.jpl.nasa.gov R. Joyner.............525-389 rjoyner@jplpds.jpl.nasa.gov M. Martin.............525-389 mike_martin@isd.jpl.nasa.gov PDS/Washington University E. Guinness....Earth & Pl Sci guinness@wunder.wustl.edu PDS/MIT P.G. Ford................37-601 pgf@space.mit.edu G.H. Pettengill..........37-641 ghp@space.mit.edu Stanford University R. Simpson.........Durand 232 rsimpson@nova.stanford.edu L. Tyler...........Durand 232 len@nova.stanford.edu Jet Propulsion Laboratory/Radio Science Support Team S.W. Asmar.............161-260 sami.w.asmar@jpl.nasa.gov Contents Preface.....................................................................ii Document Change Log.........................................................ii Items to be Determined......................................................ii Distribution...............................................................iii Contents....................................................................iv Acronyms and Abbreviations..................................................vi 1 Introduction..............................................................1 1.1 Overview................................................................1 1.2 Scope...................................................................1 1.3 Applicable Documents....................................................1 1.4 System Siting...........................................................1 1.4.1 Interface Location and Medium.........................................1 1.4.2 Data Sources, Destinations, and Transfer Methods......................1 1.4.3 Generation Method and Frequency.......................................2 1.5 Assumptions and Constraints.............................................2 1.5.1 Usage Constraints.....................................................2 1.5.2 Documentation Conventions.............................................2 1.5.2.1 Data Format Descriptions............................................2 1.5.2.2 Limits of This Document.............................................3 1.5.2.3 Typographic Conventions.............................................3 1.5.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.4 Interface Medium Characteristics........................................5 2.5 Backup and Duplicates...................................................5 3 Structure and Organization Overview.......................................6 3.1 Disc Organization.......................................................6 3.1.1 Root Directory........................................................7 3.1.2 CALIB Directory.......................................................7 3.1.3 CATALOG Directory.....................................................7 3.1.4 DOCUMENT Directory....................................................7 3.1.5 GEOMETRY Directory....................................................8 3.1.6 INDEX Directory.......................................................9 3.1.7 Directories for Raw Bistatic Radar Data...............................9 3.1.8 BROWSE Directory......................................................9 3.2 Formats.................................................................9 3.3 File Naming Conventions.................................................9 3.3.1 PDS Labels...........................................................10 3.3.2 Text Files...........................................................10 3.3.3 Document files.......................................................10 3.3.4 Tabular Files........................................................11 3.3.5 Catalog files........................................................11 4 Detailed Interface Specifications........................................12 4.1 Root Files.............................................................12 4.1.1 AAREADME.TXT File....................................................12 4.1.2 ERRATA.TXT File......................................................12 4.1.3 VOLDESC.CAT File.....................................................12 4.2 Static Directories.....................................................13 4.2.1 CALIB Directory......................................................13 4.2.1.1 CALINFO.TXT File...................................................13 4.2.1.2 Link Monitor and Control (LMC) Logs................................13 4.2.1.3 High-Gain Antenna (HGA) Pattern Measurements.......................13 4.2.2 CATALOG Directory....................................................13 4.2.2.1 CATINFO.TXT File...................................................13 4.2.2.2 MISSION.CAT File...................................................14 4.2.2.3 INSTHOST.CAT File..................................................14 4.2.2.4 INST.CAT File......................................................14 4.2.2.5 REF.CAT File.......................................................14 4.2.2.6 PERSON.CAT File....................................................14 4.2.2.7 DATASET.CAT File...................................................14 4.2.3 DOCUMENT Directory...................................................14 4.2.3.1 DOCINFO.TXT File...................................................14 4.2.3.2 LMC.TXT File.......................................................14 4.2.3.3 MGBSRSIS.TXT File..................................................15 4.2.3.4 RSC11_11.TXT File..................................................15 4.2.3.5 TRK_2_25.TXT File..................................................15 4.2.3.6 QTERNION.TXT File..................................................15 4.2.3.7 Experiment Description Document....................................15 4.2.3.8 Experiment Report Documents........................................15 4.2.3.9 NAIF Toolkit Documentation.........................................16 4.2.3.10 File Dependency File...............................................16 4.2.4 GEOMETRY Directory...................................................16 4.2.4.1 GEOMINFO.TXT File..................................................16 4.2.4.2 SPK Files..........................................................16 4.2.4.2.1 Ephemerides in NAIF Text Format..................................16 4.2.4.2.2 Ephemerides in NAIF Transfer Format..............................17 4.2.4.3 Keplerian Orbital Elements File....................................17 4.2.3.4 Quaternion Files...................................................17 4.2.5 INDEX Directory......................................................17 4.2.5.1 INDXINFO.TXT File..................................................17 4.2.5.2 INDEX.LBL File.....................................................17 4.2.5.3 INDEX.TAB File.....................................................17 4.2.5.4 CUMINDEX.LBL File..................................................17 4.2.5.5 CUMINDEX.TAB File..................................................18 4.3 Data Directories.......................................................18 4.4 BROWSE Directory.......................................................18 5 Support Staff and Cognizant Personnel....................................19 Appendices A Example VOLDESC.CAT File.................................................20 Tables 2-2 Data Directories for BSR Volumes...................................4 Figures 3-1 Example Top-Level BSR Directory Structure..........................6 4-1-1 Example Label for BSR TXT Files...................................12 Acronyms and Abbreviations ADC Archival Data Collection AMMOS Advanced Multi-Mission Operations System ANSI American National Standards Institute ASCII American Standard Code for Information Interchange ATDF Archival Tracking Data File BSR Bistatic Radar CCSDS Consultative Committee for Space Data Systems CD Compact Disc CD-WO Compact Disc - Write Once CNES Centre National d'Etudes Spatiales DOS Disk Operating System DSN Deep Space Network EOF End of File GDS Ground Data System GEO PDS Geosciences Discipline Node (Washington University) HGA High-Gain Antenna ISO International Standards Organization JPL Jet Propulsion Laboratory K Degrees Kelvin kB Kilobytes LGA Low-Gain Antenna LMC Link Monitor and Control MB Megabytes MGA Medium-Gain Antenna MGN Magellan MGS Mars Global Surveyor MIT Massachusetts Institute of Technology MQPC Mapping Quaternion Polynomial Coefficient NAIF Navigation and Ancillary Information Facility NASA National Aeronautics and Space Administration NAV Navigation Subsystem/Team NERT Near Real Time NSSDC National Space Science Data Center ODF Orbit Data File ODR Original Data Record ODS Original Data Stream PDS Planetary Data System QPC Quaternion Polynomial Coefficients ROM Read-Only Memory RS Radio Science RSST Radio Science Support Team SDP Science Data Products SDVT Science Data Validation Team SFDU Standard Formatted Data Unit SIS Software Interface Specification SOPC Science Operations Planning Computer SPK Spacecraft Planet Kernel (NAIF file) TBD To Be Determined TDF Tracking Data File (variation on ATDF) UTC Coordinated Universal Time 1 Introduction 1.1 Overview This Software Interface Specification (SIS) describes the format and content of the Magellan (MGN) bistatic radar (BSR) archival raw data set. The BSR archival raw data set consists of 13 Compact Disc - Write Once (CD-WO) media containing files of raw bistatic radar data copied from magnetic tape, files transferred electronically, and files created at Stanford University. Each CD-WO represents a "volume" of archival data. The BSR archival raw data set is a deliverable product to the Planetary Data System (PDS) and the scientific community that it supports. The formats of all files in the data set are based on PDS standards. 1.2 Scope The specifications in this document apply to all MGN bistatic radar archive volumes containing raw data produced at Stanford University for delivery to PDS. This document provides a detailed description of the BSR interface, including data flow information and a definition of all data objects that flow across the interface. 1.3 Applicable Documents [1] ISO 9660-1988. Information Processing - Volume and File Structure on CD-ROM for Information Exchange, 15 April 1988. [2] Planetary Data System Standards Reference, JPL D-7669, part 2, 3 August 1994. [3] Planetary Science Data Dictionary, JPL D-7116, Rev. C, 20 November 1992. [4] Planetary Data System, Data Preparation Workbook, JPL Publication D-7669, Part 1, Version 3.1, 17 February 1995. [5] RSC-11-11, Radio Science System Original Data Record (ODR) and Original Data Stream (ODS), 1992. [6] TRK-2-25, DSN Tracking System Interfaces: Archival Tracking Data File Interface, Document 820-13 Rev A, 1986. [7] Project Magellan Software Interface Specification NAV-135, NAIF SP-KERNEL, 25 April 1990. [8] Project Magellan Software Interface Specification RES-104, Mapping Quaternion Polynomial Coefficient (MQPC) Set, 15 September 1989. 1.4 System Siting 1.4.1 Interface Location and Medium BSR volumes are created at Stanford University using the Mars Global Surveyor (MGS) Science Operations Planning Computer (SOPC) and the Young Minds CD-Studio compact disc authoring subsystem. All volumes intended for delivery to PDS are on CD-WO media. 1.4.2 Data Sources, Destinations, and Transfer Methods Each BSR volume is a collection of products representing, derived from, or needed to analyze raw bistatic radar data. Each CD-WO is delivered using the most appropriate means to the Planetary Data System (PDS). 1.4.3 Generation Method and Frequency Each BSR volume was produced in several stages. First, an inventory of the data was completed and algorithms were developed to provide each file with a unique name having the format XXXXXXXX.ext where "XXXXXXXX" represents no more than eight upper case ASCII characters, digits, or the underscore character and "ext" is a three character (upper case) extension. In many cases file names were based on the year and day (or orbit number) during which the data were collected. The inventory also included information on the start and stop times of the data in the file and the date on which the file was created. Second, a PDS label was created for each file. The PDS label carries identifying information (such as the date and time at which the file was created). In most cases the PDS label is "detached" -- it exists as a file in its own right. But in certain cases the label may be prepended (or attached) to the beginning of the file, such as for text files. PDS labels facilitate management of data files. Third, the files were organized by data type. For BSR volumes only two primary data types were included in the archive: the original data records (ODR) and the tracking data files (TDF). Ancillary data, such as spacecraft ephemerides and quaternion files were assigned to other directories (such as GEOMETRY, in these cases). Fourth, limits on the experimental data files to be included in each CD-WO volume were defined. The number of files was limited by the capacity of a single CD-WO disc (less than 650 MB). ODR and TDF files were assigned chronologically to a volume until that capacity was approached. The assignments were adjusted so that corresponding ancillary data files could be included. Fifth, the designated files were moved to a special disk partition and the CD-WO was pre-mastered. After correction of errors, the final CD was produced. Other materials (SIS documents, information files, etc.) were created in parallel with the data manipulation. Each BSR volume was evaluated internally at Stanford and (to the extent that resources permitted) by a representative of PDS, by one of the investigators, and by the Radio Science Support Team (RSST) at JPL. 1.5 Assumptions and Constraints 1.5.1 Usage Constraints Access to the BSR volumes will be determined by PDS. 1.5.2 Documentation Conventions 1.5.2.1 Data Format Descriptions Data are stored in fields of various sizes and formats ranging from single-bit flags to 64-bit floating point numbers and to character strings. The formats vary widely among file types; users should consult the appropriate SIS for details (See Section 1.3) 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.5.2.2 Limits of This Document This document applies only to BSR raw data volumes. 1.5.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 delimiters. The last two characters on each line are the carriage-return (ASCII 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 58 lines per page is assumed. For page numbers consistent with those shown in the Table of Contents, breaks in page numbering immediately before "PREFACE" and immediately before "1. Introduction" will be required. 1.5.3 Time Standards Within BSR files that follow PDS standards, times are expressed as a string of 23 ASCII characters YYYY-MM-DDThh:mm:ss.fff where "-", "T", ":", and "." are fixed delimiters; "YYYY" is the year "19nn"; "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" is milliseconds (000-999). The data type "TIME" is assigned to this format. The TIME may be optionally truncated to 19 characters by omitting the last four characters (".fff"). It is also permissible to substitute "YYYY-DDD" for "YYYY-MM-DD", where "DDD" is the day-of-year (001-366). The suffix "Z" may be appended to any time format to indicate explicitly that time is given in UTC. 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. Alternatively, the form "YYYY-DDD" may be substituted, where "DDD" is day-of-year. 2 Interface Characteristics 2.1 Hardware Characteristics and Limitations 2.1.1 Special Equipment and Device Interfaces BSR 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 BSR volume contains an accumulation of bistatic radar data products. Each CD-WO contains at most 650 MBytes of data. The file types and their directory assignments are shown in Table 2-2. When a file type is not included in a volume, the corresponding directory is omitted. |==================================================== | | | Table 2-2 Data Directories for BSR Volumes | | | |===================================================| |Directory| Data Type | | Name | | |---------+-----------------------------------------| | ODR | Original Data Record | | TDF | (Archival) Tracking Data File | |===================================================| 2.3 Labeling and Identification 2.3.1 External Labels Each BSR volume bears a label using the following format: ACRONYM_SEQUENCE;VERSION where ACRONYM = MG SEQUENCE = 23xx where xx is a two digit number indicating the order in the CD-WO volumes were produced (starting from 01 and ending with 13) VERSION = A single digit indicating the version number of the CD-WO volume. "1" is the original version. For example, MG_2303;5 is the fifth version of the third BSR volume. 2.3.2 Internal Labels The contents of each BSR volume will be labeled in accordance with PDS standards. Labeling is described further in subsequent sections. 2.4 Interface Medium Characteristics Each BSR volume conforms to ISO 9660 standards [1]. The quantity of data stored is no more than 650 MB per disc. 2.5 Backup and Duplicates The entire contents of each BSR volume will be backed up to 8-mm tapes, which will be retained at Stanford. At least five copies of each final BSR volume will be created. One copy will be delivered to the PDS Central Node at JPL, one copy will be delivered to the RSST at JPL, one copy will be delivered to the PDS Geosciences (GEO) Microwave Node at MIT, one copy will be delivered to the GEO Discipline Node at Washington University, and one copy will be retained at Stanford. The copy delivered to PDS GEO Discipline Node is expected to be submitted to the National Space Science Data Center (NSSDC) for deep archive. 3 Structure and Organization Overview 3.1 Disc Organization Each BSR volume contains a CALIB directory, a CATALOG directory, a DOCUMENT directory, a GEOMETRY directory, an INDEX directory, one or more data directories, and a BROWSE directory (Figure 3-1). |================================================================| | | | Figure 3-1 Example Top-Level BSR Directory Structure | | | |================================================================| | | | root | | | | | |- AAREADME.TXT | | |- ERRATA.TXT | | |- VOLDESC.CAT | | | | | | | | |- CALIB | | | | | | | |---------------------------------------- | | | |- CALINFO.TXT | |- HGA_DOC.ASC | | | |- 018aaddd.LMC | |- HGA_AP.ASC | | | |- 018aaddd.LBL |- HGA_F01.PS |- HGA_F01.EPS | | | |- HGA_F02.PS |- HGA_F02.EPS | | | ... |- ... |- ... | | | |- HGA_APF2.PS |- HGA_APF2.EPS | | | |- HGA_XXX.LBL | | | | | |- CATALOG | | | | | | | |---------------------------------------- | | | |- CATINFO.TXT |- INSTHOST.CAT |- REF.CAT | | | |- MISSION.CAT |- INST.CAT |- PERSON.CAT | | | |- DATASET.CAT | | | | | |- DOCUMENT | | | | | | | |---------------------------------------- | | | |- DOCINFO.TXT |- TK_FTP.TXT |- MGBSRSIS.TXT | | | |- DESC_AAA.LBL |- TK_DESCR.TXT |- RSC11_11.TXT | | | |- DESC_TXT.ASC |- TK_INSTL.TXT |- TRK_2_25.TXT | | | |- ... | | | | | |- yydddAAA.LBL |- QTERNIONS.TXT |- FILELIST.TAB | | | |- ... |- LMC.TXT |- FILELIST.LBL | | | | | |- GEOMETRY | | | | | | | |---------------------------------------- | | | |- GEOMINFO.TXT |- yydddeee.QPC |- MGNnnnnn.TSP | | | |- PEPH8996.XSP |- yydddeee.LBL |- MGNnnnnn.LBL | | | |- PEPH8996.LBL |- ... |- ... | | | |- MGNnnnnn.XSP | | |- INDEX |- MGNnnnnn.LBL | | | | |- ... | | | |- INDXINFO.TXT | | | |- INDEX.LBL | | | |- INDEX.TAB | | | |- CUMINDEX.LBL | | | |- CUMINDEX.TAB | | | | | |- ODR data | | |- TDF directories | | | | | |- BROWSE | | | |================================================================| 3.1.1 Root Directory The root directory contains the following files: AAREADME.TXT terse description of volume contents [2] ERRATA.TXT overview of anomalies and errors [2] VOLDESC.CAT volume object definition [2] 3.1.2 CALIB Directory The CALIB directory contains some or all of the following files (detached PDS labels and format files are not listed): CALINFO.TXT text description of the directory contents [2] 018aaddd.LMC Link Monitor and Control log files for antenna 'aa' on day-of-year 'ddd'. HGA_DOC.ASC Antenna pattern measurement report for the Magellan HGA HGA_Fnn.EPS Figure nn for HGA_DOC.ASC in encapsulated PostScript format (01 <= nn <= 18). HGA_Fnn.PS Figure nn for HGA_DOC.ASC in Level 1 PostScript format (01 <= nn <= 18). HGA_AP.ASC Appendix to HGA_DOC.ASC HGA_APFn.EPS Figure n for HGA_AP.ASC in encapsulated PostScript format (1 <= n <= 2). HGA_APFn.PS Figure n for HGA_AP.ASC in Level 1 PostScript format (1 <= n <= 2). 3.1.3 CATALOG Directory The CATALOG directory contains the following files: CATINFO.TXT text description of the directory contents [2] MISSION.CAT PDS data set catalog object for mission [2] INSTHOST.CAT PDS data set catalog object for instrument host [2] INST.CAT PDS data set catalog object for instrument [2] DATASET.CAT PDS data set catalog object for data set [2] REF.CAT PDS data set catalog object for references [2] PERSON.CAT PDS data set catalog object for personnel [2] 3.1.4 DOCUMENT Directory The DOCUMENT directory contains the following files: DOCINFO.TXT text description of the directory contents [2] FILELIST.TAB table showing file dependencies MGBSRSIS.TXT this SIS document In addition the DOCUMENT directory may contain descriptive material on the experiment or Software Interface Specification documents for component files. For the Magellan BSR these additional files included: DESC_AAA.LBL PDS detached label identifying Experiment Description Document DESC_TXT.ASC ASCII document describing background, methods, and early results from observations DESC_FGn.EPS Encapsulated PostScript file containing Figure n of the Experiment Description Document DESC_FGn.PS PostScript Version 1 file containing Figure n of the Experiment Description Document yydddAAA.LBL PDS detached label identifying Experiment Report for observations begun on year 'yy' and day 'ddd'. yydddXXX.ASC ASCII file which is part of the Experiment Report defined by yydddAAA.LBL; 'XXX' is a three-character string of upper case letters, digits, or the underscore character yydddXXX.EPS Encapsulated PostScript file which is part of the Experiment Report defined by yydddAAA.LBL; 'XXX' is a three-character string of upper case letters, digits, or the underscore character yydddXXX.PS PostScript Version 1 file which is part of the Experiment Report defined by yydddAAA.LBL; this file contains the same figure or scanned document as is in yydddXXX.EPS. LMC.TXT Description of format and content of Link Monitor and Control (LMC) files. TK_FTP.TXT Access information on NAIF software TK_DESCR.TXT Description of NAIF software TK_INSTL.TXT Installation instructions for NAIF software QTERNION.TXT Description of format and content of files containing spacecraft attitude data RSC11_11.TXT DSN Interface for the DSN Radio Science System Original Data Record (ODR) and Original Data Stream (ODS) [5] TRK_2_25.TXT DSN Interface for the Archival Tracking Data File [6] 3.1.5 GEOMETRY Directory The GEOMETRY directory contains the following files (detached PDS labels are not listed) GEOMINFO.TXT text description of the directory contents [2] KEPELEMS.TAB table of several sets of Keplerian orbital elements for the Magellan spacecraft MGNnnnnn.TSP text version of a NAIF SPK (ephemeris) file PEPH8996.XSP planetary ephemeris kernel in NAIF transfer format covering the time period 1989 to 1996 yydddeee.QPC quaternion polynomial coefficients file 3.1.6 INDEX Directory The INDEX directory contains the following files: INDXINFO.TXT text description of the directory contents [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 index in tabular form for this volume[2] CUMINDEX.LBL PDS label for the cumulative volume index (CUMINDEX.TAB) [2] CUMINDEX.TAB index in tabular form for all volumes in data set [2] 3.1.7 Directories for Raw Bistatic Radar Data Each BSR volume contains directories for one or more primary data types (Figure 3-1; Table 2-2). When no data files of a given type are to be archived, the corresponding data directory will be omitted. Original Data Records are stored in the ODR directory, Archival Tracking Data Files are stored in the TDF directory. 3.1.8 BROWSE Directory The BROWSE directory is included with each volume of the BSR archival raw data set. It contains several files in PostScript format, each containing a set of summary plots which can be printed on a single 8-1/2 x 11 inch page. The plot files are considered components of a PDS document, described by the PDS label BROWSE.LBL, which is also included in the directory. 3.2 Formats BSR 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 BSR volumes are formatted in accordance with Planetary Data System specifications [2-4]. 3.3 File Naming Conventions In this document and on the discs 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 systems in which names are automatically translated into one case or the other (e.g., Unix and MacOS). Within disc 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 BSR archival raw data volumes are accompanied by PDS labels [2-4]. The label can either be prepended 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 except for the suffix ".LBL". Detached label files will be located in the same directory as the primary file. Collections of documents and associated figures may be represented by a single PDS detached label having a unique file name ending in ".LBL". PDS labels, whether prepended 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. IMAGE, TABLE, etc.) is denoted by a statement of the form: ^object = location in which the carat character (^, also called a pointer in this context) indicates where to find the object. In a prepended label, the location is an integer representing the starting record or byte number of the object, where 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: ^HEADER = ("F01.IMG",1) ^IMAGE = ("F01.IMG",1025 ) indicates that the IMAGE object begins at byte 1025 of the file F01.IMG, in the same directory as the detached label file. Below is a list of the possible 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 (up to) 3 character upper-case file extension, All detached labels have record lengths of 80 bytes. Each record ends with a carriage return character (ASCII 13) in the next-to-last byte and a line feed character (ASCII 10) in the last byte. 3.3.2 Text Files Text files (.TXT suffix) may exist in the root, CALIB, CATALOG, DOCUMENT, GEOMETRY, and INDEX directories. These are ASCII files with attached PDS labels which employ the TEXT object. All records in text files have 80-bytes, with a carriage return character (ASCII 13) in the next-to-last byte and a line feed character (ASCII 10) in the last byte. 3.3.3 Document files Document files may exist in the CALIB, DOCUMENT, and BROWSE directories. Files having names ending with the ".ASC" suffix are files of plain unmarked ASCII text. Records in these files are delimited by a carriage-return (ASCII 13) and a line-feed (ASCII 10) in the last two bytes and are USUALLY limited to 80 bytes. Files ending with the ".EPS" suffix are graphics files in encapsulated PostScript format. Files ending with the ".PS" suffix are graphics files in PostScript format; they are alternatives to ".EPS" files. Files ending with the "PSn" suffix, where "n" is a digit between 1 and 4 denoting the receiver channel, are graphics files in Level 1 PostScript format for black and white printers. A single detached PDS label accompanies each document, which can be made up of one or more *.ASC, *.EPS, and/or *.PS(n) files. 3.3.4 Tabular Files Tabular files (.TAB suffix) exist in the DOCUMENT, GEOMETRY, and INDEX directories. All tabular files are filled with ASCII characters. Some are formatted for direct reading into database management systems; they 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, 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, which is .LBL. For example, the file INDEX.TAB is accompanied by the detached label file INDEX.LBL in the INDEX directory. 3.3.5 Catalog files Catalog files (suffix .CAT) exist in the root and CATALOG directories. They are formatted in an object-oriented structure consisting of sets of "keyword=value" declarations. VOLDESC.CAT provides an overview of the contents of the volume. The files in the CATALOG directory provide a top-level understanding of the mission, the spacecraft, the ground system, and the data set [2]. All records in catalog files have 80-bytes, with a carriage return character (ASCII 13) in the next-to-last byte and a line feed character (ASCII 10) in the last byte. 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. This is an ASCII file with record lengths of 80 bytes. Each line is terminated with a carriage-return (ASCII 13) line-feed (ASCII 10) pair. The file has an attached PDS label of the form shown in Figure 4-1-1. |================================================================| | | | Figure 4-1-1 Example Label for BSR TXT Files | | | |================================================================| | | | PDS_VERSION_ID = PDS3 | | RECORD_TYPE = FIXED_LENGTH | | RECORD_BYTES = 80 | | OBJECT = TEXT | | PUBLICATION_DATE = 1994-01-25 | | NOTE = "Pre-launch description of science | | investigations, instruments, and | | experimental methods planned by | | the Mars Observer Radio Science | | Team." | | END_OBJECT = TEXT | |================================================================| Labeling requirements applicable to Figure 4-1-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 document was published or released (see Section 1.5.3). NOTE a brief description of the document, including a title if available. 4.1.2 ERRATA.TXT File ERRATA.TXT contains a cumulative listing of comments and updates concerning all BSR volumes published to date. This is an ASCII file with record lengths of 80 bytes. Each line is terminated with a carriage-return (ASCII 13) line-feed (ASCII 10) pair. The file has an attached PDS label of the form shown in Figure 4-1-1. 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 record lengths of 80 bytes. Each line is terminated with a carriage-return (ASCII 13) line-feed (ASCII 10) pair. An example VOLDESC.CAT file is shown in Appendix A. Keywords are defined in [3]. 4.2 Static Directories Static directories are those which do not change (or change very little) from one volume to another. They appear on all volumes. 4.2.1 CALIB Directory The CALIB directory contains data which could be used to calibrate the raw digital data. 4.2.1.1 CALINFO.TXT File The CALINFO.TXT file contains a description of the contents of the CALIB directory. This is an ASCII file with record lengths of 80 bytes. Each line is terminated with a carriage-return (ASCII 13) line-feed (ASCII 10) pair. The file has an attached PDS label of the form shown in Figure 4-1-1. 4.2.1.2 Link Monitor and Control (LMC) Logs The Link Monitor and Control logs are a record of all operator commands issued over the link controlling open-loop radio science data acquisition equipment during a specified interval. They also contain warning and other messages issued by the system. Each LMC file is composed of ASCII records; records can be of variable lengths, but each is delimited by a carriage-return (ASCII 13) and line-feed (ASCII 10) pair. LMC logs have file names of the form 018aaddd.LMC, where 'aa' denotes the DSN antenna number (14, 43, or 63) and 'ddd' is the day-of-year on which observations began. Each LMC file is accompanied by a PDS minimal label, which has file name 018aaddd.LBL. 4.2.1.3 High-Gain Antenna (HGA) Pattern Measurements This set of files documents measurements on the Magellan high-gain antenna at frequencies of interest in the Magellan bistatic radar experiments. The primary file is HGA_DOC.ASC; it is an ASCII file describing the antenna patterns which were collected. It has line lengths of 80 ASCII characters, including a final ASCII 13 (carriage-return) and ASCII 10 (new line) pair. Also included is an appendix (HGA_AP.ASC), which has the same ASCII format, and 20 figures in both PostScript Version 1 (black and white) and encapsulated PostScript formats. The first eighteen figures accompany HGA_DOC.ASC; the remaining two figures go with HGA_AP.ASC. A detached PDS label (HGA_XXX.LBL) covers the entire set of files and explains inter-relationships among them. 4.2.2 CATALOG Directory The CATALOG directory contains files used in cataloging the data, including files which provide high-level descriptions of the planetary mission, spacecraft, instrument, and data set. PDS "streamlined" formats are used [2]. 4.2.2.1 CATINFO.TXT File The CATINFO.TXT file contains a description of the contents of the CATALOG directory. This is an ASCII file with record lengths of 80 bytes. Each line is terminated with a carriage-return (ASCII 13) line- feed (ASCII 10) pair. The file has an attached PDS label of the form shown in Figure 4-1-1. 4.2.2.2 MISSION.CAT File The MISSION.CAT file contains a PDS high-level description and catalog information about the Magellan mission and spacecraft [2]. This is an ASCII file with record lengths of 80 bytes. Each line is terminated with a carriage-return (ASCII 13) line-feed (ASCII 10) pair. 4.2.2.3 INSTHOST.CAT File The INSTHOST.CAT file contains a PDS high-level description and catalog information about the spacecraft and ground system [2]. This is an ASCII file with record lengths of 80 bytes. Each line is terminated with a carriage- return (ASCII 13) line-feed (ASCII 10) pair. 4.2.2.4 INST.CAT File The INST.CAT file contains a PDS high-level description and catalog information about elements of the radio system on both the spacecraft and ground [2]. This is an ASCII file with record lengths of 80 bytes. Each line is terminated with a carriage-return (ASCII 13) line-feed (ASCII 10) pair. 4.2.2.5 REF.CAT File The REF.CAT file contains a PDS high-level list and catalog information about references describing the mission, spacecraft, and radio system [2]. This is an ASCII file with record lengths of 80 bytes. Each line is terminated with a carriage-return (ASCII 13) line-feed (ASCII 10) pair. 4.2.2.6 PERSON.CAT File The PERSON.CAT file contains a PDS high-level list and catalog information about personnel involved in creating the BSR volume set [2]. This is an ASCII file with record lengths of 80 bytes. Each line is terminated with a carriage-return (ASCII 13) line-feed (ASCII 10) pair. 4.2.2.7 DATASET.CAT File The DATASET.CAT file contains a PDS high-level description and catalog information about the data set on this archive volume. This is an ASCII file with record lengths of 80 bytes. Each line is terminated with a carriage-return (ASCII 13) line-feed (ASCII 10) pair. 4.2.3 DOCUMENT Directory The DOCUMENT directory contains files which describe the data included in the BSR volume. 4.2.3.1 DOCINFO.TXT File The DOCINFO.TXT file contains a description of the contents of this directory. This is an ASCII file with record lengths of 80 bytes. Each line is terminated with a carriage-return (ASCII 13) line-feed (ASCII 10) pair. The file has an attached PDS label of the form shown in Figure 4-1-1. 4.2.3.2 LMC.TXT File The LMC.TXT file is a description of the Link Monitor and Control log format and contents. This is an ASCII file with record lengths of 80 bytes. Each line is terminated by a carriage-return (ASCII 13) line-feed (ASCII 10) pair. The file has an attached PDS label of the form shown in Figure 4-1-1. 4.2.3.3 MGBSRSIS.TXT File The MGBSRSIS.TXT file is the Software Interface Specification (SIS) for the Magellan bistatic radar archival raw data archive (this document). This is an ASCII file with record lengths of 80 bytes. Each line is terminated by a carriage-return (ASCII 13) line-feed (ASCII 10) pair. The file has an attached PDS label of the form shown in Figure 4-1-1. 4.2.3.4 RSC11_11.TXT File The RSC11_11.TXT file is the DSN Radio Science System Original Data Record (ODR) and Original Data Stream (ODS) Software Interface Specification. This is an ASCII file with record lengths of 80 bytes. Each line is terminated with a carriage-return (ASCII 13) line-feed (ASCII 10) pair. The file has an attached PDS label of the form shown in Figure 4-1-1. This file documents the structure and content of data files archived in the ODR data directory of each BSR volume. 4.2.3.5 TRK_2_25.TXT File The TRK_2_25.TXT file is the DSN Archival Tracking Data File Interface. This is an ASCII file with record lengths of 80 bytes. Each line is delimited by a carriage-return (ASCII 13) line-feed (ASCII 10) pair. The file has an attached PDS label of the form shown in Figure 4-1-1. This file documents the structure and content of data files archived in the TDF data directory of each BSR volume. 4.2.3.6 QTERNION.TXT File The QTERNION.TXT file is a description of the quaternion polynomial coefficient files, which allow reconstruction of the high-gain antenna pointing during bistatic radar experiments. This is an ASCII file with record lengths of 80 bytes. Each line is terminated by a carriage-return (ASCII 13) line-feed (ASCII 10) pair. The file has an attached PDS label of the form shown in Figure 4-1-1. 4.2.3.7 Experiment Description Document This set of files is a single PDS document described by detached PDS label DESC_AAA.LBL. The PDS label is an ASCII file with record lengths of 80 bytes. Each line is terminated with a carriage-return (ASCII 13) line-feed (ASCII 10) pair. The document includes ASCII file DESC_TXT.ASC and several graphics files with names of the form DESC_FGn.PS and DESC_FGn.EPS. Files ending with suffix '.PS' are in PostScript Version 1 (black and white) format, those ending with suffix '.EPS' are in encapsulated PostScript, and 'n' indicates the figure number. 4.2.3.8 Experiment Report Documents This set of files is a single PDS document described by detached PDS label yydddAAA.LBL, where 'yy' and 'ddd' give the year and day-of-year, respectively, on which data collection began. The PDS label is an ASCII file with record lengths of 80 bytes. Each line is terminated with a carriage-return (ASCII 13) line-feed (ASCII 10) pair. Each document includes one or more ASCII files (suffix 'ASC'), zero or more encapsulated PostScript files (suffix 'EPS'), and zero or more PostScript Version 1 files (suffix 'PS'). For each 'EPS' file, there is a corresponding 'PS' file; each includes one figure or one page from a scanned document. The ASCII files have FIXED_LENGTH records, delimited by a carriage-return line-feed pair; most files have record lengths of 80 bytes, but some computer listings have line lengths of as much as 130 bytes. 4.2.3.9 NAIF Toolkit Documentation TK_FTP.TXT is an explanation for obtaining NAIF Toolkit software and documentation from on-line servers; TK_DESCR.TXT and TK_INSTL.TXT describe the Toolkit and explain its installation, respectively. Each of these three files is an ASCII file with line lengths of 80 characters. Each line is terminated by a carriage return (ASCII 13) character in the next-to-last position and a line-feed (ASCII 10) character in the last position. 4.2.3.10 File Dependency File FILELIST.TAB is a PDS table object containing information about ODR sampling and listing ancillary files that would be needed for reducing and analyzing each ODR file. FILELIST.TAB has fixed-length records, each terminated by an ASCII carriage-return line-feed pair. The file is completely described by its detached PDS label FILELIST.LBL. 4.2.4 GEOMETRY Directory The GEOMETRY file contains data useful in reconstructing the observing configuration, including the spacecraft attitude. 4.2.4.1 GEOMINFO.TXT File The GEOMINFO.TXT file contains a description of the contents of the GEOMETRY directory. This is an ASCII file with record lengths of 80 bytes. Each line is terminated by a carriage-return (ASCII 13) line-feed (ASCII 10) pair. The file has an attached PDS label of the form shown in Figure 4-1-1. 4.2.4.2 SPK Files SPK Files contain data which, in conjunction with the NAIF Toolkit, allow calculation of spacecraft and planetary positions and velocities. File structure and use are described in Magellan Project documentation [7] and elsewhere. The files contain ASCII characters only; lines have variable lengths, and each line is terminated by a carriage-return (ASCII 13) line-feed (ASCII 10) pair. Each file can be converted to local binary format using the NAIF utility SPACIT; the carriage-return line-feed delimiter pair must be converted to the default line delimiter on the local machine before using SPACIT. 4.2.4.2.1 Ephemerides in NAIF Text Format Names for most NAIF SPK files have the form MGNnnnnn.TSP, where 'nnnnn' is a five-digit number chosen by the person creating the file; the numbers 'nnnnn' increase monotonically with Magellan orbit number but are not strictly related to orbit number. Each file is stored in the NAIF 'text' format. Each file is accompanied by a detached minimal PDS label with name MGNnnnnn.LBL. 4.2.4.2.2 Ephemerides in NAIF Transfer Format Two ephemeris files are stored in NAIF 'transfer' format. File PEPH8996.XSP contains solar system ephemerides from 1989 to 1996; MGN12955.XSP is an SPK file for 31 May 1994. Both are accompanied by detached PDS minimal labels with names ending in ".XSP". 4.2.4.3 Keplerian Orbital Elements File One file contains Keplerian orbital elements for the Magellan spacecraft. It is a PDS ASCII TABLE object; its file name is KEPELEMS.TAB and it is completely described by its detached PDS label KEPELEMS.LBL. 4.2.4.4 Quaternion Files For each experiment there is a file containing quaternion polynomial coefficients which can be used to reconstruct the spacecraft attitude. Each quaternion file has a name of the form yydddeee.QPC where 'yy' is the two-digit year, 'ddd' is the first day-of-year for which the coefficients are valid and 'eee' is the last day-of-year for which they are valid. Each quaternion file is accompanied by a detached PDS minimal label with name yydddeee.LBL. A more detailed description of the files and use of the coefficients is given in file QTERNION.TXT in the DOCUMENT directory. 4.2.5 INDEX Directory 4.2.5.1 INDXINFO.TXT File The INDXINFO.TXT file contains a description of the contents of the INDEX directory. This is an ASCII file with record lengths of 80 bytes. Each line is terminated with a carriage-return (ASCII 13) line-feed (ASCII 10) pair. The file has an attached PDS label of the form shown in Figure 4-1-1. 4.2.5.2 INDEX.LBL File INDEX.LBL is a detached label that completely describes INDEX.TAB. Each record in INDEX.LBL contains 80 bytes. Each record ends with a carriage-return (ASCII 13) line-feed (ASCII 10) pair. 4.2.5.3 INDEX.TAB File INDEX.TAB is a table listing all BSR data files included in this volume. It is an ASCII file with fixed-length records. Each record is delimited by a carriage-return (ASCII 13) line-feed (ASCII 10) pair. The detailed format and content are described by INDEX.LBL. 4.2.5.4 CUMINDEX.LBL File CUMINDEX.LBL is a detached label that completely describes CUMINDEX.TAB. Each record in CUMINDEX.LBL contains 80 bytes. Each record ends with a carriage-return (ASCII 13) line-feed (ASCII 10) pair. CUMINDEX.LBL differs from INDEX.LBL in only three ways: * DESCRIPTION refers to CUMINDEX.TAB rather than to INDEX.TAB * ^TABLE points to CUMINDEX.TAB rather than to INDEX.TAB * INDEX_TYPE = CUMULATIVE rather than SINGLE 4.2.5.5 CUMINDEX.TAB File CUMINDEX.TAB is a table listing all BSR data files included in all volumes of the volume set to date. It is an ASCII file with fixed-length records. Each record is delimited by a carriage-return (ASCII 13) line-feed (ASCII 10) pair. The detailed format and content are described by CUMINDEX.LBL. 4.3 Data Directories BSR archival data volumes include directories for each of the separate data types included. Table 2-2 shows the range of data types that can be included; not all data types are necessarily included on each volume, however. The data directories contain the actual data products generated during the experiments and observations and during subsequent early stages of data reduction. In cases where data records were truncated during data acquisition or copying, the defective records have been padded with binary zeroes to the correct length. Files within the ODR directory have names of the form ydddhhmm.ODR where 'y' is the least significant digit in the year, 'ddd' is the three-digit day-of-year, 'hh' is the two-digit hour, and 'mm' is the two- digit minute on which data collection began. Files within the TDF directory have names of the form ydddeeeC.TDF where 'y' is the least significant digit of the year, 'ddd' is the three-digit day of year on which data collection began, 'eee' is the three-digit day-of-year on which data collection ended, and 'C' is an ASCII character that allows distinguishing among several files with the same first seven characters. Each data file is accompanied by a full PDS label which describes both its content and its format. Keywords are defined in [3]. The keyword DSN_STATION_NUMBER gives the antenna number or numbers from which the data were obtained; PASS_NUMBER gives the pass number as defined by the DSN. 4.4 BROWSE Directory The Browse directory consists of a single document comprising a PDS detached minimal label (BROWSE.LBL) and many PostScript files containing summary plots from the ODR files. The BROWSE directory appears on each CD-WO volume of the BSR archival raw data set; each plot file contains results from the corresponding ODR data file. The plots should be useful if a potential investigator seeks to determine times at which interesting data might have been obtained without processing the full set of ODRs. Plot files have names of the form ydddhhmm.PSc where ydddhhmm.ODR is the source ODR file name and 'c' indicates the receiver channel within the ODR from which the plot data were obtained. Each plot file corresponds to a single printed 8-1/2 x 11 inch printed page. Each page has four panels. Each panel was produced by a separate execution of MATLAB. The four panel files were then assembled into a single page using the psmulti utility written by D. Murray Laing. MATLAB is a technical computing environment for computation and visualization; MATLAB is a trademark of The Math Works, Inc. PostScript is a trademark of Adobe Systems, Inc. The PostScript files were created on a Sun SPARC-2 running SunOS 4.1.3. 5 Support Staff and Cognizant Personnel The following persons may be contacted for information. Planetary Data System Radio Science Advisor: Richard A. Simpson Durand Building - Room 232 Center for Radar Astronomy Stanford University Stanford, CA 94305-9515 Phone: 415-723-3525 FAX: 415-723-9251 Electronic mail: rsimpson@magellan.stanford.edu Planetary Data System: PDS Operator MS 525/3610 Jet Propulsion Laboratory 4800 Oak Grove Drive Pasadena, CA 91109 Phone: 818-306-6130 Electronic mail: JPLPDS::PDS_OPERATOR pds_operator@jplpds.jpl.nasa.gov Appendix A - Example VOLDESC.CAT File PDS_VERSION_ID = PDS3 RECORD_TYPE = FIXED_LENGTH RECORD_BYTES = 80 OBJECT = VOLUME VOLUME_SERIES_NAME = "MISSION TO VENUS" VOLUME_SET_NAME = "MAGELLAN: BISTATIC RADAR RAW DATA ARCHIVE" VOLUME_SET_ID = USA_NASA_PDS_MG_23XX VOLUMES = 13 VOLUME_ID = MG_2312 VOLUME_VERSION_ID = "VERSION 1" VOLUME_NAME = "VOLUME 12: 1994-06-05 MAXWELL Q-S DSS 63 AND 14" PUBLICATION_DATE = 1996-10-31 DATA_SET_ID = "MGN-V-RSS-1-BSR-V1.0" MEDIUM_TYPE = "CD-WO" VOLUME_FORMAT = "ISO-9660" DESCRIPTION = "This volume contains raw data, partially processed data, and ancillary files from Magellan bistatic radar experiments." OBJECT = DATA_PRODUCER INSTITUTION_NAME = "STANFORD UNIVERSITY" FACILITY_NAME = "MGS RS REMOTE MISSION SUPPORT AREA" FULL_NAME = "MARS GLOBAL SURVEYOR RADIO SCIENCE TEAM" ADDRESS_TEXT = "DURAND BLDG - ROOM 232 STANFORD UNIVERSITY STANFORD, CA 94305-9515" END_OBJECT = DATA_PRODUCER OBJECT = CATALOG ^MISSION_CATALOG = "MISSION.CAT" ^INSTRUMENT_HOST_CATALOG = "INSTHOST.CAT" ^INSTRUMENT_CATALOG = "INST.CAT" ^REFERENCE_CATALOG = "REF.CAT" ^PERSONNEL_CATALOG = "PERSON.CAT" ^DATA_SET_CATALOG = "DATASET.CAT" END_OBJECT = CATALOG END_OBJECT = VOLUME END