Документ взят из кэша поисковой машины. Адрес оригинального документа : http://xmm.vilspa.esa.es/sas/5.4.1/doc/slconv/node10.html
Дата изменения: Fri Jan 10 22:33:48 2003
Дата индексирования: Sat Dec 22 08:12:14 2007
Кодировка:
Поисковые слова: п п п п п п п п п п п п п п п п п п п п п п п п п п

XMM-Newton Science Analysis System


slconv (slconv-1.1.2) [xmmsas_20030110_1802-5.4.1]

Meta Index / Home Page / Description

Examples.

The following minimal command

  slconv srclisttab=srclist.ds

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;
• Copies all the sources (no filtering or truncation);
• Writes the radii of the circles in arcseconds, directly using the number found in a column called RATE (this is unlikely to be very good, RATE will most likely need to be multiplied by some scaling factor);
• Draws 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

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 racolumn=RA_CORR deccolumn=DEC_CORR

Similarly with the unit of these data:

  slconv srclisttab=srclist.ds radecunits=radians

An example of some filtering of the input source list:

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

Suppose you wanted to display only the 10 most extended sources in a PPS source list. You should do:

  slconv srclisttab=srclist.ds 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, but were not very concerned to maintain an exact quantitative arrangement, the following would produce an acceptable qualitative result:

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

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 expression='!(isnull(EXT))' withncut=yes
  ncutsortexpression=EXT ncut=10 radiusexpression='EXT' radiusstyle=auto
  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 expression='!(isnull(EXT))' withncut=yes
  ncutsortexpression=EXT ncut=10 radiusexpression='EXT' radiusstyle=auto
  labelstyle=sortedint labelsortstyle=expr labelexpression=EXT

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

  slconv srclisttab=srclist.ds 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 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 outputstyle=gaia
  extragaiacolumns='RADEC_ERR COUNTS EXT EXT_ML'