diff --git a/doc/source/reference_manual/ctbkgcube.rst b/doc/source/reference_manual/ctbkgcube.rst index fa97e02..babe5cf 100644 --- a/doc/source/reference_manual/ctbkgcube.rst +++ b/doc/source/reference_manual/ctbkgcube.rst @@ -3,17 +3,17 @@ ctbkgcube ========= -Generate background cube for a counts cube. +Generate background cube for a stacked analysis. Synopsis -------- -This tool generates a background cube for a counts cube based on an input -model. A background cube is a 3-dimensional cube spanned by Right Ascension -or Galactic longitude, Declination or Galactic latitude, and energy. The -energy binning may be either linear, logarithmic, or custom defined using an -input file. The input model is used to predict the expected number of +This tool generates a background cube for a stacked analysis based on an +input model. A background cube is a 3-dimensional cube spanned by Right +Ascension or Galactic longitude, Declination or Galactic latitude, and energy. +The energy binning may be either linear, logarithmic, or custom defined using +an input file. The input model is used to predict the expected number of background counts in each background cube bin. ctbkgcube requires on input the event list or observation definition file diff --git a/doc/source/reference_manual/ctedispcube.rst b/doc/source/reference_manual/ctedispcube.rst index c04a4e2..bd9ff2b 100644 --- a/doc/source/reference_manual/ctedispcube.rst +++ b/doc/source/reference_manual/ctedispcube.rst @@ -1,40 +1,41 @@ .. _ctedispcube: ctedispcube -========= +=========== -Generate energy dispersion cube for a counts cube. +Generate energy dispersion cube for a stacked analysis. Synopsis -------- -This tool generates an energy dispersion cube for a counts cube. An energy -dispersion cube is a 4-dimensional cube spanned by Right Ascension or -Galactic longitude, Declination or Galactic latitude, energy, and fraction -between recontructed and true photon energy. The energy binning of the cube -may be either linear, logarithmic, or custom defined using an input file. +This tool generates an energy dispersion cube for a stacked analysis. An +energy dispersion cube is a 4-dimensional cube spanned by Right Ascension or +Galactic longitude, Declination or Galactic latitude, energy, and migration +which is the ratio between reconstructed and true photon energy. The energy +binning of the cube may be either linear, logarithmic, or custom defined +using an input file -ctedispcube requires on input the event list or observation definition file -that has been used in the generation of the counts cube using :doc:`ctbin`. +ctedispcube requires on input the event list or observation definition XML +file that has been used in the generation of the counts cube using :doc:`ctbin`. It is not recommended to use the counts cube for the energy dispersion cube definition, although this is formally possible by specifying the counts cube as ``incube`` parameter. This leads however to a large FITS file on output since the number of bins in the counts cube will be multiplied by -the number of offset angle bins (typically 200). Since the energy dispersion -varies only little over the field of view of the camera it is -recommended to use a rather coarse spatial binning to keep the file size -manageable (with a typical value of ``binsz=1.0``). +the number of migration (typically 100). Since the energy dispersion varies +only little over the field of view of the camera it is recommended to use a +rather coarse spatial binning to keep the file size manageable (with a typical +value of ``binsz=1.0``). ctedispcube generates an energy dispersion cube FITS file comprising three extensions. The primary extension contains a 3-dimensional image that contains the energy disperison values. The energy and fraction dimensions of the enrgy dispersion cube are folded into the 3rd dimension of the FITS image. The next -extension named ``EBOUNDS`` contains a binary table that defines the energy -boundaries of the exposure cube. The last extension named ``DELTAS`` contains -a binary table that defines the fraction between recontructed and true photon -energy. +extension named ``ENERGIES`` contains a binary table that defines the energy +values of the energy dispersion cube. The last extension named ``MIGRAS`` +contains a binary table that defines the migration values of the cube which +is the ratio between reconstructed and true photon energy. General parameters @@ -52,9 +53,6 @@ General parameters ``irf [string]`` Instrument response function. -``(edisp = no) [boolean]`` - Apply energy dispersion for response computation. - ``outcube [file]`` Output energy dispersion cube file. @@ -97,10 +95,10 @@ General parameters ``proj [string]`` Projection method. -``(mmax = 10.0) [real]`` - Upper bound of fraction between recontructed and true photon energy. +``(migramax = 2.0) [real]`` + Upper bound of ratio between reconstructed and true photon energy. -``(migrabins = 200) [integer]`` +``(migrabins = 100) [integer]`` Number of migration bins. diff --git a/doc/source/reference_manual/ctexpcube.rst b/doc/source/reference_manual/ctexpcube.rst index 0cf1512..2855d63 100644 --- a/doc/source/reference_manual/ctexpcube.rst +++ b/doc/source/reference_manual/ctexpcube.rst @@ -3,14 +3,14 @@ ctexpcube ========= -Generate exposure cube for a counts cube. +Generate exposure cube for a stacked analysis. Synopsis -------- -This tool generates an exposure cube for a counts cube. An exposure cube is -a 3-dimensional cube spanned by Right Ascension or Galactic longitude, +This tool generates an exposure cube for a stacked analysis. An exposure +cube is a 3-dimensional cube spanned by Right Ascension or Galactic longitude, Declination or Galactic latitude, and energy, that gives the exposure as function of true sky direction and energy. The energy binning of the cube may be either linear, logarithmic, or custom defined using an input file. @@ -56,9 +56,6 @@ General parameters ``irf [string]`` Instrument response function. -``(edisp = no) [boolean]`` - Apply energy dispersion for response computation? - ``outcube [file]`` Output exposure cube file. diff --git a/doc/source/reference_manual/ctpsfcube.rst b/doc/source/reference_manual/ctpsfcube.rst index 8871c0c..14d30e6 100644 --- a/doc/source/reference_manual/ctpsfcube.rst +++ b/doc/source/reference_manual/ctpsfcube.rst @@ -3,21 +3,21 @@ ctpsfcube ========= -Generate point spread function cube for a counts cube. +Generate point spread function cube for a stacked analysis. Synopsis -------- -This tool generates a point spread function cube for a counts cube. A point -spread function cube is a 4-dimensional cube spanned by Right Ascension or -Galactic longitude, Declination or Galactic latitude, energy, and offset -angle between true and measured arrival direction of a photon. The energy -binning of the cube may be either linear, logarithmic, or custom defined -using an input file. +This tool generates a point spread function cube for a stacked analysis. +A point spread function cube is a 4-dimensional cube spanned by Right +Ascension or Galactic longitude, Declination or Galactic latitude, energy, +and offset angle between true and measured arrival direction of a photon. +The energy binning of the cube may be either linear, logarithmic, or custom +defined using an input file. -ctpsfcube requires on input the event list or observation definition file -that has been used in the generation of the counts cube using :doc:`ctbin`. +ctpsfcube requires on input the event list or observation definition XML +file that has been used in the generation of the counts cube using :doc:`ctbin`. It is not recommended to use the counts cube for the point spread function cube definition, although this is formally possible by specifying the counts @@ -53,9 +53,6 @@ General parameters ``irf [string]`` Instrument response function. -``(edisp = no) [boolean]`` - Apply energy dispersion for response computation. - ``outcube [file]`` Output point spread function cube file. diff --git a/src/ctedispcube/ctedispcube.par b/src/ctedispcube/ctedispcube.par index 246bb03..21bb9b3 100644 --- a/src/ctedispcube/ctedispcube.par +++ b/src/ctedispcube/ctedispcube.par @@ -47,7 +47,7 @@ proj, s, a, "CAR", AIT|AZP|CAR|MER|MOL|STG|TAN,, "Projection method" # # Angular separation binning parameters #====================================== -migramax, r, h, 2.0,,, "Upper bound of ratio of recontructed to true photon energy" +migramax, r, h, 2.0,,, "Upper bound of ratio between reconstructed and true photon energy" migrabins, i, h, 100,,, "Number of migration bins" #