Volume PV05_0011 Pioneer Venus Orbiter - Venus Orbital Operations CD-ROM Supplementary Experimenter Data Records (SEDR) Orbits 3901-4300 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 3901-4300 covering the time period from 1989-08-10T14:36:00.000Z to 1990-09-14T23:39:00.000Z. There is no science data for orbits 3971-3973, and there is no data for orbit 3968, though the reason for this data gap is unclear. All data files are stored in the "DATA" branch of the directory tree. Data are stored in IBM binary/EBCDC 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, some 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/AANOMOLY.TXT. The list, however, is not exhaustive and while this error is not known to have occurred for any of the orbits included on this volume the user should exercise caution when using this data. 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 eleventh 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 on any PV05 CD-ROM after the production of this volume can be found via anonymous-ftp at pdsppi.igpp.ucla.edu. Give your login name as "anonymous", but please provide your e-mail address when prompted for a password. Change to the PDS errata directory (cd pds/ERRATA/PV05), and transfer the file ERRATA.TXT (get ERRATA.TXT). Changes can also be found through our web site at http://www.igpp.ucla.edu/igpp/ditdos.exe through the data access system. ============================================================================== Software ============================================================================== The Planetary Plasma Interactions (PPI) Node of NASA's Planetary Data System (PDS) provides software to facilitate the location of the data of interest on CD-ROM data products, as well as software to convert data between architecture specific data formats. In addition, the PPI Node provides software which has been made available by individual projects which may be useful when working with PPI data. Non-PDS software is provided "as is" and is distributed by the PPI Node as a service to the community. To obtain the most recent release of any PPI distributed software use anonymous FTP to connect the PPI FTP server located at "pdsppi.igpp.ucla.edu". (Complete instructions on using FTP can be found in the SOFTWARE directory in the file "FTP.TXT"). There is software on this disk to convert from SEDR raw IBM binary data files to ASCII data files for the SOLARIS/UNIX, 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), and 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: 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------+ | | +-ORB3901 +-ATTITUDE-+-ORB4001 | +-ORB4101 | +-ORB4201 | | +-ORB3901 +-COR_PT---+-ORB4001 | +-ORB4101 | +-ORB4201 | | +-ORB3901 +-EPHEM----+-ORB4001 | +-ORB4101 | +-ORB4201 | | +-ORB3901 +-LOGISTIC-+-ORB4001 | +-ORB4101 | +-ORB4201 | | +-ORB3901 +-PULSE----+-ORB4001 | +-ORB4101 | +-ORB4201 | | +-ORB3901 +-SEL_ROLL-+-ORB4001 | +-ORB4101 | +-ORB4201 | | +-ORB3901 +-SPIN-----+-ORB4001 | +-ORB4101 | +-ORB4201 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 "GIF89A" 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.GIF - Scanned image of SEDR documentation page XX in GIF89A 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_0011) 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 DITDOS file management information. Users do not need to make use of any of these files directly, however, PPI node uses this information to extract and reformat data from this volume for its website. 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/ORB3901 contains data for orbits 3901-4000 DATA/ATTITUDE/ORB4001 contains data for orbits 4001-4100 DATA/ATTITUDE/ORB4101 contains data for orbits 4101-4200 DATA/ATTITUDE/ORB4201 contains data for orbits 4201-4300 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/ORB3901 contains data for orbits 3901-4000 DATA/COR_PT/ORB4001 contains data for orbits 4001-4100 DATA/COR_PT/ORB4101 contains data for orbits 4101-4200 DATA/COR_PT/ORB4201 contains data for orbits 4201-4300 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/ORB3901 contains data for orbits 3901-4000 DATA/EPHEM/ORB4001 contains data for orbits 4001-4100 DATA/EPHEM/ORB4101 contains data for orbits 4101-4200 DATA/EPHEM/ORB4201 contains data for orbits 4201-4300 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/ORB3901 contains data for orbits 3901-4000 DATA/LOGISTIC/ORB4001 contains data for orbits 4001-4100 DATA/LOGISTIC/ORB4101 contains data for orbits 4101-4200 DATA/LOGISTIC/ORB4201 contains data for orbits 4201-4300 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/ORB3901 contains data for orbits 3901-4000 DATA/PULSE/ORB4001 contains data for orbits 4001-4100 DATA/PULSE/ORB4101 contains data for orbits 4101-4200 DATA/PULSE/ORB4201 contains data for orbits 4201-4300 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/ORB3901 contains data for orbits 3901-4000 DATA/SEL_ROLL/ORB4001 contains data for orbits 4001-4100 DATA/SEL_ROLL/ORB4101 contains data for orbits 4101-4200 DATA/SEL_ROLL/ORB4201 contains data for orbits 4201-4300 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/ORB3901 contains data for orbits 3901-4000 DATA/SPIN/ORB4001 contains data for orbits 4001-4100 DATA/SPIN/ORB4101 contains data for orbits 4101-4200 DATA/SPIN/ORB4201 contains data for orbits 4201-4300 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 Mr. Joe Mafi of the PPI Node. Mr. Tyler Brown of JPL has helped to insure this disk conforms to accepted PDS standards. Ray Walker / Steve Joy Eva Fried / Todd King Tyler Brown 3845 Slichter Hall 4800 Oak Grove Dr. UCLA - IGPP Mail Stop 525-389 Los Angeles, CA 90024-1567 Pasadena, CA 91109