epicbscalgen (ccftools-1.36) [xmmsas_20211130_0941-20.0.0]

Description

- The axis points along the optical axis of the telescope of the respective instrument from the focal plane into the sky.
- The axis is orthogonal to the axis and lies in the plane spanned by the axis and the axis of the CAMCOORD2 (see documentation of package cal frame.
- The axis completes the right-handed, orthonormal Cartesian coordinate frame.

Figure 1: Coordinate frames used in epicbscalgen

The computation of the angles is a purely geometrical problem and, thus, should have a straightforward analytical solution. However, due to the large number of involved independent variables (Ra/Dec of pointing, position angle, position of cameras in satellite frame, uncertainties in focal lengths, position and extent of sources being looked at, etc.) and the fact that math with Euler angles is non-trivial epicbscalgen employs an empirical scheme which is outlined below. The scheme has the following advantages:

- The process is fully automatic in the sense that is does require only minimal input from the person running the task.
- It is bound to always give the right answer (chances of making mistakes are small).
- The correctness of the algorithm can be tested with SciSim.