Eirik Hatlen / ctools

Commit 408113a8a08e2c3909a3a8857013abfd4d3ea3cc

Authored by Jürgen Knödlseder
1 parent a3c71125

Update first Data Challenge tutorial

Inline Side-by-side
Showing 7 changed files with 40 additions and 48 deletions
doc/source/users/tutorials/1dc/data_organisation.rst
  View file @408113a
... ... @@ -6,7 +6,7 @@ Data organisation
6 6 Layout
7 7 ^^^^^^
8 8  
9   -The content of the ``1dc.south`` folder should be as follows:
  9 +The content of the ``1dc`` folder should be as follows:
10 10  
11 11 .. code-block:: bash
12 12  
... ... @@ -20,16 +20,16 @@ The content of the ``1dc.south`` folder should be as follows:
20 20 data/
21 21 data/baseline/
22 22 data/baseline/egal
23   - data/baseline/egal/egal_baseline_220000.fits
24   - data/baseline/egal/egal_baseline_220001.fits
  23 + data/baseline/egal/egal_baseline_210000.fits
  24 + data/baseline/egal/egal_baseline_210001.fits
25 25 ...
26 26 data/baseline/gc
27 27 data/baseline/gc/gc_baseline_310000.fits
28 28 data/baseline/gc/gc_baseline_310001.fits
29 29 ...
30 30 data/baseline/gps
31   - data/baseline/gps/gps_baseline_120000.fits
32   - data/baseline/gps/gps_baseline_120001.fits
  31 + data/baseline/gps/gps_baseline_110000.fits
  32 + data/baseline/gps/gps_baseline_110001.fits
33 33 ...
34 34 models/
35 35 models/models_egal.xml
... ... @@ -50,8 +50,6 @@ The ``caldb`` folder contains the
50 50 that are necessary for the analysis of the simulated CTA data.
51 51 The folder contains the ``1dc`` response that should be used for the
52 52 :ref:`first CTA Data Challenge <glossary_1dc>`.
53   -Currently only the response functions for CTA South are
54   -available for zenith angles of 20 deg and 40 deg.
55 53 Specifically, the following response functions are available:
56 54  
57 55 +-----------------------+-------+---------------+--------+----------+
... ... @@ -61,6 +59,10 @@ Specifically, the following response functions are available:
61 59 +-----------------------+-------+---------------+--------+----------+
62 60 | ``South_z40_50h`` | South | Baseline | 40 deg | 50 hours |
63 61 +-----------------------+-------+---------------+--------+----------+
  62 + | ``North_z20_50h`` | North | Baseline | 20 deg | 50 hours |
  63 + +-----------------------+-------+---------------+--------+----------+
  64 + | ``North_z40_50h`` | North | Baseline | 40 deg | 50 hours |
  65 + +-----------------------+-------+---------------+--------+----------+
64 66  
65 67  
66 68 Event data
... ... @@ -80,13 +82,13 @@ table below:
80 82 +-----------------------------------+---------------------+---------------------+---------------------+
81 83 | Parameter | GPS | GC | EGAL |
82 84 +===================================+=====================+=====================+=====================+
83   - | Number of observations | 2046 | 1671 | 489 |
  85 + | Number of observations | 3270 | 1671 | 1271 |
84 86 +-----------------------------------+---------------------+---------------------+---------------------+
85 87 | Duration of each observation | 1800 s | 1800 s | 1500 s |
86 88 +-----------------------------------+---------------------+---------------------+---------------------+
87 89 | Deadtime fraction | 2% | 2% | 2% |
88 90 +-----------------------------------+---------------------+---------------------+---------------------+
89   - | Total exposure time of simulation | 1023 h | 835.5 h | 203.75 h |
  91 + | Total exposure time of simulation | 1635 h | 835.5 h | 529.58 h |
90 92 +-----------------------------------+---------------------+---------------------+---------------------+
91 93 | Simulated event energies | 30 GeV - 160 TeV | 30 GeV - 160 TeV | 30 GeV - 160 TeV |
92 94 +-----------------------------------+---------------------+---------------------+---------------------+
... ... @@ -94,7 +96,7 @@ table below:
94 96 +-----------------------------------+---------------------+---------------------+---------------------+
95 97 | Start date of observations | 2021-01-01T11:58:51 | 2021-01-01T11:58:51 | 2021-01-01T11:58:51 |
96 98 +-----------------------------------+---------------------+---------------------+---------------------+
97   - | End date of observations | 2021-04-18T18:52:51 | 2021-03-29T21:32:51 | 2021-02-11T20:29:51 |
  99 + | End date of observations | 2021-04-18T18:52:51 | 2021-03-29T21:32:51 | 2021-02-25T14:38:51 |
