Futher improve estimator docs
@@ -16,16 +16,17 @@ flux points, flux profiles and flux light curves. All estimators
feature a common API and allow to estimate fluxes in energy bands.
The core of any estimator algorithm is hypothesis testing: a reference
-model is tested against a null hypothesis. From the best fit reference
-model a flux is derived and a corresponding significance from the
-difference in fit statistics to the null hypothesis.
+model or counts excess is tested against a null hypothesis. From the
+best fit reference model a flux is derived and a corresponding significance
+from the difference in fit statistics to the null hypothesis, assuming
+one degree of freedom (TODO: link to stats)
The technical implementation follows the concept of a reference
best fit model, which is then scaled in amplitude by fitting a `norm`
parameter. The fitting is done by grouping the data in spatial, time
and energy bins.
-Based on this algorithm all estimators compute the same basic quantities:
+Based on this algorithm most estimators compute the same basic quantities:
================= =================================================
Quantity Definition
@@ -34,9 +35,9 @@ e_ref Reference energy
e_min Minimum energy
e_max Maximum energy
norm Norm with respect to the reference spectral model
-norm_err Error on the norm derived from the Hessian matrix
-ts Difference in fit statistics (`stat - null_value` )
-sqrt_ts Square root of TS, corresponds to signficance (Wilk's theorem)
+norm_err Symmetric rrror on the norm derived from the Hessian matrix
+ts Difference in fit statistics (`stat_sum - null_value` )
+sqrt_ts Square root of TS, corresponds to significance (Wilk's theorem)
================= ==================================================
In addition the following optional quantities can be computed:
@@ -55,12 +56,19 @@ null_value Fit statistics value of the null hypothesis. Rename?
In addition a reference spectral model is given. Using this reference
-spectral model the norm values can be converted to different flux types
-such as `dnde`, `flux`, `e2dnde` and `eflux`, whatever users are interested
-in.
+spectral model the norm values can be converted to the following different
+SED types:
-Optionally a likelihood (fit statistics) profile can be computed for
-most estimators.
+================= =================================================
+Quantity Definition
+================= =================================================
+dnde Differential flux at ``e_ref``
+flux Integrated flux between ``e_min`` and ``e_max``
+eflux Integrated energy flux between ``e_min`` and ``e_max``
+================= ==================================================
+
+The same can be applied for the error and upper limit information.
+More information can be found on the `likelihood SED type page`_.
Getting Started
@@ -83,4 +91,6 @@ Reference/API
:include-all-objects:
+.. _`likelihood SED type page`: https://gamma-astro-data-formats.readthedocs.io/en/latest/spectra/binned_likelihoods/index.html
+
