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


ecoordconv (especget-1.54) [xmmsas_20230412_1735-21.0.0]

Parameters

This section documents the parameters recognized by this task (if any).

ParameterMand Type Default Constraints
imagesetyesstringimage 
The name of the input image.
 
srcexpnostring  
Expression for defining the source position and parameters
 
withcoordsnobooleanfalsenone
If true, the source position must be specified via the parameters coordtype, x, y. Otherwise, the source position is taken from the centre of the source region defined in the srcexp parameter.
 
xnoreal  
The X coordinate of the position to convert
 
ynoreal  
The Y coordinate of the position to convert
 
coordtypeyesstringeqposeqpos pos det raw impix
The coordinate system for which the source position, specified by the parameter x and y, is defined. If coordtype is set to eqpos, then x, y correspond to RA and DEC respectively in decimal degrees. If coordtype $=$ pos, then x,y correspond to POS coordinates. (Note that the POS coordinates are defined relative to a nominal pointing position; this is taken from the global attributes REFXCRVL and REFYCRVL of the image dataset.) If coordtype $=$ det, then x, y are the x and y positions of the source centre, in DET coordinates. If coordtype $=$ impix, then x, y are the x,y values of a pixel in the input image. Finally, if coordtype $=$ raw, then x, y are the raw chip positions of the source centre. In this case the CCD number must be specified using the ccdno parameter.
 
pos2eqposnobooleanfalsenone
If true, then only the conversion from x/y to ra/dec coordinates is made. This option is only active when withcoords=true and coordtype=pos. It avoids problems which occur when the RA_PNT, DEC_PNT coordinates are more than 90 degrees away from the X/Y reference pixel position.
 
im2eqposnobooleanfalsenone
If true, then only the conversion from image pixel to ra/dec coordinates is made. This option is only active when withcoords=true and coordtype=impix.
 
withccdnobooleanfalsenone
If true, the ccd number must be specified via the parameter ccdno, x, y. This is mandatory if the position has been specified in raw chip coordinates.
 
ccdnoyesint  
The CCD number on which the RAW chip position falls.
 
theta_outnodouble  
Output parameter that contains the off-axis angle, in units of arc seconds.
 
phi_outnodouble  
Output parameter that contains the azimuthal angle, in units of radians.
 
ra_outnodouble  
Output parameter that contains the right ascension.
 
dec_outnodouble  
Output parameter that contains the declination.
 
posx_outnodouble  
Output parameter that contains the POS, X position.
 
posy_outnodouble  
Output parameter that contains the POS, Y position.
 
detx_outnodouble  
Output parameter that contains the X position in detector coordinates
 
dety_outnodouble  
Output parameter that contains the Y position in detector coordinates
 
rawx_outnodouble  
Output parameter that contains the X position in raw, chip coordinates
 
rawy_outnodouble  
Output parameter that contains the Y position in raw, chip coordinates
 
ccd_outnoint  
Output parameter that contains the number of the CCD which the input position falls on.
 
ParameterMand Type Default Constraints

XMM-Newton SOC -- 2023-04-16