98 100 +-----------------------------------+---------------------+---------------------+---------------------+
99 101  
100 102  
... ...
doc/source/users/tutorials/1dc/event_file.png
View file @408113a

35.4 KB | W: | H:

36 KB | W: | H:

  • 2-up
  • Swipe
  • Onion skin
doc/source/users/tutorials/1dc/event_header.png
View file @408113a

113 KB | W: | H:

110 KB | W: | H:

  • 2-up
  • Swipe
  • Onion skin
doc/source/users/tutorials/1dc/event_list.png
View file @408113a

118 KB | W: | H:

118 KB | W: | H:

  • 2-up
  • Swipe
  • Onion skin
doc/source/users/tutorials/1dc/getting_data.rst
  View file @408113a
... ... @@ -14,31 +14,26 @@ Galactic Centre Survey and the Extragalactic Survey,
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.
17   -In addition, ctools metadata, including
18   -:ref:`observation definition files <glossary_obsdef>`
19   -are available.
20 17  
21 18 The data were split into the separate files that can be downloaded
22 19 by clicking on the following links:
23 20  
24   -* `Galactic Plane Survey <https://owncloud.cta-observatory.org/remote.php/webdav/1dc.south/gps-south.tar.gz>`_ (6.1 GB)
25   -* `Galactic Centre Survey <https://owncloud.cta-observatory.org/remote.php/webdav/1dc.south/gc-south.tar.gz>`_ (4.9 GB)
26   -* `Extragalactic Survey <https://owncloud.cta-observatory.org/remote.php/webdav/1dc.south/egal-south.tar.gz>`_ (1.1 GB)
27   -* `Instrument Response Functions <https://owncloud.cta-observatory.org/remote.php/webdav/1dc.south/caldb-south.tar.gz>`_ (0.1 MB)
28   -* `Sky and background models <https://owncloud.cta-observatory.org/remote.php/webdav/1dc.south/models-south.tar.gz>`_ (0.9 GB)
29   -* `ctools metadata <https://owncloud.cta-observatory.org/remote.php/webdav/1dc.south/obs-south.tar.gz>`_ (0.2 MB)
  21 +* `Galactic Plane Survey <https://owncloud.cta-observatory.org/remote.php/webdav/1dc/gps.tar.gz>`_ (8.3 GB)
  22 +* `Galactic Centre Survey <https://owncloud.cta-observatory.org/remote.php/webdav/1dc/gc.tar.gz>`_ (4.4 GB)
  23 +* `Extragalactic Survey <https://owncloud.cta-observatory.org/remote.php/webdav/1dc/egal.tar.gz>`_ (2.5 GB)
  24 +* `Instrument Response Functions <https://owncloud.cta-observatory.org/remote.php/webdav/1dc/caldb.tar.gz>`_ (1.2 MB)
  25 +* `Sky and background models <https://owncloud.cta-observatory.org/remote.php/webdav/1dc/models.tar.gz>`_ (0.9 GB)
30 26  
31 27 You can also download the files using the ``wget`` tool from the command
32 28 line by typing:
33 29  
34 30 .. code-block:: bash
35 31  
36   - $ wget https://owncloud.cta-observatory.org/remote.php/webdav/1dc.south/gps-south.tar.gz --user=<user> --ask-password
37   - $ wget https://owncloud.cta-observatory.org/remote.php/webdav/1dc.south/gc-south.tar.gz --user=<user> --ask-password
38   - $ wget https://owncloud.cta-observatory.org/remote.php/webdav/1dc.south/egal-south.tar.gz --user=<user> --ask-password
39   - $ wget https://owncloud.cta-observatory.org/remote.php/webdav/1dc.south/caldb-south.tar.gz --user=<user> --ask-password
40   - $ wget https://owncloud.cta-observatory.org/remote.php/webdav/1dc.south/models-south.tar.gz --user=<user> --ask-password
41   - $ wget https://owncloud.cta-observatory.org/remote.php/webdav/1dc.south/obs-south.tar.gz --user=<user> --ask-password
  32 + $ wget https://owncloud.cta-observatory.org/remote.php/webdav/1dc/gps.tar.gz --user=<user> --ask-password
  33 + $ wget https://owncloud.cta-observatory.org/remote.php/webdav/1dc/gc.tar.gz --user=<user> --ask-password
  34 + $ wget https://owncloud.cta-observatory.org/remote.php/webdav/1dc/egal.tar.gz --user=<user> --ask-password
  35 + $ wget https://owncloud.cta-observatory.org/remote.php/webdav/1dc/caldb.tar.gz --user=<user> --ask-password
  36 + $ wget https://owncloud.cta-observatory.org/remote.php/webdav/1dc/models.tar.gz --user=<user> --ask-password
