Download this file

PDS_VERSION_ID          = PDS3
RECORD_TYPE             = STREAM
OBJECT                  = TEXT
  PUBLICATION_DATE        = 2022-06-21
  NOTE                    = "AAREADME.TXT describes this volume."
END_OBJECT              = TEXT
END

               Volume JNOWAVB1000 -- Version 20
          
          Coverage Period 2011-08-05 to 2021-11-29T14:13:30
                    Released 2022-04-18

                         Juno Waves
                  Standard Science Products  

                     Waves Data Archive
                       Entire Mission
          Planetary Plasma Interactions Discipline Node
                           of the
                    Planetary Data System


=============================================================================
Introduction
=============================================================================

The JNOWAVB1000 volume contains all available Waves instrument Burst science
data records from launch though the end of mission.  Data provided on this
volume are at the highest available time and frequency resolution and have
been calibrated into physical units using the best calibration tables 
available at the time of publication. 

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.


=============================================================================
Quick Start Summary
=============================================================================

This volume, JNOWAVB1000, contains Juno Waves records from the entire
mission, and will be updated as new data become available.  This release,
Version 20, includes all available records for spacecraft event
time (SCET) dates 2011-08-05 up to, but not including, 2021-11-29T14:13:30.
Calibrated values have been written into the product files, thus there is no
need to transform values via software when reading the product files.



KEY THINGS TO KNOW IN USING DATA ON THIS DISK:

* A web browser can be used to view all the data in this archive in the
  form of Portable Network Graphics (PNG) files which are image files of
  frequency-time spectrograms by navigating to the BROWSE directory and
  clicking on the image files provided.  In most cases each pixel in the
  image files corresponds to an average of many measurements, either in
  frequency or in time.  Thus the image files are a REDUCED RESOLUTION
  data set.


* 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:




  WAVES_BURST - relatively high resolution waveform data

    Due to telemetry bandwidth limits, BURST data are available at only
    selected times during each Jupiter orbit and for selected cruise
    periods.  These data provide much higher time and frequency resolution
    at the cost of only being available for selected time periods and only 
    covering a portion of the full frequency range of the instrument.

* General information on all Waves data sets may be found in the volume
  software interface document (VOLSIS) in DOCUMENT/VOLSIS/INDEX.HTM.


In addition information specific to this volume is provided in PDS catalog
files located in the CATALOG directory.  The data sets are documented in:


  * BURST_DS.CAT, describing WAVES_BURST products

Other PDS catalog files include:

  * INSTHOST.CAT, describing the Juno spacecraft
  
  * MISSION.CAT, describing the Juno mission

  * PERSON.CAT, listing Waves instrument operation team members and PDS
    personnel

  * PROJREF.CAT, listing useful literature references for the Juno mission

  * WAVESREF.CAT, listing useful literature references for the Waves
    instrument

  * WAVESINST.CAT, describing the Waves instrument


=============================================================================
Relationship to Other Data Sets
=============================================================================

Many plasma wave phenomena are easier to interpret in the presence of other
particles and fields measurements.  In particular knowing the local DC
magnetic field is useful for determining key frequencies such as the electron
cyclotron frequency and the upper and lower hybrid resonances.  Since the
Waves instrument does not directly measure DC fields these measurements must
be obtained from another source.  The recommended source is volume(s) 
JNOFGM_1000 from the Juno MAG instrument team.   The Juno MAG volume should
be available from  PDS/PPI node operator.

If an un-calibrated source of these data should ever be required, the raw
experiment data records (EDRs) used to generate the products on this volume
may be found in the Waves Raw Products volume JNOWAV_0000.  If the "as-flown"
command sequences sent to the Waves instrument are ever needed these are also
provided on the JNOWAV_0000 volume.


=============================================================================
File Formats
=============================================================================


The BURST data are stored as standard (IEEE 754) little-endian 32-bit floating
point numbers in binary files with format definitions included in accompanying
"*.LBL" text files.  All required time, frequency and amplitude values needed
to use the data are included within the data products themselves, though in
the case of upper frequency burst files (those with the mnemonic _NBS_ in the
name) the frequencies are recorded as a center value and offsets from that
center value.

All documents, PDS labels, HTML and CVS 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 Android, iPhone, Linux,
MacOS, and Windows systems.  Many users may see an unnecessary carriage return
character (^M) at the end of each line.  MacOS and iPhone users may see an
unnecessary line feed character (^J) at the start of each line.

