NAME

ixpeexpmap -- Creates an exposure map in J2000 tangent-plane coordinates from the aspect solution data in the Level 1 housekeeping data.

USAGE

ixpeexpmap.py infile gti outfile [graypix] [teldef] [badpix] [pntmap] [pntname] [clobber]

DESCRIPTION

ixpeexpmap selects the J2000 tangent-plane positions of the pointing direction from a Level 1 Attitude file (infile) for all the valid rows within Good Time Intervals read from a GTI file (gti) to create a pointing map (pntmap; default=false, if pntmap=true then the pointing map will be placed in an output file given by the parameter pntname).

The pointing map contains standard sky tangent-plane X, Y coordinates with the value at each coordinate given by the exposure time in seconds. ixpeexpmap then calculates a valid pixel map to be convolved with the pointing map to create the final exposure map. The valid pixel map flags bad pixels and "gray" pixels (if graypix=true) from a bad pixel map (badpix). ixpeexpmap then convolves these two maps to build the final exposure map (outfile) using the appropriate rotations, offsets, and pixel-to-sky scalings (as given in the file teldef) necessary to convert raw pixels to sky coordinates. Exposure maps for multiple detectors can be co-added as differences in orientation and offset due to relative telescope pointing have already been accounted for.

PARAMETERS

infile* (str)
Input FITS Attitude file.

gti* (str)
Good Time Interval FITS file .

outfile* (str)
Output exposure map file name.

exc_graypix
Exclude gray pixels from exposure? (default: no)

teldef
Path to the teldef CALDB file (default: -)

badpix
Path to the badpix CALDB file (default: -)

pntmap
Output a skymap of the detector centers? (default: no)

pntname
Output exposure map file name (default: -)

clobber
Overwrite existing output file? (default: no)

use_corr
Use TXYDZ_CORR column for detector pointing centers? (default: no)

EXAMPLES

BUGS

SEE ALSO

LAST MODIFIED

Feb 2022