Replaced zzzz with zzz in BODP product ID. Added letter Q to BIDR filename convention to stand for oblique cylindrical projection, and thus be keep BIDR filenames consistent with Randy Kirk's higher level filename convention. Added number of looks backplane to volume. Removed misleading sentence regarding common radar modes.("Uncommon modes" occur frequently.)
Added info about size of record_id column in CRT file. Fixed Table 5 to include 08 transition number and added more specific definition of start and end times in CRT files. Added production_creation_time entry to index table.
Updated PDS program manager name on signature page. Eliminated hold-over reference to DVD-R. (Volumes are delivered electronically as stated in Section 2.3.) Increased data volume estimates to coincide with changes in nominal flyby geometries. Improved the explanation of archive validation process. Various minor wording changes and typo fixes.
Removed PDS program manager from signature page, described the compression of the data files, changed BEAMPAT.DOC and CONFIG.DOC to label files. Cassini Radar Transition file moved to extras directory. .FMT files moved to DATA subdirectories.
This Software Interface Specification (SIS) describes the formats, contents, and generation of the archive volumes for data produced by the Cassini Radar Instrument Team including the Burst Ordered Data Products (BODP) and the Basic Image Data Records (BIDR). Observations in the Saturn system will target Titan, Saturn, the Saturnian ring systems, and various icy satellites.
Observations of targets outside the Saturn system will also be included in the data volume. For example, radiometer observations of Jupiter, the sun, and various microwave sources will be included as well as radiometer and scatterometer observations of the Earth.
This SIS is intended to provide enough information to enable users to understand the way in which the data products are organized within the volume data set. It is intended to be used in conjunction with the Cassini Radar Burst Ordered Data Products SIS D-27891 which describes the internal format of the BODP data files and the Cassini Basic Image Data Record SIS D-27889 which similarly documents the BIDR files. The users for whom this SIS is intended are software developers, engineers, and scientists interested in accessing and using either of the two data product types.
Finally this SIS is consistent with the contract negotiated between the Cassini Project and the Cassini Radar Team Leader (TL) in which data products and documentation are explicitly defined as deliverable products.
The Cassini Radar Team will produce the BODP and BIDR Data Archive Collection. BODP files will be produced for each observation of each body. BIDR files will be produced for each SAR observation of Titan. A data volume product will be created for each observation of each body during the tour of the Saturnian system (from June 1, 2004 to the end of the mission) plus relevant observations made during cruise (before June 1, 2004). During active mission operations intermediate science data products will be made available to Cassini Radar Team members for their analysis and evaluation as they are produced. The data products will be updated several times based on improved pointing and ephemeris information. At the end of the data preparation and evaluation phase, a data volume as specified in this SIS will be created and sent to the PDS for archiving. Before production of the first data volume product, a sample volume will be distributed to the peer review panel for their evaluation. The peer panel, with representation from the Cassini Radar Team, PDS, Cassini Science Archive Working Group (SAWG) and the general science community will review and validate the products and volume for scientific integrity and compliance with PDS standards. The data products will be evaluated against the design as defined in the product and volume SIS's. The software and procedure used to create the data volume will be configuration controlled to insure that future products continue to conform to all specifications.
The following table summarizes product sizes for the Cassini Radar Instrument Team Data Products. These include the BIDR files and the three different formats of BODP files. The various types are described in detail in section See DATA Directory Contents and in the BODP Data SIS. BIDR files and BODP files of each format have fixed record lengths which can be read from the PDS label attached at the beginning of the file or in the index table file. The approximate record sizes for each file type are also listed in table 1 along with the nominal data volume per pass (for 10 hour Titan passes) and some notes briefly describing each product type. For the exact record sizes see the BODP or BIDR data SIS. The total data volume for the mission is estimated to be 160 GBytes for 20 Titan passes plus a much smaller amount from Saturn, rings, and icy satellite observations. This estimate is probably high because the radar will not be obtaining measurements for the full ten hours for every Titan pass. On the other hand, in the event of an extended mission we may acquire more passes.
A single copy of the data product volumes will be delivered to the PDS Imaging Node. The Imaging Node will be responsible for developing the methods for distributing the data products to the user community. Copies of the preliminary (sample) volumes will be provided electronically to the peer review panel for their evaluation.
This section describes the directories and contents of the Cassini Radar Instrument Team Data Product volumes, including the file names, file contents, and file types. The ancillary files described herein appear on each volume in the Cassini Radar Instrument Team Data Product volume series.
A description of the contents of this volume in a PDS labeled format. It contains a VOLUME object with aVOLUME_ID keyword of the form CORADR_NNNN where NNNN is a unique 4-digit number for each archived volume.
The following table summarizes files located in the index directory. A single index table is provided for all Cassini Radar Instrument Team Products. Data set ID is one of the fields in the index file.
This section describes the fields in the index.tab file. This file is included to provide the user with a way of quickly producing a list of data files from desired ranges of search criteria such as time, target, latitude, or longitude. See below for descriptions of each column in the index file.
5 letter ASCII string ("RIGHT" ,"LEFT ", or "BOTH " ) indicating the side of the spacecraft groundtrack to which the antenna is pointed for data acquired within each data product (file). The "BOTH " option will typically be used for BODP files. The SAR images stored in the BIDR files are always acquired on only one side of the ground track for each Titan pass. This value also indicates from which side the SAR image is illuminated. If the spacecraft images to the left of its ground track, the image will be illuminated from the (viewer's) left side, and, conversely, if the spacecraft looks to the right, the illumination will come from the right in the image file. The direction of illumination is critical to interpretation of features in the image. For unusual SAR passes in which measurements are obtained on both sides of the ground track, BOTH will be used. The transition across nadir and resultant data gap should make such passes easily identifiable.
The files in the Catalog directory provide a top-level understanding of the Cassini Mission, spacecraft, instruments, and data sets in the form of completed PDS templates. The files are produced or collected by the Cassini Radar Team. The files in this directory are coordinated with the PDS engineer. The following table lists files in the Catalog Directory.
pair has its own detached label which duplicates the information in the label attached to the uncompressed file. In this manner, a user can determine whether or not they need a particular data file without unzipping it. The detached label also contains all
Files are named using the product ID and an extension specifying the PDS file type. The product ID is the string following the PRODUCT_ID keyword in the attached PDS label. BIDR files are of the format aabcdeefggg_Dhhh_Tiii_Vnn.IMG where "aabcdeefggg_Dhhh_Tiii_Vnn" is the product ID and ".IMG" is the extension for PDS image files. Similarly the BODP files are named xxxx_yy_Dzzz_Vnn.TAB, where "xxxx_yy_Dzzz_Vnn" is the product ID and ".TAB" is the extension for a PDS Table file.
It is important to note that scatterometer measurements are obtained in all modes except radiometer only, not just in scatterometer mode. Similarly, radiometer measurements are obtained in all modes without exception.
The CONFIG directory contains a processor configuration file for each Cassini Radar observation. This file contains keyword and value pairs (Processor keywords are not PDS keywords.) which were used in running the ground processing software used to generate the BODP and BIDR files for that observation. Each processor configuration file is named "PCF_zzzz_Vnn.CFG" where zzzz is the four digit radar observation counter and nn is a two digit version number.
FIles in the BEAMPAT and CONFIG directories will be not be needed by most users of Cassini Radar Instrument Team data. For those who desire to use them label files BEAMX_VNN.LBL and PCF_zzzz_Vnn.LBL are available as documentation in the appropriate directories.
This directory contains files that do not belong anywhere else which are included to provide extra unnecessary but perhaps convenient information. The contents of the directory may vary from volume to volume. It contains at least a file
contains a memo describing the command sequence design employed for the observation, and a Cassini Radar Transition (CRT) file. Both of these files document the times of radar mode transitions. The memo is in a detailed human readable format (PDF). The CRT file is an ASCII table suitable as an input for custom analysis software. The information provided by these files is also available in the SBDR , ABDR, and LBDR files themselves on a burst by burst (record by record) basis.
The CRT files consist of four tab delimited columns of ASCII text. The first column is a UTC time tag in yyyy-doyThh:mm:ss.sss format.The second column is a two digit decimal integer denoting the type of transition.The third column is a 15 character (spaces are padded at the end) ASCII transition type tag. The fourth column is a 10 character unique record identification number . Rows are in temporal order.The following table maps transition type integers to tags.The tags denote the ending and begininning times of raster scans (scatterometer and radiometer modes only) as well as the ending and beginning times for each radar mode. For completeness, the end time of one mode and the beginning time of the next mode are both listed. Unless there is a gap between the two modes both times will be identical and will correspond to the starting time of the first burst in the second mode. Recall that each record in a BODP data file contains a UTC time tag. For a given mode or scan the UTC time tags of the bursts within that mode or scan are all <= the ending time in the CRT file and >= the starting time in the CRT file. All bursts outside of the range are not included in that scan or mode. Record identification number on the other hand will be different for the two rows. The mode ending row will have the last record identification number for the old mode. The mode staring row will contain the first record identification number for the new mode. It is important to note that scatterometer data (i.e., normalized radar backscatter cross section) will be available during altimetry and SAR modes and that radiometer data will be available during all modes.
This section describes the format of files contained in the Cassini Radar Instrument Team Archive Volumes. Data that comprise the Archive will be formatted in accordance with the Planetary Data System specifications [Planetary Science Data Dictionary, 1996; PDS Data Preparation Workbook, 1995; PDS Standards Reference 1995].
Document files with the.TXT suffix exist in the Root, Index, Catalog, Document, and Extras directories. They are ASCII files with embedded PDS labels with line lengths that do not exceed 80 characters. Document files have variable length lines with an end-of-line designator consisting of a carriage-return character followed by a line-feed character. This allows the files to be read by the MacOS, Microsoft Windows, and Unix operating Systems.
A Tabular file (INDEX.TAB) exists in the Index directory. This file is an ASCII file formatted for direct reading into many database management systems on various computers. Commas separate all fields, and character fields are enclosed in double quotation marks ("). Character fields are left justified and padded on the right with spaces to keep quotation marks in the same columns of successive records. Number fields are right justified and padded with spaces on the left to keep fixed-width fields. The records are of fixed length, and the last two bytes of each record contain the ASCII carriage-return and line-feed character. This allows a table to be treated as a fixed length record file on computers that support this file type and as a text file with embedded line delimiters on those that don't.
All data files in the Cassini Radar Instrument Team Archive Collection have PDS labels [Planetary Science Data Dictionary, 1996; PDS Standards Reference, 1995]. A PDS label, whether embedded or detached from its associated file, provides descriptive information about the associated file. The PDS label is an object-oriented structure consisting of sets of "keyword = value'' declarations. The object to which the label refers (e.g. IMAGE, TABLE, etc.) denotes the form:
in which the caret character (^, also called a pointer in this context) indicates where to find the object. 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, if there is more than one object in the file. For example:
dirlist is a 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). The list begins at the directory level below the root directory of the CD-ROM.'[dirlist]' may be omitted when the object being described is located in the same directory as the detached label.
Detached label files have variable length lines with an end-of-line designator consisting of a carriage-return character followed by a line-feed character. This allows the files to be read by the MacOS, Microsoft Windows, and Unix operating Systems.
The Cassini BODP science data files are formatted using the "table object" structure of the PDS standards. Each row of the table consists of a data record comprising radar and ancillary data for a single burst. Rows occur in time order. A column represents a particular data field with a specific meaning and data type (i.e. integer, real, etc.) Real values are either 32-bit or 64-bit IEEE floating-point values with little endian byte order (PC REAL). For more information about the format and content of the BODP files, see the Cassini Radar Burst Ordered Data Product SIS, JPL D-27891.
The Cassini BIDR science data files are formatted using the "image object" structure of the PDS standards. The size and coordinate system of the image is defined in the attached PDS label. Images pixels may have several different meanings and data types. For more information about the format and content of the BIDR files, see the Cassini Radar Basic Image Data Record SIS, JPL D-27889.