Astrosat Project Soft X-Ray Telescope (SXT)

Size: px

Start display at page:

Download "Astrosat Project Soft X-Ray Telescope (SXT)"

Junior Lloyd
5 years ago
Views:

1 Astrosat Project Soft X-Ray Telescope (SXT) SXT-SOFTWARE-SXTFLAGPIX TIFR Team Sanket Kotak Ashutosh Bajpai Kallol Mukerjee April 29, 2016 Department of Astrophysics & Astronomy Tata Institute of Fundamental Research Mumbai

2 Document Revision Status A-amend, M-modification, D-deletion Version o. Date Section ature Description 1 29/4/16 All A Initial Version

3 AME sxtflagpix Flags events for bad pixels and calibration source location. USAGE sxtflagpix [parameter = ] DESCRIPTIO 'sxtflagpix' flags events occurring in bad pixels and bad column locations, events associated with the corner calibration sources. Moreover, events whose central pixel in the 3x3 neighborhood has a PHA value (PHAS[1]) below a certain threshold are flagged. If the parameter 'thrfile' is set to CALDB, 'sxtflagpix' reads the threshold value stored in the calibration database file. By setting 'thrfile' to OE, the task allows the user to set this threshold using the parameter 'evtthr' and 'splithr'. 'sxtflagpix' allows for two different input files that identify bad pixels. These are: 1. the Bad Pixels calibration file which includes the most up to date information about known bad pixels, 2. a user supplied list of bad pixels (this file has to be of the same format as the CALDB bad pixels file). The CCD has four calibration sources located at the corners of the detector. Events coming from these positions are flagged to allow for their identification during the screening. Also the events outside of the field of view of the instrument (FOV) are flagged. The locations of the calibration sources and the geometry of the FOV are read from a CALDB file specified through the parameter 'regionfile'. The user has an option to choose which bad pixel list to use. All events are checked and flagged using the information obtained from the input bad pixels files. The bad pixels files contain a column 'TIME' at which the pixel is first considered as bad. The task reads the 'TIME' column and, for a given observation, considers only the pixels identified as bad before the observation start date. The event flag is stored as a 16 bit binary number in the column STATUS. The flag, recorded in the column STATUS, indicates if the event is considered good or bad.

4 The list of flags is the following: b Good event b Event falls in a bad pixel from CALDB b RESERVED b RESERVED b Event falls in hot bad pixel b Event falls in a user bad pixel b Event falls in flickering bad pixels b RESERVED b Event has a neighbor hot or flickering b Event falls in a bad column b Event has PHAS[1] < Event Threshold b Event has a neighbor bad from bad pixels list b Bad Event b Event from calibration source 1 b Event from calibration source 2 b Event from calibration source 3 b Event from calibration source 4 If the parameter 'owstatus' is set to 'yes' (default) the STATUS column is overwritten. To update the STATUS column, without erasing the values of the previous 'sxtflagpix' run, the user must set to 'no' the 'owstatus' parameter. All bad pixels are stored in an extension of the output file. If this already exists and the parameter 'owstatus' is set to 'no', the extension is updated with new bad pixels. The bad pixels extension or output file contains the following columns: RAWX and RAW give the raw coordinates of the pixel; TPE which identifies whether it is a single pixel (1), a column (2) or a row (3). For columns and rows of bad pixels, RAWX and RAW indicate the start pixel and EXTET the length of the set of consecutive bad pixels included in the bad pixels file; BADFLAG stores a 16 bit binary number which indicates the origin of the bad pixel.

5 PARAMETERS (infile) [filename=as1p01_044t01_ sxtpc00_level2.evt] Input Level1 Science Data File (outfile) [filename=as1p01_044t01_ sxtpc00_level2_flagpixfile.tmp] Output Level2 Unfiltered Event File (thrfile) [filename=oe / CALDB] ame of Threshold File. If set as OE 'sxtevtgen' module asks for all threshold values. (bpfile) [filename=caldb] ame of Bad Pixel File (userbpfile) [filename=oe / Filename ] ame of Input User Bad Pixel File (regionfile)[filename=oe / CALDB] ame of Region File (four corner source events are not flagged as bad if regionfile=oe) (owstatus) [string= / ] Overwrite Status Column if set as. (evtthr) [integer] Event threshold value is use for selection of events (splithr) [integer] Split Threshold Value (logpropfile) [filename=sxtflagpix.properties] LOG4CPP properties filename (logfile) [filename=sxtflagpix.log] output log filename (chatter = 2) [integer] Chatter Level (min=0, max=5). (clobber=) [string] If clobber= overwrite the output file.

6 (history=) [string] write history in output file.

7 START sxtflagpix.par file Read Input/Ouput parameter for sxtflagpix CALDB threshold file Read Threshold values from Threshold file CALDB badpix file CALDB region file Read all Bad pixel information from BadPix file Read four CornerSource and field of view regions Region file Add Status Column in Level2 Unfiltered Event File Get Total number of events in Level2 Unfiltered Event file If Row umber in Event File< Total number of Events if rawx >= 0 && rawx <= 599 && rawy >= 0 && rawy <= in STATUS Column if rawx = 0 rawx = 599 rawy = 0 rawy = 599 rawx-1 = 0 rawx+1 = 599 rawy-1 = 0 rawy+1 = in STATUS Column if (rawx - calsrc[0].rawx)*(rawx - calsrc[0].rawx) +(rawy - calsrc[0].rawy)*(rawy - calsrc[0].rawy) <= calsrc[0].radius * calsrc[0].radius

8 8192 in STATUS Column if (rawx - calsrc[1].rawx)*(rawx - calsrc[1].rawx) +(rawy - calsrc[1].rawy)*(rawy - calsrc[1].rawy) <= calsrc[1].radius * calsrc[1].radius in STATUS Column if (rawx - calsrc[2].rawx)*(rawx - calsrc[2].rawx) +(rawy - calsrc[2].rawy)*(rawy - calsrc[2].rawy) <= calsrc[2].radius * calsrc[2].radius in STATUS Column if (rawx - calsrc[3].rawx)*(rawx - calsrc[3].rawx) +(rawy - calsrc[3].rawy)*(rawy - calsrc[3].rawy) <= calsrc[3].radius * calsrc[3].radius if PHA[0] < Event Threshold in STATUS Column 2 in STATUS Column Flag status with value 256 in STATUS Column for each neighboring pixel around (RAWX,RAW) If event registered at RAWX & RAW is available in Bad Pixel table from BAD PIX File Row umber = Row umber + 1 STOP

Astrosat Project Soft X-Ray Telescope (SXT)

Astrosat Project Soft X-Ray Telescope (SXT) Standard Operating Procedure AS1SXTLevel2-1.0 Software Prepared by TIFR SXT Team 4 December 2015 Department of Astrophysics & Astronomy Tata Institute of Fundamental