From 2a3dae800e418c9a5b3621fda5b829aff9837c9a Mon Sep 17 00:00:00 2001 From: Jürgen Knödlseder Date: Sun, 26 Feb 2017 21:43:14 +0100 Subject: [PATCH] Complete glossary --- doc/source/users/glossary.rst | 90 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++------- 1 file changed, 83 insertions(+), 7 deletions(-) diff --git a/doc/source/users/glossary.rst b/doc/source/users/glossary.rst index 6a5479f..2aeb335 100644 --- a/doc/source/users/glossary.rst +++ b/doc/source/users/glossary.rst @@ -5,13 +5,21 @@ Glossary .. topic:: Counts cube - Bla bla ... + A counts cube is a three-dimensional data cube spanned by Right Ascension + or Galactic longitude, Declination or Galactic latitude, and reconstructed + energy. The binning is logarithmic in energy. + .. _glossary_eventlist: .. topic:: Event list - Bla bla ... + An event list is a table comprising the reconstructed properties of the + observed events. Each row of the table corresponds to an event. The columns + of the table provide event characteristics, such as trigger time, + reconstructed arrival direction (in Right Ascension and Declination), and + the reconstructed event energy. + .. _glossary_1dc: @@ -35,28 +43,96 @@ Glossary .. topic:: Good Time Interval - Bla bla ... + A Good Time Interval is a contiguous time period, defined by a start and + a stop time, during which the events can be used for a scientific analysis. + .. _glossary_irf: .. topic:: Instrument Response Functions - Bla bla ... + The instrument response functions provide a mathematical description that + links the measured quantities of an event to the physical quantities of + the incident photon. The instrument response functions for CTA are factorised + into the effective area :math:`A_{\rm eff}(p, E, t)` (units :math:`cm^2`), + the point spread function :math:`PSF(p' | p, E, t)`, + and the energy dispersion :math:`E_{\rm disp}(E' | p, E, t)` + following: + + .. math:: + R(p', E', t' | p, E, t) = + A_{\rm eff}(p, E, t) \times + PSF(p' | p, E, t) \times + E_{\rm disp}(E' | p, E, t) + .. _glossary_moddef: .. topic:: Model definition file - Bla bla ... + Source and background model components are defined in ctools by a model + definition file. The model definition file is an ASCII file in XML format. + The format of the model definition file is inspired from, and is + compatible with, the format used by the Fermi-LAT Science Tools. + The general structure of a model definition file is + + .. code-block:: xml + + + + + + + + + + + + + + + + + + + + + + + + Each model component is described by the ```` tag. Each source has + an mandatory spectral and a spatial component (tags ```` and + ````) and an optional temporal component (tag ````). + Parameters that should be adjusted in a maximum likelihood fit should be + set to ``free="1"``; otherwise they are hold fixed. + .. _glossary_obs: .. topic:: Observation - Bla bla ... + The data are split into observations. Each observation is characterised by + a stable instrument configuration that can be described by an instrument + response function. Observations are also known as runs. + .. _glossary_obsdef: .. topic:: Observation definition file - Bla bla ... + Observations are combined in ctools using an observation definition file. + The observation definition file is an ASCII file in XML format. + The format of the observation definition file is illustrated below: + + .. code-block:: xml + + + + + + + + + + + -- libgit2 0.21.4