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


evselect (evselect-3.71.2) [xmmsas_20230412_1735-21.0.0]

Parameters

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

ParameterMand Type Default Constraints
 
Event List Parameters 
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.
 
filteredsetnostringfiltered.fitsvalid file name
The name of the file to which the filtered event list is to be written. If this parameter is set, then keepfilteroutput is automatically set to true.
 
keepfilteroutputnobooleanfalsetrue$\mid$false
A boolean switch determining whether the result of the filtering process is to be kept or not. In the former case, the parameters flagcolumn and filteredset specify the form of the output from the filtering stage (see above).
 
flagcolumnnostring“EVFLAG”column name
The name of the integer column used to store the selection status of a table row in non-destructive filtering mode, which is activated if this parameter is set. If the column does not exist, it will be created with type int8, otherwise the existing column will be re-used. If a table with a flag column which has been added by a previous non-destructive evselect run is subsequently filtered in destructive mode the flag column gets deleted at the end of the filtering process. In case the flag column has not been created by evselect, the bit specified by the parameter flagbit is cleared at the end.
 
flagbitnointeger-1-1–31
In non-destructive filtering mode: the position of the bit in the integer column named via the flagcolumn parameter used to store the row selection status. 0 signifies the least- and the default value -1 the most-significant bit (i.e. 31 for int32, 15 for int16, 7 for int8) respectively. This bit being set flags an event as selected.
 
 
Filtering Parameters 
expressionnostring“true”valid filter expression according to selectlib syntax rules
This is the expression controlling the filtering process. It's length is in principal unlimited, please note however, that this is not true for the length of a command line in most UNIX shells. With this limit being in the range of several kByte, it should not pose a real problem in practice, though. This parameter and the dssblock parameter cannot be used at the same time. If both are specified, the one listed on the command line first takes precedence.
 
dssblocknoblock specifier  
Specifies a block containing data subspace information. This is converted into a filter expression which is used to filter the event list. Note that this parameter and the expression parameter cannot be used at the same time. If both are specified, the one listed on the command line first takes precedence.
 
 
General Output Product Parameters 
writedssnobooleantruetrue$\mid$false
Controls the writing of data subspace information to the output data files.
 
cleandssnobooleanfalsetrue$\mid$false
Controls the use of data subspace cleaning, which deletes components from the data subspace which select no events from the event list. Recommended for use by experts only.
 
updateexposurenobooleantruetrue$\mid$false
Update exposure information in event lists and in spectrum files. For the event lists this means that new values of the keywords LIVETIME, LIVETInn, ONTIME, and ONTIMEnn will be calculated, where nn is the CCD number. For spectrum files, the EXPOSURE keyword is calculated; note that this part of evselect is XMM specific
 
filterexposurenobooleantruetrue$\mid$false
Filter EXPOSUnn extentions of an EPIC event list with the same time filters applied to events in the corresponding CCD; XMM specific.
 
blockstocopynostring list  
List of extensions in the input data set to be copied to any extracted data product file. This does not apply to output event lists.
 
attributestocopynostring list  
List of attributes in the input table to be copied to any extracted data product table or array.
 
energycolumnnostringPHAname of existing column
Name of energy column, used for spectral extraction and for determining the energy range for light curve extraction.
 
zcolumnnostringWEIGHTname of existing column
Column from which to populate image, spectrum or light curve values.
 
zerrorcolumnnostringEWEIGHTname of existing column
Column containing the error on the zcolumn value, used to calculate errors for extracted products when accumulating using the zcolumn column.
 
ignorelegallimitsnobooleanfalsetrue$\mid$false
If true, ignore the TLMIN and TLMAX keywords when determining column extraction ranges.
 
 
Image Extraction Parameters 
imagesetnostringimage.fitsfile name
Name of the image product file.
 
xcolumnnostringRAWXname of existing column
Name of column with spatial X-coordinates (for image creation and spectral area determintation).
 
ycolumnnostringRAWYname of existing column
Name of column with spatial Y-coordinates (for image creation and spectral area determintation).
 
squarepixelsnobooleanfalsetrue$\mid$false
When ximagesize and yimagesize are set, forces the $x$ and $y$ bin sizes to be the same. The larger of the two bin sizes is used.
 
ximagesizenointeger600$>0$
If set, the size of the image (ie. number of image pixels) along the $x$ axis; for extraction using integer valued columns, the extracted image size may be somewhat smaller than the requested image size.
 
ximagebinsizenoreal1$>0$
If set, the binning factor for $x$ axis in image creation
 
yimagesizenointeger600$>0$
If set, the size of the image (ie. number of image pixels) along the $y$ axis; for extraction using integer valued columns, the extracted image size may be somewhat smaller than the requested image size.
 
yimagebinsizenoreal1$>0$
If set, the binning factor for $y$ axis in image creation.
 
ximageminnoreal1 
If set, the lower limit of $x$ coordinate for image extraction.
 
ximagemaxnoreal640 
If set, the upper limit of $x$ coordinate for image extraction.
 
yimageminnoreal1 
If set, the lower limit of $y$ coordinate for image extraction.
 
yimagemaxnoreal640 
If set, the upper limit of $y$ coordinate for image extraction.
 
imagedatatypenostringReal64Int8$\mid$Int16$\mid$Int32$\mid$Real32$\mid$Real64
Data type to use for the output image. If not set, evselect decides for itself what data type to use.
 
raimagecenternoreal  
If set, right ascension for the center of the output image, in decimal degrees.
 
decimagecenternoreal  
If set, declination for the center of the output image, in decimal degrees.
 
 
Spectrum Extraction Parameters 
spectrumsetnostringspectrum.fitsfile name
Name of the spectrum product file.
 
spectralbinsizenoreal10$>=1$
Binning factor for spectrum creation.
 
specchannelminnointeger $>=0$
If set, the minimum channel number to consider for spectrum creation.
 
specchannelmaxnointeger4095$>=0$
If set, the maximum channel number to consider for spectrum creation.
 
nonStandardSpecnobooleanfalsetrue$\mid$false
Should be set to true if a spectrum with a non-standard event PATTERN or non-standard channel range is required.
 
 
Rate Extraction Parameters 
ratesetnostringrate.fitsfile name
Name of the time series product file.
 
timecolumnnostringTIMEname of existing column
Name of column for time coordinate (to be used in rates files creation).
 
timebinsizenoreal1$>0$
Size of time bins for the time series files.
 
timeminnoreal  
If set, the earliest time to consider in time series file creation.
 
timemaxnoreal1000 
If set, the latest time to consider in time series file creation.
 
maketimecolumnnobooleanfalsetrue$\mid$false
If true, include a time column in the FITS table when creating a time series. If false, the table will only include a COUNTS column and the necessary keywords to deduce the time for each bin.
 
makeratecolumnnobooleanfalsetrue$\mid$false
If true, produces a lightcurve containing a RATE, rather than a COUNTS column. An ERROR column is also produced.
 
 
Histogram Extraction Parameters 
histogramsetnostringhisto.fitsfile name
File name for the histogram.
 
histogramcolumnnostringTIMEcolumn name
Name of the column from which to extract the histogram.
 
histogrambinsizenoreal1$>0$
Binning factor for histogram extraction.
 
histogramminnoreal  
If set, the lower limit for histogram extraction.
 
histogrammaxnoreal1000 
If set, the upper limit for histogram extraction.
 
ParameterMand Type Default Constraints

XMM-Newton SOC -- 2023-04-16