Volume PV01_0023 Pioneer Venus Orbiter - Venus Orbital Operations CDROM Magnetometer and Electric Field Detector Datasets Orbits 1081-1120 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 project Magnetometer and Electric Field Detector principal 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 1081-1120 covering the time period between 1981-11-20 to 1981-12-30. All data files are stored in the "DATA" branch of the directory tree. Data are stored in IGPP flatfile form which is a binary representation of data ( *.FFD) plus a detached header file (*.FFH) which describes the structure of the data file to software. Software to read IGGP flatfiles and convert data to ascii can be found on disk 1 of this volume series. All data are given in PVO Inertial Spacecraft Coordinates. Software to rotate MAG vectors into Venus Solar Orbital (VSO) is provided on disk 1. Users of this disk should read the INFO.TXT files located in each data directory which describe the data in that directory, as well as the other files in that directory. Although the INFO.TXT file is quite large it contains the most relevant information first. It begins by describing the type of data in the directory, the orbits covered, and the names of the most useful user files. Next the file naming conventions are described and the structure of the data files is given. More detailed information about each data file is then given. Novice users can ignore all directories and files except for those mentioned in this brief description. ============================================================================== Volume Set Information ============================================================================== This CD-ROM is the twenty-third disk of the PV01_xxxx series. This volume set contains the processed data from the Magnetometer and Electric Field Detector Team. Every volume will contain full resolution and 24 second averaged magnetometer data in spacecraft coordinates, full resolution and 24 second averaged electric field data, ephemeris data, engineering data, instrument status data, and phase and offset data. The OMAG and OEFD have been averaged over two spin periods (approximately 24 seconds). The averaging interval is overlapped and data are output on single spin period centers, the time stamp corresponding to the center of the averaging window. This volume set will contain 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 OMAG/OEFD CD_ROM (volume set PV01) created by this production date. Any changes or errors that were found to any PV01 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/PV01), and transfer the file ERRATA.TXT (get ERRATA.TXT). ============================================================================== 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. Most of the data files are time-series which are organized as IGPP flatfiles. An IGPP flatfile is a collection of 2 files, each of which could be considered a table. The data file (.FFD) is a binary table of data values. The header file (.FFH) is in ascii table which describes the data file (.FFD) and is used by the UCLA/IGPP Data Flow System (a software package). PDS labels are identified by a .LBL file name extension. There is one label file for each text and data file (1 flatfile) contained on this disk and the file name prefix is the same as the file the label describes. If the dataset is stored as multiple files (as most of them are), there will be a single format file which describes the physical structure of the data. This format file is then pointed to by all of the labels. Both the label files and the format files (*.FMT) are all located in the same directories 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 (VMS / 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. CDROM | +- CATALOG | +- INDEX | +- MANAGE | +- SOFTWARE | +- DATA | +- ENGR | +- EPHEM | +- INSTSTAT | +- OEFD | | | +- 24S | | | +- HIRES | | +- OMAG | | | +- 24S | | | +- HIRES | | +- PHASEOFF CATALOG Contains mission, spacecraft, coordinate, software, instrument, dataset, data processing and parameter templates organized into one file called CATALOG.CAT. key files: CATALOG.CAT - Contains catalog templates. CATINFO.TXT - Describes the directory contents. INDEX Contains a cumulative index table (CUM_INDX.TAB) which describes the location of all files on the PV01 collection (PVO OMAG/OEFD). 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 PV01 volume set. CUM_INDX.LBL - Describes the columns and format of CUM_INDX.TAB. INDEX.TAB - Contains an index of this volume (PV01_0023). 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 information about software to extract data from this disk. key files: SOFTINFO.TXT - Describes and explains the software available in the directory. DATA Contains all data in a branching tree structure of sub-directories. There is a file ZZINPUT.PDS which will be found in each DATA sub-directory which is just for our in-house production. Excuse any inconvenience these files may cause. key files; INFO.TXT - describes the sub-directories in DATA. COORDS.TXT - Coordinate system descriptions. SOFTWARE.TXT - Data processing software descriptions. DATA/ENGR Contains the engineering data associated with the OMAG and OEFD datasets. key files: INFO.TXT - Describes the directory contents. ENGRDATA.FMT - Format file that describes the binary data file. ORBxxxx.FFD - Binary data file. ORBxxxx.FFH - Ascii header file. DATA/EPHEM Contains the ephemeris data associated with the OMAG and OEFD datasets. key files: INFO.TXT - Describes the directory contents. DATASET.TXT - Dataset description. DSPROC.TXT - Specifies which software was used in processing. PARM.TXT - Dataset and instrument parameter descriptions. EPHEMDATA.FMT - Format file that describes the binary data file. ORBxxxx.FFD - Binary data file. ORBxxxx.FFH - Ascii header file. DATA/INSTSTAT Contains the instrument status data associated with the OMAG and OEFD datasets. key files: INFO.TXT - Describes the directory contents. INSTDATA.FMT - Format file that describes the binary data file. ORBxxxx.FFD - Binary data file. ORBxxxx.FFH - Ascii header file. DATA/OEFD Contains two sub-directories of the electric field data, the full resolution data, and the 24 second averaged data. key files: INFO.TXT - Describes the sub-directories in OEFD, and the naming convention of the files in the sub-directories. INST.TXT - Instrument description. DSPROC.TXT - Specifies which software was used in processing. PARM.TXT - Dataset and instrument parameter descriptions. DATA/OEFD/24S Contains 24 second averaged OEFD data files. key files: INFO.TXT - Describes the directory contents. DATASET.TXT - Dataset description. OEFDDATA.FMT - Format file describing the binary data file. ORBxxxx.FFD - Binary data file. ORBxxxx.FFH - Ascii header file. DATA/OEFD/HIRES contains the full resolution OEFD data files. key files: INFO.TXT - Describes the directory contents. DATASET.TXT - Dataset description. OEFDDATA.FMT - Format file describing the binary data file. ORBxxxx.FFD - Binary data file. ORBxxxx.FFH - Ascii header file. DATA/OMAG Contains two sub-directories of the magnetic field data, the full resolution data, and the 24 second averaged data. key files: INFO.TXT - Describes the sub-directories in OMAG, and the naming convention of the files in the sub-directories. INST.TXT - Instrument description. DSPROC.TXT - Specifies which software was used in processing. PARM.TXT - Dataset and instrument parameter descriptions. DATA/OMAG/24S Contains 24 second averaged OMAG data files. key files: INFO.TXT - Describes the directory contents. DATASET.TXT - Dataset description. OMAGDATA.FMT - Format file that describes the binary data file. ORBxxxx.FFD - Binary data file. ORBxxxx.FFH - Ascii header file. DATA/OMAG/HIRES contains the full resolution OMAG data files. key files: INFO.TXT - Describes the directory contents. DATASET.TXT - Dataset description. OMAGDATA.FMT - Format file that describes the binary data file. ORBxxxx.FFD - Binary data file. ORBxxxx.FFH - Ascii header file. DATA/PHASEOFF Contains the phase and offset data associated with the OMAG and OEFD datasets. key files: INFO.TXT - Describes the directory contents. INSTDATA.FMT - Format file that describes the binary data file. ORBxxxx.FFD - Binary data file. ORBxxxx.FFH - Ascii header file. ============================================================================== Software ============================================================================== There is NO software on this disk. The software will be contained on disk PV01_0001, the first volume in this series. The software will be provided by the PVO OMAG/OEFD team which will support UNIX and VMS systems, and by the PDS PPI group which will be multiplatform. Included will be software to rotate the magnetometer data from spacecraft to Venus Solar Orbital (VSO) coordinates (PVROT), convert the binary data files to ascii (FF2ASCII), and merge files (FFMERGE). Software is also available from the PPI Node via an anonymous ftp account - ftp.igpp.ucla.edu (128.97.68.41), and VAX users can obtain software from UCLASP::DISK$SCRATCH:[PDSUSER.SOFTWARE]. Installation procedures will be provided for all software on this disk in the INSTALL. 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. The "INFO.TXT" files will help the user determine if a desired program or application can be used on their platform. File naming will be free-form, 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.) ============================================================================== Driver and Hardware Information ============================================================================== This disk has been formatted according to the ISO standard for CDROM 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 CDROM 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 and Ms. Muriel Kniffin of the PPI Node and Ms. Sue Hess and Ms. Ruth Monarrez of the Central Node at JPL. Mr. Mike Martin of JPL has helped to insure this disk conforms to accepted PDS standards. PPI Personnel JPL Personnel Ray Walker / Steve Joy Muriel Kniffin Eva Fried / Todd King Sue Hess / Ruth Monarrez / Mike Martin 3845 Slichter Hall 4800 Oak Grove Dr. UCLA - IGPP Mail Stop 525-3610 Los Angeles, CA 90024-1567 Pasadena, CA 91109