PDS_VERSION_ID = PDS3 RECORD_TYPE = STREAM OBJECT = TEXT INTERCHANGE_FORMAT = ASCII PUBLICATION_DATE = 2013-01-14 NOTE = "N/A" END_OBJECT = TEXT END VENUS Express VIRTIS archive 1. Overview DATA_SET_ID : ----------- VEX-V-VIRTIS-2/3-EXT4-V1.0 DATA_SET_NAME : ----------- VENUS EXPRESS VENUS VIRTIS 2/3 EXT4 V1.0 CONTENTS DESCRIPTION : -------------------- Data products archived in this volume are copies of files released by the VIRTIS team. Errors and anomalies in the original data and comments about the archive are noted in the ERRATA.TXT file. 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 VIRTIS 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 need 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 VIRTIS 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 stream or fixed-length record format, and line lengths of must of 80 characters, including a CR-LF sequence (ASCII 13-10) at the end of the record. This allows the files to be read by MS-DOS/ Windows,Unix, and VMS operating systems. All catalog files (*.CAT) should have a maximum of 72 characters in each line, including a CR-LF sequence (ASCII 13-10) at the end. Documents that contain formatting and figures that cannot be rendered as ASCII text are provided as HTML,JPEG or PDF files. The hypertext file contains ASCII text plus hypertext markup language (HTML) commands that enable it to be viewed in a Web browser. The PDF (Portable Document Format) file is a proprietary format of Adobe Systems Incorporated a that can be viewed using the free Acrobat Reader software. Most of the PDS labels in the VIRTIS Standard Data Archive conform to 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 carat 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: ^HEADER = ("F01.DAT",1) ^IMAGE = ("F01.DAT",1025 ) indicates that the IMAGE object begins at byte 1025 of the file F01.DAT, in the same directory as the detached label file. 4. File Naming Convention Data products provided by the VIRTIS team have the following names: (details are available in the EAICD document) The DATA directory is subdivided as follows: /DATA/CRUISE/VIR9999 contains all data acquired during the cruise to Venus /DATA/VOI/VIR0000 contains all data acquired during orbit 0 (lasting 9 days) /DATA/VOCP/VIR000x contains all data acquired during orbit commisionning (orbits 5 to 7) /DATA/MTPxxx/VIRnnnn contains all data acquired during orbit # nnnn in MTPxxx, starting from 1. The orbit number is coded exactly on 4 digits, completed with 0s if needed, to encompass the duration of the extended mission. All orbit directories are split in three subdirectories: RAW contains all raw data files from the three channels CALIBRATED contains all calibrated files from the three channels (including H calibrated darks) GEOMETRY contains all geometry files for the three channels File names are coded on 9.3 format as follows: V_. or VFxxxx_nn.EEE where: V is a literal "V" character F is the channel/transfer mode identifier (one alpha character): H: H image transfer mode (backup observation mode) S: H single spectrum transfer mode (including dark current files in nominal mode) T: H "64-spectra frame" transfer mode (nominal mode) I: M-IR data V: M-Vis data xxxx is the orbit number coded on exactly 4 digits (same as in directory string) nn is the subsession ID (ID of file produced by this channel during this orbit) EEE is the extension identifying the type and level of data (three alpha characters): QUB: raw data GEO: geometry files CAL: calibrated data DRK: calibrated dark currents for H For cruise data files, xxxx = 9999 and nn is the ordinal number of the observation for this channel. 5. Applicable Software The VIRTIS archive contains a software library to read VIRTIS data under IDL. It is located in the DOCUMENT directory as a ZIP archive. 6. Volume Contents Files on the VIRTIS archive volume are organized into a series of subdirectories below the top-level directory. See the xxxxINFO.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 VIRTIS 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 directories, grouped by | | MTP, orbits, and data level | | | |- [MTP002] One directory per MTP, starting from 2 | | | | | |- [VIRxxxx] Files acquired during orbit xxxx | | | | | |- [CALIBRATED] A directory containing the | | | calibrated files | | | | | |- [GEOMETRY] A directory containing the | | | geometry files | | | | | |- [RAW] A directory containing the | | raw files | | | | ... | |- [BROWSE] A directory containing reduced-size, easily viewed versions | | of data products (for M only). The images are grouped in a | | directory structure based on MTPs. | | | |- BROWINFO.TXT Description of files in this directory. | | | |- MTP001 One directory per MTP | | | | ... | |- [INDEX] A directory containing an index of data files. | | | |- INDXINFO.TXT Description of files in this directory. | | | | | |- INDEX.TAB Index of data files in the DATA | | directory generated by pvv index | |- INDEX.LBL PDS detached label describing the | | the corresponding *.TAB file | | | |- VIRTIS_INDEX.TAB Alternative index of data files in | | the DATA directory, including | | relevant parameters | |- VIRTIS_INDEX.LBL PDS detached label describing the | | the corresponding *.TAB file | | | |- GEO_VENUS.TAB Geometry index Table for VIRTIS | | products | |- GEO_VENUS.LBL PDS detached label describing the | | the corresponding *.TAB file | |- BROWSE_INDEX.TAB Index of browse images | | | |- BROWSE_INDEX.LBL and its label | | | |- [GEOMETRY] A directory containing geometry files associated to the | | data products (SPICE kernels handling the M scanning | | mirror attitude) | | | |- GEOMINFO.TXT Description of files in this directory. | | | |- *.BC Spice kernels for the scanning mirror (one per MTP) | | | |- *.LBL Corresponding labels | | | | |- [CATALOG] A directory containing information about the data set | | | |- CATINFO.TXT Description of files in this directory | | | |- DATASET.CAT Description of the data set | | | |- RELEASE.CAT Release object of the VIRTIS data set | | | |- MISSION.CAT Description of the Venus Express mission | | | |- INSTHOST.CAT Description of the VenusExpress spacecraft | | | |- INST.CAT Description of the VIRTIS instrument | | | |- TARGET.CAT Description of the obesrvational targets | | | |- SOFTWARE.CAT Description of the included software | | | |- REF.CAT List of pertinent references. | | | |- PERSON.CAT Personal involved. | | | |- [DOCUMENT] A directory containing information documents. | | | |- DOCINFO.TXT Description of files in this directory. | | | |- VIRTIS_DOCS.LBL PDS labels for most documents contained | | in the directory | |- VIRTIS_EAICD.TXT VIRTIS EAICD in | | ASCII text | |- VIRTIS_EAICD.PDF VIRTIS EAICD in PDF | | format | |- EAICD_FIG_xx.PNG Figures from the EAICD | | | |- VIRTIS_EXP_USER_MANUAL.TXT VIRTIS User Manual in ASCII | | text | |- VIRTIS_EXP_USER_MANUAL.PDF VIRTIS User Manual in PDF | | format | |- USERMAN_FIG_xx.PNG Figures from the User manual | | | |- VIRTIS_GEOMETRY.PDF Documentation to the geometry files in | | PDF format | |- VIRTIS_GEOMETRY.TXT Documentation to the geometry files in | | ASCII format | |- GEOMETRY_FIG_xx.PNG Figures from the geometry documentation | | | |- VIRTIS_M_CALIBRATION.TXT VIRTIS_M Calibration report in | | ASCII text | |- VIRTIS_M_CALIBRATION.PDF VIRTIS_M Calibration report in PDF | | format, TBD | |- M_CALIB_FIG_xx.PNG Figures from the M calibration report | | | |- VIRTIS_H_CALIBRATION.TXT VIRTIS_H documentation in ASCII | | text | |- VIRTIS_H_CALIBRATION.PDF VIRTIS_H documentation in PDF | | format | |- H_CALIB_FIG_xx.PNG Figures from the H calibration document | | | |- VVX-DLR-MA-001.PDF Documentation to the Virtis VEx | | on-board software | |- VVX-DLR-MA-001.TXT ASCII version | | | |- VVX-GAF-IC-002.PDF Software internal interface control document | | (including short description of telemetry data) | |- VVX-GAF-IC-002.TXT ASCII version | | | |- VVX-GAF-IC-003.PDF On-board data handling software interface | | control document (including extensive description of TM data) | |- VVX-GAF-IC-003.TXT ASCII version | | | |- ESA_SP_2007.PDF VIRTIS technical paper in ESA SP-1295 | |- ESA_SP_2007.TXT ASCII version | | | |- LECTURE_PDS.PDF IDL software documentation in PDF format | | | |- LECTURE_PDS.TXT IDL software documentation in ASCII | | format | |- LECTUREPDS_FIG_xx.PNG Figures from the software document | | | |- LECTUREPDS2_8_1.ZIP IDL library to read and handle | | VIRTIS data, as a GZIP archive | |- LECTUREPDS2_8_1.LBL Combined label for the software | | | |- ZIPINFO.LBL Refernce to ZIP scheme | | | |- VEX_ORIENTATION_DESC.TXT Description of spacecraft | | orientation from PSA | |- VEX_ORIENTATION_DESC.LBL and its label | | | |- VEX_POINTING_MODE_DESC.TXT Description of spacecraft pointing | | mode from PSA | |- VEX_POINTING_MODE_DESC.LBL and its label | | | |- VEX_SCIENCE_CASE_ID_DESC.TXT Description of science cases | | from PSA | |- VEX_SCIENCE_CASE_ID_DESC.LBL and its label | | | |- VEX_MISSION_CALENDAR_PSA.PDF Venus Express spacecraft events | | from PSA | |- VEX_MISSION_CALENDAR_PSA.TXT ASCII version | |- VEX_MISSION_CALENDAR_PSA.LBL and its label | | | |- CK_HEADER.TXT Header to the C kernels in the GEOMETRY | | directory | | | | | |- [CALIB] A directory containing data used in the calibration process | | | |- CALINFO.TXT Description of files in this directory. | | | |- VEX_VIRTIS_M_VIS_ITF_DUMMY.DAT Transfer fct for M-visible | | | |- VEX_VIRTIS_M_VIS_ITF_DUMMY.LBL Corresponding label | | | |- VEX_VIRTIS_M_IR_ITF_V2.DAT Transfer fct for M-IR | | | |- VEX_VIRTIS_M_IR_ITF_V2.LBL Corresponding label | | | |- H_SPECTRAL_WIDTH.TAB Coefficients of the polynomials | | providing H-channel spectral widths | | | |- H_SPECTRAL_WIDTH.LBL | | | |- H_SPECTRAL_COEF.TAB Coefficients of the polynomials | | providing H-channel wavelengths | | | |- H_SPECTRAL_COEF.LBL Corresponding label | | | |- DEADPIXELMAP.DAT List of VIRTIS-H pixels not | | included in on-board summing | | | |- DEADPIXELMAP.LBL Corresponding label | | | | | |- [EXTRAS] A directory containing files not required by the PSA | | | |- EXTRINFO.TXT Description of files in this directory. | | | |- VIRTIS_LOG_DEL1.TXT Index of data cubes including | | the most important parameters | | | |- VIRTIS_LOG_DEL1.LBL Corresponding label | | | |- [CORRUPTED_DARKS] Directory containing lists of corrupted | | | H dark acquisitions in files | | | up to June 13th, 2007 | | |- VSxxxx_yy_BAD.TAB List of the corrupted acquisitions for | | | file VSxxx_yy.QUB | | |- VSxxxx_yy_BAD.LBL Corresponding label 7. Whom to Contact for Information For questions concerning this data set: Stephane Erard, Observatoire de Paris / LESIA stephane.erard@obspm.fr +0033 (0) 1 45 07 78 19 8. Cognizant Persons Pierre Drossart, LESIA / Observatoire de Paris-Meudon pierre.drossart@obspm.fr +0039 (0) 6 49 93 44 45 Giuseppe Piccioni, INAF / IASF giuseppe.piccioni@iasf-roma.inaf.it +0039 (0) 6 49 93 44 45