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

slconv (slconv-2.6.1) [xmmsas_20211130_0941-20.0.0]

Maximum number of sources.

It may be desirable to apply (in addition to the source selection described above) some definite upper limit to the number of sources to be plotted - say, to plot only the first 50 brightest sources. Such a limit may be difficult or impossible to achieve by use of the expression parameter. For this reason, an ncut parameter has also been provided. However, this parameter alone cannot provide full versatility. It is not sufficient just to specify the number of sources to keep: it is also necessary to determine which sources to keep. This means in practice that the sources must be sorted into a series before the series can be truncated after the ncutth member. The parameter ncutsortexpression has been provided to allow the sources to be sorted. This works as follows: the task looks in parameter ncutsortexpression for an expression involving column names; this expression is evaluated and the sources are then ordered in decreasing order of the resulting value.

For example,

  slconv srclisttab=bert.ds:SRCLIST radiusexpression='RATE'
  withncut=yes ncutsortexpression='RATE' ncut=10

produces a ds9 region file containing data for the first 10 brightest sources from the SRCLIST table in file `bert.ds' (that is, those 10 sources in the table which have the highest values of RATE).

XMM-Newton SOC -- 2021-11-30