PDS_VERSION_ID = PDS3 RECORD_TYPE = FIXED_LENGTH RECORD_BYTES = 80 OBJECT = TEXT INTERCHANGE_FORMAT = ASCII PUBLICATION_DATE = 2006-10-05 NOTE = "N/A" END_OBJECT = TEXT END Venus Express SOIR PSA LEVEL 2 DATA ARCHIVE VOLUME ++++++++++++++++++++++++++++++++++++++++++++++++++ 1. Overview ------------ This volume contains PSA Level 2 data products from observations acquired with the SOIR channel of SPICAV (Spectroscopy for the Investigation of the Characteristics of the Atmosphere of Venus)on Venus Express VEX). For a complete description of the data products, the user is referred to the DOCUMENT/EAICD text on the archive volume. In the DATA directory, data are stored in subdirectories per observation in files with detached label. Naming of the subdirectories is as follows : YYYYMMDD_TCC with : * YYYY = year * MM = month * DD = day * T = measurement type * CC = chronological mesurement number of the day (starting at 1) T (measurement type) can have the following values : * I = Ingress (occultation) * E = Egress (occultation) * M = Miniscan * F = Fullscan (outside atmosphere) * A = Fullscan (inside atmosphere) * N = Nadir * C = Pointing calibration DATA_SET_ID : ------------- VEX-Y/V-SPICAV-2-SOIR-V4.0 CONTENTS DESCRIPTION : ---------------------- Calibrated SOIR data records collected during the CRUISE and the different Venus orbit nominal phases 2. Archive Volume - Concept of Delivery --------------------------------------- Within the Planetary Science Archive (PSA) the archive volume represents an online delivery. This might be not fully compliant with the PDS standard 3.6, but the PSA itself can after the end of mission produce fully compatible archive volumes. Deliveries are based on the concept of a release and a revision. This concept allows the delivery of experiment data without the delivery of all supplementary information, that has already been delivered at the first initial delivery of a fully PDS compatible Archive Volume, containing the VOLDESC.CAT file and all necessary CATALOG, DOCUMENT, INDEX, DATA, etc directories and their content. Some PDS labels used in the SOIR Standard Data Archive are specifically related to the concept of release and revision. A data set release (or volume release) contains data from a well-defined period of time and is identified by the VOLUME_RELEASE_ID (4 digit number : [0001:9999]. A volume release is made of at least one revision : the initial revision. The initial revision contains the initial data of a data set release and is identified by a VOLUME_REVISION_ID equal to 0000. A following revision of the data set release (updated files, supplementary files, deleted files) would need the value of the VOLUME_REVISION_ID incremented by one. A release catalog object needs to be included in the catalog object to fully describe the release. The release object contains all keyword-value pairs that are necessary to identify a revision within a release. The DESCRIPTION part of the DATA_SET_RELEASE object will contain the full history of the release including all previous revisions. Each revision of a release is added in the release catalog object and all necessary information about this revision is given by a REVISION object. 3. File Formats ---------------- This section provides a brief description of the files and data objects available on the SOIR archive volume: text files, PDF files, HTML files, PNG files, and PDS objects. A complete description of each file format is available in the DOCUMENT/EAICD text on the archive volume. Text and detached PDS label files have fixed-length record format, and line lengths of 80 characters max (cat files 72 characters), including a carriage return (ASCII 13) at the end of the record. This allows the files to be read by MS-DOS/Windows, Unix, and VMS operating systems. Documents that contain formatting and figures that cannot be rendered as ASCII text are provided as HTML, JPEG, Microsoft Excel or PDF files. A PDS detached label provides descriptive information about the associated file. The PDS labels in the SOIR Standard Data Archive are conform to the PDS standards [Planetary Science Data Dictionary, 2001; PDS Standards Reference, 2003]. In general, the PDS label is an object-oriented structure consisting of sets of 'keyword = value' declarations; the object to which the label refers is denoted by a statement of the form: ^object = location in which the ^ character (also called a pointer in this context) indicates where to find the object. 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: ^SOIR_TABLE = "20060807_I01_OBS.TAB" indicates that the SOIR TABLE object can be found in the file 20060807_I01_OBS.TAB, in the same directory as the detached label file. 4. File Naming Convention ------------------------- Data products provided by the SOIR team will have the following names: 1 science data table and 1 associated label containing time, spectra and housekeeping data : ./VEX-Y_V-SPICAV-2-SOIR-V3.0/DATA/YYYYMMDD_TCC/YYYYMMDD_TCC_OBS.TAB ./VEX-Y_V-SPICAV-2-SOIR-V3.0/DATA/YYYYMMDD_TCC/YYYYMMDD_TCC_OBS.LBL 1 additional data table for telecommand 1 (TC1 suffix) and its associated label : ./VEX-Y_V-SPICAV-2-SOIR-V3.0/DATA/YYYYMMDD_TCC/YYYYMMDD_TCC_TC1.TAB ./VEX-Y_V-SPICAV-2-SOIR-V3.0/DATA/YYYYMMDD_TCC/YYYYMMDD_TCC_TC1.LBL 1 additional data table for telecommand 2 (TC2 suffix) and its associated label : ./VEX-Y_V-SPICAV-2-SOIR-V3.0/DATA/YYYYMMDD_TCC/YYYYMMDD_TCC_TC2.TAB ./VEX-Y_V-SPICAV-2-SOIR-V3.0/DATA/YYYYMMDD_TCC/YYYYMMDD_TCC_TC2.LBL with : * YYYY = year * MM = month * DD = day * T = measurement type * CC = chronological mesurement number of the day (starting at 1) T (measurement type) can have the following values : * I = Ingress (occultation) * E = Egress (occultation) * M = Miniscan * F = Fullscan (outside atmosphere) * A = Fullscan (inside atmosphere) * N = Nadir * C = Pointing calibration Example : Sept 12th 2006, MTP 05, Occultation 13 ./VEX-Y_V-SPICAV-2-SOIR-V3.0/DATA/20060912_I01/20060912_I01_OBS.tab ./VEX-Y_V-SPICAV-2-SOIR-V3.0/DATA/20060912_I01/20060912_I01_OBS.lbl ./VEX-Y_V-SPICAV-2-SOIR-V3.0/DATA/20060912_I01/20060912_I01_TC1.tab ./VEX-Y_V-SPICAV-2-SOIR-V3.0/DATA/20060912_I01/20060912_I01_TC1.lbl ./VEX-Y_V-SPICAV-2-SOIR-V3.0/DATA/20060912_I01/20060912_I01_TC2.tab ./VEX-Y_V-SPICAV-2-SOIR-V3.0/DATA/20060912_I01/20060912_I01_TC2.lbl 4. Applicable Software ----------------------- The SOIR data pass through a number of different software filters, all written in the python and Matlab programming language. Extraction from DDS - level 0.1 creation ---------------------------------------- After extraction from the VEX DDS the SOIR data file is loaded into a software tool with several functions : - graphical presentation of scientific data contents, second per second - graphical presentation of intensity profile throughout complete observation - graphical presentation of housekeeping values - conversion of raw DDS data to internal SOIR level 0.1 data (csv-files). Also .bin- and/or .png-files can be created upon demand ../scripts_lev0.0_to_lev0.1/v1.0/produce_lev0.1_csv.py PDS file creation ----------------- The level 0.1 .csv-files are transformed (without modification to the scientific contents) into level 0.1b, which is in PDS format and corresponds to the PSA level 1b : ../scripts_pds_creation/v1.0/produce_lev1b_pds.py 5. Volume Contents ------------------- Files on the SOIR level 2 archive volume are organized into a series of subdirectories below the top-level directory. See the DATAINFO.TXT files in each directory for specific information on the files in the directory. The following table shows the generalized structure and contents of the SPICAV/SOIR archive volumes. Top-level ROOT | |- AAREADME.TXT The file you are reading | |- ERRATA.TXT Description of known anomalies and errors | present on the volume. | |- VOLDESC.CAT Description of the contents of the volume in | a PDS format for the PDS Catalog | | |- [DATA] A directory containing the data + associated | | label files | | | |- DATAINFO.txt Description of files in this directory | | | |-[20060512_I01] | | | | | |-- {file(s) *.TAB, *.LBL} | | | | |-[20060807_IO1] | | | | | |-- {file(s) *.TAB, *.LBL} | | | |_... | |- [BROWSE] A directory containing a graphical overview of the | | measurements | | | |- BROWINFO.TXT Description of files in this directory | | | |-[20051125_CO1] | | | | | |-- {file(s) *.TAB, *.LBL} | | | | |-[20060807_I01] | | | | | |-- {file(s) *.TAB, *.LBL} | | | |_... | | |- [CATALOG] A directory containing information about the data | | set | | | |- CATINFO.TXT Description of files in this directory | | | |- DATASET.CAT Description of the VEXSPI_0.1B_SR data | | set | | | |- RELEASE.CAT Release object of the VEXSPI_0.1B_SR | | data set | | | |- MISSION.CAT Description of the Venus Express mission | | | |- INSTHOST.CAT Description of the Venus Express | | spacecraft | | | |- INST.CAT Description of the VEX SPICAV/SOIR | | instrument | | | |- REFERENCE.CAT List of pertinent references | | | |- SOFTWARE.CAT Description of the software | included on the volume. | |- [INDEX] A directory containing an index of data | | files | | | |- INDXINFO.TXT Description of files in this directory | | | |- INDEX.TAB Index of level 2 SOIR data files in | | the DATA directory | | | |- INDEX.LBL PDS detached label describing the | | the corresponding *.TAB file | | | |- BROWSE_INDEX.TAB Index of level 2 SOIR browse data | | files in the BROWSE directory | | | |- BROWSE_INDEX.LBL PDS detached label describing the | | the corresponding *.TAB file | | | |- GEOINDEX.TAB Index of level 2 SOIR GEO footprint | | data files in the DATA directory | | | |- GEOINDEX.LBL PDS detached label describing the | the corresponding *.TAB file | |- [DOCUMENT] A directory containing information documents | | | |- DOCINFO.TXT Description of files in this directory | | | |- EAICD.PDF The SPICAV/SOIR EAICD in PDF format | | | |- EAICD.ASC The SPICAV/SOIR EAICD in ASC format | | | |- EAICD.TXT The SPICAV/SOIR EAICD in TXTformat | | | |- EAICD.LBL PDS detached label that describes | | EAICD.PDF, EAICD.ASC and EAICD.TXT | | | |- FLIGHT_USER_MANUAL.TXT ASCII file describing the SOIR | | instrument. | | | |- FLIGHT_USER_MANUAL.LBL PDS detached label that | | describes FLIGHT_USER_MANUAL.TXT | | | |- INSTRUMENT_DESC.TXT ASCII file describing the SOIR | | instrument. | | | |- INSTRUMENT_DESC.LBL PDS detached label that describes | | INSTRUMENT_DESC.TXT | | | |- SOIR_DATAFILE_DESC.TXT ASCII file describing the | | contents of the data files which | | are delivered in the SOIR data | | set. | | | |- SOIR_DATAFILE_DESC.LBL PDS detached label that | | describes SOIR_DATAFILE_DESC.TXT | | | |- SOIR_CALIBRATION_DESC.TXT ASCII file describing the | | calibration of the SOIR data | | which are delivered in the SOIR | | dataset. | | | |- SOIR_CALIBRATION_DESC.LBL PDS detached label that | | describes SOIR_CALIBRATION_DESC.TXT | | | |- INSTRUMENT_MODE_DESC.TXT- ASCII file describing the | | different operating modes of the | | SPICAV/SOIR spectrometer. | | | |- INSTRUMENT_MODE_DESC.LBL- PDS detached label that | | describes INSTRUMENT_MODE_DESC.TXT | | | |- VEX_POINTING_MODE_DESC.TXT - ASCII file describing the | | different spacecraft pointing modes | | | |- VEX_POINTING_MODE_DESC.LBL - PDS detached label that | | describes VEX_POINTING_MODE_DESC.TXT. | | | |- VEX_SCIENCE_CASE_ID_DESC.TXT - ASCII file describing 10 | | different Venus Express science cases. | | | |- VEX_SCIENCE_CASE_ID_DESC.LBL - PDS detached label that | | describes VEX_SCIENCE_CASE_ID_DESC.TXT. | | | |- VEX_ORIENTATION_DESC.TXT - ASCII file informing on the | | usage of the spacecraft orientation on Venus Express. | | | |- VEX_ORIENTATION_DESC.LBL - PDS detached label that | | describes VEX_ORIENTATION_DESC.TXT. | | | |- OBSERVATION_TYPE_DESC.TXT - ASCII file describing the | | different observation types of SOIR | | | |- OBSERVATION_TYPE_DESC.LBL - PDS detached label that | | describes OBSERVATION_TYPE_DESC.TXT. | | | |- SOIR_DATAQUALITY_DESC.TXT ASCII file describing the | | of the data quality keyword in | | the SOIR data set. | | | |- SOIR_DATAQUALITY_DESC.LBL PDS detached label that | | describes SOIR_DATAQUALITY_DESC.TXT | | | |- SOIR_CALIBRATION_SOFTWARE.TXT ASCII file describing the | | calibration software for the SOIR data | | which are delivered in the SOIR dataset. | | | |- SOIR_CALIBRATION_SOFTWARE.LBL PDS detached label that | | describes SOIR_CALIBRATION_SOFTWARE.TXT | | | |- SOIR_ARCH_PSA_L1B_SOFTW.TXT ASCII file describing the | | L1B archiving software for the SOIR data which | | are delivered in the SOIR dataset. | | | |- SOIR_ARCH_PSA_L1B_SOFTW.LBL PDS detached label that | | describes SOIR_ARCH_PSA_L1B_SOFTW.TXT | | | |- SOIR_ARCH_PSA_L2_SOFTW.TXT ASCII file describing the L2 | | archiving software for the SOIR data which | | are delivered in the SOIR dataset. | | | |- SOIR_ARCH_PSA_L2_SOFTW.LBL PDS detached label that | describes SOIR_ARCH_PSA_L2_SOFTW.TXT 6. Whom to Contact for Information ------------------------------------ For questions concerning this data set: Contact Arnaud Mahieux (Archive Manager) See personnel information in PERS.CAT catalog. 7. Cognizant Persons --------------------- SPICAV data are produced under the responsibility of J-L Bertaux, SPICAV Principal Investigator, Ann Carine Vandaele, SOIR Principal Investigator, Arnaud Mahieux, SOIR co-Invetsigator and Eddy Neefs, SOIR Pproject Manager.