In making a background map or exposure map in sky coordinates it is useful to be able to transform images in CCD coordinates into sky coordinates. This is the function of the present task. The task takes in a list of images in the CHIPCOORD coordinate system (which is described in the cal library documentation) and replots them to sky coordinates.
The template for the output sky coordinate image is supplied via the parameter templateset. This should contain WCS keywords to define the sky projection plane and the image pixel size; the template image array itself supplies the numbers of pixels in the image X and Y directions. The values contained in this array are ignored, however - either an event image or an exposure map can for example be supplied as the template image. The data type of the template image array is therefore irrelevant. Also, the template image need not be from the same instrument as the chip images, or even an XMM image at all. Note however that the output image contains a copy of all keywords in the template image dataset and primary array headers. It is up to the user to ensure that these are appropriate to the output image.
In order to perform the correct coordinate transform, the task needs to know, for each input CCD image, which CCD of which instrument the image corresponds to. eimchip2sky determines the instrument from the INSTRUME keyword in each chip image dataset header. (Note that the chip images may come from more than one instrument.) There are several ways to specify the CCD numbers, including supplying an explicit list of them via the parameter ccds.
NOTE! At present the only WCS projection supported by eimchip2sky is RA/dec tangent.