PDS_VERSION_ID = PDS3 RECORD_TYPE = STREAM LABEL_REVISION_NOTE = " 2017-05-06 ISAS:Murakami: Initial version; 2017-06-08 ISAS:Murakami, CU Boulder:McGouldrick: Revised; 2017-07-01 ISAS:Murakami: Revised; 2017-10-12 ISAS:Murakami: Revised; 2018-04-20 ISAS:Murakami: Revised; 2018-08-15 ISAS:Murakami: Revised; 2018-11-06 ISAS:Murakami: Revised; 2019-04-26 ISAS:Murakami: Revised; " OBJECT = DATA_SET DATA_SET_ID = "VCO-V-IR1-3-SEDR-V1.0" OBJECT = DATA_SET_INFORMATION DATA_SET_NAME = "VENUS CLIMATE ORBITER IR1 GEOMETRY INFORMATION V1.0" DATA_SET_COLLECTION_MEMBER_FLG = "N" DATA_SET_TERSE_DESC = "Venus Climate Orbiter IR1 geometry information" ABSTRACT_DESC = " The VCO IR1 SEDR data set contains products of geometry information calculated by SPICE toolkit using SPICE kernels VCO-V-SPICE-6-V1.0, associated with images acquired by the IR1 instrument onboard the Venus Climate Orbiter (VCO, also known as PLANET-C and AKATSUKI) spacecraft. The data files are provided in FITS format with several HDUs as IMAGE extension, and it also contains metadata to the header of the HDUs. " CITATION_DESC = " Murakami, S., M. Yamada, K. McGouldrick, Y. Yamamoto, G. L. Hashimoto, VENUS CLIMATE ORBITER IR1 GEOMETRY INFORMATION V1.0, VCO-V-IR1-3-SEDR-V1.0, NASA Planetary Data System, 2018. " START_TIME = 2010-05-21T11:49:04 STOP_TIME = 2016-12-09T10:52:38 DATA_SET_RELEASE_DATE = 2019-06-01 PRODUCER_FULL_NAME = "SHIN-YA MURAKAMI" DATA_OBJECT_TYPE = "FITS" DETAILED_CATALOG_FLAG = "Y" ARCHIVE_STATUS = "LOCALLY ARCHIVED" DATA_SET_DESC = " Data Set Overview ================= This data set contains products of geometry information for purpose of reference, calculated by SPICE toolkit using SPICE kernels provided as VCO-V-SPICE-6-V1.0 data set, associated with images acquired by the IR1 instrument of the Venus Climate Orbiter (VCO, also known as PLANET-C and AKATSUKI) spacecraft. This data set uses the Committee on Data Management and Computation (CODMAC) data level numbering system. The IR1 SEDRs are considered Level 3 or Supplementary Experiment Data (equivalent to NASA Level 2). The SEDRs are reconstructed from Level 2 or Raw Data and SPICE kernels (VCO-V-SPICE-6-V1.0). This data set consists entirely of FITS files. Various geometry information are included to each HDU of the FITS files. The headers of the HDUs of the FITS files are included as part of the data set, and much of the FITS header information is reproduced in the PDS labels. Processing ========== Overview -------- The data processings are done on DANS (Data Analysis Network System) managed by C-SODA (Center for Science-satellite Operation and Data Archive), ISAS/JAXA at Sagamihara, Kanagawa, Japan. Note that DANS consists of SIRIUS (Scientific Information Retrieval and Integrated Utilization System), EDISON (Engineering Database for ISAS Spacecraft Operation Needs), ``Reformatter'', DARTS (Data ARchives and Transmission System) and data analysis servers. The summary of the data processing is as follows. The data downlinked as telemetry are transferred to the data accumulation system at ISAS, and are registered to SIRIUS and are sorted in time. From SIRIUS, level 0 data are retrieved to the Reformatter for the PLANET-C Project Team that is provided by C-SODA to each mission. All processings (data pipeline) after level 0 until level 3 are done on the Reformatter. These procedures are executed automatically. To implement these procedures, various program codes are used, written in C, C++, Fortran 90/95, Ruby, Python, Perl, and POSIX shell. Definitions of the processing levels ------------------------------------ The definitions of the processing levels for UVI, IR1, IR2, and LIR instruments are same for simplicity and homogeneity. The processing levels are defined as follows: abbr name description ---- -------- --------------------------------------------------- L0 Level 0 raw data files from telemetry. L1a Level 1a counts in FITS format. L1b Level 1b flipped and rotated L1a with summary of geometry information in FITS format. L2b Level 2b calibrated physical quantity in FITS format. L2c Level 2c (more) calibrated physical quantity in FITS format. L3b Level 3b L2b mapped onto longitude-latitude grids in NetCDF format that is preprocessed using the limb-fitting technique for correction of pointing of the camera. L3c Level 3c L2c mapped onto longitude-latitude grids in NetCDF format that is preprocessed using the limb-fitting technique for correction of pointing of the camera. Detailed description of the processings --------------------------------------- This section describes detailed procedure at each processing level. The summarized diagram of the pipeline is shown below: (1) (2) (3) (4) (5) SIRIUS -----> L0 -----> L1a -----> L1b -----> L2b -----> L3b \ \(4) (5) `-> L2c -----> L3c (1) L0 data processing L0 data are consists of three kinds of file, tile of image, common ancillary data for the image and instrument-specific ancillary data for the image. The image size of each tile file is 128 x 128 pixels. These L0 data are retrieved from the SIRIUS. The tile files of image are usually compressed by HIREW algorithm, so the tile files are decompressed at the first step. The decompressed tile files are converted from unsigned 16-bit integer into signed 16-bit integer, and then concatenating decompressed tile files, the raw image file is created. If one or more tile files are missing, missing value is substituted to the corresponding pixels at this processing level. For LIR images, only valid region of data is cropped after concatenation of tile files. If the compressed tile file is identified as corrupted, e.g., the data size of the tile file is not equal to the data size recorded in the header of the tile file, only pixels supposed to be valid are decoded and invalid pixels are filled with missing value. (2) L1a data processing From the raw image and ancillary data files in L0, L1a FITS file is created. If there are wrong ancillary data, the corrected data are stored in the header of the HDU of L1a FITS file using other source. This is currently applied only to UVI images. Some types of the ancillary data to be stored in the header of the HDU of L1a FITS file, e.g., value of P_OBSPRG that represents observation program ID used to acquire image, are automatically determined by command history files or data files created from HK (House Keeping) telemetry packets. Note that the command history files stores the commands sent from the ground to the spacecraft, and it can be retrieved from EDISON. The data files created from HK telemetry packets also can be retrieved from EDISON. For IR1 and IR2 images, command sequences (i.e., observation program) to acquire image are changed from the planned one at the instrument design phase to reduce the total time for taking images as short as possible. This change caused the issue that cannot uniquely determine both of selected filter and exposure time for each image only from the telemetry data. This issue is solved by a script using the executed observation programs extracted from command history files and the relationship between executed observation program used for taking each image and known behavior of the instrument-specific ancillary data that depends on the executed observation program. (3) L1b data processing From L1a FITS file, L1b FITS file and associated geometry information FITS file are created using SPICE kernels and the SPICE toolkit. The orientation of image data become nominal (spacecraft +Y axis is upward with the coordinate described in 'document/imagecoord.txt') at this processing by the procedure combining vertical flipping of the image and some of the 90-degree rotations. This procedure differs depending on the instruments/channels. What kind of operation has been done is recorded as value of the P_FLPROT keyword in the header of the HDU in FITS file. This operations are nominally done as follows: cam channels operations P_FLPROT --- -------- -------------------- -------- UVI all rotate CCW 270 deg 3 IR1 all flip vertically 10 IR2 1.65 um no rotation/flipping 0 IR2 others rotate 180 deg 2 LIR all flip vertically 10 For the purpose of quick look, JPEG image is created for each FITS image file. (4) L2b and L2c data processing From L1b FITS file, L2b and L2c FITS file are created using FITS files for calibration, depending on the instrument and the channels. L2c is ``more calibrated'' version than L2b. This processing level is available for IR1 and LIR at now. For IR1, handling of pixels with special flag values during smear correction are different between L2b and L2c. For L2b product, if the pixels with special flag values appear in the column in a quadrant, all the values of the pixels at the column in the quadrant are set to missing value. IR1 L2b product is processed with the aim of photometric analysis. For L2c product, if the pixels with special flag values appear in the column in a quadrant, contribution from the pixels to the total amount of smear is estimated using available value near the pixel in the same column. IR1 L2c product is processed with the aim of cloud tracking. For LIR, in addition to L2b data calibration process, L2c data processing applies calibration using baffle (hood) temperature. This requires baffle (hood) temperature acquired from HK, so the product is not available when HK lacks. For the purpose of quick look, JPEG image is created for each FITS image file also at this processing level. (5) L3b and L3c data processing From L2b or L2c FITS file, L3b or L3c NetCDF file, and L3bx or L3cx NetCDF file are created using SPICE kernels and SPICE toolkits. The fully-automated algorithms of limb-detection, limb-fitting and interpolation onto equally spaced longitude-latitude grids has been implemented for the processing. For verification of the result of limb-detection and limb-fitting, L3bx or L3cx NetCDF file is also created. This file also contains correction of pointing of the camera. Using the correction of pointing of camera, L3bx or L3cx FITS file is created. L3bx and L3cx FITS files have a similar structure to geometry information file (``geo'' file), so one can use L3bx or L3cx FITS file as pointing- corrected geometry information file instead of geometry information file created at the L1b data processing. Assumption on the altitude for observed quantity ------------------------------------------------ For geometry calculations, what altitude that the observed quantity is coming from and includes information on is roughly assumed as follows: cam channels assumed altitude --- ------------- ---------------- UVI 283 nm 70 km 365 nm 70 km IR1 0.90 um day 60 km 0.90 um night 60 km 0.97 um 60 km 1.01 um 60 km IR2 1.735 um 50 km 2.26 um 50 km 2.32 um 50 km 2.02 um 70 km 1.65 um N/A LIR pic 65 km The assumed altitude is recorded in the FITS header keyword, S_CLDALT. Parameters ========== The primary data are the SPICE kernels, provided as the VCO-V-SPICE-6-V1.0 data set, especially for the information on the position of the spacecraft and the attitude of the spacecraft, and observation time for each image provided as VCO-V-IR1-2-EDR-V1.0 and VCO-V-IR1-3-CDR-V1.0 data sets. From the primary data, longitude, latitude, local (solar) time, phase angle, emission angle, incidence angle and azimuthal angle for each pixel are derived, and stored in each HDU with IMAGE extension in FITS file. These values are calculated using the pinhole camera model. Contents and definition ----------------------- The Content of data includes latitude, longitude, local (solar) time, phase angle, incidence angle, emission angle, and azimuthal angle. These values are defined as follows: - ``Latitude'' is defined in IAU Venus, planetocentric coordinate system. The range of latitude is [-90, 90] in degrees. - ``Longitude'' is defined in IAU Venus, planetocentric coordinate system. The range of longitude is [0, 360) in degrees. - ``Local (solar) time'' is calculated by (sub-solar longitude - longitude)/15 + 12 where the range of local (solar) time is [0, 24) in hours. - ``Phase angle'' is defined by angle between a scatterer-Sun vector and a scatterer-observer vector. This is calculated by illum_c function in SPICE toolkit. The range of phase angle is [0, 180] and is stored as in degrees. - ``Incidence angle'' is defined by angle between a surface normal vector and a scatterer-Sun vector. This is calculated by illum_c function in SPICE toolkit. The range of incidence angle is [0, 180] and is stored as in degrees. - ``Emission angle'' is defined by angle between a surface normal vector and a scatterer-observer vector. This is calculated by illum_c function in SPICE toolkit. The range of emission angle is [0, 180] and is stored as in degrees. - ``Azimuthal angle'' is defined by angle between a vector from Sun to scatterer at the scatterer projected onto the surface and a vector from scatterer to observer projected onto surface. The range of azimuthal angle is [0, 180] and is stored as in degrees. The formula to calculate azimuthal angle is: az = arccos( ( -cos(ph)+cos(in)*cos(em) ) / ( sin(in)*sin(em) ) ) where ``ph'', ``in'', ``em'', and ``az'' are phase angle, incidence angle, emission angle, and azimuthal angle, in radians, respectively. The following ASCII diagram is for the definition of these angles, Sun ^ surface normal vector .__ | '|\ | | \ | | \ | __. observer | \ | /|` | \ in | / | | \ __ | em / | | \/ `|-. / | __ | ____ \ | `/ __ | _____________ / | \.-. / | / / | \ |`/ ph | / / | \|/ | / / +-----------*.----,--|-------------> / `..' az| / / `. | / / `. | / / `+ / / / surface --------------------------------------- where ``ph'', ``in'', ``em'', and ``az'' are phase angle, incidence angle, emission angle, and azimuthal angle, respectively. This diagram is drawn in isometric view. The rectangular region shows the surface of the sphere of the target body where the scatterer exists, and the scatterer is located at the center of the rectangular region denoted by ``*''. A scatterer-Sun vector, a scatterer-observer vector, and the surface normal vector are shown. The vector emanating from the scatterer from left to right on the surface is opposite vector of the projection of the scatterer-Sun vector onto the surface. This vector can be interpreted as a vector that is a projected vector of the Sun-scatterer vector onto the surface with origin at the scatterer. Data ==== Overview -------- The geometry information FITS file stores the geometry data at the center of the pixel. For the definition of the image coordinate please refer the ``document/imagecoord.txt'' file. The geometry information FITS file has the string ``_geo_'' in the filename. File format and structure ------------------------- The files with the extension ``.fit'' under ``data'' directory are FITS format file. These FITS files are considered to be compliant with the FITS Standard Version 4.0 published online on 22 July 2016 by the IAUFWG except for handling of keywords that stores numeric value. If value of the keyword is supposed to be ``Not Available'', the value is set to 'N/A' in string literal in spite of definition of the keyword that stores numeric value. This is a work around for non-existence of numeric literals that represent special values in FITS Standard Version 4.0. For each geometry information file, each data is stored in the data part of the several HDUs (Header Data Unit) as IMAGE extension. The list of HDU in the geometry files is as follows: HDU 0: Primary HDU (header only) HDU 1: Latitude HDU 2: Longitude HDU 3: Local (Solar) Time HDU 4: Phase Angle HDU 5: Incidence Angle HDU 6: Emission Angle HDU 7: Azimuthal Angle File naming conventions ----------------------- The file naming conventions for the data files are same over the four cameras, UVI, IR1, IR2, and LIR. In addition to the four cameras, the data of LAC and RS have very similar file naming conventions. In this section, the file naming conventions for the four cameras are described. The filename has the format {cam}_{YYYY}{MM}{DD}_{hh}{mm}{ss}_{filter}_{level}_v{ver}.{ext} where {cam}: abbreviated name of cameras, i.e., uvi, ir1, ir2, and lir Note that for LAC and RS data, lac and rs are used, respectively. {YYYY}: year in four-digits {MM}: month in two-digits {DD}: day in two-digits {hh}: hour in two-digits {mm}: minute in two-digits {ss}: second in two-digits Note that {YYYY}-{MM}-{DD}T{hh}:{mm}:{ss} means the representative time of observation for the image in UTC. This time is also stored in HDU of the FITS file as string value of DATE-OBS keyword. {filter}: abbreviated filter name or type of image with 3 characters used to acquire image For each camera, values of {filter} and corresponding NAIF name of channel are listed below. {cam} {filter} NAIF name of channel used to acquire image ----- -------- ------------------------------------------ uvi 283 VCO_UVI_283 or VCO_UVI_283_TOPOB dif VCO_UVI_DIF or VCO_UVI_DIF_TOPOB 365 VCO_UVI_365 or VCO_UVI_365_TOPOB sht VCO_UVI_SHT or VCO_UVI_SHT_TOPOB ir1 09d VCO_IR1_09D 09n VCO_IR1_09N 097 VCO_IR1_097 101 VCO_IR1_101 dif VCO_IR1_DIF drk VCO_IR1_DRK ir2 174 VCO_IR2_174 226 VCO_IR2_226 232 VCO_IR2_232 202 VCO_IR2_202 165 VCO_IR2_165 drk VCO_IR2_DRK lir pic VCO_LIR_PIC opn VCO_LIR_OPN sht VCO_LIR_SHT {level}: abbreviated name of product The values of {level} is summarized in the following table. Note that the l3{b,c} and l3{b,c}x products are not provided as part of PDS3 data set, but will be provided at DARTS at ISAS/JAXA and PDS ``annex''. {level} corresponding DATA_SET_ID description -------- ------------------------- --------------------------- l1b VCO-V-{CAM}-2-EDR-V{VER} uncalibrated count data l2{b,c} VCO-V-{CAM}-3-CDR-V{VER} calibrated data with physical dimension geo VCO-V-{CAM}-3-SEDR-V{VER} geometry data at the center of each pixel l3{b,c} not applicable interpolated data projected onto longitude-latitude l3{b,c}x not applicable grid data for evaluation of automated limb-fitting and pointing corrected data that can be used instead of ``geo'' {ver}: version string of the product in 2 digits The value is larger than or equal to 10. When the version number appeared in DATA_SET_ID is multiplied by 10, the result is equal to the value of {ver}. {ext}: extension of the file The following typical extensions are included in this data set except for ``nc'' that is only included in l3{b,c} and l3{b,c}x products. The ``data'' directory contains only ``fit'' and ``lbl'' files, and the ``browse'' directory contains only ``jpg'', ``html'', and ``lbl'' files. {ext} description ----- ---------------------------------------- fit FITS file based on the FITS Standard 4.0 lbl PDS3 label file jpg JPEG file html HTML (mostly compliant with HTML 5.2) nc NetCDF file in NetCDF-4 Format Structure and size of image data -------------------------------- All geometry information FITS files have same lengths for each axis with the corresponding file included in VCO-V-IR1-2-EDR-V1.0 and in VCO-V-IR1-3-CDR-V1.0 but with the ``_geo_'' in the filename instead of ``_l1b_'', ``_l2b_'', or ``_l2c_''. Special pixels and its expressions in data array ------------------------------------------------ For pixel at the space, IEEE NaN (Not a Number) is stored at the pixel. Ancillary Data ============== +Y-axis Inversion Events ------------------------ In order to ensure thermal stability of the spacecraft and its instruments, the spacecraft +Y-axis must be inverted relative to the solar system plane periodically. The dates of these inversions are as follows: Date Events ------------------- -------------- 2015-12-09T23:36:00 south to north 2016-02-08T23:16:00 north to south 2016-11-24T05:00:00 south to north 2017-02-01T04:30:00 north to south 2017-11-16T01:00:00 south to north 2018-02-23T03:00:00 north to south 2018-04-04T05:41:00 south to north 2018-10-04T04:00:00 north to south Geometry information -------------------- The data on geometry in FITS data files were calculated using the VCO SPICE kernels data set, VCO-V-SPICE-6-V1.0. This data set is available at DARTS in ISAS/JAXA and the PDS SPICE Archives in JPL/NASA. The image data associated with geometry information in this data set is provided in VCO-V-IR1-2-EDR-V1.0 and in VCO-V-IR1-3-CDR-V1.0. Coordinate System ================= In Space -------- Some geometric quantities appearing in the labels and the header of FITS files are in J2000 coordinates. In this coordinate, the +Z-axis points northward along the Earth's J2000 rotation axis and the +X-axis points toward the first point of aries. On Venus -------- For Venusian geometry, IAU VENUS that is defined as the planetocentric coordinate system for Venus is used. For Image --------- For all the data stored in the IMAGE extension HDU in FITS files provided in this data set, +Y-axis of the spacecraft is upward and -Z-axis of the spacecraft is rightward, when we use the commonly-used coordinate system with the origin at the lower-left corner of the image, horizontal axis (or X-axis or 1st axis) oriented from left to right, vertical axis (or Y-axis or 2nd axis) oriented from bottom to top. This coordinate system is commonly used in visualization software of FITS file, such as SAOImage DS9. The file ``document/imagecoord.txt'' describes detailed descriptions on the relationships between the image coordinate and indexes of the data used in this data set. Software ======== No software is included in this data set. However, the data products, being FITS files, can be readily accessed by means of a variety of FITS readers. PLANET-C Project Team members have been successful in using SAOImage DS9 version 7.6 by Smithsonian Astrophysical Observatory, the astropy module for Python version 3.0.3 (Python 3.7 has been used successfully), and the IDL Astronomy Users' Library. Note that for some of these readers, the existence of multiple HDU in the file must be included in the issued command. " CONFIDENCE_LEVEL_NOTE = " Confidence Level Overview ========================= This data set is calculated using SPICE toolkit and VCO SPICE kernel data set. In the VCO SPICE kernel data set, especially for C-kernel, they doesn't have enough accuracy to derive enough accurate geometry information in pixel unit. There are two major possible sources of the resultant error in the VCO SPICE C-kernel. One is the attitude stability of the spacecraft, and the other is the measurement accuracy of the attitude of the spacecraft by the star trackers onboard the spacecraft. The latter is described in detail in the comment in the C-kernel. Review ====== Prior to release, this data set will be reviewed by the IR1 team and the PDS Atmospheres Node. Data Coverage and Quality ========================= Data Coverage ------------- If there is no Venus or the Earth at the center of each pixel in the image, or if the image is taken with dark filter, geometry information file is not created. The periods without observations and the reasons are as follows: Period Reason ------------------------ ------------------------------------------- 2010-05-22 -- 2010-12-07 Cruise phase and 1st trial of VOI 2010-12-11 -- 2015-12-06 Sun orbiting phase 2015-12-15 -- 2016-01-14 Initial checkout on the orbit 2016-02-10 -- 2016-02-22 Not nominal attitude by misoperation 2016-05-26 -- 2016-06-14 Superior-conjunction 2016-12-11 -- Input power failure for Analog Electronics of IR system Quality ------- There are known discrepancies between the SPICE-calculated pointing and the image data. Namely, the center of the planet as determined from best-information SPICE kernels does not match the center of the planet as determined from inspection (e.g., limb-fitting). This difference is sometimes tens of pixels. In order for the geometry to be useful, a limb-fitting technique must be applied to the image data. While not part of this data set, but expected to be published in the form of an annex in the future, the level 3 data products are provided with a post-processing pointing correction algorithm to improve the geometry, and are then converted the data into latitude/longitude maps in NetCDF format. This corrected geometry data is also provided in FITS format as L3bx or L3cx product. Limitations =========== There are no known limitations at now. " END_OBJECT = DATA_SET_INFORMATION OBJECT = DATA_SET_MISSION MISSION_NAME = "VENUS CLIMATE ORBITER" END_OBJECT = DATA_SET_MISSION OBJECT = DATA_SET_TARGET TARGET_NAME = VENUS END_OBJECT = DATA_SET_TARGET OBJECT = DATA_SET_TARGET TARGET_NAME = EARTH END_OBJECT = DATA_SET_TARGET OBJECT = DATA_SET_HOST INSTRUMENT_HOST_ID = "VCO" INSTRUMENT_ID = "IR1" END_OBJECT = DATA_SET_HOST OBJECT = DATA_SET_REFERENCE_INFORMATION REFERENCE_KEY_ID = "NULL" END_OBJECT = DATA_SET_REFERENCE_INFORMATION END_OBJECT = DATA_SET END