PDS labels are object-oriented.  The object to which the label refers (e.g.,
FILE, 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:

  ^INDEX_TABLE = ("INDEX.TAB", 2)

indicates that the INDEX_TABLE object begins at record 2 of the file
INDEX.TAB, 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<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.



=============================================================================
Software
=============================================================================

Since all data are stored as calibrated values, no end-user example code is
provided for reading data on this volume.  The BURST files are documented 
well enough to allow one to create simple programs for reading their contents.


=============================================================================
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.


[JNOWAVB1000] (root directory)
   |
   |- AAREADME.HTM      (This file)
   |
   |- AAREADME.TXT      Describes volume contents, organization, and use
   |
   |- ERRATA.TXT        Describes known deficiencies or caveats in the
   |                    data on this volume.
   |
   |- VOLDESC.CAT       High level description of volume contents.
   |
   |- [BROWSE]          Contains PNG (Portable Network Graphics) images of
   |                    of the Burst data products on this volume.
   |
   |- [CATALOG]         Information on data sets and how they are
   |                    processed and produced, on the Juno spacecraft
   |                    and mission, on the Waves instrument, on cognizant
   |                    personnel, and on references to various related
   |                    documents.
   |
   |- [DATA]            Contains text and binary files of instrument
   |     |              measurements and supporting information
   |     |              constituting the primary archive products.
   |     |
   |     |- [WAVES_BURST]
   |                    High-resolution E-Field and B-Field wave amplitude
   |                    products.
   |
   |- [DOCUMENT]        Volume Software
   |                    Interface Specification, and the Waves Instrument
   |                    Users Guide.
   |
   |- [EXTRAS]          Bonus content not necessarily conforming to
   |                    PDS archive standards.
   |
   |- [INDEX]           Listing of all volume archive products.



=============================================================================
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.  Any changes or errors that are
found on the JNOWAVB1000 volume set can be found on the PPI Node errata Web
page (
http://www.igpp.ucla.edu/cgi-bin/ditdos?errata=JNOWAVB1000).

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


=============================================================================
Contacts
=============================================================================

Chris Piker handles downlink operations for the Waves Instrument Operation
team the University of Iowa and prepares the Waves data archive. David Gell
operates the Juno Science Operations Center at the Southwest Research
Institute.  William Kurth is the Waves principle investigator.  Jack Connerney
is the MAG instrument principle investigator.

For questions or problems relating to functionality or technical details of
this archive, please contact the Waves downlink operator.


For questions or problems relating to functionality or technical details of
this archive, please contact the Waves downlink operator.

Email:        chris-piker@uiowa.edu
Telephone:    (319) 335-1960

U.S. Mail:    Chris Piker
              203 Van Allen Hall
              Department of Physics and Astronomy
              The University of Iowa
              Iowa City, IA  52242-1479


For science or collaboration inquiries, please contact the Waves Principle
investigator:

Email:        william-kurth@uiowa.edu
Telephone:    (319) 335-1926
U.S. Mail:    Dr. William Kurth
              203 Van Allen Hall
              Department of Physics and Astronomy
              The University of Iowa
              Iowa City, IA  52242-1479


For data usage inquiries regarding Juno Magnetometer data, please contact
the MAG Principle investigator:

Email:        Jack.Connerney@nasa.gov
Telephone:    (301) 286-5884
U.S. Mail:    Dr. John E.P. Connerney
              NASA/Goddard Space Flight Center
              Code 695
              Greenbelt, MD 20771
              
              
For questions or problems gathering Juno Waves data from JSOC please
contact the Juno Science Operations Center manager:

Email:        david.gell@swri.org
Telephone:    (210) 522-5559
U.S. Mail:    Space Sciences and Engineering, Div 15
              Southwest Research Institute
              PO Drawer 28510
              San Antonio, TX 78228-0510


For questions or problems regarding the JNOWAV_0000, and JNOWAV_1000 volumes,
please contact the PDS/PPI operator:

Email:        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):

Email:        pds_operator@jpl.nasa.gov
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, the Planetary Plasma Interactions (PPI) Node, the Juno Science
Operation Center (JSOC) and the Juno Waves team assume no legal liability for
errors in this archive.  All users are encouraged to verify the "correctness"
of the data prior to submitting any publications or other work based on these
data.  Errors in this archive should be reported back to the Juno Waves team
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.


=============================================================================
Acknowledgments
=============================================================================

These data were collected under the auspices of the Juno Project. Dr.
William Kurth was the Waves Science Principal Investigator.  The archiving
effort at The University of Iowa was supported by Chris Piker.

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 R. Joyner of the Jet Propulsion
Laboratory.