XMM-Newton Science Analysis System


eimsim (eimsim-2.4) [xmmsas_20190531_1155-18.0.0]

Choice of source detection scheme

It is possible to run the simulation with different schemes for detecting sources in the simulated images. The task eimsim calls a separate script to perform the source detection. The user may either select one from the (small) range available, or supply their own. It is usually also necessary to supply a matching `preparation' script to eimsimprep. Exact details of the necessary calls can be found in the documentation for these respective tasks. In `cookbook' terms however, the two styles appear as follows:

• If the user chooses one of the supplied detection schemes, eg the 2xmm scheme, the `cookbook' procedure changes to the following:
  1. Do items 1 to 3 from the `cookbook' (section 4.1).
  2. Copy $SAS_DIR/lib/data/eimsimdata/srcspec_2xmm.fits into the PWD and rename it `srcspec.fits'.
  3. Run the tasks as follows:

             eimsimprep dettype=2xmm
             eimsimbatch
             eimsimreduce
     

• If the user wishes to supply their own detection and det-prep tasks, the `cookbook' procedure changes to the following:
  1. Do items 1 to 3 from the `cookbook' (section 4.1).
  2. Copy an appropriate template file from $SAS_DIR/lib/data/eimsimdata/ into the PWD, or otherwise generate one; if you want to adhere to the present simple cookbook style you will then need to rename it `srcspec.fits'.
  3. Run the tasks as follows:

             eimsimprep detpreptask=<name of my det prep task>
             eimsimbatch dettask=<name of my detection task>
             eimsimreduce
     

  Of course you can also use this command style to run one of the supplied detection schemes if you wish. If you do this you will find that there is some protection in place to prevent you running clashing preparation and detection scripts. You will also be warned if you try to use a 1xmm template set with 2xmm detection scheme, for example.