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


specgroup (specgroup-1.7.1) [xmmsas_20230412_1735-21.0.0]

Parameters

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

ParameterMand Type Default Constraints
spectrumsetyesdataset  
The name of the input spectrum in counts v channel space.
 
overwritenobooleanno 
Whether to overwrite the input spectrum with grouping information or to produce a new file (default)
 
groupedsetnodatasetSpecGrp.ds 
The name of the grouped output spectrum
 
backgndsetnodataset  
The name of the background spectrum
 
mincountsnoint  
The minimum number of counts (source+background) to use when grouping
 
minSNnoreal  
The minimum signal to noise ratio to use when grouping
 
ratioabovebgndnoreal  
The minimum ratio of source to background to use when grouping
 
grouptemplatenodataset  
The name of a spectrum from which to copy the grouping parameters
 
oversamplenoreal  
The minimum energy resolution for each group, e.g. if oversample=3 then the minimum width of a group is 1/3 of the resolution FWHM at that energy.
 
rangesnostring  
Ranges to group over. They should be entered as integer numbers, if defined in channels, or as decimals if defined in keV (in which case the units parameter should be set accordingly. The beginning and end of a range may be seperated by either a colon or a dash. Multiple ranges should be seperated by a comma. e.g. "2-20,63-97" or "0.2-0.5" or "0.4:3.6" etc.
 
unitsnochoiceCHANCHAN KEV
The units used for ranges - can be channel number of keV.
 
regbinstartnoint  
First channel to use if grouping done by regular bins
 
regbinendnoint  
Last channel to use if grouping done by regular bins
 
regbinwidnoint  
Number of channels to combine in each group if grouping done by regular bins
 
rmfsetnodataset  
The name of a redistribution matrix used to define the energy of the spectral channels.
 
hightolownobooleanfalse 
Whether to group from low to high (false) or high to low (true) energies.
 
addfilenamesnobooleantrue 
Whether to set the ANCRFILE, RESPFILE, BACKFILE keywords in the spectrum header.
 
arfsetnodataset  
The name of an effective area (ARF) file. This is purely used as a string to write into the ANCRFILE keyword. The file is not opened.
 
lastbinnochoiceaddtogroupaddtogroup setbad owngroup
What to do about ungrouped channels, typically the channels at the end of the spectrum which don't meet the statistical criterion.
 
setbadnostringCCFCCF no ranges_of_values
Whether to set some channels BAD and exclude them from grouping. Options are: "CCF" - to read the BAD channels from a calibration file, "no" - meaning 'take no action' or a range such as "0-10,750-799" may be entered to explicitely specify which channels to set BAD. The range may be defined in channels or keV, consistent with the setting of the units parameter.
 
ParameterMand Type Default Constraints

XMM-Newton SOC -- 2023-04-16