European Space Agency Research and Science Support Department Planetary Missions Division ROSETTA-RPC-ICA To Planetary Science Archive Interface Control Document RO-RPC-ICA-EAICD Draft 30 April 2010 _____________________________ Prepared by: Hans Nilsson _____________________________ Approved by: Rickard Lundin Distribution List Recipient Organisation E-mail Rickard Lundin Swedish Institute of Space Physics, Kiruna, Sweden Rickard.Lundin@irf.se Jan Karlsson Swedish Institute of Space Physics, Umea, Sweden jk@irf.se Anders Eriksson Swedish Institute of Space Physics, Uppsala, Sweden Anders.Eriksson@irfu.se J. Burch SwRI, San Antonio, TX., United States jburch@swri.edu K-H Glassmeier TU Braunschweig, Germany kh.glassmeier@tu-bs.de Chris Carr Imperial College London c.m.carr@imperial.ac.uk Jean-Gabriel Trotignon LPCE/CNRS, Orleans, France Jean-Gabriel.Trotignon@cnrs-orleans.fr G. Schwehm SCI-SB gerhard.schwehm@esa.int K.R. Wirth SCI-SB Kristin.wirth@esa.int J. Zender SCI-SD Joe.zender@esa.int D. Koschny SCI-SB Detlef.koschy@esa.int M. A'Hearn PDS-SBN ma@astro.umd.edu T. Farnham PDS-SBN Farnham@astro.umd.edu Change Log Date Sections Changed Reasons for Change TBD ITEMS Section Description Table Of Contents 1 Introduction 3 1.1 Purpose and Scope 3 1.1.1 Contents 3 1.2 Archiving Authorities 3 1.2.1 ESA's Planetary Science Archive (PSA) 3 1.3 Intended Readership 3 1.4 Applicable Documents 4 1.5 Relationships to Other Interfaces 4 1.6 Acronyms and Abbreviations 4 1.7 Contact Names and Addresses 5 2 Overview of Instrument Design, Data Handling Process and Product Generation 5 2.1 Scientific Objectives 9 2.2 Data Handling Process 10 2.3 Product Generation and Data Validation 10 2.4 Overview of Data Products 11 2.4.1 Instrument Calibrations 11 2.4.2 In-Flight Data Products 13 2.4.3 Software 14 2.4.4 Documentation 14 2.4.6 Derived and other Data Products 14 2.4.7 Ancillary Data Usage 15 3 Archive Format and Content 15 3.1 Format and Conventions 15 3.1.1 Deliveries and Archive Volume Format 15 3.1.2 Data Set ID Formation 15 3.1.3 Directory Naming Convention 16 3.1.4 File naming Convention 16 3.2 Standards Used in Data Product Generation 17 3.2.1 PDS Standards 17 3.2.2 Time Standards 17 3.2.3 Reference Systems 17 3.2.4 Other Applicable Standards 17 3.3 Data Validation 18 3.4 Content 18 3.4.1 Volume Set 18 3.4.2 Data Set 18 3.4.3 Directories 19 3.4.4.1 Root Directory 19 3.4.4.2 Calibration Directory 19 3.4.4.3 Catalog Directory 20 3.4.4.4 Index Directory 20 3.4.4.5 Browse Directory and Browse Files 21 3.4.4.6 Geometry Directory 22 3.4.4.7 Software Directory 22 3.4.4.8 Label Directory 22 3.4.4.10 Document Directory 22 3.4.4.11 Data Directory 23 4 Detailed Interface Specifications 23 4.1 Structure and Organization Overview 24 4.2 Data Sets, Definition and Content 24 4.5 Data Product Design 24 4.5.1 Data Product "Uncalibrated data" Design 25 4.5.1.1 File Characteristics Data Elements 32 4.5.1.2 Data Object Pointers Identification Data Elements 32 4.5.1.3 Instrument and Detector Descriptive Data Elements 32 4.5.1.4 Structure Definition of Instrument Parameter Objects 32 4.5.1.5 Data Object Definition 32 4.5.1.6 Description of Instrument 33 4.5.1.7 Parameters Index File Definition 33 4.5.1.8 Mission Specific Keywords 33 4.5.2 Data Product "Calibrated data" Design 33 6 Appendix: Available Software to read PDS files 34 8 Appendix: Example of Directory Listing of Data Set X 35 1Introduction 1.1Purpose and Scope The purpose of this EAICD (Experimenter to (Science) Archive Interface Control Document) is two fold. First it provides users of the Rosetta Plasma Consortium Ion Composition Analyzer (RPC-ICA) instrument with detailed description of the product and a description of how it was generated, including data sources and destinations. Secondly, it is the official interface between your instrument team and your archiving authority. 1.1.1 Contents This document describes the data flow of the RPC-ICA instrument on Rosetta from the s/c until the insertion into the PSA for ESA. It includes information on how data were processed, formatted, labeled and uniquely identified. The document discusses general naming schemes for data volumes, data sets, data and label files. Standards used to generate the product are explained. Software that may be used to access the product is explained further on. The design of the data set structure and the data product is given. Examples of these are given in the appendix. 1.2Archiving Authorities The Planetary Data System Standard is used as archiving standard by NASA for U.S. planetary missions, implemented by PDS ESA for European planetary missions, implemented by the Research and Scientific Support Department (RSSD) of ESA 1.2.1 ESA's Planetary Science Archive (PSA) ESA implements an online science archive, the PSA, to support and ease data ingestion to offer additional services to the scientific user community and science operations teams as e.g. search queries that allow searches across instruments, missions and scientific disciplines several data delivery options as direct download of data products, linked files and data sets ftp download of data products, linked files and data sets The PSA aims for online ingestion of logical archive volumes and will offer the creation of physical archive volumes on request. 1.3 Intended Readership The staff of the archiving authority (Planetary Science Archive, ESA, RSSD, design team) and any potential user of the RPC-ICA data. 1.4Applicable Documents Planetary Data System Data Preparation Workbook, February 1, 1995, Version 3.1, JPL, D-7669, Part1 Planetary Data System Standards Reference, August 1, 2003, Version 3.6, JPL, D-7669, Part 2 [Mission] Archive Generation, Validation and Transfer Plan, [month day, year], [doc number] Rosetta Plasma Consortium Users' Manual, October 28, 2002, v. 0.994, RO-RPC-UM Planetary Data System Data Preparation Workbook Planetary Data System Standards Reference, August 1, 2003, Version 3.6 ROSETTA, Archive Generation, Validation and Transfer Plan, 06 October 2005, RO-EST-PL-5011 1.5 Relationships to Other Interfaces This EAICD describes the overall RPC-ICA archiving details. If there will be changes in the archive format or labels this will affect both this document and the software which produces the PDS format data. 1.6 Acronyms and Abbreviations PSA Planetary Science Archive ICA Ion Composition Analyzer IES Ion and Electron Spectrometer, part of RPC instrument suite on Rosetta PDS Planetary Data System RPC Rosetta Plasma Consortium MCP Micro Channel Plate IMA Ion Mass Analyzer, twin instrument of ICA on Mars Express CESR Centre d'Etudes Spatiales et de Rayonnements IRF Institutet foer rymdfysik (Swedish Institute of Space Physics) FGM Flux Gate Magnetometer ES Electrostatic in ES analyzer TC Telecommand TM Telemetry GSE Geo Solar Ecliptic coordinate system UTC Universal time FOV Field-of-view HV High Voltage PROM Programmable Read Only Memory NRM Normal instrument model HAR High Angular Resolution model EXM Energy-mass matrix high mass resolution instrument model 1.7 Contact Names and Addresses Hans Nilsson, project manager Hans.nilsson@irf.se Swedish Institute of Space Physics Box 812 981 28 Kiruna Sweden Telephone +46 980 79127 Fax +46 980 79050 2 Overview of Instrument Design, Data Handling Process and Product Generation The Ion Composition Analyzer is an ion spectrometer designed to study ion dynamics with mass resolution. The design of the instrument is shown in figure 1. [PICTURE ICA_EAICD004.PNG] Figure 1 Overview of the ICA instrument Particles enter the analyzer through an outer grounded grid. Behind the grid is a deflection system whose purpose is to deflect particles coming from angles between 45 deg and 135 deg with respect to the instrument symmetry axis (spacecraft y-axis) into the electrostatic analyser. This deflection system is named Deflector in figure 1 and the curved path of ions affected by the deflection electric field are shown as a red and a blue line. Ions within a swept energy pass band will pass the electrostatic analyzer (ES Analyzer, ESA in figure above). This is achieved by applying a high-voltage electric field between the inner and outer plate of the ES Analyzer. Only particles within the desired energy pass band will get just the right curvature of their path from this electric field so that they can pass the ES Analyzer. The geometrical (particle-optical) properties of the ES Analyzer determines the energy resolution which is 7% for ICA The ions are then deflected in a cylindrical magnetic field set up by permanent magnets, labeled Magnets in figure 1. The field deflects lighter ions more than heavy ions. The blue line in figure 1 depicts the path of a heavy and energetic particle which deviates only a little from a straight path. Heavy particles with therefore hit close to the center of the detection area. The red line depicts the pass of an ion with lower mass and/or energy. The ions finally hit a micro-channel plate (MCP) which amplifies the signal from the particle so that it can be detected by charge sensitive amplifiers. The charges from the MCP are detected by an anode system with 16 anodes for detecting angle of arrival and 32 anodes to determine radial position and thus mass (radial position is affected by both mass and energy, but energy is known because of the ES Analyzer). The different angles of arrivals that can be detected are termed sectors, and the radial anodes are termed mass channels. Ions are analyzed in both direction and mass per charge simultaneously. The magnet assembly can be biased with respect to the electrostatic analyzer to post accelerate ions; this post acceleration enables a selection of both mass range and mass resolution. The energy range of the instrument is 25 eV/e to 40 keV/e, covered in 96 steps. The full mass matrix has 32 channels, which are grouped according to calibration data. Resolution and mass coverage will depend on ion energy and post acceleration setting. The spatial resolution of the instrument is 22.5 deg x 4.5 deg. The 16 anode sectors of the MCP constitutes a 360 deg field-of-view in the x-z plane of the spacecraft with 22.5 deg resolution. This angle will be referred to as the azimuthal angle of the instrument field-of-view. A field-of-view of 51 deg to 131 deg with respect to the spacecraft y-axis is in practice achieved through the deflection system, with an intrinsic angular resolution of the instrument of 4.5 deg. The electric field applied over the deflection plates bends the path of incoming particles so that those coming from some angle away from 90 deg with respect to spacecraft y-axis will be able to pass the electrostatic analyzer . This angle will be referred to as the elevation angle. The resolution in elevation angle is determined by the geometrical (particle-optical) properties of the instrument. The elevation angle resolution has been determined through calibration and the number of elevation steps has been tailored to provide an almost continuous coverage of the elevation field-of-view. . The steps are nominally 5.625 deg apart to cover as close as possible the nominal angular range of +-45 deg from the instrument measurement symmetry plane. Elevation angle index numbering is shown in figure 2, produced by A. Fedorov of CESR Toulouse. Figure 2 is the official reference to sector and elevation index numbering and will be included with the archived data in the GEOMETRY directory. [PICTURE ICA_EAICD006.PNG] Figure 2 Sector and elevation angle numbering for ICA. Note that the sector numbering is for the physical location of the sector anode. The particles actually detected by that sectors comes from the opposite direction. This can be understood by studying the particle path described in figure 1. Note that the coordinates are in the instrument coordinate system used in the calibration report. Instrument Y is spacecraft -Z and instrument Z is spacecraft Y. The spatial resolution transmitted to ground is dependent on available telemetry, as is the mass resolution. Therefore the data files from ICA contain a variable amount of mass channels, deflection angles and sectors. Which angles of arrivals (sector and elevation angle) and mass channels which have been added together must be known by the end user and this information must therefore be contained in the archive data. Data is further compressed using lossless compression, though the archived data will be uncompressed. One complete measurement cycle of all measured energies and 16 elevation angles always takes 192 s. for the standard 96 energy level mode. The location of ICA on Rosetta is shown schematically in figure 3. The spacecraft coordinate system is shown so that sector and elevation angles (through figure 2) can be related to the spacecraft coordinate system. [PICTURE ICA_EAICD008.PNG] Figure 3 Location of ICA on the spacecraft. Also shown are the sectors (10 - 15 and 0) which for some elevation angles (index 0-7) are shadowed by the spacecraft. The latitude and longitude scales are used in figure 4. The field-of-view of the ICA can also be shown using the latitude and longitude definitions shown in figure 3, which is done in figure 4. [PICTURE ICA_EAICD010.PNG] Figure 4 Rosetta seen from the ICA point-of-view. Latitude and longitude defined in figure 3. Note that this handwritten figure is not exact, it is intended as an indication where the spacecraft and solar panels are within the ICA field-of-view. The spot at 90 deg longitude, 0 deg latitude is the nominal position of the comet. Note that -90 and 270 degrees in figure 4 are the same. In nominal comet-pointing position the comet will be at 90 deg longitude, 0 deg latitude. The approximate angles which can be affected by the solar panels can be seen. The region between -10 deg and 180 deg is the free field-of-view of ICA. Longitudes below -10 deg and above 180 deg are totally blocked by the spacecraft for negative latitude. Figure 3 and 4 will be stored in the GEOMETRY directory of the archive. 2.1 Scientific Objectives ICA supports the RPC science goals by measurements of three-dimensional ion velocity distributions with mass resolution and derived quantities such as density, flow velocity and temperature for different ion species. Because Rosetta is not a spinning spacecraft ICA cannot achieve full angular coverage. This will limit the ability to derive 3D moments and probably make it unfeasible to automatically generate moments for the database. Cometary origin ions will often form beam distributions which when within the instrument field-of-view can be well characterized. Other common distributions will be torii and shell distributions in which case a fitting procedure can be used on a case basis, this is also true for hot enough populations when the measured part of velocity space represents a significant part of the total particle population. The most important aspect of ICA is the mass resolution which distinguishes it from the Ion Electron Spectrometer (IES) of the Rosetta Plasma Consortium (RPC). The cometary origin ions are to a large extent O+ and water group ions. These are significantly heavier than the major solar wind ions (H+ and He++). Thus the important pick-up of heavy cometary origin ions by the solar wind, and subsequent decelaration of the solar wind can be studied. As soon as the comet gets active enough to release significant amounts of ionized gas to the solar wind ICA will be able to detect increased counts of heavier ions. The gradual increase of the cometary activity, as well as fine structure related to structure in the outflow from the comet can be studied (i.e. surface jets). Boundaries between the solar wind and the cometary ionosphere can be studied, including transient plasma transfer phenomena 2.2 Data Handling Process Data is unpacked into raw data files at IRF in Kiruna. After that data, housekeeping and geometry data are transferred directly to PDS format ASCII tables for raw data and transferred to the RPC server at Imperial College. Data is transferred to the PSA from Imperial College. Higher level processing products will be produced in Kiruna. First calibration and geometry considerations are applied to achieve fluxes. Note that instrument background noise will have to be subtracted manually. Therefore the raw data PDS format with attached calibration tables will be the most useful format for users. Then background subtraction, which must be performed case-to-case, can be made by the users themselves, and calibration tables applied after that.. If high background levels are present the QUALITY_ID will be set to 0, otherwise to 1. The background subtraction must be performed by the ICA team in order to deliver calibrated data. This is delivered to the common RPC database. Browse graphics file of all - direction averaged spectra are produced for two mass-bins (high and low) and delivered to the RPC browse data server and to the PSA. A possible strategy to automatically remove the background has been tried for Mars Express IMA data and can be used by the end user on high resolution ICA data. One uses the fact that for significant counts of a real signal, one will always get signal from several contiguous mass channels. Usually the signal will also be seen in several adjacent energy channels. Therefore one can remove all occurrences of counts in a single mass and energy channel, where there are no counts in neighboring channels. This gives a much lower background around significant real peaks in the data. It does lower the sensitivity of the instrument. For weak signals one needs to first integrate for several full measurement periods,. In such a case the noise will also add up and may show up as larger groups of several adjacent mass and energy channels with non-zero counts. 2.3Product Generation and Data Validation The raw data products are generated upon unpacking of the telemetry data. Certain information not contained in the telemetry must be added, such as currently valid calibration files. This is straightforward and can be done as the data arrive, but further validation through manual inspection will take place before ingestion into the archive. Calibrated data requires more, possibly manual work, and will be delivered later than the raw data. All data is unpacked and processed at IRF and then delivered to the RPC server at Imperial College from where it is ingested to the ESA server. Data is delivered to the RPC server immediately upon unpacking. Further transmission to the ESA archive takes place once the data has been validated and the quality level has been checked so that the quality parameter can be determined. The initial data validation consists of manual inspection. Attempts to cross-compare different azimuthal sectors of the instrument can be made once a statistically significant data set exists and thus determine the relative sensitivity of different azimuth sectors. 2.4Overview of Data Products The ICA data products consists of the raw counts produced by the in-flight data (section 2.4.4, which are interpreted and turnied into calibrated data using tables containing the calibration results (section 2.4.3). Derived products (moments), section 2.4.7, are not expected to be delivered as these require manual inspection and choices which must be done on a case by case basis. There are no pre-flight data products nor any sub-system tests. 2.4.1 Instrument Calibrations Calibration tables from the calibration of the flight model will be stored. These include energy tables, deflection angle tables, mass channel to ion mass tables for different post-acceleration levels, and counts to flux conversion tables for a given post-acceleration and MCP bias. With time the MCP ages and the bias voltage applied must be increased. This will affect the count to flux calibration and new calibration tables will have to be made based on suitable estimates of the new efficiency of the MCP. Therefore the data labels will contain information about the currently valid calibration table. The calibration tables are given in PDS format with detached labels. These are for the energy resolution: ICAENTABLEVNN.TAB and ICAENTABLEVNN.LBL where NN is version number. which contains 96 rows with 2 columns. The columns are Index number of the energy level (i.e. just a counter which corresponds to the data points in the PDS data file),and energy per charge [eV] of detected ion. The beginning of table ICAEnTableV001.TAB is shown below. 0,39998.4 1,37007.3 2,34245.6 3,31683.3 4,29320.4 Note that high energies come first. This reflects the actual measurement sequence, the analyzer voltage is stepped from high to low. For the entrance deflection the table is ICA_EL_TABLE_VNN.TAB and ICA_EL_TABLE_VNN.LBL where NN is version number. Which contains 16 +1 columns and 96 rows, where 16 corresponds to the amount of elevation angles and 96 to the amount of energy levels. The energy index number is given in the first column. A sample close to nominal value obtained at intermediate energy index 42 is shown below: 42,-39.2,-33.6,-28.0,-22.7,-17.5,-12.3, -7.2, -1.4, 3.7, 8.8, 14.1, 19.4, 24.9, 30.6, 35.7, 40.9 At low (below 300 eV) and high (above 15 keV) energy the angular resolution and coverage deviates significantly from nominal values. At low energy this is because of insufficient resolution of the digital to analog conversion. Therefore no entrance deflection is used below 300 eV. The elevation angle is always close to 0. At high energies the discrepancy is due to insufficient high voltage to deviate the flight path of the more energetic ions. This table can be used by the end user to get accurate conversion of elevation index into actual physical angle from the spacecraft X-Z plane. Otherwise nominal values can be used (for approximate visualization purposes) with the angle given by: -42.1875+elev*90/16 where elev is the elevation index number (0-15) The angle within the X-Z plane, from X towards Z, is given by the sector (or azimuth angle index).as -168.75+azim*360/16 where azim is the azimuth index (0-15, same as sector number). The ICA has a command, enable bad-HV masking. This sets all deflection angle and energy combinations which deviates substantially from nominal values to zero. However, experiences from Mars Express shows clearly that it is better to set the elevation angle setting to zero for the low energy case and keep the data. Therefore a new table with deflection angle as close to zero as possible is now used for energies below 300 eV where the limited elevation angle accuracy problem may occur. However, the command for bad-HV masking exists and may be used again in the future. For high energies the deflection voltage is set to as high as possible and this data will not be masked either, but will not have the deflection angle nominally specified. Therefore the end-user must have access to this table Finally, mass look-up and mass calibration tables must be used. The mass look-up tables are used on-board to reduce the telemetry. As described in section 2 ICA has 32 mass channels. Ions of a certain mass will hit the detector surface (MCP) at some range of mass channels, and this range will vary with the energy. Therefore the mass look-up table must have one entry for each energy, telling what range of mass channels to put together. Furthermore the post-acceleration setting will also affect where the particles hit the detector surface. Therefore ICA has three mass look-up tables for three different post-acceleration settings (labeled 0, 1 and 2 in the calibration document). For high mass-resolution modes the actual mass-channel data will be transferred to ground, possibly binned (32, 16 or 8 bins). For lower resolution than that the data is instead binned into mass-groups according to the mass look-up tables. These tables are named ICALookUpNVNN.LBL and ICALookUpNVNN.TAB Where N is 1,2 or 3 depending on the post-acceleration setting. Note that the actual post-acceleration setting is from 0-2 according to the calibration document, but later mass look-up table 0 will be used to specify that no mass look-up table was used. The file contains 12+2 column elements and 96 rows. Each row contains post-acceleration level it is valid for, the energy index and 6 different ion mass ranges (2 values, start and stop), corresponding to H+, >O+, O+, He+, He++, O++ The column elements specifying mass range are given as start mass channel, end mass channel. A value of -1 indicates that the indicated ion mass range cannot be seen by the instrument for that particular energy and post-acceleration setting. A sample line for energy index 42 and no post-acceleration: 0,42,-1,-1, 0,14,15,20,27,31,-1,-1,21,26 Meaning that for no post-acceleration (0) and energy level 42, H+ cannot be measured (-1), >O+ ions are found between mass channels 0 to 14, O+ between 15 to 20, He+ between 27-31, He++ cannot be measured and O++ is found between mass channels 21 and 26. The reason for the strange order is that for severe telemetry restrictions not all mass bins are transmitted, and then Larger than O+ (a large group of everything above O+), O+ and H+ are the most important to transmit. The reason for the larger than O+ mass group (>O+) is that if only two mass ranges are allowed due to telemetry constraints, then H+ (solar wind) and heavy cometary ions can be distinguished. A table relating the post-acceleration setting to post-acceleration high voltage index (the actual high voltage reference value set in the instrument) and the actual high voltage as given by the calibration is also provided as POST_ACC_INTERVALS_VNN.LBL (.TAB). Further details can be found in ICATABLES.PDF by A. Fedorov which is also stored in the CALIB directory. The counts to flux tables has at the time of writing not been delivered from CESR and we cannot provide a format for them. The name will be COUNT_TO_FLUX_VNN.LBL (.TAB) for the label. They are stored in the CALIB directory. PDF graphics files defining the geometry of measurements are included in the GEOMETRY directory. One is the Sectors.pdf shown in figure 2. Another one is the ICA field-of-view (ICAlocation.jpg and ICA_FOV.JPG), also shown as figure 3 and 4 in this document. Other Files written during Calibration Data file on the ion source and experimental setup will be provided. (TBC) 2.4.2 In-Flight Data Products The ICA instrument gives essentially only one raw data (Level 2) output, counts. The instrument obtains counts for each energy level, sector, elevation angle and mass channel (as described in section 2). One full distribution is obtained in 192 s for all modes except the solar wind mode which takes 64 s. The instrument make measurements in the same way regardless of available telemetry rates. To reduce the data rate the data is reduced in resolution. Elevation angles, sectors and mass channels are added together into larger bins. Data is never binned over energy and time in this way. The raw data is thus in principle 4-dimensional, but must be stored as a two-dimensional table. The size of the sector, elevation angle and mass channel bins will vary continuously depending on available telemetry and loss-less compression ratio. It is thus not feasible to vary the tables after the current angular and mass resolution. Therefore start and stop values for each bin (sector, deflection angle and mass) must be included in the data. Start and stop values for elevation angle, sector and mass bins add 6 fields to the table. For the mass bins an on-board table-look up which is energy dependent may have been used onboard. Therefore one field is used to describe which table was used (and a keyword in the label gives which revision of the table), where table 0 indicate that no mass-lookup table was used. Because of high voltage limitations, spacecraft body and solar panel shadow, and potentially other reasons, some angles and mass channels may not contribute counts to certain energy steps. Therefore the number of sectors, mass channels and deflection angles actually contributing to the counts for each energy step must also be known. This is however normally static and it is very inefficient to store for each energy spectrum. Instead status information taken from the header of the science data packet is included. This header information contains information about whether bad-high voltage masking and shadow masking was enabled. Bad high-voltage masking was described in section 2.4.3, and means that certain elevation angle - energy combinations are masked to zero. This masking possibility will likely not be used for the data, and the corresponding status bit will be zero. Shadow masking implements the same for certain combinations of sector and elevation angle. Figure 3 shows which sectors and elevation angles will be shadowed by the spacecraft. These will not provide useful counts whether masking was on or not so it is important for the end-user to know about figure 3, but the value of the status bit is likely not important. However, its value should be kept because otherwise the archive data is not complete and does not allow future users full control of the data set. The science header also contains information about which onboard eeprom the software and tables was taken from. This is normally not important for the end user but the PDS data set will be used as the long time archive format by the ICA team and must therefore contain all the information from the science packets. House keeping parameters are stored in a separate file and with a separate label in the same directory as the data. When the calibration data is applied the raw counts can be translated into flux for different ion species or ion mass ranges (Level 3 data). When magnetic field and spacecraft attitude data is added the instrument coordinates can be transformed into magnetic field or geographic (likely comet-sun-orbit plane coordinates, must be common at least for RPC, sensibly for all of Rosetta). Housekeeping data will be unpacked and stored in human and PDS readable ASCII files. One day of full resolution data will be about 1 Gbyte. The file may be difficult to handle and will therefore be subdivided into 1 hour intervals. 2.4.3 Software The unpacking software is based on the software used for Mars Express data from Aspera 3-IMA. Currently two softwares exist for analysis of Mars Express IMA Aspera-3 IMA data, both from CESR Toulouse. These can with small modifications be used for ICA. In the long run we intend to use the raw data archive format described in this document, which will be very easy to import into any analysis software. Read and plot routines in the format we use ourselves will be made publicly available through the archive system (currently we use Matlab). A Matlab line to read an entire data file into the Matlab workspace is shown below: indata=fscanf(fid,['%4d %*c %2d %*c %2d %*c %2d %*c %2d %*c %f,%f,%f,%f,%f,%f,%f,%f,%f,%f,%f' ... ',%f,%f,%f,%f,%f,%f,%f,%f,%f,%f,%f,%f,%f,%f,%f,%f,%f,%f,%f,%f,%f,%f,%f,%f,%f,%f,%f,%f,%f,%f' ... ',%f,%f,%f,%f,%f,%f,%f,%f,%f,%f,%f,%f,%f,%f,%f,%f,%f,%f,%f,%f,%f,%f,%f,%f,%f,%f,%f,%f,%f,%f' ... ',%f,%f,%f,%f,%f,%f,%f,%f,%f,%f,%f,%f,%f,%f,%f,%f,%f,%f,%f,%f,%f,%f,%f,%f,%f,%f,%f,%f,%f,%f' ... ',%f,%f,%f,%f,%f,%f,%f'],[113,inf]); where fid is a file pointer variable pointing to an archive table file. The same formatting is essentially used in C. Sample Matlab files are provided in the SOFTWARE directory. 2.4.4 Documentation "The ICA-IMA TC/TM data formats and related software aspects" by Hans Borg "ICA Command Description" by Hans Borg "ICA calibration report" by Andrei Fedorov ICATables.pdf by A. Fedorov All stored in Portable Document Format (pdf) in the DOCUMENTS directory. 2.4.5 2.4.6 Derived and other Data Products The L3 (calibrated) data can be used to calculate higher order data (moments), but as the ICA field-of-view is not complete the feasibility of such calculations must be individually judged for each event, and this is thus not foreseen to be included in the PSA. Furthermore one must for each event judge if the moments should be fitted functions (Maxwellians) to take into account truncation due to the limited field-of-view or a numerical integration (which is used when the entire particle population is within the field-of-view of the instrument). 2.4.7 Ancillary Data Usage Space craft attitude and orbit data are necessary. In particular it is necessary to transform between the spacecraft coordinate system and some common system such as GSE and any mission specific comet centered coordinate system. The RPC fluxgate magnetometer (FGM) data is necessary to transform into magnetic coordinates. A common defintion must be made for all of RPC but pitch-angle (angle between magnetic field and viewing direction) must at least be calculated. The plane perpendicular to the magnetic field may be described by another angle with zero towards the sun or towards the comet. 3 Archive Format and Content 3.1 Format and Conventions 3.1.1 Deliveries and Archive Volume Format PDS compliant data will be delivered to ESA at DATA SET Level. One data set corresponds to one volume. Data of different processing levels will be archived in different data sets. The complete RPCICA data set will be delivered to the Imperial College server. From there all RPC data will be delivered to ESA by the RPC archive manager. 3.1.2 Data Set ID Formation RO-E/M/A/C-RPCICA-x-description-Vn.m E/M/A/C = Earth/Mars/Asteroid/Comet RO = INSTRUMENT_HOST_ID RPCICA = INSTRUMENT_ID x = {2,3} Codmac Data processing level numbers. description = {UNCALIBRATED, CALIBRATED} Vn.m = Version number Within each data set TARGET_NAME and TARGET_TYPE will then be used to identify the current target. (Thus they will not stay the same within one data set, but data set id will.) 3.1.3 Directory Naming Convention DATA_SET_ID | +----+---+-------+--- ... | | | DATA DOCUMENT CATALOG ... | CALIBRATED | +------+----- 2009 2010 The top level directory of the data set is named by DATA_SET_ID according to PDS specifications. This is found under a top level RPC directory structure as shown above at the Imperial College server. Under DATA a directory specifying the type of data (EDITED, CALIBRATED) is used, but this is in practice redundant as a new DATA_SET must be used for each type of data. The DATA is further subdivided as: 2009 | +------------+------------+------------... | | | JAN FEB MAR ... | +----+----+ ... | | | D01 D02 D03 3.1.4 File naming Convention ICA will produce two types of science data files for uncalibrated data and two types for calibrated data. These are data for 96 energy step modes and data for the 32 energy step mode.Furthermore an edited housekeeping data file and geometry data file will be produced. POSITION: 012345678901234567890123.012 FILENAME: RPCICAYYMMDDTHH_xxx_nnLL.EXT YY = Year MM = Month DD =Day T = Time separator HH=hour xxx = file running number to allow for several files in one time period nn = 32 or 96 depending on energy step mode. Not used for HK and GEOM files LL = L2 for raw counts, L3 for calibrated data, HK for housekeeping and GEOM for geometry EXT = LBL or TAB 3.2 Standards Used in Data Product Generation 3.2.1 PDS Standards ICA complies to PDS version 3, and we use version 3.6 of the PDS standard reference. 3.2.2 Time Standards All references to time in the ICA PDS archive will be to UTC. Then time is displayed using the PDS standard CCYY-MM-DDThh:mm:ss.sss we will convert space craft time into UTC in this format (not GMT as the original PDS definition). The conversion will be done from the epoch 2000. Housekeeping files will also contain the spacecraft clock time (i.e. unconverted and uncorrected ticks.) The spacecraft Clock (OBT) is given in the label files as "1/nnnnnnnnnn.nnnnn" It is the SPACECRAFT_CLOCK_START/STOP COUNT which is given as OBT. The OBT is described in Rosetta Time Handling, RO-EST-TN-3165, sect. 4.2. The general principle is as follows: SPACECRAFT_CLOCK_START/STOP_COUNT = "/." Where the unit seconds and the fractional seconds are separated by the full stop character ("."). Note that this is not a decimal point. The fractional seconds are expressed as multiples of 2^(-16) = 1.53E-5 seconds and count from 0 to 2^16 -1= 65535. E.g. in SPACECRAFT_CLOCK_START_COUNT = "1/21983325.392" the 392 fractional seconds correspond to 392 * 2^(-16) = 0.00598 decimal seconds. The spacecraft clock could be reset during the mission (although this is not planned). This would imply a change of the zero point. The zero point of the OBT will be indicated by pre-pending the reset number (integer starting at 1) and a slash to the unit seconds, i.e. "1/" means OBT = 0 at 2003-01-01T00:00:00 UTC. 3.2.3 Reference Systems Reference systems used in this document and the ICA PDS data: Reference system Description Instrument coordinates THE ICA instrument coordinate system. Retained for consistency with calibration report. Aligned with spacecraft Cartesian coordinate system, but different definition of the axes. Spacecraft coordinate system Orientation: x: pointing from the LANDER to the s/c center, perpendicular to solar array axes; y :parallel to solar array axis; pointing to the left, when standing in front of the Lander, z: pointing up 3.2.4 Other Applicable Standards N/A 3.3 Data Validation Data will be scanned for internal consistency when decommutating to edited raw format. Derived data will when possible be compared to independent measurements by other instruments. The solar wind is particularly useful as it is a narrow beam which, when at all within the field-of-view, is typically fully measured by ICA. When changes are made to one of the RPC ion spectrometers (ICA and IES), such as changing the MCP bias, this can be made when both instruments have the sun (solar wind) in the field-of-view. That way the relative change of the sensitivity can be estimated. Before archiving a data set from some mission phase, this set will have been used internally by RPC scientists. It is planned to base all scientific analysis on the data products formatted. To actually have the data used by scientists before delivery to archive is considered the best way of revealing problems, and this is the approach taken by RPC. In the label a QUALITY_ID keyword is used to indicate the quality of the data. QUALITY_ID -1 means invalid data even though it is not clear under what circumstances invalid data would be delivered to the PSA. QUALITY_ID 0 will be used when the background levels are an obvious problem. For such data the user must individually check the data and try to subtract background. QUALITY_ID 1 is expected to be the most common QUALITY_ID, in which case background levels are low. For Level 3 data background should in principle always be subtracted which gives a further QUALITY_ID of 2. If Calibration tables are applied to RAW data without subtraction of background (which likely must be manual) then all QUALITY_ID will be valid for the resulting level 3 data. 3.4 Content 3.4.1 Volume Set The one data set on one volume basic volume organization is used. Thus the volume directory structure looks like the following: ROOT |--- AAREADME.TXT |--- ERRATA.TXT |--- VOLDESC.TXT +--------------------------------------------------------------------------... | | | | | | | BROWSE CATALOG SOFTWARE CALIB GEOMETRY INDEX DATA 3.4.2 Data Set Our naming convention for the data set will follow the same principles as the DATA_SET_ID thus. DATA_SET_NAME="ROSETTA-ORBITER E/M/A/C RPCICA 2 DDDDDDD V1.0" ROSETTA-ORBITER = INSTRUMENT_HOST_NAME E/M/A/C = EARTH MARS ASTEROID COMET RPC-ION-MASS-ANALYZER = INSTRUMENT_NAME 2 = Data processing level numbers Data set will include Edited data or Calibrated data DDDDDDDDDDDDD = Processing level in text, i.e. EDITED or CALIBRATED One data set will be used for each processing level. Multiple targets will be used for each data set and within each data set TARGET_NAME and TARGET_TYPE will be used to identify the current target (Thus they will not stay the same within one data set, but data set id will). The data set name fits in the full length thus 60 characters. 3.4.3 Directories 3.4.4 3.4.4.1 Root Directory Table 1: Root Directory Contents File Name File Contents AAREADME.TXT This file completely describes the Volume organization and contents AAREADME.HTM Hypertext version of AAREADME.TXT AAREADME.LBL A PDS detached label that describes AAREADME ERRATA.TXT A cumulative listing of comments and updates concerning all ICA standard data products on all ICA Volumes in the Volume set published to data VOLDESC.CAT A description of the contents of this Volume in a PDS format readable by both humans and computers CALIB/ Calibration directory CATALOG/ Catalogue directory DOCUMENT/ Document directory INDEX/ Index directory DATA/ Data directory BROWSE/ Browse directory GEOMETRY/ Geometry directory LABEL/ Label directory SOFTWARE/ Software directory 3.4.4.2 Calibration Directory Table 1: Calibration Directory Contents File Name File Contents CATINFO.TXT A description of the contents of this directory ICA_EL_TABLE_V01.LBL, .TAB Calibration table describing the elevation angle corresponding to each elevation index, as a function of particle energy ICA_ENERGY_TABLE_V01.LBL, .TAB Calibration table describing the particle energy corresponding to each energy index level ICA_MASS_LOOK_UP_TABLEN_V01.LBL, .TAB Calibration tables describing the mass channels corresponding to 6 different ion mass intervals as a function of energy. N is 1,2 or 3 where table 1 is used in the case of no post-acceleration, table 2 when post-acceleration reference level is 1-4 and table3 when post-acceleration level is 5-7. 3.4.4.3 Catalog Directory Table 3: Catalog Directory Contents File Name File Contents CATINFO.TXT A description of the contents of this directory UNCALIBRATED_DS.CAT PDS Data Set catalog description of all the ICA un-calibrated level 2 data files CALIBRATED_DS.CAT PDS Data Set catalog description of all the ICA calibrated level 3 data files DERIVED_DS.CAT PDS Data Set catalog description of all the ICA derived level 5 data files, if this will exist INSTHOST.CAT PDS instrument host (spacecraft) catalog description of the Rosetta orbiter spacecraft INST.CAT PDS instrument catalog description of the ICA instrument MISSION.CAT PDS mission catalog description of the Rosetta mission PERSON.CAT PDS personnel catalog description of ICA Team members and other persons involved with generation of ICA Data Products REF.CAT ICA-related references mentioned in other *.CAT files SOFTWARE.CAT PDS software catalog description of ICA software 3.4.4.4 Index Directory Table 4:Index Directory Contents File Name File Contents INDXINFO.TXT Dataset Index File BROWSE_INDEX.LBL BROWSE_INDEX.TAB Browse index file INDEX.LBL INDEX.TAB Data index file No other index files will be used 3.4.4.5 Browse Directory and Browse Files Contains png files of all-direction raw spectrograms binned into two mass bins (low and high) for a fixed time interval of 1 hour. The data is organized in the same structure as the data, i.e. year, month and day are directories which contain png and corresponding label (.LBL) files. . Description in BROWSEINFO.TXT. Table 5: Browse Directory Contents File Name File Contents BROWSEINFO.TXT Information about the Browse data DATA Contains .LBL and :TAB files with the plot data as ASCII files YEAR Directories containing browse plots from each year. See directory structure below. The YEAR catalogue structure follows that of the archive format, i.e. in the BROWSE directory a structure with the following principal format can be found: BROWSE | |--BROWINFO.TXT |--BROWSE.HTM |--BROWSE.LBL | DATA | +------+----... | | 2005 2006 ... | +----+---... | | MAY OCT ... | +---... | D01 ... | PNG picture files 3.4.4.6 Geometry Directory Files of the instrument viewing geometry, taken from the calibration documentation, will be provided. Figures 2,3 and 4 of this document will be included as SECTORS.PDF shown in figure 2, ICALOCATION.JPG (figure 3) and ICA_FOV.JPG (figure 4). Table 6: Geometry Directory Contents File Name File Contents ICALOCATION.JPG A figure describing where ICA is located on Rosetta, as well as relating the ICA instrument and spacecraft coordinate systems to each other. SECTORS.PDF Figure describing the sector (azimuth) and elevation index numbering in the instrument coordinate system. ICA_FOV.JPG Rosetta seen from the ICA field-of-view in a local latitude-longitude coordinate system explained in figure ICALOCATION.JPG 3.4.4.7 Software Directory Sample matlab files to read ICA ASCII archive files are provided, as well as a commented sample on how to produce a spectrogram plot. The files are named readica.m and plot_NRM.m. Table 7: SOFTWARE Directory Contents File Name File Contents Readica.m File to read ICA data into the Matlab workspace. Plot_nrm.m Sample program to plot ICA data obtained in the NRM modes (on-board mass look-up tables). For high resolution data the program need to be modified, but the general way of working with the data will be the same. ICAinitilize.m Script to initialize the workspace by for example reading the ICA energy table into the workspace. Needed to run plot_NRM.m 3.4.4.8 Label Directory This directory is not used. 3.4.4.9 3.4.4.10 Document Directory Table 8: Document Directory Contents File Name File Contents DOCINFO.TXT A description of the contents of this directory and all subdirectories. ICA_EAICD/ Directory containing the ICA EAICD document ICA_EAICD/ICA_EAICD.HTM The ICA Experiment-Archive Interface Control Document as hypertext ICA_EAICD/ICA_EAICD.ASC The ICA Experiment-Archive Interface Control Document in ASCII text ICA_EAICD/ICA_EAICD.PDF The ICA Experiment-Archive Interface Control Document in PDF format ICA_EAICD/ICA_EAICD.DOC The ICA Experiment-Archive Interface Control Document in MSWordXP format ICA_EAICD/ICA_EAICD.LBL A PDS detached label that describes ICA_EAICD.HTM, ICA_EAICD.ASC, ICA_EAICD.PDF and ICA_EAICD.DOC ICA_INST/ Directory containing the ICA instrument paper ICA_INST/* Similar to ICA_EAICD/* ICA_CALIB/ Directory containing information regarding calibration ICA_CALIB/* Similar to ICA_EAICD/* ICMA_TCTM.PDF "The ICA-IMA TC/TM data formats and related software aspects" by Hans Borg ICA_CMD_BRIEF.PDF "ICA Command Description" by Hans Borg ICA_CAL.PDF "ICA calibration report" by Andrei Fedorov ICATABLES.PDF ICA Tables by A. Fedorov Other Documents Additional documents describing data processing, etc. Other Document labels Detached PDS labels for any additional documents 3.4.4.11 Data Directory Table 9: Data Directory Contents File Name File Contents CATINFO.TXT A description of the contents of this directory RPCICAYYMMDDTHH_000_96L2.LBL, .TAB Label and table files containing ICA data RPCICAYYMMDDTHH_000_GEOM.LBL, .TAB Label and table files with geometry data RPCICAYYMMDDTHH_000_HK.LBL, .TAB Label and table files with housekeeping data 4 Detailed Interface Specifications 4.1 Structure and Organization Overview See section 3.1.3 for general overview. Note that different processing levels are stored as different DATA_SETs. Now as defined in section 3.1.3 we have the following structure for each year in the DATA directory. +---------------+-------------------... DATA_SET_ID1 DATA_SET_ID2 | | DATA DATA | | EDITED CALIBRATED | +---------------------+-------------------+----------... | | | 2004 2005 2006 ... | +------------+-------------+------------... | | | MAR APR MAY ... | +--------------+--------------+---- ... | | | D01 D02 D03 ... 4.2 Data Sets, Definition and Content Two levels of data are used: Raw (edited) data and calibrated data. The raw edited data contains the raw counts from the detector, sorted into the PDS format and with UT calculated and a quality parameter set to indicate data quality. For the calibrated data a background subtraction has been performed and the calibration tables to turn counts ino physical flux units. The raw data archive also contains the housekeeping data from the TM stream in uncalibrated format. 4.3 4.4 4.5 Data Product Design ICA produce two kinds of data, ion mass energy spectrograms and housekeeping data (HK). The instrument can be run in different modes, resulting in different resolution, but the data format is the same. A complete set of edited data consists of housekeeping and science data. Calibration files in the CALIB directory will also be needed to interpret the data. A complete set of calibrated data consists of science data only. 4.5.1 Data Product "Uncalibrated data" Design The labels below follows the RPC and PDS conventions. ICA specific options are the mode ID which describes the ICA mode of operation. This is not necessary for the end user to know, as the resulting resolution of the data is anyway evident from the data. The instrument modes are described in the ICMA_TCTM.PDF document in the DOCUMENTS directory. They are: ID Name MSPO Minimum spectra only MSIS Minimum, selected ion species MEXM Minimum, energy mass matrix NRM Normal mode, intermediate resolution HAR High angular resolution EXM High mass resolution TEST Test mode CAL Calibration mode FAKE Test mode producing artificial data stream The data files consist of 106 columns. These columns are described in words below and later a sample label file is shown. The number of rows is variable. In the sample below figures from a real file is provided. Column 1.Start time of the observations in Universal Time 2.Bad HV mask, a status bit which describes if the bad HV mask was enabled (see section 2.4.4) 3.Shadow mask, a status bit which describes if the shadow mask was enabled (see section 2.4.4). If enabled all azimuth and elevation angle combinations shadowed by the spacecraft are set to zero. If not, the counts need not be exactly zero and may be used to estimate background levels, at the expense of using more telemetry. 4.PROM section, ICA can run from different PROM software banks. Usually not important for the end user. 5.Post-acceleration reference level (0-7). Necessary to know in order to interpret the mass channels correctly in terms of physical mass of measured particles. Which mass table to use for a certain post-acceleration reference value is given in the file "ICA_POST_ACC_TABLE_V01.LBL" in the CALIB directory. 6.Mass table used. ICA may use mass look-up tables on board to bin data into certain physical mass ranges (see section 2.4.3). This column describes which of three on-board tables was used. 0 indicates that no mass look-up table was used, 1 indicates the table for no post-acceleration, 2 low post acceleration and 3 high post-acceleration. 7.Azimuth index describing the start sector of the sectors binned together to produce the data (see sections 2, 2.4.3 and figures 2 and 3) 8.Azimuth index describing the last sector of the sectors binned together to produce the data. 9.Mass channel number describing the start mass channel of those binned together to produce the data. See sections 2 and 2.4.3. 10.Mass channel number describing the end mass channel of those binned together to produce the data. 11.Elevation index describing the start elevation angle index of the elevation angles binned together to produce the data (see sections 2, 2.4.3 and figures 2 and 3) 12.Elevation index describing the end elevation angle index of the elevation angles binned together to produce the data 13.- 107 contains 96 count-values for the 96 different energy steps in the energy spectrogram. The counts are the sum over all sectors, elevation angles and mass channels used to produce the data according to the previous columns. The energy levels are found in the file ICA_ENERGY_TABLE_V01.LBL in the CALIB directory. Example of edited raw data detached label file (e.g. RPCICAYYMMDDTHH_000_96L2.LBL) PDS_VERSION_ID = PDS3 LABEL_REVISION_NOTE = "V0.8" RECORD_TYPE = FIXED_LENGTH RECORD_BYTES = 632 FILE_RECORDS = 1176 FILE_NAME = "RPCICA050301T00_000_96L2.LBL" ^TABLE = "RPCICA050301T00_000_96L2.TAB" PRODUCT_ID = "RPCICA050301T00_000_96L2" DATA_SET_ID = "RO-E-RPCICA-2-EAR1-RAW-V1.0" DATA_SET_NAME = "ROSETTA-ORBITER EARTH RPCICA 2 EAR1 UNCALIBRATED V1.0" PROCESSING_LEVEL_ID = 2 PRODUCT_TYPE = "EDR" PRODUCT_CREATION_TIME = 2010-04-28T11:08:49 MISSION_ID = "ROSETTA" MISSION_NAME = "INTERNATIONAL ROSETTA MISSION" INSTRUMENT_HOST_ID = "RO" INSTRUMENT_HOST_NAME = "ROSETTA-ORBITER" INSTRUMENT_MODE_ID = "NRM" INSTRUMENT_MODE_DESC = "NORMAL MODE, INTERMEDIATE RESULOTION" TARGET_NAME = "EARTH" TARGET_TYPE = "PLANET" MISSION_PHASE_NAME = "EARTH SWING-BY 1" START_TIME = 2005-03-01T00:13:49.397 STOP_TIME = 2005-03-01T01:00:13.429 SPACECRAFT_CLOCK_START_COUNT = "1/68257386.1653" SPACECRAFT_CLOCK_STOP_COUNT = "1/68262378.1653" SC_SUN_POSITION_VECTOR = ( 1.410337E+08,-4.993928E+07, 73588.38 ) SC_TARGET_POSITION_VECTOR = ( 1358715, -322246.2, 73178.12 ) SC_TARGET_VELOCITY_VECTOR = ( -3.848141, 0.856229, -0.218708 ) SPACECRAFT_ALTITUDE = 1391944 SUB_SPACECRAFT_LATITUDE = 2.5 SUB_SPACECRAFT_LONGITUDE = 4.3 NOTE = " The values of the keywords SC_SUN_POSITION_VECTOR, SC_TARGET_POSITION_VECTOR and SC_TARGET_VELOCITY_VECTOR, are related to the ECLIPJ2000 reference frame. SUB_SPACECRAFT_LATITUDE and SUB_SPACECRAFT_LONGITUDE are northern Latitude and eastern Longitude in the standard planetocentric IAU_ frame. All values are computed for the time t= START_TIME. Distances are given in , velocities in and Angles in ." PRODUCER_ID = "RPC_ICA_KIRUNA_TEAM" PRODUCER_FULL_NAME = "NILSSON, HANS" PRODUCER_INSTITUTION_NAME = "SWEDISH INSTITUTE OF SPACE PHYSICS KIRUNA" INSTRUMENT_ID = "RPCICA" INSTRUMENT_NAME = "ROSETTA PLASMA CONSORTIUM - ION COMPOSITION ANALYSER" INSTRUMENT_TYPE = "PLASMA INSTRUMENT" DATA_QUALITY_ID = 1 DATA_QUALITY_DESC = " -1:INVALID. 0:SERIOUSLY AFFECTED BY HIGH BACKGROUND LEVELS. 1:NOMINAL. 2:BACKGROUND SUBTRACTED." NOTE = " LBL & TAB FILES HAVE BEEN GENERATED BY S/W: PDS VERSION 1.00D TIMECORR FILE USED. SPICE USED." ROSETTA:ICA_ENERGY_TABLE_NAME = "ICA_ENERGY_TABLE_V01.LBL" ROSETTA:ICA_ENERGY_TABLE_DESC = " THE TABLE DESCRIBES THE ENERGY LEVEL CORRESPONDING TO EACH OF THE 96 COLUMNS GIVING COUNTS PER ENERGY LEVEL. THE TABLE IS FOUND IN THE CALIB DIRECTORY." ROSETTA:ICA_MASS_TABLE1_NAME = "ICA_MASS_LOOK_UP_TABLE1_V01.LBL" ROSETTA:ICA_MASS_TABLE2_NAME = "ICA_MASS_LOOK_UP_TABLE2_V01.LBL" ROSETTA:ICA_MASS_TABLE3_NAME = "ICA_MASS_LOOK_UP_TABLE3_V01.LBL" ROSETTA:ICA_MASS_TABLE_DESC = " WHEN THE MASS CHANNEL RESOLUTION IN THE TELEMETRY IS REDUCED BELOW 8 THE MASS CHANNELS ARE BINNED TOGETHER IN CERTAIN MASS CHANNEL RANGES EXPECTED TO CORRESPOND TO CERTAIN ION MASS RANGES. THESE WILL VARY FOR DIFFERENT POST- ACCELERATION SETTINGS AND ENERGY AND THUS 3 DIFFERENT TABLES ARE PROVIDED FOR DIFFERENT POST-ACCELERATION SETTING. THE BINNING IS DESCRIBED IN THE TABLES DESCRIBED BY THE MASS_TABLE_NAME KEYWORDS. THE TABLES ARE FOUND IN THE CALIB DIRECTORY. WHICH TABLE WAS USED IS GIVEN BY A COLUMN IN THE DATA." ROSETTA:ICA_ELEVATION_TABLE_NAME = "ICA_EL_TABLE_V01.LBL" ROSETTA:ICA_ELEVATION_TABLE_DESC = " THE NOMINAL ANGLES FOR EACH ELEVATION INDEX ARE NOT REACHED FOR ALL ENERGIES. THE ELEVATION TABLE GIVES THE ACTUAL ELEVATION ANGLES FOR EACH ENERGY." OBJECT = TABLE NAME = "RPCICA-2-EAR1-RAW" INTERCHANGE_FORMAT = ASCII ROWS = 1176 COLUMNS = 13 ROW_BYTES = 632 DESCRIPTION = "DETECTOR COUNTS PER TIME, SECTOR (AZIMUTH ANGLE), ELEVATION ANGLE AND MASS BIN. THE SIZE OF THE AZIMUTH ANGLE, ELEVATION ANGLE AND MASS BINS ARE GIVEN AS THESE MAY VARY CONTINUOUSLY." OBJECT = COLUMN NAME = TIME_UTC DATA_TYPE = TIME START_BYTE = 1 BYTES = 26 UNIT = SECONDS DESCRIPTION = "TIME OF OBSERVATION YYYY-MM-DDTHH:MM:SS.ssssss" END_OBJECT = COLUMN OBJECT = COLUMN NAME = BAD_HV_MASK DATA_TYPE = ASCII_INTEGER START_BYTE = 28 BYTES = 1 VALID_MINIMUM = 0 VALID_MAXIMUM = 1 UNIT = "N/A" DESCRIPTION = "INDICATES WHETHER BAD-HV MASK WAS ON OR OFF. IF ON ENERGY- ELEVATION ANGLE COMBINATIONS WHICH COULD NOT REACH THE NOMINAL VALUE OF ELEVATION ANGLE ARE SET TO ZERO. FOR LOW ENERGIES LIMITED RESOLUTION OF THE ELEVATION DEFLECTION VOLTAGE IS LIMITING, FOR HIGH ENERGIES INSUFFICIENT HIGH VOLTAGE IS LIMITING." END_OBJECT = COLUMN OBJECT = COLUMN NAME = SHADOW_MASK DATA_TYPE = ASCII_INTEGER START_BYTE = 30 BYTES = 1 VALID_MINIMUM = 0 VALID_MAXIMUM = 1 UNIT = "N/A" DESCRIPTION = "INDICATES WHETHER SHADOW MASK WAS ON OR OFF. IF ON IONS COMING FROM ANGLES BLOCKED BY THE SPACECRAFT ARE SET TO ZERO. IF OFF THE CORRESPONDING SECTORS WILL LIKELY PRODUCE VERY FEW COUNTS ANYWAY, BUT MAY BE USEFUL FOR BACKGROUND SUBTRACTION." END_OBJECT = COLUMN OBJECT = COLUMN NAME = PROM_SECTION DATA_TYPE = ASCII_INTEGER START_BYTE = 32 BYTES = 1 VALID_MINIMUM = 0 VALID_MAXIMUM = 7 UNIT = "N/A" DESCRIPTION = "ICA CAN RUN USING SOFTWARE AND TABLES FROM DIFFERENT PROM SECTIONS. THE NUMBER OF THE PROM SECTION USED IS PROVIDED IN THE SCIENCE PACKET HEADER AND IS RETAINED HERE TO MAKE THE DATA COMPLETE." END_OBJECT = COLUMN OBJECT = COLUMN NAME = PACC_LEVEL_REFERENCE DATA_TYPE = ASCII_INTEGER START_BYTE = 34 BYTES = 1 VALID_MINIMUM = 0 VALID_MAXIMUM = 7 UNIT = "N/A" DESCRIPTION = "REFERENCE VALUE DESCRIBING THE POST-ACCELERATION LEVEL. THE LEVEL OF THE POST-ACCELERATION MUST BE KNOWN AS IT AFFECTS BOTH THE DETECTOR EFFICIENCY AND WHERE A CERTAIN MASS WILL HIT THE DETECTOR SURFACE. DETAILS ARE FOUND IN ICA_CAL.PDF IN THE DOCUMENTS DIRECTORY." END_OBJECT = COLUMN OBJECT = COLUMN NAME = MASS_TABLE DATA_TYPE = ASCII_INTEGER START_BYTE = 36 BYTES = 1 VALID_MINIMUM = 0 VALID_MAXIMUM = 3 DESCRIPTION = "ICA HAS THREE ON-BOARD MASS-LOOK UP TABLES, FOR DIFFERENT RANGES OF THE POST-ACCELERATION SETTING. THE TABLES ARE ENERGY DEPENDENT AND THE CURRENTLY USED TABLES ARE FOUND IN FILES DEFINED BY THE KEYWORD ROSETTA: ICA_MASS_TABLE_NAME. THE TABLES ARE FOUND IN THE CALIB DIRECTORY. TABLE 0 MEANS THAT NO ON-BOARD TABLE WAS USED AND THAT INDICATED MASS INDICES CORRESPOND TO PHYSICAL MASS CHANNELS ON THE MICRO CHANNEL PLATE. FOR TABLE 1, 2 AND 3 START AND STOP ARE THE SAME AND CORRESPONDS TO THE ION MASS GIVEN BY THE CORRESPONDING COLUMN OF THE MASS LOOKUP TABLE." END_OBJECT = COLUMN OBJECT = COLUMN NAME = AZIMUTHAL_INDEX_START DATA_TYPE = ASCII_INTEGER START_BYTE = 38 BYTES = 2 VALID_MINIMUM = 0 VALID_MAXIMUM = 15 UNIT = "N/A" DESCRIPTION = "START SECTOR (CORRESPONDS TO AZIMUTHAL ANGLE). THE DATA IN THIS ROW IS A SUM OF THE COUNTS FROM THE START TO THE STOP SECTORS (INCLUSIVE) GIVES INFORMATION ABOUT ANGLE OF INCIDENCE OF DETECTED PARTICLES. EACH SECTOR CORRESPONDS TO 22.5 DEGREES AND THE PHYSICAL LOCATION ON SPACECRAFT IS GIVEN BY SECTORS.PDF AND ICALOCATION.JPG IN THE GEOMETRY DIRECTORY." END_OBJECT = COLUMN OBJECT = COLUMN NAME = AZIMUTHAL_INDEX_STOP DATA_TYPE = ASCII_INTEGER START_BYTE = 41 BYTES = 2 VALID_MINIMUM = 0 VALID_MAXIMUM = 15 UNIT = "N/A" DESCRIPTION = "STOP SECTOR (CORRESPONDS TO AZIMUTHAL ANGLE). THE DATA IN THIS ROW IS A SUM OF THE COUNTS FROM THE START TO THE STOP SECTORS (INCLUSIVE) GIVES INFORMATION ABOUT ANGLE OF INCIDENCE OF DETECTED PARTICLES. EACH SECTOR CORRESPONDS TO 22.5 DEGREES AND THE PHYSICAL LOCATION ON SPACECRAFT IS GIVEN BY SECTORS.PDF AND ICALOCATION.JPG IN THE GEOMETRY DIRECTORY." END_OBJECT = COLUMN OBJECT = COLUMN NAME = MASS_CHANNEL_START DATA_TYPE = ASCII_INTEGER START_BYTE = 44 BYTES = 2 VALID_MINIMUM = 0 VALID_MAXIMUM = 31 UNIT = "N/A" DESCRIPTION = "START MASS CHANNEL. THIS CORRESPONDS TO MASS CHANNELS ON THE MICRO CHANNEL PLATE IF MASS_TABLE IS 0. FOR MASS_TABLE = 1,2,3 THE START AND STOP MASS CHANNELS ARE THE SAME AND CORRESPONDS TO THE ION MASS RANGE DEFINED IN THE MASS LOOK UP TABLE. NOTE THAT THIS IS ENERGY DEPENDENT. THE MASS RANGE CORRESPONDS TO A RANGE OF MASS CHANNELS OF THE DETECTOR AND THE ACTUAL MASS MUST BE FOUND FROM CALIBRATION TABLES. THE ORIGINAL CALIBRATION RESULTS ARE FOUND IN ICA_CAL.PDF IN THE DOCUMENTS DIRECTORY. CURRENTLY VALID LOOKUP MASS TABLES ARE GIVEN BY KEYWORDS ROSETTA:ICA_MASS_LOOKUP_TABLEN_NAME WHERE THE N AFTER TABLE IS 1, 2 OR 3." END_OBJECT = COLUMN OBJECT = COLUMN NAME = MASS_CHANNEL_STOP DATA_TYPE = ASCII_INTEGER START_BYTE = 47 BYTES = 2 VALID_MINIMUM = 0 VALID_MAXIMUM = 31 UNIT = "N/A" DESCRIPTION = "STOP MASS CHANNEL. THIS CORRESPONDS TO MASS CHANNELS ON THE MICRO CHANNEL PLATE IF MASS_TABLE IS 0. FOR MASS_TABLE = 1,2,3 THE START AND STOP MASS CHANNELS ARE THE SAME AND CORRESPONDS TO THE ION MASS RANGE DEFINED IN THE MASS LOOK UP TABLE. NOTE THAT THIS IS ENERGY DEPENDENT. THE MASS RANGE CORRESPONDS TO A RANGE OF MASS CHANNELS OF THE DETECTOR AND THE ACTUAL MASS MUST BE FOUND FROM CALIBRATION TABLES. THE ORIGINAL CALIBRATION RESULTS ARE FOUND IN ICA_CAL.PDF IN THE DOCUMENTS DIRECTORY. CURRENTLY VALID LOOKUP MASS TABLES ARE GIVEN BY KEYWORDS ROSETTA:ICA_MASS_LOOKUP_TABLEN_NAME WHERE THE N AFTER TABLE IS 1, 2 OR 3." END_OBJECT = COLUMN OBJECT = COLUMN NAME = ELEVATION_INDEX_START DATA_TYPE = ASCII_INTEGER START_BYTE = 50 BYTES = 2 VALID_MINIMUM = 0 VALID_MAXIMUM = 15 UNIT = "N/A" DESCRIPTION = "START ELEVATION ANGLE INDEX. THE DATA IN THIS ROW IS A SUM OF THE COUNTS FROM START ELEVATION ANGLE INDEX TO STOP ELEVATION ANGLE INDEX (INCLUSIVE) GIVES INFORMATION ABOUT ANGLE OF INCIDENCE OF DETECTED PARTICLES. THE DEFINITION OF THE ELEVATION ANGLE INDEX IS GIVEN IN FIGURE SECTORS.PDF IN THE GEOMETRY DIRECTORY. THE ANGULAR RESOLUTION IS GIVEN IN ICA_CAL.PDF IN THE DOCUMENTS DIRECTORY." END_OBJECT = COLUMN OBJECT = COLUMN NAME = ELEVATION_INDEX_STOP DATA_TYPE = ASCII_INTEGER START_BYTE = 53 BYTES = 2 UNIT = "N/A" VALID_MINIMUM = 0 VALID_MAXIMUM = 15 DESCRIPTION = "STOP ELEVATION ANGLE INDEX. THE DATA IN THIS ROW IS A SUM OF THE COUNTS FROM START ELEVATION ANGLE INDEX TO STOP ELEVATION ANGLE INDEX (INCLUSIVE) GIVES INFORMATION ABOUT ANGLE OF INCIDENCE OF DETECTED PARTICLES. THE DEFINITION OF THE ELEVATION ANGLE INDEX IS GIVEN IN FIGURE SECTORS.PDF IN THE GEOMETRY DIRECTORY. THE ANGULAR RESOLUTION IS GIVEN IN ICA_CAL.PDF IN THE DOCUMENTS DIRECTORY." END_OBJECT = COLUMN OBJECT = COLUMN NAME = NO_OF_COUNTS DATA_TYPE = ASCII_INTEGER START_BYTE = 56 BYTES = 575 ITEMS = 96 ITEM_BYTES = 5 ITEM_OFFSET = 6 UNIT = "N/A" DESCRIPTION = "NO OF COUNTS OBTAINED FOR EACH ENERGY LEVEL, AND SPECIFIED SECTORS, DEFLECTION ANGLES AND MASS CHANNELS AS INDICATED. THE ENERGY STEPS ARE GIVEN IN SEPARATE FILE DEFINED BY KEYWORD ROSETTA:ICA_ENERGY_TABLE_NAME." END_OBJECT = COLUMN END_OBJECT = TABLE END 4.5.1.1 File Characteristics Data Elements The *.LBL file will be identified by the FILE_NAME. 4.5.1.2 Data Object Pointers Identification Data Elements The only pointer used is from the *.LBL file to the *.TAB file. Keywords are also used to identify the correct calibration table from the CALIB directory to use for the data. 4.5.1.3 Instrument and Detector Descriptive Data Elements INSTRUMENT_MODE_ID describes the instrument mode. The instrument mode determines the data resolution but this is evident from the data and not strictly necessary for the end user to know. The instrument modes are: The instrument modes are described in the ICMA_TCTM.PDF document in the DOCUMENTS directory. They are: ID Name MSPO Minimum spectra only MSIS Minimum, selected ion species MEXM Minimum, energy mass matrix NRM Normal mode, intermediate resolution HAR High angular resolution EXM High mass resolution ROSETTA:ICA_ENERGY_TABLE_NAME Describes the energy table currently in use. ROSETTA:ICA_MASS_TABLE1_NAME ,ROSETTA:ICA_MASS_TABLE2_NAME, ROSETTA:ICA_MASS_TABLE3_NAME gives the names of the currently used mass lookup tables. These tables relates which ion mass corresponds to which range of detector mass channels for a given energy and post acceleration setting. The three different tables are used for three different ranges of post-acceleration settings, corresponding to post-acceleration reference levels as: Number of table Post acceleration reference value 1 0 2 1-4 3 5-7 ROSETTA:ICA_ELEVATION_TABLE_NAME gives the elevation table currently in use. This provides more precise elevation angles for particles of different energies than the nominal angles described in section 2 and shown in figure 2. 4.5.1.4 Structure Definition of Instrument Parameter Objects N/A 4.5.1.5 Data Object Definition All data stored in *.TAB files. Their structure is defined by OBJECT Table definition within *.LBL file. Each data definition block has a DESCRIPTION which explains the meaning of the assigned data columns. 4.5.1.6 Description of Instrument The basics of the instrument is described in section 2 of this document. 4.5.1.7 Parameters Index File Definition N/A 4.5.1.8 Mission Specific Keywords None. 4.5.2 Data Product "Calibrated data" Design Will contain background subtracted data in physical units (particle flux). Possibly the azimuth and elevation indices will be replaced by real angles (degrees/radians) or some other vectors in the spacecraft coordinate system. Another possibility is to retain the index system, as the tables for their interpretation are easily available in the CALIB directory. Then the format will be identical to RAW except that we may remove auxiliary information such as prom-section used, and the data values are changed from counts to flux. 4.5.3 5 6 Appendix: Available Software to read PDS files A sample matlab script is provided, named readica.m. The file reading follows C syntax so it can easily be ported to C, and contains the information needed to quickly write a Fortran read routine. 7 8 Appendix: Example of Directory Listing of Data Set X |-- AAREADME.TXT |-- BROWSE | |-- 2006 | | `-- FEB | | |-- D24 | | | |-- RPCICA060224.LBL | | | |-- RPCICA060224.PNG | | | |-- RPCICA060224T05.LBL | | | |-- RPCICA060224T05.PNG | | | |-- RPCICA060224T06.LBL | | | |-- RPCICA060224T06.PNG : : : : : : : : : | |-- BROWINFO.TXT | |-- BROWSE.HTM | `-- BROWSE.LBL | |-- CALIB | |-- CALINFO.TXT | |-- ICA_EL_TABLE_V01.LBL | |-- ICA_EL_TABLE_V01.TAB | |-- ICA_EL_TABLE_V02.LBL | |-- ICA_EL_TABLE_V02.TAB | |-- ICA_ENERGY_TABLE_V01.LBL | |-- ICA_ENERGY_TABLE_V01.TAB | |-- ICA_MASS_LOOK_UP_TABLE1_V01.LBL | |-- ICA_MASS_LOOK_UP_TABLE1_V01.TAB | |-- ICA_MASS_LOOK_UP_TABLE2_V01.LBL | |-- ICA_MASS_LOOK_UP_TABLE2_V01.TAB | |-- ICA_MASS_LOOK_UP_TABLE3_V01.LBL | `-- ICA_MASS_LOOK_UP_TABLE3_V01.TAB | |-- CATALOG | |-- CATINFO.TXT | |-- DATASET.CAT | |-- INST.CAT | |-- INSTHOST.CAT | |-- MISSION.CAT | |-- PERSON.CAT | |-- REF.CAT | `-- SOFTWARE.CAT | |-- DATA | `-- EDITED | `-- 2006 | `-- FEB | |-- D24 | | |-- RPCICA060224T05_000_96L2.LBL | | |-- RPCICA060224T05_000_96L2.TAB | | |-- RPCICA060224T05_000_GEOM.LBL | | |-- RPCICA060224T05_000_GEOM.TAB | | |-- RPCICA060224T05_000_HK.LBL | | |-- RPCICA060224T05_000_HK.TAB : : : : : : |-- DOCUMENT | |-- DOCINFO.TXT | |-- ICATABLES.LBL | |-- ICATABLES.PDF | |-- ICA_CAL.LBL | |-- ICA_CAL.PDF | |-- ICA_CMD_BRIEF.LBL | |-- ICA_CMD_BRIEF.PDF | |-- ICA_EAICD | | |-- ICA_EAICD.ASC | | |-- ICA_EAICD.DOC | | |-- ICA_EAICD.HTM | | |-- ICA_EAICD.LBL | | |-- ICA_EAICD.PDF | | |-- ICA_EAICD004.PNG | | |-- ICA_EAICD006.PNG | | |-- ICA_EAICD008.PNG | | |-- ICA_EAICD010.PNG | | |-- ICA_EAICD013.PNG | | `-- ICA_EAICDPNG.LBL | |-- ICMA_TCTM.LBL | `-- ICMA_TCTM.PDF | |-- GEOMETRY | |-- GEOMINFO.TXT | |-- ICALOCATION.JPG | |-- ICALOCATION.LBL | |-- ICA_FOV.JPG | |-- ICA_FOV.LBL | |-- SECTORS.LBL | `-- SECTORS.PDF | |-- INDEX | |-- BROWSE_INDEX.LBL | |-- BROWSE_INDEX.TAB | |-- INDEX.LBL | |-- INDEX.TAB | `-- INDXINFO.TXT | |-- SOFTWARE | |-- ICAINITIALIZE.LBL | |-- ICAINITIALIZE.M | |-- ICALOOKUP0V1.DAT | |-- ICALOOKUP0V1.LBL | |-- ICALOOKUP1V1.DAT | |-- ICALOOKUP1V1.LBL | |-- ICALOOKUP2V1.DAT | |-- ICALOOKUP2V1.LBL | |-- ICAV1.DAT | |-- ICAV1.LBL | |-- PLOT_NRM.LBL | |-- PLOT_NRM.M | |-- READICA2.LBL | |-- READICA2.M | `-- SOFTINFO.TXT | `-- VOLDESC.CAT