42 37  
43 38 .. warning::
44 39 ``<user>`` needs to be replaced by your CTA user name.
... ... @@ -49,29 +44,28 @@ After downloading, uncompress the files at any place by typing
49 44  
50 45 .. code-block:: bash
51 46  
52   - $ tar xfvz gps-south.tar.gz
53   - $ tar xfvz gc-south.tar.gz
54   - $ tar xfvz egal-south.tar.gz
55   - $ tar xfvz caldb-south.tar.gz
56   - $ tar xfvz models-south.tar.gz
57   - $ tar xfvz obs-south.tar.gz
  47 + $ tar xfvz gps.tar.gz
  48 + $ tar xfvz gc.tar.gz
  49 + $ tar xfvz egal.tar.gz
  50 + $ tar xfvz caldb.tar.gz
  51 + $ tar xfvz models.tar.gz
58 52  
59   -You should now have a folder named ``1dc.south`` in your current working
  53 +You should now have a folder named ``1dc`` in your current working
60 54 directory with the following structure:
61 55  
62 56 .. code-block:: bash
63 57  
64   - 1dc.south/
65   - 1dc.south/caldb
66   - 1dc.south/data
67   - 1dc.south/models
68   - 1dc.south/obs
  58 + 1dc/
  59 + 1dc/caldb
  60 + 1dc/data
  61 + 1dc/models
  62 + 1dc/obs
69 63  
70 64 Before continuing, please set the following environment variables:
71 65  
72 66 .. code-block:: bash
73 67  
74   - $ export CTADATA=$PWD/1dc.south
  68 + $ export CTADATA=$PWD/1dc
75 69 $ export CALDB=$CTADATA/caldb
76 70  
77 71 .. note::
... ...
doc/source/users/tutorials/1dc/getting_tools.rst
  View file @408113a
... ... @@ -6,14 +6,14 @@ Getting the analysis tools
6 6 We recommend that you use ctools to analyse the data from the
7 7 :ref:`first CTA Data Challenge <glossary_1dc>`.
8 8  
9   -The reference version for the Data Challenge is ``ctools-1.3.0``.
10   -``ctools-1.3.0`` depends on ``gammalib-1.3.0``. You may either download
  9 +The reference version for the Data Challenge is ``ctools-1.4.0``.
  10 +``ctools-1.4.0`` depends on ``gammalib-1.4.0``. You may either download
11 11 the source code for both packages or use a pre-compiled binary package for
12 12 Mac OS X that includes all necessary code:
13 13  
14   -* `Mac OS X binary package <http://cta.irap.omp.eu/ctools/releases/ctools/ctools-1.3.0-macosx10.7.dmg>`_ (Mac OS X 10.7+)
15   -* `GammaLib <http://cta.irap.omp.eu/ctools/releases/gammalib/gammalib-1.3.0.tar.gz>`_ source code tarball
16   -* `ctools <http://cta.irap.omp.eu/ctools/releases/ctools/ctools-1.3.0.tar.gz>`_ source code tarball
  14 +* `Mac OS X binary package <http://cta.irap.omp.eu/ctools/releases/ctools/ctools-1.4.0-macosx10.7.dmg>`_ (Mac OS X 10.7+)
  15 +* `GammaLib <http://cta.irap.omp.eu/ctools/releases/gammalib/gammalib-1.4.0.tar.gz>`_ source code tarball
  16 +* `ctools <http://cta.irap.omp.eu/ctools/releases/ctools/ctools-1.4.0.tar.gz>`_ source code tarball
17 17  
18 18 After downloading, configure GammaLib and ctools as follows:
19 19  
... ...
doc/source/users/tutorials/1dc/scope.rst
  View file @408113a
... ... @@ -36,11 +36,7 @@ were simulated from high-level
36 36 that correspond to an ideal CTA with good and stable atmosphere and instrument
37 37 conditions; only zenith angles of 20 degrees and 40 degrees were
38 38 simulated.
39   -
40   -Data are provided for the baseline arrays. So far only data for the South array
41   -were simulated, data for the North array will be provided once the
42   -:ref:`instrument response functions <glossary_irf>`
43   -for the North array are available.
  39 +Data are provided for the baseline arrays.
44 40  
45 41 Three Key Science Projects (KSPs) were simulated using realistic pointing
46 42 patterns as defined in the CTA Science Case document:
... ...