NAME
ixpecalcfov -- Calculates a map of the nominal sky field of view for each detector
USAGE
ixpecalcfov.py time ra dec outfile [roll] [refframe] [align] [teldef] [use_d1] [use_d2] [use_d3] [print_angles] [clobber]
DESCRIPTION
ixpecalcfov is a stand-along mission planning tool that computes the nominal (non-dithered) field of view for a user-selectable sub-set of the three detectors, sky position (ra, dec) and observing time (time). The output is a ds9 region file (user selectable with outfile) containing a composite region comprised of rectangular regions for each selected detector's field of view. The user can customize the result by specifying a custom roll angle (roll) or position angle of the spacecraft Y-axis, and the detectors included in the field of view image (selected by setting use_d1, use_d2, and use_d3, where setting the value to True will include the given detector in the field of view calculation).
In addition, the user can specify the celestial reference frame (refframe) of the inputted ra and dec and the outputted region file. By default, the alignment quaternions and telescope definition data are obtained from the IXPE CALDB. align is used to designate the name of a custom file of alignment quaternions, and teldef is used to designate the name of a custom file of telescope definition data.
PARAMETERS
- time* (str)
- Observation date and time in ISOT format.
- ra* (float)
- Right ascension of target in degrees.
- dec* (float)
- Declination of target in degrees.
- outfile* (str)
- Path name of output FITS image file.
- roll (float)
- Position angle of the spacecraft y-axis. Default is the computed value, which orients the y-axis toward the sun at the observation date and time.
- refframe (str)
- Celestial reference frame of input position. (default: icrs)
- align (str)
- Path to the align CALDB file. (default: -).
- teldef (str)
- Path to the teldef CALDB file. (default: -).
- use_d1 (bool)
- Calculate detector 1 field of view? (default: yes)
- use_d2 (bool)
- Calculate detector 2 field of view? (default: yes)
- use_d3 (bool)
- Calculate detector 3 field of view? (default: yes)
- print_angles (bool)
- Print the rotation angles of each fov? (default: yes)
- clobber
- Overwrite existing output file? (default: no)
EXAMPLES
BUGS
SEE ALSO
LAST MODIFIED
May 2023