XMM-Newton Science Analysis System
omsource (omsource-1.12) [xmmsas_20060628_1801-7.0.0]
Meta Index / Home Page
Usage
The following gives the various command lines for running the program.
- omsource In this case the program will prompt the user
to select an image file, either from a list of previously assessed files
or from a directory. When the main window is displayed the user will also
be able to select an existing source-list file by clicking on the
sourcelist button. He/she can also load another image by clicking on
the load image button.
- omsource imageset=... newsrclistset=... For creating a new
source-list file (no parameter oldsrclistset specified). The image
stored in the image file specified by the parameter imageset is displayed
without any source regions displayed. The user can either select sources
manually, or run the SAS task omdetect to detect sources. Again,the
user can load a source-list by clicking on the sourcelist button.
- omsource imageset=... newsrclistset=... wdxset=... This is
similar to the previous case, except that the wdxset parameter has
been used. This parameter is needed when running omsource on images reduced
using SAS software versions prior to 5.4. Please refer to the section
Input files for more information about this file.
- omsource imageset=... oldsrclistset=... newsrclistset=... The
sources stored in the source-list file specified by the parameter oldsrclistset
are loaded the image file specified by the parameter imageset is displayed
with the source regions overlaid. Each source is numbered.
- omsource imageset=... oldsrclistset=... newsrclistset=... wdxset=... Same as before,
except that the wdxset parameter has been specified, which is needed
when running omsource on images reduced using SAS software versions prior to 5.4.
- omsource wdxset=... Same as before, except that the
wdxset parameter has been specified, which is needed when running
omsource on images reduced using SAS software versions prior to 5.4.
- omsource oldsrclistset=... As before, except that the user
wishes to modify an existing source-list file.
- omsource oldsrclistset=... wdxset=... Same as before, except that the
wdxset parameter has been specified, which is needed when running
omsource on images reduced using SAS software versions prior to 5.4
When the program is running the user can load a new image/source-list file at
any time. When the user exits the program and the parameter
newsrclistset was omitted from the command-line and changes to
source-list have been made, the program will display a text-input
box allowing the user to type in the name of the new source-list file.
The task starts up by displaying a small progress-dialog box whilst
it is doing some initialisation work. The image file is displayed
using ds9. When the main task window is displayed the user
has a choice of actions, each of which is initiated by clicking the
appropriate button.
If the user did not load an existing source-list file, the user will first
have to either manually select sources from the image (by clicking the
Add sources button), or run the sas task omdetect
(by clicking the Run omdetect) button to locate sources on the image.
In the former case a small window appears and the user selects
sources by clicking the left-mouse button. In the
latter case, a small window is shown which allows the user to change the
default input parameter values to omdetect. Once done, this window is closed
and is replaced by another one indicating that omdetect is running. For both
cases, when finished, the main window is shown and the user can then proceed to
either examine the parameters of a particular source, by selecting it, redo
its photometry, or delete it.
Subsections
XMM-Newton SOC/SSC -- 2006-06-28