XMM-Newton SAS Home Page
XMM-Newton Science Analysis System

evproject (attcalc2-1.5) [xmmsas_20211130_0941-20.0.0]


The task evproject does three things:

  1. For each event in the input list, evproject calculates an X and Y coordinate pair. These are the coordinates of the event on a plane which is tangent to the celestial sphere. The X axis of the tangent plane points in the direction of decreasing right ascension and the Y axis points in the direction of increasing declination. See section 3.3 or parameter tangdirstyle for a description of how the user can provide the direction of the tangent point to the program.

    These X and Y coordinate values are stored as 4-byte integers in columns of the event list designated by the parameters xcol and ycol. The coordinates are both offset and scaled, the relevant information being stored according to the usual World Coordinate System conventions in WCS column attributes of the xcol and ycol columns. The scaling is such that an increment of 1 in either X or Y value corresponds to a tangent-plane distance equal to the arc length of 0.05 arcsec (same as for the DETX and DETY columns of the event list).

    Note that the basic purpose of this projection is to make it easy to extract several images from different selections of the same events. Since the positions of all events on a projection plane are pre-calculated by evproject, it is a simple matter to rebin these positions to form an image. In formal terms, the X and Y values already constitute an image, albeit with a very small pixel size.

  2. The task calculates a nominally average spacecraft attitude (comprising right ascension and declination of the spacecraft -X axis and the position angle of the spacecraft -Z axis) and stores this in the event list header in keywords RA_PNT, DEC_PNT and PA_PNT.

  3. In principle, due to residual instability of the spacecraft pointing, each event is associated with a slightly different spacecraft attitude. However, because the differences from one event to another are usually slight, and because it is time consuming to perform the coordinate-transform calculation with a different attitude for each event, it was found convenient to divide the duration of the exposure into $N$ unequal bins, each of these time bins being associated with a fixed attitude. The task generates these bins by following the attitude and starting a new bin at the point where the attitude diverges from the bin baseline value by more than a set threshold.

    Note that the task can either perform this attitude binning itself (with the option to store the result in outbinnedattset) or it can make use of a binning scheme already prepared by task attbin. See section 3.4 for details.

These activities are described in more detail in the remaining subsections of section 3.

XMM-Newton SOC -- 2021-11-30