det2att2 HEADAS help file

NAME

det2att2 - Converts detector coordinate offsets and rotations to attitude quaternions

USAGE

det2att2 infile outfile teldeffile startsys

DESCRIPTION

'det2att2' calculates the spacecraft rotation quaternions corresponding to offsets in detector coordinates. 'det2att2' can also incorporate time-dependent rotations of the detector coordinate system relative to the sky coordinate system. This option requires that the input file has columns for the sine and cosine of the rotation angle; otherwise the rotation angle is assumed to be zero.

'det2att2' is mission-independent and allows the selection of the origin system of the transformation using the parameter 'startsys'. The quaternion qdelta for an offset (dx, dy) is such that with a mapping of a detector position p = (px, py) to sky coordinates using an attitude q0, yield identical results when applying qdelta * q0 to p as applying q0 to (p - dx, p - dy).

PARAMETERS

infile [filename]: Name of the input offset file.
outfile [string]: Name of the output attitude file.
(teldeffile = CALDB) [string]: Name of the TelDef file. If the parameter is set to CALDB, the file is read from the calibration database.
startsys = SKY_FROM [string]: Name of the starting coordinate system. This must be either one of the coordinate systems defined in the file specified with the 'teldeffile' parameter or the special value 'SKY_FROM' (the default). With TelDef files format versions older than 0.2 and a parameter 'startsys' set to 'SKY_FROM', the originating coordinate system is read from the SKY_FROM keyword in the 'teldeffile.'
(deltaxcol = DELTADETX) [string]: Column name for the offset in the detector X coordinate.
(deltaycol = DELTADETY) [string]: Column name for the offset in the detector Y coordinate.
(sincol = SINANGLE) [string]: Column name for the sine of the rotation angle of the detector coordinates.
(coscol = COSANGLE) [string]: Column name for the cosine of the rotation angle of the detector coordinates.
(clobber = no) [boolean]: Overwrites the existing output file if set to yes (yes/[no]).
(chatter = 1) [integer]: Chatter level for output. Set to 0 to suppress output, or to 1, 2, or 3 for increasing the chatter of the output.
(logfile = !DEFAULT) [string]: Log filename. If set to DEFAULT uses the name of the task and, if preceded by '!', overwrite the file if it exists. If set to NONE no log file is created.
(debug = no) [boolean]: Diagnostic output is printed out on the screen if set to yes (yes/[no]).
(history = yes) [boolean]: Records tool parameters in HISTORY ([yes]/no).
(mode = ql) [string]: Mode to query the parameter file. Acceptable values include: "ql (query and learn/remember), "hl" (hidden and learn/remember), "q" (query but don't remember), "h" (hidden).

EXAMPLES

1. Convert an offset file derived from the Hitomi CAMS into a delta-attitude quaternion. The input file is the output of 'cams2det.' The TelDef file is that for HXI1, which is the instrument for which the offsets were derived.

det2att2 infile="CAMS_offsets.fits" outfile="delta_attitude.att" \
teldeffile="ah_hxi1.teldef" startsys=RAW deltaxcol="DELTARAWX" \
deltaycol="DELTARAWY" clobber=yes

2. Convert an offset file derived from the Swift TAM into a delta-attitude quaternion. The TelDef file is that for Swift XRT. The 'deltaxcol' and 'deltaycol' parameters can be the default values. The 'sincol' and 'coscol' parameters are ignored.

det2att2 infile="TAM_offsets.fits" outfile="delta_attitude.att" \
teldeffile="sw_xrt.teldef" startsys=SKY_FROM clobber=yes

LAST MODIFIED