XMM-Newton Science Analysis System


slconv (slconv-2.6.2) [xmmsas_20230412_1735-21.0.0]

Examples.

The following minimal command

  slconv srclisttab=srclist.ds radiusexpression='RATE/10.0'

does the following:

• Reads sources from the first table in the dataset srclist.ds;
• Reads RA and dec information, in decimal degrees, from columns named RA and DEC;
• Uses all the sources (no filtering or truncation);
• Determines the radii of the ds9 or gaia circles in arcseconds, directly using the number found in a column called RATE, divided by 10;
• Specifies green circles for the source symbols;
• Writes the output to a ds9-style region file called region.reg.

If data from some other table in srclist.ds is desired, say one called SOURCES, it must be specified in the value of srclisttab as follows:

  slconv srclisttab=srclist.ds:SOURCES radiusexpression='RATE/10.0'

If the RA and dec are contained in columns of names different from the defaults, these also must be specified directly, eg:

  slconv srclisttab=srclist.ds radiusexpression='RATE/10.0'
  racolumn=RA_CORR deccolumn=DEC_CORR

Similarly with the unit of these data:

  slconv srclisttab=srclist.ds radiusexpression='RATE/10.0' radecunits=radians

An example of some filtering of the input source list:

  slconv srclisttab=srclist.ds radiusexpression='RATE/10.0'
  expression='(ID_BAND==0)&&(!(isnull(EXT)))&&((ID_INST!=1)||(RAWY>15))'

Suppose you wanted to display only the 10 most extended sources in an XMM-product source list. You could do:

  slconv srclisttab=srclist.ds radiusexpression='RATE/10.0'
  expression='!(isnull(EXT))' withncut=yes
  ncutsortexpression='EXT' ncut=10

If you wanted the source circles in the previous example to scale with the extent EXT instead of RATE/10, but were not very concerned to maintain an exact quantitative arrangement, the following would produce an acceptable qualitative result:

  slconv srclisttab=srclist.ds radiusexpression='EXT' radiusstyle=auto
  expression='!(isnull(EXT))' withncut=yes
  ncutsortexpression='EXT' ncut=10

Still maintaining this example, suppose you also wanted the sources to be numbered in decreasing order of the extent, you should do:

  slconv srclisttab=srclist.ds radiusexpression='EXT' radiusstyle=auto
  expression='!(isnull(EXT))' withncut=yes
  ncutsortexpression='EXT' ncut=10
  withlabels=yes labelstyle=sortedint labelsortstyle=radius

This locks the source numbering into the calculation of radii. If you changed radiusexpression in the previous command line to `DET_ML' for example, but nothing else, then the radii would then decrease with a decrease in the detection likelihood DET_ML, but the labels would still be integers in an ordered sequence following the decrease in radius. If you wanted to tie the label sequence definitely to, say, EXT, regardless of which rule the radius followed, you would rather do

  slconv srclisttab=srclist.ds radiusexpression='EXT' radiusstyle=auto
  expression='!(isnull(EXT))' withncut=yes
  ncutsortexpression='EXT' ncut=10
  withlabels=yes labelstyle=sortedint labelsortstyle=expr sortexpression='EXT'

To use the actual value of, say, column COUNTS as the label, do:

  slconv srclisttab=srclist.ds radiusexpression='RATE/10.0'
  withlabels=yes labelstyle=expr labelexpression='COUNTS'

So far all these examples have produced an output file in ds9 format, since this reflects the default setting of the parameter outputstyle. To obtain gaia-style output, this must be set to `gaia' explicitly:

  slconv srclisttab=srclist.ds radiusexpression='RATE/10.0' outputstyle=gaia

With this nearly all-default command line, the processing is identical to that in the first example in this subsection, except that the task in addition looks for two more columns in the input source table: RADEC_ERR and RATE, because the default value of extragaiacolumns lists these two columns. If these are found, their contents are copied to columns with identical names in the output table (an error results if either is not found). If you want a different set of columns, these must of course be explicitly specified, for example:

  slconv srclisttab=srclist.ds radiusexpression='RATE/10.0' outputstyle=gaia
  extragaiacolumns='RADEC_ERR COUNTS EXT EXT_ML'