Luigi Tibaldo / ctools

Commit 8969bbf906f04ebfe5c30da0c5a596440d272a49

Authored by Jürgen Knödlseder
2 parents c38f16a2 cbfbbcca

Merge branch '1dc-doc-update' into bugfix-1.4.2

Inline Side-by-side
Showing 3 changed files with 40 additions and 29 deletions
doc/source/users/tutorials/1dc/data_organisation.rst
  View file @8969bbf
... ... @@ -17,6 +17,10 @@ The content of the ``1dc`` folder should be as follows:
17 17 caldb/data/cta/1dc/caldb.indx
18 18 caldb/data/cta/1dc/bcf
19 19 ...
  20 + data/baseline/agn
  21 + data/baseline/agn/agn_baseline_510000.fits
  22 + data/baseline/agn/agn_baseline_510001.fits
  23 + ...
20 24 data/
21 25 data/baseline/
22 26 data/baseline/egal
... ... @@ -32,11 +36,13 @@ The content of the ``1dc`` folder should be as follows:
32 36 data/baseline/gps/gps_baseline_110001.fits
33 37 ...
34 38 models/
  39 + models/models_agn.xml
35 40 models/models_egal.xml
36 41 models/models_gc.xml
37 42 models/models_gps.xml
38 43 ...
39 44 obs/
  45 + obs/obs_agn_baseline.xml
40 46 obs/obs_egal_baseline.xml
41 47 obs/obs_gc_baseline.xml
42 48 obs/obs_gps_baseline.xml
... ... @@ -75,29 +81,30 @@ and that were stored into FITS files.
75 81 Event data are split into :ref:`observations <glossary_obs>` with a fixed
76 82 pointing direction (observations are also known as runs).
77 83 The duration of an observation is 25 minutes for the Extragalactic Survey
78   -and 30 minutes for the Galactic Plane and Centre surveys.
79   -The properties of the event data for all three surveys are summarised in the
  84 +and 30 minutes for the Galactic Plane and Centre surveys and the AGN monitoring
  85 +program.
  86 +The properties of the event data for all simulations are summarised in the
80 87 table below:
81 88  
82   - +-----------------------------------+---------------------+---------------------+---------------------+
83   - | Parameter | GPS | GC | EGAL |
84   - +===================================+=====================+=====================+=====================+
85   - | Number of observations | 3270 | 1671 | 1271 |
86   - +-----------------------------------+---------------------+---------------------+---------------------+
87   - | Duration of each observation | 1800 s | 1800 s | 1500 s |
88   - +-----------------------------------+---------------------+---------------------+---------------------+
89   - | Deadtime fraction | 2% | 2% | 2% |
90   - +-----------------------------------+---------------------+---------------------+---------------------+
91   - | Total exposure time of simulation | 1635 h | 835.5 h | 529.58 h |
92   - +-----------------------------------+---------------------+---------------------+---------------------+
93   - | Simulated event energies | 30 GeV - 160 TeV | 30 GeV - 160 TeV | 30 GeV - 160 TeV |
94   - +-----------------------------------+---------------------+---------------------+---------------------+
95   - | Maximum off-axis angle | 5 deg | 5 deg | 5 deg |
96   - +-----------------------------------+---------------------+---------------------+---------------------+
97   - | Start date of observations | 2021-01-01T11:58:51 | 2021-01-01T11:58:51 | 2021-01-01T11:58:51 |
98   - +-----------------------------------+---------------------+---------------------+---------------------+
99   - | End date of observations | 2021-04-18T18:52:51 | 2021-03-29T21:32:51 | 2021-02-25T14:38:51 |
100   - +-----------------------------------+---------------------+---------------------+---------------------+
  89 + +-----------------------------------+------------------+------------------+------------------+-----------------+
  90 + | Parameter | GPS | GC | EGAL | AGN |
  91 + +===================================+==================+==================+==================+=================+
  92 + | Number of observations | 3270 | 1671 | 1271 | 1920 |
  93 + +-----------------------------------+------------------+------------------+------------------+-----------------+
  94 + | Duration of each observation | 1800 s | 1800 s | 1500 s | 1800 s |
  95 + +-----------------------------------+------------------+------------------+------------------+-----------------+
  96 + | Deadtime fraction | 2% | 2% | 2% | 2% |
  97 + +-----------------------------------+------------------+------------------+------------------+-----------------+
  98 + | Total exposure time of simulation | 1635 h | 835.5 h | 529.58 h | 960.00 h |
  99 + +-----------------------------------+------------------+------------------+------------------+-----------------+
  100 + | Simulated event energies | 30 GeV - 160 TeV | 30 GeV - 160 TeV | 30 GeV - 160 TeV | 30 GeV - 50 TeV |
  101 + +-----------------------------------+------------------+------------------+------------------+-----------------+
  102 + | Maximum off-axis angle | 5 deg | 5 deg | 5 deg | 5 deg |
  103 + +-----------------------------------+------------------+------------------+------------------+-----------------+
  104 + | Start date of observations | 2021-01-01 | 2021-01-01 | 2021-01-01 | 2021-01-01 |
  105 + +-----------------------------------+------------------+------------------+------------------+-----------------+
  106 + | End date of observations | 2021-04-18 | 2021-03-29 | 2021-02-25 | 2022-07-09 |
  107 + +-----------------------------------+------------------+------------------+------------------+-----------------+
