Commit e009c0e3e55712e353e76154449196e76c290a45
1 parent
a4109691
Updated reference manual entry for csphagen.
Showing
1 changed file
with
15 additions
and
2 deletions
doc/source/users/reference_manual/csphagen.rst
| ... | ... | @@ -13,8 +13,9 @@ Synopsis |
| 13 | 13 | This script can be used to derive from an observation or a set of observations |
| 14 | 14 | the count spectra in a source region and in background regions, as well as the |
| 15 | 15 | detector response (effective area, energy redistribution matrix), that can be |
| 16 | -used to perform a classical 1D spectral analysis. The output files are saved in | |
| 17 | -the OGIP format normally used in X-ray astronomy (PHA, ARF, RMF). | |
| 16 | +used to perform a classical 1D spectral analysis. Regions can be placed | |
| 17 | +automatically or by hand. The output files are saved in the OGIP format normally | |
| 18 | +used in X-ray astronomy (PHA, ARF, RMF). | |
| 18 | 19 | `See here <https://heasarc.gsfc.nasa.gov/docs/heasarc/ofwg/docs/spectra/ogip_92_007/node5.html>`__. |
| 19 | 20 | |
| 20 | 21 | The outputs are: |
| ... | ... | @@ -94,6 +95,12 @@ General parameters |
| 94 | 95 | Method for background estimation. |
| 95 | 96 | ``REFLECTED:`` background evaluated in regions with the same shape as |
| 96 | 97 | source region reflected w.r.t. pointing direction for each observation. |
| 98 | + ``CUSTOM:`` background evaluated in regions specified by user. | |
| 99 | + For event list or single obs in an obs definition XML: region files can | |
| 100 | + be queried. | |
| 101 | + For multiple observations: those have to be specified in the obs def XML. | |
| 102 | + Here use parameters name="OnRegion" and name="OffRegions" (per observation) | |
| 103 | + with appropriate <file> entry. Files can be ds9 regions or FITS WCS maps. | |
| 97 | 104 | |
| 98 | 105 | ``(bkgregmin = 2) [integer]`` |
| 99 | 106 | Minimum number of background regions that are required for an observation. |
| ... | ... | @@ -117,6 +124,12 @@ General parameters |
| 117 | 124 | ``(etruebins = 30) [integer]`` |
| 118 | 125 | Number of bins per decade for true energy bins. |
| 119 | 126 | |
| 127 | +``(bkgreg = bkg.reg) [file]`` | |
| 128 | + Background regions file (ds9 or FITS WCS map). | |
| 129 | + | |
| 130 | +``(srcreg = on.reg) [file]`` | |
| 131 | + Source region file (ds9 or FITS WCS map). | |
| 132 | + | |
| 120 | 133 | |
| 121 | 134 | Standard parameters |
| 122 | 135 | ------------------- | ... | ... |