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

specgroup (specgroup-1.7.1) [xmmsas_20211130_0941-20.0.0]

User defined ranges

The spectrum may be grouped using a fixed set of ranges in channel space, e.g.:

specgroup spectrumset=srcspec.ds groupedset=SpecGrp.ds ranges=''1:10,11:50''

which will produce two groups: the first from spectral channel 1 to spectral channel 10 and the second from spectral channel 11 to 50. The rest of the spectrum will remain ungrouped. Note that the spectral channel refers to the channel number contained in the CHANNEL array in the spectrum. This is not necessarily the same as the bin number of the spectrum.

The ranges can also be defined in photon energy units (KEV), e.g.:

specgroup spectrumset=srcspec.ds groupedset=SpecGrp.ds ranges=''0.0:0.4,1.0:2.0''
units=KEV rmfset=m1.rmf

which will produce a group containing spectral bins with central energies between 0.0 and 0.4 keV and another with central energies between 1.0 and 2.0 keV. The conversion between spectral channel and photon energy is given in the EBOUNDS extension of an OGIP compliant response file (see George et al....). Therefore if ranges are given in keV a redistribution matrix (RMF) must be supplied otherwise the error, NoRMFsupplied will be issued.

This option may be used in conjunction with the regular binning option and/or one of the statistical options. In which case the range grouping is applied first and the subequent options are applied to the remaining ungrouped bins.

XMM-Newton SOC -- 2021-11-30