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