Volume VGPW_1101
Voyager 1
Plasma Wave Spectrometer Spectrum Analyzer

• Introduction
• IMPORTANT INFORMATION ABOUT THIS DISK -- READ THIS FIRST!
• Relationship to Other Data Sets
• Volume Set Information
• Volume Format Information
• File Formats
• Errata
• Software
• Volume Contents and Structure
• Driver and Hardware Information
• Contacts

Introduction

This volume set contains the Voyager 1 Plasma Wave Spectrometer spectrum analyzer data from the entire mission, submitted to the Planetary Data System (PDS). Every effort has been made to assure that the data and documentation are of the best possible quality. However, mistakes are inevitable. The PPI Node of the PDS will maintain an online list of ERRATA where errors and updates are documented. Should any user of this product find an error on this volume, please report the error to the PPI Node so that the finding can be made public. All users are encouraged to verify the "correctness" of the data prior to submitting any publications or other work based on these data. Users of these data are encouraged to acknowledge both the PDS and the principal investigators of the instruments whose data are used in analysis in all publications.

IMPORTANT INFORMATION ABOUT THIS DISK -- READ THIS FIRST!

This volume set contains Voyager 1 PWS spectrum analyzer data from the entire mission. New data will be added on subsequent volumes as they become available. This volume, VGPW_1101, includes all available spectrum analyzer files for spacecraft event time (SCET) dates 1977-09-05 through 2001-12-31. Edited telemetry data in the form of 16-bit integers are provided at full resolution, along with calibration information. Also provided are hourly average electric field spectral densities.

KEY THINGS TO KNOW IN USING DATA ON THIS DISK:

• General information about these datasets is found in CATALOG/FULL_DS.CAT and CATALOG/HOUR_DS.CAT.
• Specific information about a data file *.DAT is found in the same directory in the label file *.LBL.
• Data file format information is found in the same directories as *.DAT in files named VGRPWSEL.FMT
• Calibration files are found in VG1PWSCL.TAB
• Helpful information, including code snippets, on how to extract data from the *.DAT files and calibrate them is found in DOCUMENT/DATATIPS.TXT.

All data files are stored in the DATA branch of the directory tree by date. The DATA directory branches off into DATA/FULL, containing full resolution uncalibrated data, and DATA/HOUR, containing calibrated hourly average electric field spectral densities. Beneath DATA/FULL are directories named "Tyymm_mm" where yymm_mm indicates a two-digit year and range of months. For example, the directory "T7709_12" includes data from September through December, 1977. Each of the "Tyymm_mm" subdirectories may contain up to 92 data files named "Tyymmdd.DAT", where "yymmdd" is the year, month, and date of the data contained in the file; each file covers 1 day. The data are stored in binary with format descriptions included as separate files. Time values are expressed in spacecraft clock and spacecraft event time (SCET). The DATA/HOUR directory contains files named like "Tyy.TAB" containing calibrated hourly averages and peaks for an entire year.

The documentation for this volume is located in the CATALOG directory. The data sets are documented as part of the archive (FULL_DS.CAT and HOUR_DS.CAT); so is the PWS instrument (PWSINST.CAT), the Voyager mission (MISSION.CAT) and spacecraft (INSTHOST.CAT), the PWS team (PERSON.CAT), and useful literature references (REF.CAT).

All data files on this DVD are described by detached PDS labels (.LBL) and format files (.FMT). Metadata are stored as text files with the data. Information on the particular form of metadata used in the PDS catalog can be found in the CATALOG directory.

Relationship to Other Data Sets

The data on this disk are Voyager Plasma Wave Spectrometer spectrum analyzer data which provide amplitudes for each of 16 logaritmically-spaced channels from 10 Hz to 56.2 kHz from the Voyager Plasma Wave Receiver. These are low resolution spectrum analyzer data which are available for all times during which the Plasma Wave Receiver is on and telemetry is available. High resolution waveform data for limited times are found in the data set with a dataset_id of

• VG1-J/S/SS-PWS-1-EDR-WFRM-60MS-V1.0

Volume Set Information

This DVD is the only volume of the VGPW_11xx set. This volume, VGPW_1101, contains all available PWS spectrum analyzer data from the spacecraft event time (SCET) interval 1977-09-05 through 2001-12-31. This volume will be updated as new data are archived.

Volume Format Information

The disk is organized into a hierarchical directory structure. The disk is formatted according to both ISO 9660 and POSIX (UNIX) standards in order to accommodate users on a wide variety of platforms. This volume does not contain any Extended Attribute Records (XAR). Thus, VAX/VMS users may have some problems accessing files on this volume.

File Formats

The data files on this volume are ASCII text and binary files. All data files are described by detached PDS labels. A detached label file has the same name as the data file that it describes, but with the extension .LBL. For example, the file T770905.DAT is accompanied by the detached label file T770905.LBL in the same directory. File names within this archive comply with the "8.3" convention for compliance with ISO 9660 Level 1 interchange requirements.

All documents, detached PDS labels, and HTML files are stream format files, with a carriage return (ASCII 13) and a line feed character (ASCII 10) at the end of the record. This allows the files to be read by MacOS, DOS, Windows, UNIX, and VMS operating systems. UNIX system users will see an unnecessary carriage return character (^M) at the end of each line. Mac users will see an unnecessary line feed character (^J) at the start of each line.

