Volume PV01_0057
Pioneer Venus Orbiter - Venus Orbital Operations CD-ROM
Magnetometer and Electric Field Detector Datasets
Orbits 3541-3580
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 3541-3580 covering the time period between
1988-08-15 to 1988-09-24. 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 fifty-seventh 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.
CD-ROM
|
+- 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_0057).
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.
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.
COORDS.TXT - Coordinate system descriptions.
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 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 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