CCSD3ZF0000100000001NJPL3IF0PDSX00000001
PDS_VERSION_ID = PDS3
RECORD_TYPE = FIXED_LENGTH
RECORD_BYTES = 80
OBJECT = TEXT
PUBLICATION_DATE = 1996-12-16
NOTE = "MAGELLAN FMAP CD-ROM"
END_OBJECT = TEXT
END
MAGELLAN FMAP CD-ROM
1. Introduction
This CD-ROM belongs to the global Full Resolution SAR Map of Venus (FMAP)
produced by the U. S. Geological Survey. The FMAP is the unique, full-
resolution mosaicked Magellan SAR dataset; as Mr. Lincoln would have said,
the MIDRs cover some of the planet at all of the resolution (FMIDRs, 75
m/pixel) and all of the planet at some of the resolution (C1-C3MIDRs,
225-2025 m/pixel) but the FMAP does both. More precisely, the present
series of maps contains all coverage (about 92% of the planet) obtained
with the left-looking nominal desired look angle profile (DLAP). Future
series may be created containing data obtained with the right-looking
constant incidence DLAP and left-looking stereo DLAP, increasing total
coverage to 96% with considerable redundancy. To facilitate manipulation of
the global dataset, the FMAP divides Venus into fewer, larger quadrangles
than the same-resolution FMIDRs, and divides each quadrangle into fewer,
larger files on CD-ROM. Specifically, FMAP quadrangles subtend 12 degrees
of latitude, except for the polarmost quadrangles, which extend from +/- 84
to +/- 90 degrees latitude. The longitudinal extent of the quadrangles
increases with latitude from 12 degrees at the equator to maintain a
roughly constant number of lines and samples.
This CD-ROM contains two FMAP quadrangles and associated documentation.
The complete FMAP data set contains 340 quadrangles in Sinusoidal Equal Area
projection. The five quadrangles covering latitudes 84-90 degrees comprise
a single volume. Data from these quadrangles will also be distributed in
Polar Stereographic projection on a separate volume. Finally, an
additional volume will contain browse versions of the entire FMAP dataset
for quick inspection. Format and resolution of the browse images are TBD.
All data formats are based on the Planetary Data System Data
Preparation Workbook ("PDS Data Preparation Workbook", JPL D-7669, April
1993) and are similar to the formats used in generating the Voyager CD-ROM
set ("Voyagers to the Outer Planets", volumes 1-8, Planetary Data System,
JPL, 1989).
2. Disk Format
The disk has been formatted so that a variety of computer systems
(e.g. IBM PC, Macintosh, Sun, VAX) may access the data. Specifically,
the disk is formatted according to the ISO 9660 level 1 Interchange
Standard, and file attributes are specified by Extended Attribute
Records (XARs). For computer software that fully supports XARs, access
to the CD-ROM volume will be straightforward; the disk will appear to
the user to be identical to a file system of directories, sub-
directories, and data files. Some computer systems that do not support
XARs will ignore them; others will append the XAR to the beginning of
the file. In the latter case the user must ignore the first 512 bytes of
the file. For further information, refer to the ISO 9660 Standard
Document: RF# ISO 9660-1988, 15 April 1988.
3. File Formats
Each FMAP is divided into an array of 36 framelets, arranged in six rows
and six columns, except for the quadrangles from 84 to 90 degrees latitude,
which are divided into 18 framelets in three rows. The framelets are
numbered in increasing order from left to right, top to bottom. Each
framelet is stored in a separate file. The size of the framelets varies
with latitude, but they typically consist of approximately 3000 lines of
3000 samples, with one byte per sample. The framelet files contain
attached PDS labels.
Additional general information about each product is found in the
CATALOG directory. The *.CAT files in that directory contain the PDS
catalog information for the Magellan Mission, the spacecraft, the radar
instrument, and the data set.
All document files and detached label files contain 80-byte fixed-
length records, with a carriage return character (ASCII 13) in the 79th
byte and a line feed character (ASCII 10) in the 80th byte. This allows
the files to be read by the MacOS, DOS, Unix, and VMS operating systems.
All tabular files are also described by PDS labels, either embedded at
the beginning of the file or detached. If detached, the PDS label file
has the same name as the data file it describes, with the extension
.LBL; for example, the file GAZETTER.TAB is accompanied by the detached
label file GAZETTER.LBL in the same directory. The detached catalog
information for FMAPs also contains PDS-defined map projection keywords
that provide information needed to extract latitude and longitude values
from given line and sample locations.
Tabular files are formatted so that they may be read directly into
many database management systems on various computers. All fields are
separated by commas, and character fields are enclosed in double
quotation marks ("). Character fields are left justified, and numeric
fields are right justified. The "start byte" and "bytes" values listed
in the labels do not include the commas between fields or the quotation
marks surrounding character fields. 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.
PDS labels are object-oriented. The object to which the label
refers (e.g. IMAGE, TABLE, etc.) is denoted by a statement of the
form:
^object = location
in which the carat character (^, also called a pointer in this
context) indicates that the object starts at the given location. In
an embedded label, the location is an integer representing the
starting record number of the object (the first record in the file is
record 1). In a detached label, the location denotes the name of the
file containing the object, along with the starting record or byte
number. For example:
^IMAGE = ("C102.IMG",3)
indicates that the IMAGE object begins at record 3 of the file
C102.IMG, in the same directory as the detached label file. Below is
a list of the possible formats for the ^object keyword.
^object = n
^object = n<BYTES>
^object = "filename.ext"
^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)
<BYTES> indicates that the number given is in units of bytes
filename is the upper-case file name
ext is the upper-case file extension
4. CD-ROM Contents
The files on this CD-ROM are organized in one top-level directory
with several subdirectories. The following table shows the structure
and content of these directories. In the table, directory names are
enclosed in square brackets ([]), upper-case letters indicate an actual
directory or file name, and lower-case letters indicate the general form
of a set of directory or file names.
FILE CONTENTS
Top-level directory
|
|- AAREADME.TXT The file you are reading.
|
|- AAREADME.VMS Contains special instructions for reading the
| files off of this CD-ROM using a VAX/VMS system.
|
|- ERRATA.TXT A cumulative listing of comments concerning all
| FMAP CD-ROMs published to date.
|
|- VOLDESC.CAT A high-level description of the contents of this
| CD-ROM volume in a format readable by both humans
| and computers.
|
|- [CATALOG] A directory containing the catalog objects
| | (Mission, Instrument Host, Instrument, Data Set,
| | Data Set Map Projection, Personnel, and
| | References) associated with the FMAP data set.
| |
| |- CATINFO.TXT Description of files in the CATALOG directory.
| |
| |- DSMAP.CAT Contains map projection information for the FMAP
| | data set.
| |
| |- FMAPDS.CAT Contains catalog information on the FMAP data
| | set.
| |
| |- INSTHOST.CAT Contains instrument host catalog information.
| |
| |- MISSION.CAT Contains mission catalog information.
| |
| |- PERS.CAT Contains personnel catalog information.
| |
| |- RDRSINST.CAT Contains instrument catalog information.
| |
| `- REFS.CAT Contains reference catalog information.
|
|- [GAZETTER] A directory containing detailed information about
| | the named features on Venus.
| |
| |- GAZINFO.TXT Contains a description of the contents of the
| | GAZETTER subdirectory.
| |
| |- GAZETTER.TXT Contains a description of the structure and
| | contents of the gazetteer table.
| |
| |- GAZETTER.LBL Contains the PDS label identifying and giving
| | a formal description of the structure of the
| | gazetteer table.
| |
| `- GAZETTER.TAB Contains the gazetteer table.
|
|- [SOFTWARE] A directory containing software for reprojecting
| | and mosaicking the FMAP tiles.
| |
| |- SOFTINFO.TXT Contains information about the NEWMAP and MOSAIC
| | programs including how to compile and run them
| | on different computer systems.
| |
| |- NEWMAP.C Contains source code for the reprojection
| | software.
| |
| |- MOSAIC.C Contains source code for the mosaic software.
| |
| |- [VAXVMS] A directory containing executable modules for
| | | the VAX/VMS computer system.
| | |
| | |- CDCOPY.COM A command file needed by VAX/VMS users to copy
| | | files from this CD-ROM to a magnetic disk.
| | |
| | |- NEWMAP.EXE Executable module for the reprojection software.
| | |
| | `- MOSAIC.EXE Executable module for the mosaic software.
| |
| |- [SUNOS] A directory containing executable modules for
| | | the SUN/UNIX computer system.
| | |
| | |- NEWMAP.EXE Executable module for the reprojection software.
| | |
| | `- MOSAIC.EXE Executable module for the mosaic software.
| |
| |- [PCDOS] A directory containing executable modules for
| | | the IBM/MS-DOS computer system.
| | |
| | |- NEWMAP.EXE Executable module for the reprojection software.
| | |
| | |- MOSAIC.EXE Executable module for the mosaic software.
| | |
| | |- DOS4GW.EXE Executable module for the Rational Systems, Inc.
| | | DOS extender needed by NEWMAP.EXE and MOSAIC.EXE.
| | |
| | |- IMDISP.EXE Contains the executable module for the image
| | | display software.
| | |
| | |- IMDISP.TXT Contains a user's guide to the image display
| | | software.
| | |
| | `- IMDISP.HLP Help information for the image display software.
| |
| `- [MAC] A directory containing source code and executable
| | modules for the MACINTOSH/MACOS computer system.
| |
| |- NEWMAP.HQX Contains a self-extracting Stuffit archive in
| | BinHex format for the source code and
| | executable module of the reprojection software.
| |
| |- MOSAIC.HQX Contains a self-extracting Stuffit archive in
| | BinHex format for the source code and
| | executable module of the mosaic software.
| |
| |- IMAGE.HQX Contains a self-extracting Stuffit archive in
| | BinHex format for the image display software.
| |
| `- IMAGE.TXT Contains instructions for extracting the IMAGE
| display software.
|
|- [INDEX] A directory containing index files for searching
| | for specific FMAP products.
| |
| |- INDXINFO.TXT Contains a description of the contents of the
| | INDEX subdirectory.
| |
| |- CUMINDEX.LBL Contains the PDS label which identifies the
| | cumulative volume set index (CUMINDEX.TAB). It
| | describes the structure of the cumulative index
| | table.
| |
| |- CUMINDEX.TAB Contains the cumulative volume set index in a
| | tabular format.
| |
| |- INDEX.LBL Contains the PDS label which identifies the
| | volume index (INDEX.TAB). It describes the
| | structure of the index table.
| |
| |- INDEX.TAB Contains the volume index in a tabular format.
| |
| `- [ORBIT] A directory containing orbit information for the
| | FMAP tiles.
| |
| |- nnzmmmOR.LBL Contains the PDS label which identifies the table
| | of source F-BIDR information for a tile
| | (nnzmmmOR.TAB) where nn is the center latitude of
| | the tile rounded down to the nearest whole
| | integer, z is N or S (North or South latitude),
| | and mmm is the center longitude of the framelet
| | rounded down to the nearest whole integer. It
| | describes the structure of the source F-BIDR
| | table.
| |
| `- nnzmmmOR.TAB Contains the source F-BIDR information for a tile
| in a tabular format.
|
`- [xynnzmmm] Directories containing framelets that make up a
single FMAP mosaic, where x is the file type:
(F = Full Resolution Sinusoidal,
B = Browse version of Sinusoidal quadrangle,
P = Polar Stereographic,
C = Browse version of Polar Stereographic,
G = Global image at reduced resolution)
y is the data type (NOTE that the present series
of disks contains only left-look data;
designators for other data types are reserved for
future use):
(L = Left Look,
R = Right Look,
O = Stereo Look Angle Profile,
M = Maxwell Look Angle Profile,
P = Vertically (VV) Polarized,
T = GTDR data coregistered to FMAP,
S = GSDR data coregistered to FMAP,
E = GEDR data coregistered to FMAP,
R = GREDR data coregistered to FMAP),
nn is the center latitude of the framelet rounded
down to the nearest whole integer, z is N or S
(North or South latitude), and mmm is the center
longitude of the framelet rounded down to the
nearest whole integer.
5. Recommended CD-ROM Drives and Driver Software
Please note that the following list is not complete. However, these
drives and accompanying driver software were tested successfully by the
FMAP project.
VAX/VMS
Drive: Digital Equipment Corporation (DEC) RRD40, RRD42, or RRD50.
Driver: DEC VFS CD-ROM driver V4.7 or V5.2 and up.
Note: The driver software may be obtained from Jason Hyon at
JPL (Files are: JPLPDS::DISK$USER1:[JHYON]VFS*.A). It is
necessary to use this driver to access the XARs on the CD-ROM.
VAX/Ultrix
Drive: DEC RRD40, RRD42, or RRD50.
Driver: Supplied with Ultrix 3.1.
Note: Use the "cdio" software package (in "~ftp/src/cdio.shar"
from the "space.mit.edu" server). Contact Dr. Peter
Ford for details (see below).
IBM PC
Drive: Toshiba, Hitachi, Sony, or compatible.
Driver: Microsoft MSCDEX version 2.2.
Note: The newest version of MSCDEX (released in February 1990)
is generally available.
Apple Macintosh
Drive: Apple CD SC (Sony) or Toshiba.
Driver: Apple CD-ROM driver.
Note: The Toshiba drive requires a separate driver, which may
be obtained from Toshiba.
Sun Micro
Drive: Delta Microsystems SS-660 (Sony).
Driver: Delta Microsystems driver or SUN CD-ROM Driver.
Note: The Sun-supplied driver can mount the disks for SunOS
4.1 and up and Solaris 2.1 and up. Systems prior to Solaris
2.3 require a patch which can be acquired from delcano.mit.edu
in /mgn/software/sun.cdrom.patch.
6. Who to Contact for Information
For questions about how to read the CD-ROM:
Jason J. Hyon
MS 168-514
Jet Propulsion Laboratory
4800 Oak Grove Drive
Pasadena, CA 91109
818-306-6054
Electronic mail addresses:
NSI/DECNET: MIPL3::JJH345
Internet: jjh345@mipl3.jpl.nasa.gov
For questions concerning the F-BIDR products from which the FMAP was made:
Magellan Data Products Support Office
Washington University
Campus Box 1169
One Brookings Drive
St. Louis, MO 63130
314-935-5493
Electronic mail addresses:
Internet: mgnso@wunder.wustl.edu
For questions concerning the FMAP software and algorithms:
Kathleen Edwards
or Tracie Sucharski
Branch of Astrogeology
U.S. Geological Survey
2255 N. Gemini Drive
Flagstaff, AZ 86001
520-556-7118 (Edwards)
520-556-7213 (Sucharski)
Electronic mail addresses:
NSI/DECNET: ASTROG::KEDWARDS
ASTROG::TSUCHARSKI
Internet: kedwards@flagmail.wr.usgs.gov
tsuchars@flagmail.wr.usgs.gov
For general questions about Magellan data products and documentation:
Magellan Data Products Support Office
Washington University
Campus Box 1169
One Brookings Drive
St. Louis, MO 63130
314-935-5493
Electronic mail addresses:
Internet: mgnso@wunder.wustl.edu
The Magellan Data Products Support Office is maintained by the
Geosciences Node of the Planetary Data System (PDS) at Washington
University. The purpose of the Support Office is to provide users of
Magellan data products with information about the data and to provide
assistance in obtaining the data. Both standard and special data
products are supported, including digital products, photoproducts,
slides, videotapes, and NASA Public Information Office (PIO) products.
The Magellan Data Products Support Office serves NASA-sponsored scientists,
other researchers and educators, and the general public.
The Support Office is staffed by researchers who have knowledge of
Magellan data products. The primary contacts are Dr. Edward Guinness
and Ms. Susan Slavney. The Office can answer questions such as what
data products exist, where they can be obtained, and at what cost. The
Office will also help the user place an order with the National Space
Science Data Center (NSSDC).
Most standard data products released by the Magellan Project are
distributed by NSSDC. The user who knows exactly what products he or
she wants is encouraged to call the NSSDC Coordinated Request and User
Support Office at 301-286-6695 to place an order. The user who needs
help in deciding what products to order, or who cannot obtain the
desired products from NSSDC, should contact the Magellan Data Products
Support Office for assistance.
7. Cognizant Persons
Mike Martin (JPL), Gail Woodward (JPL), Peter Ford (MIT), Robert
Mehlman (UCLA), and Jason Hyon (JPL) designed the PDS labels and the
tables. Edward Guinness (Washington University), Kay Edwards (USGS), Eric
Eliason (USGS) and Raymond Arvidson (Washington University) helped to
develop the map projection keywords and tables. Janet Barrett (USGS)
developed the software to generate the PDS labels and tables. Richard
Simpson (Stanford University), Randy Kirk (USGS) and Janet Barrett (USGS)
created the catalog information files, with help from Edward Guinness
(Washington University) and Ron Joyner (JPL). The Magellan Project
supplied the relevant data and information used to populate the files on
this CD-ROM. Software to reproject, mosaic, and do cosmetic seam removal
to put the image data in FMAP format was developed by Kay Edwards and
Tracie Sucharski (USGS). Cartographic processing was done by Robert
Sucharski (USGS). Joel Russell and Haig Morgan at USGS designed the cover
of this CD-ROM.
This disk was produced by Janet Barrett and Robert Sucharski.
8. Errata and Disclaimer
A cumulative list of errors and changes is maintained in the file
ERRATA.TXT at the root directory of this volume.
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 one of the cognizant persons listed herein.