PDS_VERSION_ID = PDS3 RECORD_TYPE = STREAM OBJECT = TEXT PUBLICATION_DATE = 2019-01-28 NOTE = "AAREADME.TXT describes this archive product." END_OBJECT = TEXT END Volume VGPW_0101 Voyager 1 and Voyager 2 Plasma Wave Spectrometer Spectrum Analyzer PWS Data Archive Entire Mission Planetary Plasma Interactions Discipline Node of the Planetary Data System ======================================================================== Introduction ======================================================================== This volume contains the Voyager 1 and Voyager 2 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. ======================================================================== Quick Start Summary ======================================================================== This volume, VGPW_0101, contains Voyager PWS spectrum analyzer data from the entire mission, and will be updated as new data become available. This release includes all available spectrum analyzer files for spacecraft event time (SCET) dates 1977-08-20 through 2019-01-09. 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 strength (Vrms/m). KEY THINGS TO KNOW IN USING DATA ON THIS DISK: A web browser can be used to view all the data on this disk in the form of Portable Network Graphics (PNG) files which are image files of calibrated multi-channel plots. Follow the link named "Graphical Data Browser Index" in AAREADME.HTM in the root directory. The browse data under the BROWSE directory consist of the "*.PNG" files. Survey plots are presented along with links to corresponding data files and their PDS label files. All data files are stored under the DATA top-level directory and are organized by data set and spacecraft event time. The DATA directory branches off into: * FULL1 and FULL2 containing full resolution ucalibrated data from Voyager 1 and Voyager 2, respectively These are binary day-long files named like Tyymmdd.DAT, where yymmdd is the corresponding year, month, and day. They are segregated into four-month directories named like Tyymm_mm, where yymm_mm indicates the corresponding year and range of months. Each file is described by an associated PDS label file named like Tyymmdd.LBL, and the binary record structure is described by the file named VGRPWSEL.FMT. Each directory also contains a calibration table, either VG1PWSCL.TAB or VG2PWSCL.TAB and associated PDS label files. * HOUR1 and HOUR2 containing calibrated hourly average electric field strength from Voyager 1 and Voyager 2, respectively These are text year-long files named like Tyy.TAB, where yy is the corresponding year. Each file is described by an associated PDS label file named like Tyy.LBL. General information for this volume is provided in PDS catalog files located in the CATALOG directory. The data sets are documented in: * FULL1_DS.CAT, Voyager 1 PWS SA uncalibrated full resolution * FULL2_DS.CAT, Voyager 2 PWS SA uncalibrated full resolution * HOUR1_DS.CAT, Voyager 1 PWS SA calibrated hourly averages * HOUR2_DS.CAT, Voyager 2 PWS SA calibrated hourly averages Other PDS catalog files include: * INSTHOST1.CAT and INSTHOST2.CAT, describing the Voyager 1 and Voyager 2 spacecraft * MISSION.CAT, describing the Voyager mission (both spacecraft) * PERSON.CAT, listing PWS and PDS personnel * REF.CAT, listing useful literature references * PWSINST1.CAT and PWSINST2.CAT, describing the PWS instruments on Voyagers 1 and 2 The DOCUMENT directory contains: * DATATIPS.TXT, a quick-start guide for programmers * PWSINST.HTM, the published instrument description paper The EXTRAS/SOFTWARE directory contains example code, plus a Java (TM) application which is the primary analysis tool used by the PWS investigators. See EXTRAS/SOFTWARE/SOFTINFO.TXT for more information. ======================================================================== Related PDS Products ======================================================================== 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 sets: * VG1-J/S/SS-PWS-1-EDR-WFRM-60MS-V1.0 * VG2-J/S/U/N/SS-PWS-1-EDR-WFRM-60MS-V1.0 which are available elsewhere within the Planetary Data System on volume sets VGPW_10xx (Voyager 1) and VGPW_20xx (Voyager 2). ======================================================================== Volume Information ======================================================================== This DVD-R is the only volume of the VGPW_01xx set. This volume, VGPW_0101, contains all available PWS spectrum analyzer data from the spacecraft event time (SCET) interval 1977-08-20 through 2013-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 a combination of ISO 9660, UDF, Rock Ridge (UNIX), and Joliet (Microsoft) standards in order to accommodate users on a wide variety of platforms. This volume does not contain any Extended Attribute Records (XAR). Thus, 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. Browse data are provided in Portable Network Graphics (PNG) format. 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 "27.3" convention for compliance with ISO 9660 Level 2 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, MS 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 in which the caret character (^, also called a pointer in this context) indicates that the object starts at the given location. For an object in the same file as the label, the location is an integer representing the starting record number or byte of the object (the first record/byte in the file is 1). For an object located outside the label file, the location denotes the name of the file containing the object, along with the starting record or byte number. For example: ^SERIES = ("20903684.DAT", 3) indicates that the SERIES object begins at record 3 of the file 20903684.DAT, in the same directory as the detached label file. Below is a list of the possible formats that use the ^object keyword. ^object = n ^object = n ^object = ("filename.ext",n) ^object = ("filename.ext",n) 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. 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 Example: ^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-R was published. Any changes or errors that are found after the production of this volume can be found on the PPI Node errata Web page, http://www.igpp.ucla.edu/cgi-bin/ditdos?errata=VGPW_01XX. 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 ======================================================================== Example C code for reading and calibrating the raw binary measurements as well as a complete display and analysis Java application are provided in the EXTRAS/SOFTWARE directory. This software is provided as "as is" and is distributed as a service to the community. More information is provided in the file EXTRAS/SOFTWARE/SOFTINFO.TXT. ======================================================================== Volume Contents and Structure ======================================================================== This section describes the volume structure and naming conventions. Below is a tree diagram of the volume, 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 | 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. | |- ERRATA.TXT Describes known deficiencies or caveats in | the data or with this volume. | |- VOLDESC.CAT High-level description of volume contents. | |- [BROWSE] Contains browse summary plots in PNG format. | | | |- [VG1] Plots for VG1 PWS SA data. | | | |- [VG2] Plots for VG2 PWS SA data. | |- [CATALOG] Information on data sets and how they are | processed and produced, on the Voyager | spacecraft and mission, on the PWS instruments, | on cognizant personnel, and on references to | related documents. | |- [DATA] Contains text and binary files of instrument | | measurements constituting the primary archive | | products. | | | |- [ANCILLARY] Ancillary tables of noise events. | | | |- [FULL1] VG1 PWS SA full resolution uncalibrated data. | | | |- [FULL2] VG2 PWS SA full resolution uncalibrated data. | | | |- [HOUR1] VG1 PWS SA hourly average calibrated data. | | | |- [HOUR2] VG2 PWS SA hourly average calibrated data. | |- [DOCUMENT] Documents including the instrument description | paper. | |- [EXTRAS] Bonus content not necessarily conforming to PDS | | archive standards. | | | |- [SOFTWARE] Example code, plus a complete analysis | application. | |- [INDEX] Contains an index of PDS label files for all data archived on the volume. ======================================================================== Contacts ======================================================================== The person most directly responsible for the construction and release of this archive volume 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 volume include Dr. William Kurth and Dr. Raymond Walker, the PDS/PPI Node manager. For questions or problems regarding this volume, please contact the PDS/PPI 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 archive volumes 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 ======================================================================== Disclaimer ======================================================================== 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. All trademarks are acknowledged as the property of their respective owners. The producers and publishers of this archive do not endorse any commercial entities which may be mentioned for clarity. ======================================================================== Acknowledgements ======================================================================== These data were collected under the auspices of the Voyager Project. Donald A. Gurnett was the Plasma Wave Science Principal Investigator. The archiving effort at The University of Iowa was supported by L. Granroth, J. Groene and C. Piker. Java software was developed by J. Faden and E. West. This archiving effort was supported by the Planetary Plasma Interactions Node of the Planetary Data System. Assistance was provided by S. Joy of the University of California, Los Angeles, and by S. Adams of the Jet Propulsion Laboratory. ========================================================================