Commit e009c0e3e55712e353e76154449196e76c290a45

Authored by Andreas Specovius
1 parent a4109691

Updated reference manual entry for csphagen.

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 -------------------
... ...