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


especget (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
withfilestemnobooleanyes 
Whether to specify the output file names using the filestem parameter.
 
filestemnostringmyfiles 
Stem for the output filenames. A value "myfiles" will produce the files, myfiles_src.ds, myfiles_bgd.ds, myfiles_src.arf, myfiles_src.rmf
 
srcspecsetnostringsrcspec.ds 
Name of the output source spectrum. This is only used if withfilestem is false in which case it becomes mandatory.
 
bckspecsetnostringbckspec.ds 
Name of the output background spectrum. Only used if withfilestem is false in which case it becomes mandatory.
 
srcarfsetnostringsrcspec.arf 
Name of the output effective area file (ARF). This is only used if withfilestem is false and witharfset is true.
 
srcrmfsetnostringsrcspec.rmf 
Name of the output redistribution matrix (RMF). This is only used if withfilestem is false and withrmfset is false.
 
srcexpyesstring  
Expression for extracting the source events.
 
backexpyesstring  
Expression for extracting the background events.
 
tableyestable specifier event list table specifier
A table specifier which must point to an event list table in a data set. It must be in either of the forms setname or setname:tableid where setname must be the name of an existing data set and tableid the name of a table in the specified data set. If the first form, setname, is used, the event data are sought in the first block of the named data set.
 
withbadpixcorrnobooleanyes 
Whether to use bad pixels and chip gaps in the ARF calculation.
 
useodfattnobooleanno 
Whether to use the ODF attitude file to construct position info when calculating the ARF.
 
extendedsourcenobooleanno 
If set true then arfgen is run with parameters which are relevant to an extended source.
 
detxbinsnoint5 
The number of x bins in the detector map.
 
detybinsnoint5 
The number of y bins in the detector map.
 
withsourceposnobooleanfalsenone
If true, the source position must be specified via the parameters sourcecoords, sourcex, sourcey. Otherwise, the source position is taken from the centre of the source region defined in the data subspace of the input spectrum.
 
sourcecoordsnochoiceeqposeqpos pos tel det
Used if withsourcepos $=$ true. The coordinate system for which the source position, specified by the parameter sourcex and sourcey, is defined. If sourcecoords is set to eqpos, then sourcex, sourcey correspond to RA and DEC respectively in decimal degrees. If sourcecoords $=$ pos, then sourcex, sourcey correspond to POS coordinates. (Note that the POS coordinates are defined relative to a norminal pointing position; this is taken from the global attributes REFXCRVL and REFYCRVL of the spectrum dataset.) If sourcecoords $=$ tel, then sourcex, sourcey correspond to the telescope coordinates theta (arcseconds) and phi (radians). If sourcecoords $=$ det, then sourcex, sourcey are the x and y positions of the source centre, in DET coordinates.
 
sourcexnoreal none
(Used if withsourcepos $=$ true) The x-position of source centre, in terms of the coordinate system specified in sourcecoords.
 
sourceynoreal none
(Used if withsourcepos $=$ true) The y-position of source centre, in terms of the coordinate system specified in sourcecoords.
 
witharfsetnobooleanyes 
If set false an ARF will not be produced by the task and the geometrical area of the source and background regions will not be calculated and written into the BACKSCAL keyword.
 
withrmfsetnobooleanno 
If set false an RMF is produced by running rmfgen. If true the RMF is taken from the file specified in the parameter rmfset.
 
rmfsetnostring  
The name of the RMF to be used when rmfgen is not to be run. If this parameter is not set and withrmfset is true then the task sets the name of the RMF to be that of the appropriate canned matrix.
 
withenergybinsnobooleanfalsenone
If true use energy grid specified by energymin, energymax, and nenergybins, otherwise, use the grid defined in the CAL.
 
energyminnoreal none
Used if withenergybins $=$ true. Lower energy bound of matrix, in keV.
 
energymaxnoreal15none
Used if withenergybins $=$ true. Upper energy bound of matrix, in keV.
 
nenergybinsnointeger30none
Used if withenergybins $=$ true. The number of bins in the energy grid $=$ number of rows in RMF matrix.
 
a0removefilesnobooleantrue 
If true all created spectra and matrices are removed if the calculated ARF is 0 or negative. Set false to keep these files.
 
ParameterMand Type Default Constraints

XMM-Newton SOC -- 2023-04-16