Volume PV10_0003 Pioneer Venus Orbiter - Venus Orbital Operations CD-ROM Retarding Potential Analyzer Datasets Orbits 3001-5055 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 ORPA 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 is organized into 6 principal sub-directories. These are as follows: CATALOG Contains PDS Catalog templates which contain information describing the mission, spacecraft, instruments, data sets, personnel, and references. DATA Contains the data sub-directories. DOCUMENT Contains complete 'official' versions of documents published in other sources and contained on this volume (including copyright notices, and GIF image representations of figures and tables). Please note that full or partial copies of these documents may appear elsewhere on the CD-ROM. INDEX Contains a complete index of all files of interest including file location and associated data sets. MANAGE Contains DITDOS inventory files which PPI node uses for making this volume available on its website. SOFTWARE Contains a description of software useful for viewing or manipulating data found on this volume, plus instructions for obtaining it. For a more detailed description of these sub-directories, please refer to the "Volume Contents and Structure" section below. Novice users, however, can ignore all directories and files except for those mentioned in the following description of "Important Files and Directories." Important Files and Directories This CD-ROM contains data for orbits 3001-5055 covering the time period between 19xx-xx-xx to 1992-10-07. All data files are stored in the "DATA" branch of the directory tree. All the data, except for the UADS data, are stored in IEEE binary (.DAT) files, the UADS is stored in ASCII (.TAB) files. All are 1 file per orbit. The content of each data file is described by a detached PDS label file (.LBL). The internal structure or format of each data set is described by a single format file (.FMT) which is pointed to (^STRUCTURE). The file DATASET.TXT, found in each directory which contains data, provides additional information about the data which it accompanies. Users of this disk should read the INFO.TXT file located in the DATA directory which explains where each type of data is located. INFO.TXT files, which are located in each data sub-directory, describe the data found in that directory. Although the INFO.TXT files can be quite large they contain the most relevant information first. They begin by describing the type of data in the directory, the days 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. ============================================================================== Volume Set Information ============================================================================== This CD-ROM is disk 3 of 3 in the PV10_000x series. This volume set contains 1 processed dataset comprised of 4 components: 1) Thermal Electron, 2) Ion (which contains uncertainties), 3) Photoelectron, and 4) UADS data (density, temperature, S/C potential). Spacecraft position or trajectory data can be found either on the PVO SEDR data volumes (PV04_xxxx), or on the OMAG/OEFD processed data (PV01_xxxx) volume series. Volume 1 contains orbits 0001-1000 (198X-XX-XX to 199X-XX-XX) Volume 2 contains orbits 1001-3000 (198X-XX-XX to 199X-XX-XX) Volume 3 contains orbits 3001-5055 (199X-XX-XX to 1992-10-07) All three volumes in this series have an identical structure and duplicates of documents, templates, etc. ============================================================================== Documents ============================================================================== This CD-ROM contains documents (consisting of text and, in some cases, images) which have been extracted from the original documentation. All copyright protections associated with these documents are retained by the publishers. All occurrences on this CD-ROM of documents originally published by Kluwer Academic Publishers and by IEEE contain their respective copyright permissions statements in their text in some form: Reprinted with permission of Kluwer Academic Publishers. or Copyright (c) 1980 IEEE. Reprinted, with permission, from IEEE Transactions on Geoscience and Remote Sensing, GE-18, Num. 1, 60-65, Jan. 1980. This material is posted here with permission of the IEEE. Such permission of the IEEE does not in any way imply IEEE endorsement of any of PDS's products or services. Internal or personal use of this material is permitted. However, permission to reprint/republish this material for advertising or promotional purposes or for creating new ccollective works for resale or redistribution must be obtained from the IEEE by sending a blank e-mail message to info.pub.permission@ieee.org. By choosing to view this document, you agree to all provisions of the copyright laws protecting it. Users of this CD-ROM and/or the Planetary Data System are required to comply with the copyright laws governing the usage of these and any other copyrighted materials on the disk. ============================================================================== Errata ============================================================================== There may be 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 ORPA CD-ROM (volume set PV10) created by this production date. Any changes or errors that were found to any PV10 CD-ROM after the production of this volume can be found via anonymous-ftp at ftp.igpp.ucla.edu. The account name is anonymous, but please provide your e-mail address when prompted for a password (to leave an audit trail). Change to the PDS errata directory (cd pds/ERRATA/PV10), 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. ============================================================================== File Format ============================================================================== All files on this disk are time series data described by detached version 3.x PDS labels. 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 is an ASCII text format file which describes the physical structure of the data files. This format file is then pointed to by all of the labels. Both the label files (.LBL) and the format files (*.FMT) are all located in the same directory as the data files 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 many of the sub-directories there is a file called ZZINPUT.PDS. This is a necessary production file, but not for the user. Excuse any inconvenience that this files may cause. The basic organization of the disk is as follows (note that directory order has been changed from alphabetical to enhance readability): PV10_0001 (root level directory) | + AAREADME.TXT describes volume contents, organization and use | (this file) | + AAREADME.LBL detached PDS label for AAREADME.TXT | + ERRATA.TXT file describing errors and anomalies found on this | volume | + ERRATA.LBL detached PDS label for ERRATA.TXT | + VOLDESC.CAT high level description of volume contents | | + CATALOG | | + BRACE | + DATA + DOCUMENT--+ INST | + MILLER | + INDEX | + MANAGE | + SOFTWARE (platform/format sub-directories) | + DATA | + ELE (sub-directories containing 100 orbits) | + ION (sub-directories containing 100 orbits of data) | + IUN (sub-directories containing 100 orbits of uncertainties) | + PHOTOELE (sub-directories containing 100 orbits) | + UADS (sub-directories containing 100 orbits) The following is a brief summary of the contents of each directory: CATALOG Contains the all of the metadata associated with this CD-ROM, including mission, instrument host, instrument, data set, personnel and reference descriptions and information. The metadata associated with a particular instrument or data set is arranged into individual file, or template, containing information on that instrument or data set. key files: CATALOG.CAT - contains pointers to the individual catalog templates CATINFO.TXT - explains directory contents MISSION.CAT - contains the mission objective template INSTHOST.CAT - contains the instrument host (spacecraft) description template DATA_SET.CAT - data set description template INST.CAT - instrument description template PERSONEL.CAT - personnel description template REF.CAT - reference template, contains a description of all the references cited in association with this volume DOCUMENT Contains 4 documents which are considered important to the understanding of these and other PVO charged particle experiment datasets. Each document is stored in its own directory and has been converted to an ASCII text file (with any graphics missing). In addition, two of the documents have been scanned electronically and stored as HTML files (images are GIF). In addition, fortran code which was used to create this data from the EDRs is included in this section as reference to this process. key files: DOCINFO.TXT - Describes the contents of the DOCUMENT directory. DOCUMENT/BRACE contains the appendix extracted from Brace, L. H. and A. J. Kliore, "Structure of the Venus Ionosphere", Space Science Reviews, v55, p81-163, 1991. which describes some of the problems associated with the inter- calibration of the charged particle detectors aboard PVO. key files: INFO.TXT - Describes the contents of the DOCUMENT/BRACE directory. BRACE.ASC - ASCII text version of appendix A from reference above. DOCUMENT/DATA contains the complete dataset documentation provided by Dr. William Knudsen along with the PDS data submission. This document is provided in both HTML form and in straight ASCII text. This document contains a long list of references to studies generated by this experiment. key files: INFO.TXT - Describes the contents of the DOCUMENT/DATA directory. DATA.ASC - ASCII text version of document. DATA.HTM - HTML text version of document. DOCUMENT/INST contains the original instrument description and initial results paper William C. Knudsen, Karl Spenner, Jack Bakke, and Vit Novak, "Pioneer Venus Orbiter Planar Retarding Potential Analyzer Plasma Experiment", IEEE Trans. Geoscience and Remote Sensing, vol. GE-18, No 1, pXX-XX, 1980. as both an ASCII text file and an HTML (images are GIF files) representation of the paper. key files: INFO.TXT - Describes the contents of the DOCUMENT/INST directory. INST.ASC - ASCII text version of document. INST.HTM - HTML text version of document. FIGxx.GIF - GIF image file of figure xx. TABxx.GIF - GIF image file of table xx. EQNxx.GIF - GIF image file of equation xx. DOCUMENT/MILLER contains selected sections extracted from Miller, K. L., W. C. Knudsen, K. Spenner, "The Dayside Venus Ionosphere", Icarus, 1984. which describes some of the problems associated with the inter- calibration of the charged particle detectors aboard PVO. key files: INFO.TXT - Describes the contents of the DOCUMENT/MILLER directory. MILLER.ASC - ASCII text version of appendix A from reference above. FIGxx.GIF - GIF image file of page XX. INDEX Contains a cumulative index (CUM_INDX.TAB) which describes the location of all files on the PV10 collection (PVO-ORPA). 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. The index files are described by detached PDS labels. key files: CUMINDEX.TAB - Contains a cumulative index for the PV10 volume set (a collection of all INDEX.TABs - see below). CUMINDEX.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 (PV10_0001) containing name of file, dataset association, file type 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: MNGINFO.TXT - Describes the contents of this directory. SOFTWARE Some software is provided in the SOFTWARE directory. Note however that PDS/PPI is aware of software that is either under development or already available which may be used with some of the data found on this volume. For more information about obtaining this software please send e-mail to pds_operator@igpp.ucla.edu or check the latest version of this CD-ROM located on the PDS/PPI website (http://www.igpp.ucla.edu/ssc/pdsppi/Welcome.html). key files: COPYRIGH.TXT - Describes the legal rights and limitations of liability pertaining to software distributed by the PPI Node of PDS. FTP.TXT - Contains instructions on using anonymous ftp to obtain software from the PDS/PPI Node SOFTINFO.TXT - Describes the available software and how to acquire software. DATA Contains all data in a branching tree structure of sub-directories. In the data file the string xxxx refers to the orbit number. key files: DATAINFO.TXT - Describes the structure of the data area. DATASET.TXT - ASCII text document describing the dataset. This is the same document found in the /DOCUMENT/DATA area as DATA.ASC INST.TXT - ASCII text document describing the instrument and initial scientific results from the ORPA experiment. This is the same document found in the /DOCUMENT/INST area as INST.ASC DATA/THRM_ELE Contains the reduced thermal electron mode data sweeps. Data is sub-divided into directories of 100 orbits. key files: ORPADATA.FMT - format file describing data file INFO.TXT - describes directory contents ORBxxxx.DAT - data file in IEEE binary format ORBxxxx.LBL - PDS label describing structure of data file DATA/ION Contains the ion mode reduced data. Data is sub-divided into directories of 100 orbits. key files: ORPADATA.FMT - format file describing data file INFO.TXT - describes directory contents ORBxxxx.DAT - data file in IEEE binary format ORBxxxx.LBL - PDS label describing structure of data file DATA/IUN Contains the ion mode uncertainty data. Data is sub-divided into directories of 100 orbits. key files: ORPADATA.FMT - format file describing data file INFO.TXT - describes directory contents ORBxxxx.DAT - data file in IEEE binary format ORBxxxx.LBL - PDS label describing structure of data file DATA/PHOTOELE Contains the reduced photoelectron mode data sweeps. Data is sub-divided into directories of 100 orbits. key files: ORPADATA.FMT - format file describing data file INFO.TXT - describes directory contents ORBxxxx.DAT - data file in IEEE binary format ORBxxxx.LBL - PDS label describing structure of data file DATA/UADS Contains the UADS data. Data is sub-divided into directories of 100 orbits. key files: ORPADATA.FMT - format file describing data file INFO.TXT - describes directory contents ORBxxxx.TAB - data file in ASCII table format ORBxxxx.LBL - PDS label describing structure of data file UADS_HDR.TXT - UADS header information which has been stripped off the data to keep the ASCII data in a flat table format. The data files, labels, and dataset catalog templates are contained in the sample rate subdirectory. Any files which apply to all datasets further down the tree, are placed at the level at which this transition occurs. This applies to many catalog templates, as well as, calibration files or ancillary information files. Data files are named using the orbit number of the file. Files whose names are Orbit numbers begin with the letters "ORB" and give the orbit in the format ORBXXXX. If the number of files within a single sample rate directory would exceed the ISO 9660 CDROM standard of 255, an additional directory level is added. This level is given an orbit count name which follows the convention just described. In this case, the directory is given the same name as the first file in that directory. ============================================================================== 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. This disk does not contain any software to facilitate the usage or viewing of the data. Please contact pds_operator@igpp.ucla.edu or check the latest version of this CD-ROM located on the PDS/PPI website (http://www.igpp.ucla.edu/ssc/pdsppi/Welcome.html) for software which may have become available subsequent to the release of this volume. ============================================================================== 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 of the PPI Node and verified by Mr. Tyler Brown of the Central Node at JPL. Some labels were revised later by Dr. Mark Sharlow of the PPI Node. PPI Personnel JPL Personnel Ray Walker / Steve Joy Eva Fried / Todd King Mark Sharlow Tyler Brown / Mike Martin 3845 Slichter Hall 4800 Oak Grove Dr. UCLA - IGPP Mail Stop 525-389 Los Angeles, CA 90024-1567 Pasadena, CA 91109 (310)206-6073 (818)306-6130 pds_operator@igpp.ucla.edu pds_operator@jplpds.jpl.nasa.gov