ASCII tabular data files (.TAB) are formatted so that they may be read directly into many database management systems (DBMS) or spreadsheet programs on various computers. All fields are of fixed length and are separated by white space or commas. Character fields are left justified, and numeric fields are right justified. The records are of fixed length, and the last two bytes of each record contain the ASCII carriage return and line feed characters. This allows a table to be treated as a fixed length record file on computers that support this file type and as a normal text file on other computers.

The document, PDS label, and ASCII table files on this volume can be viewed with a Web browser. Note that to view these files, the browser may need to be configured to recognize files with extensions of .CAT, .LBL, and .TAB as text files. Users with Web browsers also can navigate the disk via the HTML file AAREADME.HTM in the disk's root directory.

PDS labels are object-oriented. The object to which the label refers (e.g., SERIES, TABLE, etc.) is denoted by a statement of the form:

^object = location

^SERIES            = ("20903684.DAT", 3)

^object = n
^object = n<BYTES>
^object = ("filename.ext",n)
^object = ("filename.ext",n<BYTES>)

where

n	is the starting record or byte number of the object, counting from the beginning of the file (record 1, byte 1); default is record number.
<BYTES>	indicates that number given is in units of bytes.
filename	upper-case file name.
ext	upper-case file extension.

In cases where many files of the same format or structure are present, the structure description component is detached from the primary label. This minimizes repeating information which does not vary from file to file. In these cases, a format file (.FMT) contains the file structure information and the base label (.LBL) describes the parameters which generally do vary from file to file (number of records, file name, start/stop time, etc.). When a format file is used within the PDS label, the syntax is:

^STRUCTURE    = filename

^STRUCTURE    = "EDRHDR.FMT"

Syntactically, the contents of the format file can be inserted directly into the base label such that the entire file contents replace the single line ^STRUCTURE = filename.

Errata

There is a file called ERRATA.TXT found at the root level of this volume which contains a list of known deficiencies or caveats associated with data on this volume at the time this DVD was published. Any changes or errors that are found on this DVD after the production of this volume can be found on the PPI Node errata Web page ( http://www.igpp.ucla.edu/ssc/pdsppi/Welcome.html). Also, they can be obtained via anonymous FTP at ftp.igpp.ucla.edu. The account name is "anonymous" and the password should be your e-mail address (it's polite to leave an audit trail). Locate yourself in the PDS errata directory (cd pds/ERRATA/VGPW_11xx), and transfer the file ERRATA.TXT (get ERRATA.TXT).

If you find an error on this disk, please report the error to the PDS Operator at the PPI Node of the PDS.

Internet	pds_operator@igpp.ucla.edu
Telephone	(310) 206-6073
U.S. Mail	PDS Operator c/o Dr. Raymond Walker UCLA - IGPP Los Angeles, CA 90095-1567

Only through support and feedback of the users of these data can an effective errata list be maintained.

Software

There is no software provided with these data at this time.

Volume Contents and Structure

This section describes the volume structure and naming conventions. Below is a tree diagram of the DVD, followed by a description of the directory function and key files in each directory.

[VGPW_1101]		Root directory
	AAREADME.TXT	Describes volume contents, organization and DVD use
	AAREADME.LBL	Label file for AAREADME.HTM
	AAREADME.HTM	HTML version of AAREADME.TXT. Can be viewed in a Web browser and used to navigate the data. (this file).
	ERRATA.TXT	Describes known deficiencies or caveats in the data or on this DVD.
	VOLDESC.CAT	High-level description of DVD contents.
	[CATALOG]	Information on data sets and how they are processed and produced. Also contains information regarding Voyager 1, the instrument covered by this volume, personnel involved, and references from various documents including those contained in the CATALOG directory.
	[DATA]	Contains all data in a branching tree structure of subdirectories.
	[DOCUMENT]	Contains documents describing the data on the volume.
	[EXTRAS]	Contains files which facilitate use of the disk, but which are not required for such use.
	[INDEX]	Contains an index of PDS label files for all data archived on the DVD and the volume set to date.

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.

Contacts

The person most directly responsible for the construction and release of this DVD is Mr. Steven Joy. He was the PPI Node Data Administrator at the time this disk was created and understands as much about the disk structure and data organization as anyone. Other PPI personnel who may be aware of issues related to this DVD include Dr. William Kurth and Dr. Raymond Walker, the PDS/PPI Node manager.

For questions or problems regarding this DVD, please contact the PDS/PPI 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 90095-1567

For questions regarding PDS Standards or other CD-ROM's available from the PDS, please contact PDS Operator at the PDS Central Node (at JPL):

Internet	pds_operator@jpl.nasa.gov
Telephone	(818) 354-4321
U.S. Mail	Planetary Data System, PDS Operator Jet Propulsion Laboratory Mail Stop 202-101 4800 Oak Grove Dr. Pasadena, CA 91109-8099

The PDS and the Planetary Plasma Interactions (PPI) Node in particular, assume no legal liability for errors on this disk. All users are encouraged to verify the "correctness" of the data prior to submitting any publications or other work based on these data. Errors on this disk should be reported back to the PPI Node of the PDS through the ERRATA reporting procedures described above.