Volume PV05_0001 Pioneer Venus Orbiter - Venus Orbital Operations CD-ROM Supplementary Experimenter Data Records (SEDR) Orbits 1-400 Superior Conjunction during orbits 252-281 Planetary Plasma Interactions Node of the Planetary Data System ============================================================================== Introduction ============================================================================== This disk contains Venus Orbital Operations data submitted to the Planetary Data System (PDS) by PVO Magnetometer Experiment project investigators. Every effort has been made to assure that the data are of the best quality available. However, the PDS and the Planetary Plasma Interactions (PPI) Node in particular, assume no liability for this disk or its contents. All users are encouraged to verify the "correctness" of the data prior to submitting any publications or other work based on these data. Brief Disk Description This CD-ROM contains data for orbits 1-400 covering the time period between 1978-12-05 to 1980-01-09. There is no data for orbits 252-281 due to a superior conjunction. All data files are stored in the "DATA" branch of the directory tree. Data are stored in IBM binary/EBCDIC format (*.DAT). Each file has a corresponding PDS label file, *.LBL. Software to convert binary data to ASCII can be found in the SOFTWARE directory. When the UCLA magnetometer team corrected the pulse times, they either corrected or inserted the following fields as appropriate: msec_of_Fs, msec_of_Rip and nearest_real_sun_pulse. The values for the other fields in such records were set to zero. Note: due to a bug in the early version of the program, 63 orbits contain invalid values in some of the corrected or inserted records. These values should be ignored. A list of the files and record numbers that contain this error are available in the file /DATA/AANOMALY.TXT. Users of this disk should read the INFO.TXT file located in the DATA directory which explains where each type of data is located, as well as the INFO.TXT files located in each data directory which describe the data in that directory. Novice users can ignore all directories and files except for those mentioned in this brief description. ============================================================================== Volume Set Information ============================================================================== This CD-ROM is the first disk of the PV05_xxxx series. This volume set contains an exact copy of the original SEDR data tapes provided to the Magnetometer instrument team. These original data tapes contained six different files all stored in IBM binary/EBCDC format. These files are 1) a logistics or tape header file, 2) a spacecraft attitude file, 3) an ephemeris file, 4) a pulse time file, 5) a selected roll reference file, and 6) a spin period file. In addition to these original 6 files, the magnetometer team has included their "corrected pulse time" file. With this one exception, no effort has been made to process or change in any way the original SEDR data as provided by the project. The Electric Field Detector data is used to "correct" the pulse times. OEFD detects a signal that is not due to plasma waves that is synchronized with the sun. The phase of this signal is calculated at the spin period relative to the solar direction, using the pulse times provided by the project. If the phase is not in the range expected or if the phase is drifting there is a problem with the pulse times. The 5.4 kHz channel is used because of the generally low level of ambient (natural) signal at this frequency and because the sun induced spin signal is well defined at this frequency. The complete volume set will include orbits 1-5055 (1978-12-05 to 1992-10-07). ============================================================================== Errata ============================================================================== There is a file called ERRATA.TXT found at the root level of this volume which contains a list of changes and errors if there are any at the time this CD was published. This is a list of cumulative changes made to any PVO SEDR CD-ROM (volume set PV05) created by this production date. Any changes or errors that were found to any PV05 CD-ROM after the production of this volume can be found via anonymous-ftp at ftp.igpp.ucla.edu (ftp 128.97.68.41). The account name is anonymous and the password should be your e-mail address (it's nice to leave an audit trail). Change to the PDS errata directory (cd pds/ERRATA/PV05), and transfer the file ERRATA.TXT (get ERRATA.TXT). ============================================================================== Software ============================================================================== There is software on this disk to convert from SEDR raw IBM binary data files to ASCII data files for the SUN_OS/UNIX, HP/UNIX, and IBM/PC platforms. Source code to compile on any other system, including VAX/VMS is also available. Software is also available from the PPI Node via an anonymous ftp account - ftp.igpp.ucla.edu (128.97.68.55). VAX users can obtain software from UCLASP::DISK$SCRATCH:[PDSUSER.SOFTWARE], installation procedures are provided in the file SOFTINFO.TXT. Instructions on compiling source code on other systems is provided in the file INSTALL.TXT. This file is bundled with the SEDR2ASC.TAR file. Procedures to unbundle the tar file is provided in the SOFTWARE/SOURCE/INFO.TXT file. In general, if the installation location is fully compatible with the development platform, the executable will be moved to the installation area. If there are minor incompatibilities (operating system version or compiler version differences) a new executable will be generated from the object code. If there are major incompatibilities i.e. unsupported platform) and source code is available, the user will have to port the code to the platform needed. File naming will be freeform, however, the file name extensions will follow the standard naming for Unix platforms (.f - Fortran source code, .c - "C" source code, .o - object code, etc.) ============================================================================== File Formats ============================================================================== All files on this disk are described by detached version 3.0 PDS labels. Version 3.0 of the PDS label does not support detached TEXT file labels, however, TEXT file labels are detached on this disk. This is the only known exception to the PDS version 3.0 standard. PDS labels are identified by a .LBL file name extension. There is one label file for each text and data file contained on this disk and the file name prefix is the same as the file the label describes. The data directories contain multiple data files all with an identical structure. There are two ASCII text format files which describe the physical structure of the data files (header and data areas). These format files are then pointed to by all of the labels. Both the label files and the format files (*.FMT) are all located in the same directory as the data they describe. ============================================================================== Disk Format ============================================================================== The disk is organized into a hierarchical directory structure which the PPI Node hopes will be both intuitive for the user as well as easy to use. The disk is formatted according to both ISO 9660 and POSIX (UNIX) standards in order to accommodate users on a wide variety of platforms. All of the label, table, and text files are ASCII with CR/LF (VAX / IBM-PC) format. ============================================================================== Volume Contents and Structure ============================================================================== This section describes the volume structure and naming conventions. Below is a tree diagram of the CD-ROM, followed by a description of the directory function and key files in each directory. Note: There is a file called YMTRANS.TBL in every directory. This is characteristic of the CD-ROM production software. Also within each of the DATA sub-directories there is a file called ZZINPUT.PDS which is a necessary production file, but not for the user. Excuse any inconvenience that these files may cause. The basic organization of the disk is as follows: CD-ROM | +-CATALOG | +-DOCUMENT | +-INDEX | +-MANAGE | +-DOS | +-HPUX +-SOFTWARE--+-SOLARIS | +-SOURCE | +-SUNOS | +-VMS | +-DATA------+ | | +-ORB0001 +-ATTITUDE-+-ORB0101 | +-ORB0201 | +-ORB0301 | | +-ORB0001 +-COR_PT---+-ORB0101 | +-ORB0201 | +-ORB0301 | | +-ORB0001 +-EPHEM----+-ORB0101 | +-ORB0201 | +-ORB0301 | | +-ORB0001 +-LOGISTIC-+-ORB0101 | +-ORB0201 | +-ORB0301 | | +-ORB0001 +-PULSE----+-ORB0101 | +-ORB0201 | +-ORB0301 | | +-ORB0001 +-SEL_ROLL-+-ORB0101 | +-ORB0201 | +-ORB0301 | | +-ORB0001 +-SPIN-----+-ORB0101 +-ORB0201 +-ORB0301 The following is a brief summary of the contents of each directory: CATALOG Contains mission, spacecraft, dataset, software, parameter and coordinate system templates organized into one file called CATALOG.CAT. key files: CATALOG.CAT - Contains catalog templates CATINFO.TXT - Explains directory contents. DOCUMENT Contains the original project documentation describing the PVO SEDR. The document has been scanned electronically and stored as "TIF" files (images of the actual pages) and the document has also been converted to an ASCII text file (with all graphics missing). key files: SEDR.ASC - ASCII text of the SEDR documentation SEDRXX.TIF - Scanned image of SEDR documentation page XX in TIFF format. DOCINFO.TXT - Describes the contents of the DOCUMENT directory. INDEX Contains a cumulative index table (CUM_INDX.TAB) which describes the location of all files on the PV05 collection (PVO-SEDR). In addition, there is a file (INDEX.TAB) which gives the name and location of all files on this volume. These index files have been provided for users who do not wish to make use of the DITDOS software. key files: CUM_INDX.TAB - Contains a cumulative index for the PV05 volume set (a collection of all INDEX.TABs - see below). CUM_INDX.LBL - Describes the columns and format of CUM_INDX.TAB. INDEX.FMT - Describes the structure for both the CUM_INDX.TAB file and the INDEX.TAB file. INDEX.TAB - Contains an index of this volume (PV05_0001) containing name of file, dataset association, and Volume ID. INDEX.LBL - Describes the columns and format of INDEX.TAB. INDXINFO.TXT - Describes the contents of this directory. MANAGE Contains data management information for the DITDOS software. Users do not need to make use of any of these files directly, however, the software which allows DITDOS to extract and reformat data files needs to have this information. key files: No User Files SOFTWARE Contains software to extract data from the PVO SEDR CD-ROM series. The software allows users to extract data to the screen for test display or to ASCII output files. Source code is written in C and therefore should compile on various platforms including UNIX, DOS, HP, VAX, etc. The executable for SOLARIS, SUNOS, HPUX and PC (DOS) is available on the disk. VMS software is available electronically from the PDS-PPI Node. key files: SOFTINFO.TXT - Describes the software available and how to acquire software for VMS platforms. DATA Contains all data in a branching tree structure of sub-directories. In the data file names, the string xxx refers to the orbit number. key files: SEDR_DOC.TXT - ASCII text of the SEDR documentation. AANOMALY.TXT - Describes the dataset anomaly DATA/ATTITUDE contains directories of S/C attitude data DATA/ATTITUDE/ORB0001 contains data for orbits 1-100 DATA/ATTITUDE/ORB0101 contains data for orbits 101-200 DATA/ATTITUDE/ORB0201 contains data for orbits 201-300 DATA/ATTITUDE/ORB0301 contains data for orbits 301-400 key files: INFO.TXT - Describes the directory contents ATxxxx.DAT - Data file in IBM binary format ATxxxx.LBL - PDS label describing the structure of the data file. ATHDR.FMT - Format file describing the header portion of the data file ATDATA.FMT - Format file describing the data portion of the data file DATA/COR_PT contains directories of "corrected" pulse time data files DATA/COR_PT/ORB0001 contains data for orbits 1-100 DATA/COR_PT/ORB0101 contains data for orbits 101-200 DATA/COR_PT/ORB0201 contains data for orbits 201-300 DATA/COR_PT/ORB0301 contains data for orbits 301-400 key files: AANOMALY.TXT - Describes the dataset anomaly INFO.TXT - Describes the directory contents CPxxxx.DAT - Data file in IBM binary format CPxxxx.LBL - PDS label describing the structure of the data file. CPHDR.FMT - Format file describing the header portion of the data file CPDATA.FMT - Format file describing the data portion of the data file DATA/EPHEM contains directories of ephemeris data files DATA/EPHEM/ORB0001 contains data for orbits 1-100 DATA/EPHEM/ORB0101 contains data for orbits 101-200 DATA/EPHEM/ORB0201 contains data for orbits 201-300 DATA/EPHEM/ORB0301 contains data for orbits 301-400 key files: INFO.TXT - Describes the directory contents EPxxxx.DAT - Data file in IBM binary format EPxxxx.LBL - PDS label describing the structure of the data file. EPHDR.FMT - Format file describing the header portion of the data file EPDATA.FMT - Format file describing the data portion of the data file DATA/LOGISTIC contains directories of logistic (tape header) data files DATA/LOGISTIC/ORB0001 contains data for orbits 1-100 DATA/LOGISTIC/ORB0101 contains data for orbits 101-200 DATA/LOGISTIC/ORB0201 contains data for orbits 201-300 DATA/LOGISTIC/ORB0301 contains data for orbits 301-400 key files: INFO.TXT - Describes the directory contents SLxxxx.DAT - Data file in IBM binary format SLxxxx.LBL - PDS label describing the structure of the data file. SL.FMT - Format file describing the header portion of the data file SEDR.TAB - Table containing start, stop, periapsis, etc. DATA/PULSE contains directories of original SEDR pulse time data files DATA/PULSE/ORB0001 contains data for orbits 1-100 DATA/PULSE/ORB0101 contains data for orbits 101-200 DATA/PULSE/ORB0201 contains data for orbits 201-300 DATA/PULSE/ORB0301 contains data for orbits 301-400 key files: INFO.TXT - Describes the directory contents PTxxxx.DAT - Data file in IBM binary format PTxxxx.LBL - PDS label describing the structure of the data file. PTHDR.FMT - Format file describing the header portion of the data file PTDATA.FMT - Format file describing the data portion of the data file DATA/SEL_ROLL contains directories of selected roll reference data files DATA/SEL_ROLL/ORB0001 contains data for orbits 1-100 DATA/SEL_ROLL/ORB0101 contains data for orbits 101-200 DATA/SEL_ROLL/ORB0201 contains data for orbits 201-300 DATA/SEL_ROLL/ORB0301 contains data for orbits 301-400 key files: INFO.TXT - Describes the directory contents SRxxxx.DAT - Data file in IBM binary format SRxxxx.LBL - PDS label describing the structure of the data file. SRHDR.FMT - Format file describing the header portion of the data file SRDATA.FMT - Format file describing the data portion of the data file DATA/SPIN contains directories of spin period data files DATA/SPIN/ORB0001 contains data for orbits 1-100 DATA/SPIN/ORB0101 contains data for orbits 101-200 DATA/SPIN/ORB0201 contains data for orbits 201-300 DATA/SPIN/ORB0301 contains data for orbits 301-400 key files: INFO.TXT - Describes the directory contents SPxxxx.DAT - Data file in IBM binary format SPxxxx.LBL - PDS label describing the structure of the data file. SPHDR.FMT - Format file describing the header portion of the data file SPDATA.FMT - Format file describing the data portion of the data file ============================================================================== Driver and Hardware Information ============================================================================== This disk has been formatted according to the ISO standard for CD-ROM production (9660) with level 1 compliance. Any system which complies with this standard (all of them should) should be able to access this disk. Recommended CD-ROM Drives and Driver Software Please note that the following list is not complete. However, these drives and driver software were tested and approved by the project. VAX/VMS Drive: Digital Equipment Corporation (DEC) RRD40, RRD42, or RRD50. Driver: DEC VFS CD-ROM driver V4.7 or V5.2 and up. Product VMS vn Released Commands VFS010 4.7 4/88 MOUNT/STRUCTURE=ISO_9660 VFS020 5.2 12/89 MOUNT/STRUCTURE=ISO_9660 VFS022 5.4 7/90 CDMOUNT/STRUCTURE=ISO_9660 F11CD055 5.5 6/92 CD_MOUNT, CD_DISMOUNT, CDROM (dump) ISO support will be bundled with VMS in version 6.0. Note: VMS drivers can be obtained at UCLASP::DISK$SCRATCH:[PDSUSER.SOFTWARE.VMS_DRIVERS] VAX/Ultrix Drive: DEC RRD40, RRD42, or RRD50. Driver: Supplied with Ultrix 3.1. Note: Use the "cdio" software package (in "~ftp/src/cdio.shar" from the "space.mit.edu" server). Contact Dr. Peter Ford for details. IBM PC Drive: Toshiba, Hitachi, Sony, or compatible. Driver: Microsoft MSCDEX version 2.2. Note: The newest version of MSCDEX (released in February 1990) is generally available. Apple Macintosh Drive: Apple CD SC (Sony) or Toshiba. Driver: Apple CD-ROM driver. Note: The Toshiba drive requires a separate driver, which may be obtained from Toshiba. Sun Micro Drive: Delta Microsystems SS-660 (Sony). Driver: Delta Microsystems driver or SUN CD-ROM Driver. Note: For questions concerning this driver, contact Denis Down at Delta Microsystems, 415-449-6881. ============================================================================== Point of Contact ============================================================================== If the user has problems reading this disk or can not make use of it on one or more of the platforms which should be supported, please contact the PPI pds_operator. This person can be reached in the following ways: SPAN/DEC-NET uclasp::pds_operator Internet pds_operator@igpp.ucla.edu Telephone (310) 206-6073 U.S. Mail PDS Operator c/o Dr. Raymond Walker 3845 Slichter Hall UCLA - IGPP Los Angeles, CA 90024-1567 ============================================================================== Cognizant Persons ============================================================================== The person most directly responsible for the construction and release of this CD-ROM is Mr. Steven Joy. He was the PPI Node Data Administrator at the time this disk was created and he understands as much about the disk structure and data organization as anyone. The construction of the PDS labels and templates was done by Ms. Eva Fried of the PPI Node and verified by Ms. Ruth Monarrez of the Central Node at JPL. PPI Personnel JPL Personnel Ray Walker / Steve Joy Eva Fried / Todd King Ruth Monarrez 3845 Slichter Hall 4800 Oak Grove Dr. UCLA - IGPP Mail Stop 525-3610 Los Angeles, CA 90024-1567 Pasadena, CA 91109