PDS_VERSION_ID = PDS3 LABEL_REVISION_NOTE = " 2012-02-21 Cornell:BTCarcich incorporated comments from Ken Klaasen. " RECORD_TYPE = FIXED_LENGTH RECORD_BYTES = 80 MISSION_NAME = "NEXT" INSTRUMENT_HOST_NAME = "STARDUST" OBJECT = TEXT PUBLICATION_DATE = 2012-02-09 NOTE = "Stardust-NExT archive data. This is the 'Read me first' file for this data set. It is duplicated in two places in the data set: in the top-level directory as AAREADME.TXT; in the DOCUMENT/ directory as AAAREADME.TXT. The PDS standard requires the former but PDS does not guarantee its preservation, so it is duplicated in the DOCUMENT/ directory." END_OBJECT = TEXT END Stardust-NExT archive data set for NAVCAM RDR data. This file is the "Read me first" file for this data set. Its purpose is to be the starting point for any user who wishes to view and understand the data in this data set. It contains a high-level description of the contents of this data set, and points the user to other documents in this data set that contain more detailed descriptions of the data along with pointers to additional documentation. If the information in this data set is represented as a tree, with each file as a leaf covering a specific area or sampled data, then this file is the root of the tree. Some of the 'leaves' contain reference to external information sources such as journal articles or other data sets; those references are considered an integral part of this data set and are often critical for understanding the data. All of the data sets for the Stardust-NExT mission instrument data have been prepared in a similar manner, so the "Read me first" files for these data sets will be similar. This file comprises the following sections: 1) Introduction to this data set, including pointers to other files that explain what is in the data set 1.1) Quick start 1.2) Product description 2) Data set medium format 3) File formats - where to learn about the formats used in this data set 4) Data set contents - a high-level description of the directory layout 5) Recommended computer software 6) Errata, Disclaimer and PDSDD 6.1) PDS Data Dictionary (PDSDD) 7) Whom to Contact for further Information 1) Introduction =============== This volume contains NAVCAM CODMAC level 3 products from the Stardust-NExT mission. It also contains documentation which describes these products. 1.1) Quick start: ----------------- The data set files are laid out with a directory (a.k.a. folder) structure. The most important top-level directories are CATALOG/, DOCUMENT/ and DATA/. The CATALOG/ directory contains high-level PDS catalog files which describe the mission, spacecraft, instrument and other information related to this data set. The catalog files also contain references to external materials such as journal articles. See CATALOG/CATINFO.TXT for more details. The DOCUMENT/ directory contains more detailed descriptions of this data set. See DOCUMENT/DOCINFO.TXT for more details. The DATA/ directory contains the data in this data set. Subdirectories partition the data by date and/or by target. Each data product has a corresponding PDS data label in accordance with the Planetary Data System (PDS) Standards reference, Version 3.8, document JPL D-7669. See DOCUMENT/DATAINFO.TXT for more details. The BROWSE/ directory contains a browsing facility for the data. See BROWSE/BROWINFO.TXT for more details. 1.2) Product description ------------------------ Each NAVCAM calibrated (RDR) product comprises several sections: the image pixel data from the CCD calibrated to spectral radiance; the BaseLine Stabilization (BLS or bias) pixels from the CCD electronics; the prefix table from the instrument telemetry; the image histogram from the ground data system; the original PDS label from the ground data system; a quality map of the image; an uncertainty map; a signal-to-noise ratio (SNR) map. See also DATA/DATAINFO.TXT, CATALOG/DATASET.CAT and DOCUMENT/DOCINFO.TXT for further details. The products archived in this volume have all been released by the Stardust-NExT Project. 2) Data set medium format ========================= This data set has been delivered to PDS in an electronic format, transferred via either the Internet or portable disk drive. User access will typically be via a web browser over the Internet to a web server at the Small Bodies Node of PDS (currently http://pdssbn.astro.umd.edu/). Duplicating the directory hierarchy and contents recursively from the directory which contains this AAREADME.TXT file and below is all that is required to copy this data set. 3) File format ============== Each data product and all files with content have a PDS label. The PDS label is the definitive and complete source describing the data layout and format in each product in this data set. The PDS label may be attached or detached. Attached labels are in the same file as the data at the start of the file. Detached labels are separate files with pointers to the data files; detached label filenames always end in .LBL or .lbl. The label files conform to the Planetary Data System (PDS) Standards, Version 3.8, Jet Propulsion Laboratory (JPL) document JPL D-7669 Part 2; refer to this standards reference for details in interpreting the label and contents of any file in this data set. PDS labels for data products also contain parameter values such as the start and end times of the data in the data product. NAVCAM image data products are stored as Primary Data Unit (PDU) images and multiple Extension Data Units (EDUs) in FITS files; see http://fits.gsfc.nasa.gov/iaufwg/iaufwg.html FITS-savvy users may use existing FITS software to view and process these data. However, the PDS labels adequately describe both the conditions of each observation (geometry, camera parameters, &c) and the data layout and format in the files, so FITS software is not necessary to work with these data. The FITS headers in the files were developed for use by the science team and are provided as-is with no documentation beyond the comments that follow most FITS header keyword values. All 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 format allows the files to be read by many different operating systems (e.g. MacOS, Windows, DOS, Unix, Linux, VMS etc.). All tabular files are also described by PDS labels, either embedded at the beginning of the file (attached) or detached. If detached, the PDS label file has the same, or a similar, name as the data file(s) it describes, with the extension .LBL; for example, the file INDEX.TAB is accompanied by the detached label file INDEX.LBL in the same directory. 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. 4) Data set contents and directory layout ========================================= The following ASCII graphic describes the file layout of this data set. TOP-LEVEL-DIRECTORY/ | +--AAREADME.TXT The text version of the "Read me first" file. | This file is the starting point for documentation | describing this data set. A duplicate of this | file has been placed in the DOCUMENT/ directory | as AAAREADME.TXT because PDS does not guarantee | preservation of this top-level AAREADME.TXT file. | +--ERRATA.TXT File listing known data set anomalies and errors | +--VOLDESC.CAT Description of the contents of this volume. | +--CATALOG/ Directory containing PDS catalog objects; refer | | to CATINFO.TXT for details. | +--CATINFO.TXT File with detailed description of contents of | | CATALOG/ directory. | +--*.CAT Catalog files (mission, spacecraft, instrument, | data set, personnel, references) | +--DATA/ Directory containing NAVCAM data files; refer to | | DATAINFO.TXT for details. | +--DATAINFO.TXT File describing the layout of data files under | | the DATA/ directory along with any optional | | subdirectories. | |.../ Optional subdirectories of DATA/, described in | | DATAINFO.TXT. | |.../*.LBL Optional detached labels for data files | |.../*.* The data files themselves | +--DOCUMENT/ Directory containing documents necessary for | | understanding this data set; refer to DOCINFO.TXT | | for details. | +--DOCINFO.TXT File with detailed description of contents of | | DOCUMENT/ directory | | | +--AAAREADME.TXT Duplicate of top-level AAREADME.TXT; see above | | | +--*.TXT Documents with attached labels | +--*.LBL Detached PDS labels, one for each document. | | Each label may refer to more than one file. | | Each label has a DESCRIPTION keyword, the value | | of which describes the document. | +--*.* The documents themselves | | | +--*/ Subdirectory(ies) of DOCUMENT/. See | DOCINFO.TXT for more information. | +--INDEX/ Directory containing tabular summaries of the | | data and files in this data set; refer to | | INDXINFO.TXT for details. | +--INDXINFO.TXT File with detailed description of contents of | | of INDEX/ directory. | +--*.LBL PDS labels, one for each index. | +--*.TAB Index tables | +--BROWSE/ Directory containing data set browse facility; | | refer to BROWINFO.TXT for details | +--BROWINFO.TXT File with detailed description of contents of | | of BROWSE/ directory. | | | +--*.LBL PDS labels | +--*.* Browse files | | | +--*/ BROWSE/ subdirectories | +--EXTRAS/ Directory containing additional information that | may be useful for understanding this data set, | but which does not readily fit in one of the | other PDS categories. See EXTRINFO.TXT for | details. +--EXTRINFO.TXT File with detailed description of contents of | EXTRAS/ directory. | +--PDSDD_NEXT.FULL Proposed PDS Data Dictionary (See 6.1 below) | +--*.* Any EXTRAS/ files. +--*/ Any EXTRAS/ subdirectories. 5) Recommended computer software ================================ As noted above, this data set was delivered to PDS-SBN in electronic format. Any computer system capable of replicating the directory (folder) structure should be able to maintain a usable copy of this data set. At the time of the delivery of this data set (2011 A.D.), that specification will be met by computers running the following operating systems: Microsoft Windows; Apple Mac OSX; Unix(tm) derivatives including Linux; VMS. Tabular data may be imported into a spreadsheet application (OpenOffice.org Spreadsheet or Microsoft Office Excel) or a database application (MySQL, PostgreSQL, Microsoft SQL Server or Microsoft Office Access). Tabular data may also be viewed with a PDS tool called NasaView: http://pds.nasa.gov/tools/nasa-view.shtml PDS supplies tools that may be of use in viewing the data files in this data set: http://pds.nasa.gov/tools/index.shtml http://pds.nasa.gov/tools/other-tools.shtml NAVCAM image data can be viewed with NasaView, as well as by using FITS libraries within other programming environments: FITSIO library in several environments (C, FORTRAN, etc.) (http://heasarc.gsfc.nasa.gov/fitsio/) Native FITS reader in Matlab IDL Astronomy Library (http://idlastro.gsfc.nasa.gov/) Documentation and data labels may be viewed with word processing applications: OpenOffice.org Word Processor; Microsoft Office Word; editors such as VI, VIM, GEDIT and others in the Linux/Unix(tm) environment. ASCII files, such as tables and PDS labels, may be viewed with many web browsers. Some documentation files are stored as PDF (Portable Document Format) files; PDF filenames will end in .PDF (case-insensitive). A PDF reader (e.g. Acrobat reader on Windows and Mac OSX, acroread on Unix, Document Viewer on Linux, or a PDF plug-in for a web browser) is necessary to view these files, but in the absence of such readers all PDF documents also have alternate versions that will be easier to view. 6) Errata, Disclaimer and PDSDD =============================== A cumulative list of anomalies and errors is maintained in the file ERRATA.TXT at the root directory of this volume. Over time and multiple versions of this data set it is anticipated that the errors will be corrected and the anomalies incorporated into the data set documentation. Users should always check the latest ERRATA.TXT file for this data set before using the data for any purpose. 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. At the time of delivery of this data set no known anomalies exist and the ERRATA.TXT file comprises only its attached label. Reports of errors or difficulties would be appreciated. Please contact one of the persons listed herein. 6.1) PDS Data Dictionary (PDSDD) -------------------------------- This data set presupposes and proposes the following STANDARD_VALUE_SET entries will be added to the PDS Data Dictionary; see also the file PDSDD_NEXT.FULL in the EXTRAS/ directory. Until those entries are added, PDS validation tools may generate errors and/or warnings when run against this data set. Changes proposed for all Stardust-NExT instrument data sets (CIDA, DFMI, NAVCAM) are included here so PDS personnel do not have to browse several data sets to compile the proposed changes. STANDARD _VALUE Keyword _TYPE New entry ------------ --------- --------- MISSION_NAME STATIC NEXT DATA_SET_ID FORMATION SDU-C/CAL-NAVCAM-3-NEXT-TEMPEL1-V1.0 DATA_SET_NAME FORMATION STARDUST 9P/TEMPEL 1 NAVCAM 3 NEXT V1.0 VOLUME_SET_NAME DYNAMIC STARDUST NAVCAM RDR DATA INSTITUTION_NAME DYNAMIC FINNISH METEOROLOGICAL INSTITUTE INSTITUTION_NAME DYNAMIC THE OPEN UNIVERSITY INSTRUMENT_MODE_ID DYNAMIC NEGATIVE ION MODE INSTRUMENT_MODE_ID DYNAMIC POSITIVE ION MODE PRODUCT_TYPE SUGGESTED SPECTRUM CONFIGURATION_PARAMETERS FDAQ_CALIBRATION GLOBAL_VARIABLES HOUSEKEEPING DOCUMENT_FORMAT DYNAMIC MICROSOFT EXCEL WAVE FACILITY_NAME DYNAMIC CENTER FOR RADIOPHYSICS AND SPACE RESEARCH LABORATORY FOR ASTROPHYSICS & SPACE RESEARCH PSSRI FILTER_NAME DYNAMIC OPNAV INSTITUTION_NAME DYNAMIC FINNISH METEOROLOGICAL INSTITUTE THE OPEN UNIVERSITY MISSION_NAME STATIC NEXT MISSION_PHASE_NAME DYNAMIC CHECKOUT CRUISE 5 CRUISE 6 TEMPEL 1 ENCOUNTER VOLUME_SET_ID FORMATION USA_NASA_JPL_SDNAVCAM_XXXX VOLUME_SET_NAME DYNAMIC STARDUST CIDA DATA STARDUST CIDA EDR/RDR DATA STARDUST DFMI EDR/RDR DATA STARDUST NAVCAM EDR DATA STARDUST NAVCAM RDR DATA 7) Whom to Contact for further Information ========================================== Refer to the personnel catalog file CATALOG/PERSONNEL.CAT, included in this data set, to get contact information for the following people. For questions concerning this data set, data products and documentation: Brian Carcich For questions concerning the generation of the data products under DATA/: Brian Carcich For questions concerning the instrument and instrument data: Ken Klaasen For questions concerning the data labels: Brian Carcich