Astrosat Project Level2 Interface Control Document Level2 Data Pipeline Software for Soft X-Ray Telescope (SXT)
Total Page:16
File Type:pdf, Size:1020Kb
Astrosat/DP/SAC/SIPA/SPDCG/HRDPD/TR-5(c)/Sept.2017 Astrosat Project Level2 Interface Control Document Level2 Data Pipeline Software For Soft X-ray Telescope (SXT) SAC DP Team Navita Thakkar, P. Neethi Nathan, Arvind K Singh, T. P. Srinivasan, B. Gopala Krishna Instrument Team Prof. Sudip Bhattacharyya, Ms.Nilima Kamble, S. L. Vishwakarma, J G Koyande September 2017 High Resolution Data Processing Division Satellite Photogrammetry and Digital Cartography Group Signal and Image Processing Area Space Applications Centre Ahmedabad-380015 1 Astrosat/DP/SAC/SIPA/SPDCG/HRDPD/TR-5(c)/Sept.2017 Space Applications Centre (ISRO), Ahmedabad Document Control and Data Sheet 1 Report No & : Astrosat/DP/SAC/SIPA/SPDCG/HRDPD/TR-5(c)/Sept. Date 2016 2 Title : Astrosat Project- Level2 Interface Control Document Level2 data pipeline software for Soft X-ray Telescope(SXT) 3 Version : 1.3 4 No. of Pages : 48 5 No. of : 4 References 6 Authors : SAC DP Team – Navita Thakkar, Neethi Nathan, Arvind K. Singh, T. P. Srinivasan, B. Gopala Krishna Instrument Team – Prof. Sudip Bhattacharyya, Nilima Kamble, S.L. Vishwakarma, J G Koyande 7 Originating : High Resolution Data Processing Division, Unit Satellite Photogrammetry and Digital Cartography Group,Signal and Image Processing Area 8 Abstract : This document describes the level2 output data formats to be generated from Level-2 data pipeline software. 9 Keywords : Astrosat, SXT, MKF, FITS, PHAS, PI 10 Security : Restricted Classification 2 Astrosat/DP/SAC/SIPA/SPDCG/HRDPD/TR-5(c)/Sept.2017 Astrosat Project- Level2 Interface Control Document Level-2 data pipeline software for Soft X-ray Telescope (SXT) Document Change History *A: Addition; M: Modification; D: Deletion Version Date Section A/M/D Description of change No. No. * V 1.0 Aug. 2012 All A Initial Version V 1.1 Sep. 2016 All M Changed version V 1.2 Nov. 2016 2 M Changed version V 1.3 Sep. 2017 1 & 2 M Changed version 3 Astrosat/DP/SAC/SIPA/SPDCG/HRDPD/TR-5(c)/Sept.2017 Table of Contents DOCUMENT CONTROL AND DATA SHEET.........................................................……..…..2 ASTROSAT PROJECT - LEVEL 2 INTERFACE CONTROL DOCUMENT …………………..…...2 LEVEL -2 DATA PIPELINE SOFTWARE FOR SOFT X- RAY TELESCOPE (SXT)..........……....2 DOCUMENT CHANGE HISTORY …………………………………................................…….... 3 1. INTRODUCTION................................................................................................…….. 5 2. LEVEL2 DATA ORGANISATION.......................................................…….................…. 6 3. LEVEL2 OUTPUT DATA FORMATS...................................................…….................. ..6 3.1 LEVEL2 EVENT FILE 3.1.1 PRIMARY HEADER FITS................................................................…………………..7 3.1.2 EVENTS HEADER FITS FORMAT...............................................................…….…..8 3.1.3 GTI HEADER FITS FORMAT...............................................................…….………..10 3.1.4 BADPIX HEADER FITS FORMAT...............................................................………...12 3.2 CLEAN EVENT FILE 3.2.1 PRIMARY HEADER FITS FORMAT...............................................................……....13 3.2.2 EVENTS HEADER FITS FORMAT .........................................................................15 3.2.3 GTI HEADER FITS FORMAT ....................................................................………...17 3.2.4 BADPIX H EADER FITS FORMAT ...........................................................………….19 3.3 LIGHT CURVE FILE 3.3.1 Primary Header FITS FORMAT................................................................……….20 3.3.2 RATE Header FITS FORMAT…............................................................................21 3.3.3 GTI Header FITS FORMAT…...............................................................................23 3.3.4 REG00101 HEADER FITS format …........................................................…….24 3.4 SPECTRUM FILE 3.4.1 PRIMARY HEADER FITS FORMAT...............................................................................25 3.4.2 SPECTRUM HEADER FITS FORMAT..........................................................................29 3.4.3 GTI HEADER FITS FORMAT......................................................................................31 3.4.4 REG00101 HEADER FITS FORMAT 3.5 IMAGE FILE 3.5.1 PRIMARY HEADER FITS FORMAT...............................................................................34 3.6 TCT FILE 3.6.1 PRIMARY HEADER FITS FORMAT...............................................................................35 3.6.2 TCT HEADER FITS FORMAT.....................................................................................36 3.7 MKF FILE 3.7.1 PRIMARY HEADER FITS FORMAT.........................................................................38 3.7.2 MKF HEADER FITS FORMAT.....................................................................................39 3.8 LBT HK FILE 3.8.1 PRIMARY HEADER FITS FORMAT ….....................................................................40 3.8.2 LBT HK HEADER FITS FORMAT................................................................................45 3.9 ATTITUDE FILE 3.9.1 PRIMARY HEADER FITS FORMAT...............................................................................46 3.9.2 ATTITUDE HEADER FITS FORMAT............................................................................47 4.REFERENCES.............................................................................................................48 4 Astrosat/DP/SAC/SIPA/SPDCG/HRDPD/TR-5(c)/Sept.2017 1.Introduction The Level2 ICD contains Level2 output data files format for the Soft X-ray Telescope (SXT) of Astrosat. All the outputs files will be in FITS Format. The Level2 Output data files are provided for each OBS ID. Under each OBS ID there are multiple tar files. Each tar file named as ( LEVL2AS1SXTyyyymmdd_<ObsID>_OrbNo.tar_VerNo ) corresponds to one data dump orbit as received from ISSDC as level-1. Level2 Event File (.evt) Level2 Clean Event File (_cl.evt) Image File (.img) Spectrum File (.pha) Light Curve File (.lc) Region text file (.reg) Xselect commands text file (.xco) Level2 Pipeline Log File Data quality report text file(_DQR.txt) The Other ancillary files are inherited from the Level1 are Time Calibration Table (.tct) Data File Make Filter Data File (.mkf) Low Bit rate House Keeping file (.lbt) Attitude File (.att) 2.Level2 Data Organisation Organized level-2 data set comes in tar format as ( LEVL2AS1SXTyyyymmdd_<ObsID>_OrbNo.tar_VerNo ) and after extracting the directory structure for data organization after level2 processing is given below. The files under yyyymmdd_<ObsID>_level2_OrbNo_VerNo directory will be generated during level2 data processing and other files viz. lbt file, attitude file, orbit file, mkf file will be copied from level1 to level2 directory. File names will bear the data mode and mode's status bits, MM and WW respectively. 5 Astrosat/DP/SAC/SIPA/SPDCG/HRDPD/TR-5(c)/Sept.2017 yyyymmdd_<ObsID>_level2_OrbNo_VerNo/sxt/OrbNo/ AS1<ObsID>sxt_level2.mkf sxt.01/ cs_pha/ (15 files) cs_pi/ (15 files) AS1<ObsID>sxtMMWW_level2.evt AS1<ObsID>sxtMMWW_level2_cl.evt AS1<ObsID>sxtMMWW_level2.img AS1<ObsID>sxtMMWW_level2.pha AS1<ObsID>sxtMMWW_level2.lc AS1<ObsID>sxtMMWW_level2_region.reg AS1<ObsID>sxtMMWW_level2_br_earth_remove.xco AS1<ObsID>sxtMMWW_level2_ci_sxtproducts.xco AS1<ObsID>sxtMMWW_level2_sxtscreen.xco aux/AS1<ObsID>sxt_level2.tct aux1/AS1<ObsID>sxt_level2.att aux2/AS1<ObsID>sxt_level2.lbt yyyymmdd_<ObsID>_level2_OrbNo_VerNo/ yyyymmdd_yyyymmdd_ObsID_level2_OrbNo_VerNo (Pipeline log file ) yyyymmdd_ObsID_level2_OrbNo_VerNo_DQR.txt (DQR text file) 6 Astrosat/DP/SAC/SIPA/SPDCG/HRDPD/TR-5(c)/Sept.2017 3.Level2 output data formats The detailed format description for all the Level2 data files are described in detail in respective sections which shown below. 3.1 Level2 Event File AS1<OBSID>sxtMMWW_level2.evt Where OBSID is Observation ID, MM is the Data Mode, WW mode's status bits. 3.1.1 Primary Header FITS format SIMPLE = T / File does not conform to FITS standard BITPIX = 8 / Number of bits per data pixel NAXIS = 0 / Number of data axes EXTEND = T / FITS dataset may include extensions MISSION = 'ASTROSAT' / Mission Name ORIGIN = 'NASA/GSFC' / Origin of fits file CREATOR = 'extractor v5.25' / Extractor TELESCOP = 'ASTROSAT' / Telescope (mission) name INSTRUME = 'SXT ' / Instrument name DATE = / file creation date (YYYY-MM-DDThh:mm:ss UT) DATE-OBS = / Start date of observation DATE-END = / End date of observation TIME-OBS = / Start time of observation TIME-END = / End time of observation TIMESYS = 'UTC ' / Time measured from MJDREFI = / MJD reference day MJDREFF = / MJD reference (fraction of day) = / MJD = JD - 2400000.5 TIMEZERI = / Clock correction integer TIMEZERF = / Clock correction fractional TIMEDEL = / Time resolution TIMEUNIT = 's ' / Unit for time keywords TSTARTI = / integer portion of start time TSTARTF = / fractional observation start time TSTOPI = / integer observation stop time TSTOPF = / fractional observation stop time OBJECT = / Name of observed object RA_PNT = / [deg] Nominal RA pointing DEC_PNT = / [deg] Nominal DEC pointing EQUINOX = 2000.0 / Equinox of celestial coord system RADECSYS = 'ICRS ' / Celestial coord system OBSERVER = / Observation information block OBS_ID = / Observation Id SOURCEID = / Source Id TARGETID = / Target Id EXP_TIME = / Exposure Time ORB_NUM = nnnnn / Orbit Number CHECKSUM = / HDU checksum updated yyyy-mm-ddThh:mm:ss 7 Astrosat/DP/SAC/SIPA/SPDCG/HRDPD/TR-5(c)/Sept.2017