PDS_VERSION_ID = PDS3
DATA_SET_ID = "MGS-M-MAG-3-PREMAPPING_HIGHRES-V1.0"
RECORD_TYPE = STREAM
OBJECT = TEXT
PUBLICATION_DATE = 2009-02-01
NOTE = "AAREADME.TXT describes this archive product."
END_OBJECT = TEXT
END
Mars Global Surveyor
Magnetometer
MAG High-Resolution (Detail) Premapping Data
Planetary Plasma Interactions Discipline Node
of the
Planetary Data System
=============================================================================
Introduction
=============================================================================
This data set contains the High-Resolution (Detail) data from the
Mars Global Surveyor (MGS) Magnetometer (MAG) instrument, submitted to
the Planetary Data System (PDS). The data set contains the data from
the premapping period of the mission.
Users are encouraged to provide comments back to the PPI Node of the PDS
if errors or omissions are found either in data or in documentation.
Please send comments by e-mail or U.S. mail to PDS Operator as defined
at the end of this document.
Questions regarding data content, processing, or quality should be sent to
Dr. J.E.P. Connerney jack.connerney@nasa.gov
NASA Goddard Space Flight Center
Code 695
Greenbelt, MD 20771
=============================================================================
Brief Volume Description
=============================================================================
This data set contains MGS MAG high time resolution (Detail) data
from the premapping period of the MGS mission.
All data files are stored in the "DATA" branch of the directory tree.
All data are stored in ASCII tables with attached MAG team headers.
The main documentation for this volume is located in the CATALOG
directory. The data set is documented as part of the archive
(*DS.CAT); so are the MAG instrument (*INST.CAT), the MGS
mission (MISSION.CAT) and spacecraft (MGS_HOST.CAT), the MAG/ER
team, and useful literature references.
All data files in this volume 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.
=============================================================================
Volume Format Information
=============================================================================
These data are stored on media appropriate for online delivery.
=============================================================================
File Formats
=============================================================================
The data files on this volume are ASCII text 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.
All documents, detached PDS labels, and HTML files (if any) 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 may see an unnecessary carriage return character
(^M) at the end of each line. Mac 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., 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❮BYTES❯
^object = ("filename.ext",n)
^object = ("[dirlist]filename.ext",n)
^object = ("filename.ext",n❮BYTES❯)
^object = ("[dirlist]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.
dirlist* period-delimited path-list of parent directories,
in upper case, that specifies the object file
directory (used only when the object is not in the
same directory as the label file).
* All PDS labels on this volume are located in the same directory as
the file they describe so this construct is not used here.
In cases where many files of the same format or structure are present,
the structure description component may optionally be 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. This file will be updated if any new changes or
errors are found.
If you find an error on this volume, please report the error to the PDS
Operator at the PPI Node of the PDS.
Email 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 volume, followed by a description of the directory
function and key files in each directory.
Root directory
|
|- AAREADME.TXT Describes volume contents, organization and volume use
| (this file).
|
|- ERRATA.TXT Describes known deficiencies or caveats in the data or
| on this volume.
|
|- VOLDESC.CAT High-level description of volume contents.
|
|- [CATALOG] Information on the data set and how it is processed
| and produced. Also contains information regarding
| Mars Global Surveyor, the MAG instrument, personnel
| involved, and pertinent literature references.
|
|- [DATA] Contains all data in a branching tree structure of
| | subdirectories corresponding to years and months
| | of data.
| |
=============================================================================
Contacts
=============================================================================
For questions or problems regarding this volume, please contact the PDS/PPI
PDS 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 data available from the
PDS, please contact PDS Operator at the PDS Engineering Node (at JPL):
Email pds_operator@jpl.nasa.gov
Telephone (818) 354-4321
U.S. Mail Planetary Data System, PDS Operator
Jet Propulsion Laboratory
Mail Stop 168-400
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 volume. 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 volume should be reported
back to the PPI Node of the PDS through the ERRATA reporting procedures
described above.
|