Voyager UVS AAREADME.TXT
Return to UVS data set page.
PDS_VERSION_ID = PDS3
RECORD_TYPE = STREAM
DATA_SET_ID = "VG1/VG2-SR/UR/NR-UVS-2/4-OCC-V1.0"
OBJECT = TEXT
PUBLICATION_DATE = 2003-12-05
NOTE = "General overview of the Voyager 2
UVS ring occultation data set."
END_OBJECT = TEXT
END
VOYAGER 2 UVS RING OCCULTATION ARCHIVE
--------------------------------------
1. INTRODUCTION
This volume contains the data from the four Voyager 2 Ultraviolet
Spectrometer (UVS) ring occultation experiments: delta Sco at Saturn,
sigma Sgr at Uranus, beta Per at Uranus, and sigma Sgr at Neptune. The
data from each experiment is provided in a variety of formats ranging
from raw to calibrated and resampled. Also provided are ancillary
files containing geometry, calibration models, and trajectory data,
plus software tools for manipulating the data.
For more detailed information and guidance about how to work with this
data set, see the file DOCUMENT/TUTORIAL.TXT. Most users will find the
calibrated, uniformly-sampled ring profiles in the EASYDATA directory
tree sufficient for their needs. Users wishing to dig further into the
details of the UVS experiment will probably need only consult the
EDITDATA, GEOMETRY and CALIB directories. Most other files in this
archive are provided primarily for documentation purposes and for
users with very special needs.
This data set represents the second component of a data set collection
which also includes the Voyager Photopolarimeter (PPS) and processed
Radio Science (RSS) ring occultation data sets.
Supporting documentation and label files conform to the Planetary Data
System (PDS) Standards, Version 3.5, Jet Propulsion Laboratory (JPL)
document JPL D-7669 (October 15, 2002).
2. VOLUME FORMAT
This disk has been formatted according to the ISO 9660 Level 1
Interchange Standard. This format is compatible with a large variety
of computer systems (e.g. Sun, HP, Macintosh, PC). For further
information, refer to the ISO 9660 Standard Document, RF# ISO
9660-1988, 15 April 1988.
3. FILE FORMATS
3.1 FILE EXTENSIONS
Files on this volume are named according to PDS standards, where the
1-3 characters after the period indicate the file type. The file types
used on this volume are:
Binary files:
Images *.IMG
Other binary data files *.DAT
SPICE ephemeris files *.BSP
Source data files *.VOY
Adobe Acrobat documentation files *.PDF
Adobe Postscript documentation files *.PS
ASCII text files:
PDS labels *.LBL
ASCII tables and indices *.TAB
PDS catalog files *.CAT
Text documentation files *.TXT, *.ASC
Source code files *.C, *.H, *.FOR, *.INC,
*.PRO, *.F1, *.C1, *.H1
Software build scripts *.COM, *.MAK, *.DEF
SPICE kernels *.TLS, *.TPC
SPICE transfer ephemeris files *.XSP
Other files (for documentation only) *.FDS, *.FIT, *.LOG, *.OUT
3.2 PDS LABELS
Every file in this data set is described by an associated PDS label.
Most files are described by a detached label, which has the same name
as the corresponding file but an extension ".LBL". Text files (*.TXT,
*.CAT) have attached labels.
In some cases, all or most of the files in a given directory share a
single, abbreviated "combined-detached" label. In this case, the name
of the file is the name of the enclosing directory, with extension
".LBL".
See the PDS Standards Reference (JPL D-7669) for a complete
description of the PDS label format. This document can also be found
online at
//pds.jpl.nasa.gov/stdref/
3.3 ASCII TEXT FILES
Different popular operating systems use different standards for how
ASCII text files are formatted. On Unix systems, lines are terminated
by a >LF< (linefeed character, control-J, ASCII 10). On Macintosh
computers, lines are terminated by a >CR< (carriage return character,
control-M, ASCII 13). On PCs, lines are terminated by a >CR<>LF< pair.
PDS standards require all text files to use >CR<>LF< line termination.
If the PDS label indicates INTERCHANGE_FORMAT = ASCII or RECORD_TYPE =
STREAM, then this line termination is in use.
On occasion, users on Unix and Macintosh computers may need to change
the line termination on some text files before they can use them. This
can be handled via text editors or a variety of utilities. For
example, the Unix tr (translate) command can be used to change
carriage returns to blanks:
tr "\015" " " >oldfile.txt <newfile.txt
Some ASCII tables indicate RECORD_TYPE = FIXED_LENGTH and include an
additional parameter RECORD_BYTES, which indicates the length in bytes
of each record in the file. It should be noted that all ASCII files
still include the >CR<>LF< line terminators, and these two bytes are
included in the byte count. For this reason, it is unwise to convert
the line terminator to a single character (>LF< on Unix or >CR< on
Macintosh) because this can change the number of bytes per record and
invalidate the label. In these situations, it is recommended that the
line terminator be replaced by a space plus >LF< or a space plus >CR<
instead.
3.4 BINARY FORMATS
Binary data file formats differ among hardware platforms. Most binary
files are provided in these formats:
IEEE: For Sun, SGI and Macintosh platforms. Integers appear with most
significant byte first; floating-point numbers appear in IEEE format.
PC: For PC platforms. Integers appear with least significant byte
first; floating-point numbers appear in byte-reversed IEEE format.
Vax: For DEC (now HP) VMS platforms. Integers appear with least
significant byte first; floating-point numbers appear in Vax G format.
Although not widely used today, this is the platform on which most
Voyager data were originally used. Note that, for files containing
nothing but integers, the PC versions of files can be used.
Note that the software tools included in the SOFTWARE/PROFILE
subdirectory take care of all data conversions automatically.
The SPICE subdirectory contains ephemeris files for Voyager 2 and
planets and satellites, plus the Sun, Earth, and Moon. These files are
provided in SPICE format for a variety of platforms. For more
information about SPICE data and toolkits, consult the PDS Navigation
and Ancillary Information Facility (NAIF) Node at
//pds.jpl.nasa.gov/naif.html
4. VOLUME CONTENTS
4.1 FILE NAMING CONVENTIONS
ISO-9660 Level 1 standards require that file names be a maximum of
eight characters. Most of the supported data files provided on this
volume are based on the following nomenclature:
Characters 1-3: Experiment indicator
1st character: U for UVS.
2nd character: S for Saturn; U for Uranus; N for Neptune.
3rd character: 1-3, indicating a stellar occultation sequence
number at the given planet.
Based on these rules, the following indicators have been used:
US1 = Voyager 2 delta Sco egress occultation by Saturn's rings.
US2 = Voyager 2 delta Sco ingress occultation by Saturn's C Ring.
US3 = Voyager 1 iota Her occultation by Saturn's C Ring.
UU1 = Voyager 2 sigma Sgr occultation by Uranus' outer rings.
UU2 = Voyager 2 beta Per occultation by Uranus' rings.
UN1 = Voyager 2 sigma Sgr occultation by Neptune's rings.
Character 4: File type
C = calibration models.
D = edited data consisting of spectral sums.
F = filtered, calibrated profiles.
G = geometry files.
N = noise data.
P = resampled, calibrated profiles.
R = raw data.
T = trajectory files.
V = vector geometry files.
W = edited data consisting of full spectra.
Characters 5-6: Version number
A two-digit number indicating the version number of the given file
(using a leading zero if necessary). In general, the meaning of
this number depends on the experiment and file type.
As an exception, for vector geometry files, the fifth character
identifies the coordinate system:
C = celestial coordinates.
E = planet equator coordinates.
R = ring planet coordinates.
A = ring anomaly coordinates.
In this case, the sixth character still provides a 1-digit version
number.
Characters 7-8: Supplemental
These characters are only used when needed to further identify a
file. They are used to distinguish rings, ingress vs. egress,
coordinate frames, binary data formats, etc. These characters are
explained in the *INFO.TXT file in each relevant subdirectory.
Non-data files do not follow these conventions. Furthermore, source
data files provided by other investigators appear on this volume under
their original names, but abbreviated if necessary to conform to ISO
standards. If a file has been renamed, the DESCRIPTION field in the
label indicates the file's original name.
4.2 DIRECTORY STRUCTURE
The UVS data set is organized in a directory tree as follows:
FILE CONTENTS
(root) Root directory for this PDS Volume.
|
|-AAREADME.TXT This file.
|
|-ERRATA.TXT A file describing any known errors or
| deviations from PDS standards.
|
|-VOLDESC.CAT A PDS volume object, providing a high-level
| description of the volume and its contents.
|
|-CALIB/ A directory containing calibration models for
| | the ring occultations.
| |
| |-CALINFO.TXT Description of the files in this directory.
| |
| |-UxnCnn*.TAB ASCII data files that tabulate models for the
| | stellar and background photon counts as a
| | function of UVS spectrum index during the
| | given occultation.
| |-UxnCnn*.LBL Detached PDS labels for the above.
|
|-CATALOG/ A directory containing PDS catalog
| | information, providing high-level descriptions
| | of the data, instruments, etc.
| |
| |-CATINFO.TXT Description of the files in this directory.
| |
| |-*.CAT PDS catalog files describing this volume.
|
|-DOCUMENT/ A directory containing useful documentation
| | relating to the data on this volume.
| |
| |-DOCINFO.TXT Description of the files in this directory.
| |
| |-PDSDD.TXT Excerpts from the PDS Data Dictionary,
| | defining the keywords appearing in the PDS
| | labels of this data set.
| |
| |-POLES.TXT A memo defining the conversion between ring
| | longitudes in B1950 and J2000 coordinates.
| |
| |-TUTORIAL.TXT A tutorial describing how to make optimal use
| | of this data set.
| |
| |-NOISE/ A subdirectory documenting the noise
| | properties of the UVS data.
| |
| |-SPROFILE/ A subdirectory documenting the timing and
| | calibration of the Saturn ring data.
| |
| |-CALIB/ Subdirectories containing programs and
| |-EDITDATA/ intermediate data files documenting the
| |-GEOMETRY/ generation of files in the corresponding
| |-RAWDATA/ root-level directories.
| |-TRAJECT/
| |-VECTORS/
|
|-EASYDATA/ A directory containing calibrated, resampled
| | ASCII profiles of the rings in a form
| | particularly easy to use.
| |
| |-DATAINFO.TXT A description of the files in the
| | subdirectories of this directory.
| |
| |-FILTER01/UxnF01*.TAB Ring profiles at the original raw sampling.
| |-FILTER0n/UxnF01*.TAB Ring profiles subsampled by a factor of n.
| |-FILTER*/UxnF01*.LBL Detached PDS labels for each of the above.
| |
| |-KM000_2/UxnP01*.TAB Ring profiles at 0.2 km resolution.
| |-KM000_5/UxnP01*.TAB Ring profiles at 0.5 km resolution.
| |-KM001/UxnP01*.TAB Ring profiles at 1 km resolution.
| |-KM002/UxnP01*.TAB Ring profiles at 2 km resolution.
| |-KM005/UxnP01*.TAB Ring profiles at 5 km resolution.
| |-KM010/UxnP01*.TAB Ring profiles at 10 km resolution.
| |-KM020/UxnP01*.TAB Ring profiles at 20 km resolution.
| |-KM050/UxnP01*.TAB Ring profiles at 50 km resolution.
| |-KM*/UxnP01*.LBL Detached PDS labels for each of the above.
|
|-EDITDATA/ A directory containing edited data files.
| | These have been carefully cleaned and
| | reformatted and should be the easiest binary
| | files to use.
| |
| |-DATAINFO.TXT A description of the files in this directory.
| |
| |-UxnDnn*.DAT Edited data files containing spectral sums.
| |-UxnDnn*.LBL Detached PDS labels for the above.
| |
| |-UxnWnn*.DAT Edited data files containing full spectra.
| |-UxnWnn*.LBL Detached PDS labels for the above.
|
|-GEOMETRY/ A directory containing geometry models for the
| | ring occultations.
| |
| |-GEOMINFO.TXT Description of the files in this directory.
| |
| |-UxnGnn*.TAB ASCII data files that tabulate models for the
| | ring intercept geometry as a function of UVS
| | spectrum index during the given occultation.
| |-UxnGnn*.LBL Detached PDS labels for the above.
|
|-IMAGES/ A directory containing support images obtained
| | during each of the Voyager occultations.
| |
| |-DATAINFO.TXT Description of the images in this directory.
| |
| |-C1138nnn.IMG VICAR format images supporting the Neptune
| | sigma Sgr occultation. The 7-digit number is
| | the associated FDS count.
| |-C2683058.IMG VICAR format image supporting the Uranus sigma
| | Sgr occultation.
| |-C2684902.IMG VICAR format image supporting the Uranus beta
| | Per occultation.
| |-C4400349.IMG VICAR format image supporting the Saturn delta
| | Sco occultation.
| |-*.LBL Detached PDS labels for each of the above.
|
|-INDEX/ A directory containing indices of the files in
| | this data set.
| |
| |-INDXINFO.TXT Description of the files in this directory.
| |
| |-INDEX.TAB A table of all the data files on this volume.
| |-INDEX.LBL A detached PDS label for the above, defining
| each column in the table.
|
|-NOISDATA/ A directory containing edited data files in
| | which all ring signal has been removed,
| | leaving only noise. These files were used for
| | some calibration solutions.
| |
| |-DATAINFO.TXT A description of the files in this directory.
| |
| |-UxnNnn*.DAT Edited noise data files.
| |-UxnNnn*.LBL Detached PDS labels for the above.
|
|-RAWDATA/ A directory containing raw data files. These
| | files contain the same values as found in the
| | SORCDATA directories but have had time tags
| | corrected.
| |
| |-DATAINFO.TXT A description of the files in this directory.
| |
| |-UxnRnn*.DAT Raw data files.
| |-UxnRnn*.LBL Detached PDS labels for the above.
|
|-SOFTWARE/ A directory containing software libraries to
| | support the processing and analysis of the UVS
| | data set. Note that unsupported software used
| | in the production of this data set is found in
| | the DOCUMENT directory tree instead.
| |
| |-SOFTINFO.TXT Description of the files in this directory and
| | its subdirectories.
| |
| |-UVSFILT.FOR A program to generate subsampled ring
| | profiles.
| |-UVSFILT.OUT A sample output file from the above.
| |
| |-UVSRESAM.FOR A program to generate ring profiles resampled
| | onto a uniform radial grid.
| |-UVSRESAM.OUT A sample output file from the above.
| |
| |-SOFTWARE.LBL A combined-detached PDS label for the above.
| |
| |-OAL/ A subdirectory containing the source code and
| | documentation for version 1.3 of the PDS
| | Object Access Library and version 1.2 of the
| | PDS Light Label Library.
| |
| |-PROFILE/ A subdirectory containing the source code and
| documentation for version 1.3 of the Rings
| Node's Profile Library.
|
|-SORCDATA/ A directory containing "source" data files as
| originally provided to the Ring-Moon Systems Node. These
| files are included for documentation purposes
| only and are not otherwise supported. See the
| RAWDATA directory for supported files.
|
|-SPICE/ A directory containing SPICE ephemeris files
| | for the Voyager 2 encounters with Saturn,
| | Uranus and Neptune.
| |
| |-DATAINFO.TXT Description of the files in this directory
| | tree.
| |
| |-NAIF0007.TLS The latest leap seconds file for the SPICE
| | toolkit.
| |-NAIF0007.LBL A detached PDS label for the above.
| |
| |-PCK00006.TPC The latest body constants file for the SPICE
| | toolkit.
| |-PCK00006.LBL A detached PDS label for the above.
| |
| |-IEEE/ A subdirectory containing binary ephemeris
| | | files in SPICE format for machines that use
| | | IEEE floating-point format (e.g. Sun, Silicon
| | | Graphics, Macintosh).
| | |
| | |-VG2_SAT.BSP Ephemeris for the Voyager 2 Saturn encounter.
| | |-VG2_SAT.LBL A detached PDS label for the above.
| | |
| | |-VG2_URA.BSP Ephemeris for the Voyager 2 Uranus encounter.
| | |-VG2_URA.LBL A detached PDS label for the above.
| | |
| | |-VG2_NEP.BSP Ephemeris for the Voyager 2 Neptune encounter.
| | |-VG2_NEP.LBL A detached PDS label for the above.
| |
| |-PC/ A subdirectory containing files identical to
| | those in the IEEE subdirectory, except in PC
| | binary (i.e. byte-swapped IEEE) format. This
| | workstations running Unix.
| |
| |-VAXG/ A subdirectory containing files identical to
| | those in the IEEE subdirectory, except in VAXG
| | binary format, appropriate for DEC Alpha
| | workstations running VMS.
| |
| |-TRANSFER/ A subdirectory containing the same ephemeris
| files as the IEEE subdirectory, except in the
| SPICE "transfer" (.XSP) ASCII format. These
| can be translated to binary for any platform
| on which the SPICE toolkit has been
| implemented.
|
|-TRAJECT/ A directory containing trajectory models for
| | the ring occultations.
| |
| |-DATAINFO.TXT Description of the files in this directory.
| |
| |-UxnTnn*.TAB ASCII data files that tabulate the trajectory
| | of Voyager as a function of UVS spectrum index
| | during the given occultation.
| |-UxnTnn*.LBL Detached PDS labels for the above.
|
|-VECTORS/ A directory containing vector position tables
| from which additional geometry parameters can
| be derived.
|
|-DATAINFO.TXT Description of the files in this directory.
|
|-B1950/ A subdirectory containing vector tables based
| | on the B1950 coordinate frame.
| |
| |-UxxVCn*.TAB Vectors in B1950 celestial coordinates.
| |
| |-UxxVEn*.TAB Vectors in planet equator coordinates, where
| | the Z-axis points along the planet's pole.
| | The longitude reference is Earth's B1950
| | equator.
| |
| |-UUxVRn*.TAB Vectors in ring plane coordinates, where the
| Z-axis points normal to the ring plane. The
| longitude reference is Earth's B1950 equator.
| Provided for Uranus only.
|
|-J2000/*.TAB A subdirectory containing vector tables based
| on the J2000 coordinate frame. File names are
| identical to those found in the B1950
| subdirectory.
|
|-RINGANOM/ A subdirectory containing vector tables in
| ring anomaly coordinates.
|
|-UUxVAn*.TAB Vectors in ring anomaly coordinates, where the
Z-axis points normal to the ring plane and the
longitude reference is the ring's pericenter.
Provided for Uranus only.
5. CONTACT INFORMATION
PDS Ring-Moon Systems Node personnel:
Mark Showalter
SETI Institute
515 N. Whisman Road
Mountain View, CA 94043
650-810-0234
mshowalter@seti.org
or
Mitch Gordon
SETI Institute
515 N. Whisman Road
Mountain View, CA 94043
276-523-0341
mgordon@seti.org
or
Neil Heather
SETI Institute
515 N. Whisman Road
Mountain View, CA 94043
650-810-0243
nheather@seti.org
/
For software, data, and further information regarding SPICE data,
contact the PDS Navigation and Ancillary Information Facility Node:
Charles Acton
Jet Propulsion Laboratory
Mail Stop 301-125L
4800 Oak Grove Drive
Pasadena, CA
818-354-3869
charles.h.acton@jpl.nasa.gov
//pds.jpl.nasa.gov/naif.html
The UVS team members who carried out the observations archived in this
data set are (as of 1986):
A. L. Broadfoot
Sushil K. Atreya
J. L. Bertauz
J. E. Blamont
Alexander J. Dessler
Thomas M. Donahue
W. T. Forrester
D. T. Hall
F. Herbert
Jay B. Holberg
Donald M. Hunten
Vladimir A. Krasnopolsky
S. Linick
Jonathan I. Lunine
John C. McConnell
H. Warren Moos
Bill R. Sandel
Nicholas M. Schneider
Donald E. Shemansky
G. R. Smith
Darrell F. Strobel
Roger V. Yelle
======================================================================
ACKNOWLEDGMENTS
======================================================================
We thank Jay Holberg, Philip Nicholson, Linda Spilker and Padma
Yanamandra-Fisher for their extensive help in locating the data files
and documents archived herein.
======================================================================
DISCLAIMER
======================================================================
Although considerable care has gone into making this volume, errors
are both possible and likely. Users of the data are advised to
exercise the same caution as they would when dealing with any other
unknown data set.
Reports of errors or difficulties would be appreciated. Please
contact Mark Showalter or Mitch Gordon at the addresses listed above.
Return to UVS data set page.