101 108  
102 109  
103 110 Each event file contains the events for an
... ... @@ -205,8 +212,8 @@ An example of an ``EVENTS`` table is shown below.
205 212 Observation Definition Files
206 213 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^
207 214  
208   -The files ``obs_egal_baseline.xml``, ``obs_gc_baseline.xml``, and
209   -``obs_gps_baseline.xml`` are so called
  215 +The files ``obs_agn_baseline.xml``, ``obs_egal_baseline.xml``,
  216 +``obs_gc_baseline.xml``, and ``obs_gps_baseline.xml`` are so called
210 217 :ref:`observation definition files <glossary_obsdef>`
211 218 containing the information (or metadata) of a list of observations.
212 219 The file is a plain ASCII files in XML format that can be inspected and
... ... @@ -218,11 +225,11 @@ Models
218 225  
219 226 The ``models`` folder contains the definitions of all source and background
220 227 models that were used for simulating the data.
221   -The files ``models_egal.xml``, ``models_gc.xml`` and ``models_gps.xml`` are
222   -so called
  228 +The files ``models_agn.xml``, ``models_egal.xml``, ``models_gc.xml`` and
  229 +``models_gps.xml`` are so called
223 230 :ref:`model definition files <glossary_moddef>`
224 231 collecting the definition of all model components used for the three surveys.
225   -Since the same sky model was used for all surveys the three files are
  232 +Since the same sky model was used for all surveys the four files are
226 233 identical.
227 234 The other files in the folder are ASCII and FITS files containing spectral,
228 235 temporal and spatial information that was used in the simulations.
... ...
doc/source/users/tutorials/1dc/getting_data.rst
  View file @8969bbf
... ... @@ -10,7 +10,7 @@ data are available on the
10 10 You need your usual CTA credentials to download the data.
11 11  
12 12 The release contains simulated data for the Galactic Plane Survey, the
13   -Galactic Centre Survey and the Extragalactic Survey,
  13 +Galactic Centre Survey, the Extragalactic Survey and the AGN monitoring program,
14 14 :ref:`instrument response functions (IRFs) <glossary_irf>`, and the
15 15 :ref:`model definition files <glossary_moddef>`
16 16 that were used for the simulation.
... ... @@ -21,6 +21,7 @@ by clicking on the following links:
21 21 * `Galactic Plane Survey <https://owncloud.cta-observatory.org/remote.php/webdav/1dc/gps.tar.gz>`_ (8.3 GB)
22 22 * `Galactic Centre Survey <https://owncloud.cta-observatory.org/remote.php/webdav/1dc/gc.tar.gz>`_ (4.4 GB)
23 23 * `Extragalactic Survey <https://owncloud.cta-observatory.org/remote.php/webdav/1dc/egal.tar.gz>`_ (2.5 GB)
  24 +* `AGN monitoring program <https://owncloud.cta-observatory.org/remote.php/webdav/1dc/agn.tar.gz>`_ (??? GB)
24 25 * `Instrument Response Functions <https://owncloud.cta-observatory.org/remote.php/webdav/1dc/caldb.tar.gz>`_ (1.2 MB)
25 26 * `Sky and background models <https://owncloud.cta-observatory.org/remote.php/webdav/1dc/models.tar.gz>`_ (0.9 GB)
26 27  
... ... @@ -32,6 +33,7 @@ line by typing:
32 33 $ wget https://owncloud.cta-observatory.org/remote.php/webdav/1dc/gps.tar.gz --user=<user> --ask-password
33 34 $ wget https://owncloud.cta-observatory.org/remote.php/webdav/1dc/gc.tar.gz --user=<user> --ask-password
34 35 $ wget https://owncloud.cta-observatory.org/remote.php/webdav/1dc/egal.tar.gz --user=<user> --ask-password
  36 + $ wget https://owncloud.cta-observatory.org/remote.php/webdav/1dc/agn.tar.gz --user=<user> --ask-password
35 37 $ wget https://owncloud.cta-observatory.org/remote.php/webdav/1dc/caldb.tar.gz --user=<user> --ask-password
36 38 $ wget https://owncloud.cta-observatory.org/remote.php/webdav/1dc/models.tar.gz --user=<user> --ask-password
37 39  
... ... @@ -47,6 +49,7 @@ After downloading, uncompress the files at any place by typing
47 49 $ tar xfvz gps.tar.gz
48 50 $ tar xfvz gc.tar.gz
49 51 $ tar xfvz egal.tar.gz
  52 + $ tar xfvz agn.tar.gz
50 53 $ tar xfvz caldb.tar.gz
51 54 $ tar xfvz models.tar.gz
52 55  
... ...
doc/source/users/tutorials/1dc/scope.rst
  View file @8969bbf
... ... @@ -38,15 +38,16 @@ conditions; only zenith angles of 20 degrees and 40 degrees were
38 38 simulated.
39 39 Data are provided for the baseline arrays.
40 40  
41   -Three Key Science Projects (KSPs) were simulated using realistic pointing
  41 +Four Key Science Projects (KSPs) were simulated using realistic pointing
42 42 patterns as defined in the CTA Science Case document:
43 43  
44 44 * the Galactic Plane Scan (GPS)
45 45 * the Galactic Centre Survey (GC)
46 46 * the Extragalactic Survey (EGAL)
  47 +* an AGN monitoring program (AGN)
47 48  
48 49 The source model used for the simulations is distributed together with the
49 50 data to the CTA Consortium Science Working Groups, so that analysis results
50 51 can be compared to the Monte Carlo truth. The same source model was used for
51   -the simulation of all three surveys.
  52 +all simulations.
52 53  
... ...