CCSD3ZF0000100000001NJPL3IF0PDSX00000001 PDS_VERSION_ID = PDS3 RECORD_TYPE = FIXED_LENGTH RECORD_BYTES = 80 OBJECT = TEXT PUBLICATION_DATE = 1994-08-01 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 ^object = "filename.ext" ^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) 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. | | | |- PATCH.C Contains source code for the patch software. | | See the DSMAP.CAT or ERRATA.TXT file for an | | explanation of this 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. | | | | | `- PATCH.EXE Executeable module for the patch software. | | See the DSMAP.CAT or ERRATA.TXT file for an | | explanation of this 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. | | | | | `- PATCH.EXE Executeable module for the patch software. | | See the DSMAP.CAT or ERRATA.TXT file for an | | explanation of this 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. | | | | | |- PATCH.EXE Executeable module for the patch software. | | | See the DSMAP.CAT or ERRATA.TXT file for an | | | explanation of this software. | | | | | |- DOS4GW.EXE Executable module for the Rational Systems, Inc. | | | DOS extender needed by NEWMAP.EXE, MOSAIC.EXE, | | | and PATCH.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. | | | |- PATCH.HQX Contains a self-extracting Stuffit archive in | | BinHex format for the source code and | | executeable module of the patch software. | | See the DSMAP.CAT or ERRATA.TXT file for an | | explanation of this 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 602-556-7118 (Edwards) 602-556-7396 (Sucharski) Electronic mail addresses: NSI/DECNET: ASTROG::KEDWARDS ASTROG::TSUCHARSKI Internet: kedwards@astrog.span.nasa.gov tsucharski@astrog.span.nasa.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.