CCSD3ZF0000100000001NJPL3IF0PDSX00000001 PDS_VERSION_ID = PDS3 RECORD_TYPE = FIXED_LENGTH RECORD_BYTES = 80 SPACECRAFT_NAME = MAGELLAN TARGET_NAME = VENUS OBJECT = TEXT PUBLICATION_DATE = 1993-09-01 NOTE = "WU-MGN-FBIDR-ACD V1.0 Software Interface Specification" END_OBJECT = TEXT END Washington University Earth and Planetary Remote Sensing Laboratory PROJECT MAGELLAN Software Interface Specification WU-MGN-FBIDR-ACD FULL-RESOLUTION BASIC IMAGE DATA RECORD COMPACT DISC ARCHIVE prepared by Thomas C. Stein, Raymond E. Arvidson Department of Earth and Planetary Sciences Washington University St. Louis, Missouri 63130 Tel (314) 935-5679 Version 1.0 September 1, 1993 ________________________________________________________________________ 1. GENERAL DESCRIPTION 1.1. Overview This Software Interface Specification (SIS) contains the description of the Full-Resolution Basic Image Data Record (F-BIDR) product archive write-once compact discs (CD-WO) for the Magellan Project. 1.2. Scope The format and content specifications in this SIS apply to the Magellan F-BIDR product archive as stored on compact disc. 1.3. Applicable Documents International Standards Organization (ISO) document: [1] ISO 9660-1988, Information Processing - Volume and File Structure of CD-ROM for Information Exchange, April 15, 1988. Jet Propulsion Laboratory (JPL) documents: [2] SDPS-101, Magellan Software Interface Specification, Full-Resolution Basic Image Data Record, K. Leung, JPL, Revision E, August 31, 1992. [3] JPL D-7669, PDS Data Preparation Workbook, Version 3.0, April 31, 1993. Additional JPL documents describe the format and content of the set of F-BIDR files, as listed below. file_01. is described by: SDPS-101 file_02. TPS-101 file_03. TPS-101 file_04. NAV-135 file_05. SES-112 file_06. MON-105 file_07. RES-104 file_08. RES-101 file_09. SES-115 + TPS-129 file_10. TPS-101 + SFOC-5-TIS-*DU-MgnSFDU file_11. TPS-101 + SFOC-1-MHR-Mgn-SABHdr file_12. SDPS-101 file_13. SDPS-101 file_14. SDPS-101 file_15. SDPS-101 file_16. SDPS-101 file_17. SDPS-101 file_18. SDPS-101 file_19. SDPS-101 file_20. SDPS-101 For information on obtaining any of these documents, contact the Magellan Data Product Support Office. (Refer to Section 6 of the AAREADME.TXT file on this volume for contact information.) Other documents: [4] VAX Architecture Handbook, Digital Equipment Corporation, 1986. 1.4. System Siting 1.4.1. Interface Location and Medium F-BIDR write-once compact discs (CD-WO) are created by the Washington University Geosciences Node of the Planetary Data System, using Sun/4 workstations and Young Minds CD-Studio compact disc authoring systems. 1.4.2. Data Sources, Destinations, and Transfer Methods F-BIDR archive CD-WOs (ACD) include the original F-BIDR files as delivered by the Magellan Project's Data Management and Archive Team (DMAT) at JPL. F-BIDR ACDs are written in the ISO-9660 standard format [1]. Two copies of each CD-WO are generated. One copy remains archived at Washington University. The other copy is forwarded to the National Space Science Data Center (NSSDC) for archive. 1.4.3. Generation Method and Frequency F-BIDR ACDs are generated from the F-BIDR tapes created as part of the standard product set by the Magellan Project. Each source tape volume contains one F-BIDR product. Each F-BIDR product received is compared to the F-BIDR Software Interface Specification (SIS) [2] for consistency. Any anomalies are noted in the anomaly report file (ERRATA.TXT) archived with each ACD. Corrections to the F-BIDR product are not made, except for replacing unreadable tapes or files. Each ACD contains 4 or more consecutive F-BIDR products, depending on the product size. Only the latest version of an F-BIDR is archived. Earlier versions will be available on demand through the Washington University Geosciences Node as resources allow. 1.5. Assumptions and Constraints 1.5.1. Usage Constraints Access to F-BIDR ACD is provided by Washington University on an as needed basis to PDS users as resources permit. 1.5.2. Documentation Conventions 1.5.2.1. Data Format Descriptions The reference data unit is the byte. In the F-BIDR product, data are stored in fields with various sizes and formats: one-, two-, and four-byte binary integers, four-byte binary floating-point numbers, and character strings, as detailed in the F-BIDR SIS [2]. Floating-point numbers and integers are written using the Digital Equipment Corporation representation. Single-precision floating point numbers occupy four bytes; double-precision floating point numbers occupy eight bytes. The order of bits for floating point numbers is shown below (bit 0 is the left-most bit) SINGLE MSB to LSB DOUBLE MSB to LSB ------ ---------- ------ ---------- exponent 14-7 exponent 14-7 fraction 6-0, 31-16 fraction 6-0, 31-16, 47-32, 63-48 sign 15 sign 15 For each floating-point format, fractions are represented in sign-magnitude notation, with the binary radix point to the left of the most significant bit. Fractions are assumed to be normalized, and therefore the most significant bit is not stored (this is called "hidden bit normalization"). This bit is assumed to be 1 unless the exponent is 0. If the exponent is 0, then the value represented is 0. For both single- and double-precision floating-point numbers, bits 14-7 represent an excess 128 binary exponent. Integers are represented in two's complement form. Refer to the VAX Architecture Handbook [4] for further details of integer and floating-point data representation. 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 with lower numbered bytes preceding higher numbered bytes. 1.5.2.2. Limits of This Document This document defines the format for F-BIDR archive compact disc products. ________________________________________________________________________ 2. INTERFACE CHARACTERISTICS 2.1. Hardware Characteristics and Limitations 2.1.1. Special Equipment and Device Interfaces F-BIDR ACD volumes require no special equipment to be read. Each volume is an ISO-9660 compliant CD-WO and may be read on any standard CD-ROM player. 2.2. Volume and Size Each ACD volume contains 4 or more F-BIDR products, depending on the product sizes. Each F-BIDR product contains the data for one orbit, and consists of 20 files, as detailed in the F-BIDR SIS [2]. The size of an F-BIDR product varies according to the design characteristics of that orbit, spacecraft system functions, and telemetry quality. Each F-BIDR product is a maximum of 170 MB in size. Each archive volume contains F-BIDR products from consecutive orbits where possible. F-BIDR products will not be spread across two archive volumes. 2.3. Labeling and Identification 2.3.1. External Disc Labels Each volume has a primary external label identifying the volume. The label consists of the following information: archive volume id (see below) and creation date (format YYYY-MM-DD). The primary label is handwritten about the hub to avoid disc imbalance caused by adhesive labels. Each volume has a secondary external label identifying its contents. The label consists of archive volume id, creation date, and volume contents (listed as F-BIDR product id and product size). The secondary label is in the form of a front liner in the protective CD-WO jewel case. The archive volume id is a unique identifier, with the format: USA_NASA_PDS_MG_4xxx where 'xxx' is a 3-digit decimal number denoting the sequential volume number, beginning with '001' for the first archive volume, and incremented by 1 for each subsequent volume. 2.3.2. Internal Labeling The content of each of the 20 F-BIDR data files on the ACD is described by an associated PDS detached label file. The labels conform to the referenced PDS Standards [3]. Appendix A contains an example of a PDS detached label file. 2.4. Interface Medium Characteristics Magellan F-BIDR archive products are contained on one CD-WO volume written to ISO-9660 standards. The data volume of each CD-WO is no more than 670 MB. ________________________________________________________________________ 3. DETAILED INTERFACE SPECIFICATIONS 3.1. Structure and Organization Overview The F-BIDR archive volume is an NFS-mountable volume containing a [CATALOG] directory, [DOCUMENT] directory, [INDEX] directory, and 4 or more data directories, each containing an F-BIDR product. The root directory contains the following files: AAREADME.TXT - terse description of volume contents ERRATA.TXT - F-BIDR errors and anomalies (overview) VOLDESC.CAT - volume object definition The [CATALOG] directory contains the following files: CATINFO.TXT - Description of files in the CATALOG directory. DATASET.CAT - PDS dataset catalog object The [DOCUMENT] directory contains the following file: DOCINFO.TXT - Description of files in the DOCUMENT directory. FBIDRACD.TXT - this file The [INDEX] directory contains the following files: CUMINDEX.LBL - PDS label for the cumulative volume index (CUMINDEX.TAB). CUMINDEX.TAB - Cumulative volume index in tabular format. INDEX.LBL - PDS label for the volume index (INDEX.TAB). It identifies the volume index and describes the structure (columns) of the index table. INDEX.TAB - Volume index in tabular format. INDXINFO.TXT - Description of files in the INDEX directory. Each F-BIDR product is stored within a subdirectory named [fnnnn_x] where 'nnnn' is a 4-digit decimal number denoting the Magellan Project-assigned orbit number and 'x' is a 1-digit decimal number denoting the Project assigned version of the F-BIDR product for the orbit. Within the F-BIDR product subdirectory, the following files appear: ERR_oooo.TXT - List of discrepancies for this BIDR between the SIS and the BIDR data files FILE_01. - Summary BIDR Volume Information FILE_02. - Orbit Header FILE_03. - EDR Data Quality Summary FILE_04. - S/C ephemeris file FILE_05. - SCLK/SCET conversion coefficients FILE_06. - DSN monitor records FILE_07. - Quaternion pointing coefficients FILE_08. - Processing bandwidth FILE_09. - Decommutation and decalibration data FILE_10. - Engineering data FILE_11. - Radar burst header records FILE_12. - Per-Orbit Parameters FILE_13. - Image data in oblique sinusoidal projection FILE_13.AUX - Index file for FILE_13. FILE_14. - Processing parameters for oblique sinusoidal data FILE_15. - Image data in sinusoidal projection FILE_15.AUX - Index file for FILE_15. FILE_16. - Processing parameters for sinusoidal data FILE_17. - Processed radiometric data FILE_18. - Cold-sky calibration results FILE_19. - Processing monitor record FILE_20. - Additional BIDR volume information FILE_01.LBL - PDS label for FILE_01.dat (see Appendix A) FILE_02.LBL - PDS label for FILE_02.dat FILE_03.LBL - PDS label for FILE_03.dat : : : FILE_20.LBL - PDS label for FILE_20.dat FILE_nnA.LBL - PDS labels for auxillary files 13 and 15 ________________________________________________________________________ APPENDIX A. SAMPLE FILE_01.LBL FILE CCSD3ZF0000100000001NJPL3IF0PDSX00000001 PDS_VERSION_ID = PDS3 RECORD_TYPE = FIXED_LENGTH RECORD_BYTES = 32500 FILE_NAME = 'FILE_01.' FILE_RECORDS = 1 HARDWARE_MODEL_ID = 'SUN SPARCSTATION 10 MODEL 30' OPERATING_SYSTEM_ID = 'SUN OS 4.1.3' DATA_SET_ID = 'MGN-V-RDRS-5-BIDR-FULL-RES-V1.0' PRODUCT_ID = 'F-BIDR.00376;03' SPACECRAFT_ID = MGN SPACECRAFT_NAME = MAGELLAN INSTRUMENT_ID = RDRS INSTRUMENT_NAME = 'RADAR SYSTEM' TARGET_NAME = VENUS START_TIME = 1990-09-15T16:22:19.211 STOP_TIME = 1990-09-15T16:59:28.273 SPACECRAFT_CLOCK_START_COUNT = '00723776.72.2.0 SPACECRAFT_CLOCK_STOP_COUNT = '00723813.48.8.0 START_ORBIT_NUMBER = 376 STOP_ORBIT_NUMBER = 376 PRODUCT_CREATION_TIME = 1993-09-03 INTERCHANGE_FORMAT = ASCII DESCRIPTION = "This file contains a single SFDU volume header record and uniquely identifies the BIDR by orbit number and creation time. For more information, refer to SDPS-101, Magellan Software Interface Specification, Full-Resolution Basic Image Data Record, K. Leung, JPL, Revision E, August 31, 1992." END