PDS_VERSION_ID = PDS3 RECORD_TYPE = STREAM OBJECT = TEXT PUBLICATION_DATE = 2014-07-29 NOTE = "Description of the archival volume of MAGELLAN radio tracking data. Formatted for display with fixed width characters at 55 lines per page." END_OBJECT = TEXT END MAGELLAN RADIO TRACKING DATA ARCHIVE VOLUME SOFTWARE INTERFACE SPECIFICATION Version 1.0 2014-07-29 Richard A. Simpson ----------------------------------------------------------------------------- TABLE OF CONTENTS Title Page Table of Contents Document Change Log Acronyms and Abbreviations 1.0 Introduction 1.1 Purpose and Scope 1.2 Content Overview 1.3 Applicable Documents and Constraints 2.0 Archive Volume Generation 3.0 Archive Volume Contents 3.1 Root Directory Contents 3.2 CATALOG Directory 3.3 DOCUMENT Directory 3.4 INDEX Directory 3.5 AMD Directory 3.6 ION Directory 3.7 ODF Directory 3.8 TDF Directory 3.9 TRO Directory 3.10 WEA Directory 4.0 Archive Volume Format 5.0 Cognizant Persons ----------------------------------------------------------------------------- DOCUMENT CHANGE LOG Change Date Affected Sections -------------------------------------- ---------- --------------------------- SHS/GEO: Added Venus Gravity Handbook 2014-10-03 3.3, 4.0 ----------------------------------------------------------------------------- ACRONYMS AND ABBREVIATIONS AMD Angular Momentum Desaturation (file or directory) ASCII American Standard Code for Information Interchange ATDF Archival Tracking Data File DSN Deep Space Network ION Ionospheric Media Calibration (file or directory) ISO International Standards Organization JPL Jet Propulsion Laboratory NASA National Aeronautics and Space Administration NSSDC National Space Science Data Center ODF Orbit Data File PDS Planetary Data System RMDCT Radio Metric Data Conditioning Team SIS Software Interface Specification SFF Small Forces File (see aso AMD) TBD To be determined TRO Tropospheric Media Calibration (file or directory) WEA DSN Weather (file or directory) ----------------------------------------------------------------------------- 1.0 Introduction 1.1 Purpose and Scope This Software Interface Specification (SIS) describes the archive of MAGELLAN Radio Tracking Data. It is intended to give people interested in using MAGELLAN ATDFs and ODFs an overview of the archive. 1.2 Content Overview The MAGELLAN radio tracking archive comprises 243 ATDFs, 6 ODFs, ancillary data, and associated documentation. Each ATDF contains measurements of MAGELLAN range and Doppler collected using ground stations of the NASA Deep Space Network (DSN). The ATDFs cover the period between 4 May 1989 (as MAGELLAN began its cruise to Venus) to 12 October 1994 after MAGELLAN burned up in the Venus atmosphere. The ODFs cover 22 April 1992 to 12 October 1994 at both 2- and 10-second integrations. Section 2 of this document (Archive Volume Generation) describes the procedure for transferring data products to the archive. Section 3 (Archive Volume Contents) describes the structure of the archive and the contents of each file. Section 4 (Archive Volume Format) describes the file formats used in the archive volume. Finally, Section 5 (Support Staff and Cognizant Persons) lists the individuals responsible for generating the archive volumes. This is an ASCII document with 80 characters per line. Each line ends with an ASCII carriage-return/line-feed pair in positions 79 and 80. 1.3 Applicable Documents and Constraints This archive volume is consistent with the following document: [1] Planetary Data System Standards Reference, February 16, 2009, Version 3.8. JPL D-7669, Part 2. ----------------------------------------------------------------------------- 2.0 Archive Volume Generation The MAGELLAN Project released 247 ATDFs to the Planetary Data System (PDS); these were collected in a set of Compact-Disc / Write Once volumes at the PDS Geosciences (GEO) Node in 1997. The data were passed to the PDS Radio Science Advisor, who assembled 243 ATDFs into this archive in 2010. A series of peer reviews was conducted by PDS, the ODFs and then the ancillary data files were added, and the final archival data set was completed in 2014. One ATDF was lost before the files were delivered to GEO. In constructing the archive it was found that 2 ATDFs were defective and that another 2 appeared to contain duplicate data; these four files were omitted from the archive. The five problem files were: Coverage (YYYY/DDD) Reason for Omission from Archive ------------------- ---------------------------------- 1990/166-1990/193 Lost before GEO collection in 1997 1991/084-1991/112 Corrupted 1992/034-1992/050 Duplicate 1993/313-1993/313 Duplicate 1994/162-1994/164 Corrupted MAGELLAN gravity investigator Alex Konopliv located NAVIO files from the final 2-1/2 years of the mission. NAVIO is an in-house format used at the Jet Propulsion Laboratory (JPL). KJ Lee of JPL's Radio Metric Data Conditioning Team (RMDCT) was able to convert these to the ODF format, and the reconstructed ODFs have been included in this archive. They cover: Coverage (YYYY/DDD) File Name Bytes Comment ------------------- ------------ --------- ------------------------- 1992/113-1993/004 2113004A.ODF 17708544 10-second integration 1993/004-1994/003 3004003A.ODF 44085888 10-second integration 1994/003-1994/285 4003285A.ODF 40303872 10-second integration 1992/262-1993/011 2262011A.ODF 59994324 2-second integration 1993/011-1994/003 3011003A.ODF 178327296 2-second integration 1994/003-1994/285 4003285B.ODF 196084224 2-second integration The archive is contained in a single electronic volume, delivered originally to GEO in 2010 on three DVD+R physical volumes. ----------------------------------------------------------------------------- 3.0 Archive Volume Contents 3.1 Root Directory Contents Files in the Root Directory include an overview of the archive, a description of the volume for the PDS Catalog, and a list of errata or comments about the archive. File Name File Contents Provided By ------------ --------------------------------------------------- ---------- AAREADME.TXT Volume content and format information R. Simpson ERRATA.TXT Volume anomalies or comments R. Simpson VOLDESC.CAT Machine-readable volume contents R. Simpson 3.2 CATALOG Directory The CATALOG directory includes files describing the MAGELLAN mission (MISSION.CAT), the spacecraft and supporting ground communications facilities (INSTHOST.CAT), the radio science instrument used to collect the ATDF data (INST.CAT), and this data set (DATASET.CAT). There is also a list of people involved in the MAGELLAN gravity investigation and this archiving activity (PERSON.CAT); and there is a list of references included in other CATALOG files (REF.CAT). Finally, the CATINFO.TXT file provides an overview of the contents of the CATALOG directory. 3.3 DOCUMENT Directory The DOCUMENT directory includes a copy of the archive volume SIS (ARCH_SIS.TXT -- this document), a SIS describing the ATDF files in detail (TRK_2_25.TXT), a SIS describing the ODF files in detail (TRK_2_18.TXT), a tutorial document explaining how to extract binary data from ATDF records (ATDF_TUT.TXT), SISs for the ancillary data types, the Venus Gravity Handbook explaining how the gravity field is estimated, and a DOCINFO.TXT file providing an overview of the contents of the DOCUMENT directory. 3.4 INDEX Directory The INDEX directory contains a summary listing of each data file in the data directories (INDEX.TAB), a PDS label file which describes both the structure and content of INDEX.TAB (INDEX.LBL), and an INDXINFO.TXT file which provides an overview of the contents of the INDEX directory. 3.5 AMD Directory The AMD directory contains 5 ASCII AMD files, each accompanied by an ASCII PDS label file. Each AMD file contains data from approximately one year. File names are of the form ydddeeeC.AMD, where 'y' is the least significant digit of the year in which the file begins, 'ddd' is the doy-of- year on which the file begins, 'eee' is the day-of-year on which the file ends, and 'C' is a letter ('A' or 'B') distinguishing files when more than one has the same 'ydddeee'. Label files have the same name as the corresponding AMD except that the extension is 'LBL'. 3.6 ION Directory The ION directory contains 56 ASCII ION files, each accompanied by an ASCII PDS label file. Each ION file contains data from approximately one month. File names are of the form ydddeeeC.ION, where 'y' is the least significant digit of the year in which the file begins, 'ddd' is the doy-of- year on which the file begins, 'eee' is the day-of-year on which the file ends, and 'C' is a letter ('A' or 'B') distinguishing files when more than one has the same 'ydddeee'. Label files have the same name as the corresponding ION except that the extension is 'LBL'. 3.7 ODF Directory The ODF directory contains 6 binary ODFs, each accompanied by an ASCII PDS label file. Data file names have the form, ydddeeeC.TDF, where 'y' is the least significant digit of the year in which the file begins, 'ddd' is the doy-of- year on which the file begins, 'eee' is the day-of-year on which the file ends, and 'C' is a letter ('A' or 'B') distinguishing files when more than one has the same 'ydddeee'. Label files have the same name as the corresponding ODF except that the extension is 'LBL'. 3.8 TDF Directory The TDF directory contains 243 binary ATDFs, each accompanied by an ASCII PDS label file. Data file names have the form, ydddeeeC.TDF, where 'y' is the least significant digit of the year in which the file begins, 'ddd' is the doy-of- year on which the file begins, 'eee' is the day-of-year on which the file ends, and 'C' is a letter ('A' or 'B') distinguishing files when more than one has the same 'ydddeee'. Label files have the same name as the corresponding TDF except that the extension is 'LBL'. 3.9 TRO Directory The TRO directory contains 44 ASCII TRO files, each accompanied by an ASCII PDS label file. Each TRO file contains data from approximately one month. File names are of the form ydddeeeC.TRO, where 'y' is the least significant digit of the year in which the file begins, 'ddd' is the doy-of- year on which the file begins, 'eee' is the day-of-year on which the file ends, and 'C' is a letter ('A' or 'B') distinguishing files when more than one has the same 'ydddeee'. Label files have the same name as the corresponding TRO except that the extension is 'LBL'. 3.10 WEA Directory The WEA directory contains 15 ASCII WEA files, each accompanied by an ASCII PDS label file. Each WEA file contains data from approximately one year at a single DSN complex. File names are of the form ydddeeeC.WEA, where 'y' is the least significant digit of the year in which the file begins, 'ddd' is the doy-of-year on which the file begins, 'eee' is the day-of-year on which the file ends, and 'C' is a digit denoting the DSN complex ('1', '4', or '6' for Golstone, Canberra, or Madrid, respectively). Label files have the same name as the corresponding WEA except that the extension is 'LBL'. ----------------------------------------------------------------------------- 4.0 Archive Volume Format The archive volume organization is shown in the diagram below root | |- AAREADME.TXT |- ERRATA.TXT |- VOLDESC.CAT | |- CATALOG | | | |- CATINFO.TXT PDS catalog files for mission, | |- MISSION.CAT host, instrument, references, | |- INSTHOST.CAT personnel, and data set | |- INST.CAT | |- REF.CAT | |- PERSON.CAT | `- DATASET.CAT | |- DOCUMENT | | | |- DOCINFO.TXT Overview of directory | |- HANDBOOK.LBL Label for HANDBOOK.PDF | |- HANDBOOK.PDF Venus Gravity Handbook | |- SFFDR.LBL Label and documentation for | |- SFFDR.ASC Magellan small forces (AMD) | |- SFFDR.PDF files in ASCII, PDF, and Word | |- SFFDR.DOC formats | |- TRK_2_18.TXT Description of ODF contents | |- TRK_2_23.TXT Description of ION and TRO contents | |- TRK_2_24.TXT Description of WEA contents | |- TRK_2_25.TXT Description of ATDF contents | |- ATDF_TUT.TXT Tutorial on extracting binary | | data from ATDFs | `- ARCH_SIS.TXT Overview of archival volume | |- INDEX | | | |- INDXINFO.TXT Overview of directory | |- INDEX.LBL Label to INDEX.TAB | `- INDEX.TAB List of data files (ATDFs) | |- AMD Data directory (5 AMDs and labels) |- ION Data directory (56 IONs and labels) |- ODF Data directory (6 ODFs and labels) |- TDF Data directory (243 ATDFs and labels) |- TRO Data directory (44 TROs and labels) `- WEA Data directory (15 WEAs and labels) The 243 data files (named ydddeeeC.TDF) in the TDF directory are binary with 288 byte records and variable numbers of records per file. The 6 data files (named ydddeeeC.ODF) in the ODF directory are also binary; they have 36-byte records and variable numbers of records per file. All other files are ASCII with a carriage-return/line-feed pair at the end of each record. AMD files have 36 bytes per record. ION and TRO files have 82 bytes per record. WEA files have 62 bytes per record. INDEX.TAB has 121 bytes per record. ATDF_TUT.TXT has 120 bytes per record. All other files have 80 bytes per record. Each file in the archive includes a PDS label. Files with names ending in *.TXT or *.CAT have attached labels - the label is the first few lines of the file. Files with other extensions -- e.g., ending in *.TAB, *.AMD, *.TDF, or *.ODF -- have detached labels; the label is in a separate file, which has the same name except that the extension is 'LBL'. Detached labels are ASCII files with 80 character lines, ending with carriage-return/line-feed pairs. PDS labels, whether attached or detached, consist of keyword = value statements that provide descriptive information about the data file. Labels are intended to be readable by both humans and machines. Details of the syntax and semantics of PDS labels can be found in the PDS Standards Reference [1]. Definitions of the keywords used in the label can be found by using the PDS Data Dictionary Lookup web service at http://pds.jpl.nasa.gov/tools/data_dictionary_lookup.cfm. The archive is 'electronic' meaning that its format is independent of the medium on which it is (temporarily) stored. ----------------------------------------------------------------------------- 5.0 Cognizant Persons For questions concerning this archive: Ray Arvidson -- Planetary Data System, Geosciences Node Manager Washington University Dept. of Earth and Planetary Sciences 1 Brookings Drive Campus Box 1169 St. Louis, MO 63130 1-314-935-5609 E-mail address: arvidson@wunder.wustl.edu Dick Simpson -- Planetary Data System, Radio Science Advisor Stanford University Packard Building - Room 332 (MC 9515) 350 Serra Mall Stanford, CA 94305-4020 1-650-723-3525 E-mail: radiosci@att.net For questions about the gravity investigation, use of data products, and derivation of gravity models: Alexander S. Konopliv Jet Propulsion Laboratory (301-144) California Institute of Technology 4800 Oak Grove Drive Pasadena, CA 91109 1-818-354-6105 E-mail address: alexander.s.konopliv@jpl.nasa.gov