diff --git a/doc/source/users/tutorials/1dc/data_organisation.rst b/doc/source/users/tutorials/1dc/data_organisation.rst index f5bfe74..81d913c 100644 --- a/doc/source/users/tutorials/1dc/data_organisation.rst +++ b/doc/source/users/tutorials/1dc/data_organisation.rst @@ -6,7 +6,7 @@ Data organisation Layout ^^^^^^ -The content of the ``1dc.south`` folder should be as follows: +The content of the ``1dc`` folder should be as follows: .. code-block:: bash @@ -20,16 +20,16 @@ The content of the ``1dc.south`` folder should be as follows: data/ data/baseline/ data/baseline/egal - data/baseline/egal/egal_baseline_220000.fits - data/baseline/egal/egal_baseline_220001.fits + data/baseline/egal/egal_baseline_210000.fits + data/baseline/egal/egal_baseline_210001.fits ... data/baseline/gc data/baseline/gc/gc_baseline_310000.fits data/baseline/gc/gc_baseline_310001.fits ... data/baseline/gps - data/baseline/gps/gps_baseline_120000.fits - data/baseline/gps/gps_baseline_120001.fits + data/baseline/gps/gps_baseline_110000.fits + data/baseline/gps/gps_baseline_110001.fits ... models/ models/models_egal.xml @@ -50,8 +50,6 @@ The ``caldb`` folder contains the that are necessary for the analysis of the simulated CTA data. The folder contains the ``1dc`` response that should be used for the :ref:`first CTA Data Challenge `. -Currently only the response functions for CTA South are -available for zenith angles of 20 deg and 40 deg. Specifically, the following response functions are available: +-----------------------+-------+---------------+--------+----------+ @@ -61,6 +59,10 @@ Specifically, the following response functions are available: +-----------------------+-------+---------------+--------+----------+ | ``South_z40_50h`` | South | Baseline | 40 deg | 50 hours | +-----------------------+-------+---------------+--------+----------+ + | ``North_z20_50h`` | North | Baseline | 20 deg | 50 hours | + +-----------------------+-------+---------------+--------+----------+ + | ``North_z40_50h`` | North | Baseline | 40 deg | 50 hours | + +-----------------------+-------+---------------+--------+----------+ Event data @@ -80,13 +82,13 @@ table below: +-----------------------------------+---------------------+---------------------+---------------------+ | Parameter | GPS | GC | EGAL | +===================================+=====================+=====================+=====================+ - | Number of observations | 2046 | 1671 | 489 | + | Number of observations | 3270 | 1671 | 1271 | +-----------------------------------+---------------------+---------------------+---------------------+ | Duration of each observation | 1800 s | 1800 s | 1500 s | +-----------------------------------+---------------------+---------------------+---------------------+ | Deadtime fraction | 2% | 2% | 2% | +-----------------------------------+---------------------+---------------------+---------------------+ - | Total exposure time of simulation | 1023 h | 835.5 h | 203.75 h | + | Total exposure time of simulation | 1635 h | 835.5 h | 529.58 h | +-----------------------------------+---------------------+---------------------+---------------------+ | Simulated event energies | 30 GeV - 160 TeV | 30 GeV - 160 TeV | 30 GeV - 160 TeV | +-----------------------------------+---------------------+---------------------+---------------------+ @@ -94,7 +96,7 @@ table below: +-----------------------------------+---------------------+---------------------+---------------------+ | Start date of observations | 2021-01-01T11:58:51 | 2021-01-01T11:58:51 | 2021-01-01T11:58:51 | +-----------------------------------+---------------------+---------------------+---------------------+ - | End date of observations | 2021-04-18T18:52:51 | 2021-03-29T21:32:51 | 2021-02-11T20:29:51 | + | End date of observations | 2021-04-18T18:52:51 | 2021-03-29T21:32:51 | 2021-02-25T14:38:51 | +-----------------------------------+---------------------+---------------------+---------------------+ diff --git a/doc/source/users/tutorials/1dc/event_file.png b/doc/source/users/tutorials/1dc/event_file.png index e0e3d8a..0c53632 100644 --- a/doc/source/users/tutorials/1dc/event_file.png +++ b/doc/source/users/tutorials/1dc/event_file.png diff --git a/doc/source/users/tutorials/1dc/event_header.png b/doc/source/users/tutorials/1dc/event_header.png index 1e447e0..bdca0f1 100644 --- a/doc/source/users/tutorials/1dc/event_header.png +++ b/doc/source/users/tutorials/1dc/event_header.png diff --git a/doc/source/users/tutorials/1dc/event_list.png b/doc/source/users/tutorials/1dc/event_list.png index 140688d..7847132 100644 --- a/doc/source/users/tutorials/1dc/event_list.png +++ b/doc/source/users/tutorials/1dc/event_list.png diff --git a/doc/source/users/tutorials/1dc/getting_data.rst b/doc/source/users/tutorials/1dc/getting_data.rst index 7c38f2c..7bb482e 100644 --- a/doc/source/users/tutorials/1dc/getting_data.rst +++ b/doc/source/users/tutorials/1dc/getting_data.rst @@ -14,31 +14,26 @@ Galactic Centre Survey and the Extragalactic Survey, :ref:`instrument response functions (IRFs) `, and the :ref:`model definition files ` that were used for the simulation. -In addition, ctools metadata, including -:ref:`observation definition files ` -are available. The data were split into the separate files that can be downloaded by clicking on the following links: -* `Galactic Plane Survey `_ (6.1 GB) -* `Galactic Centre Survey `_ (4.9 GB) -* `Extragalactic Survey `_ (1.1 GB) -* `Instrument Response Functions `_ (0.1 MB) -* `Sky and background models `_ (0.9 GB) -* `ctools metadata `_ (0.2 MB) +* `Galactic Plane Survey `_ (8.3 GB) +* `Galactic Centre Survey `_ (4.4 GB) +* `Extragalactic Survey `_ (2.5 GB) +* `Instrument Response Functions `_ (1.2 MB) +* `Sky and background models `_ (0.9 GB) You can also download the files using the ``wget`` tool from the command line by typing: .. code-block:: bash - $ wget https://owncloud.cta-observatory.org/remote.php/webdav/1dc.south/gps-south.tar.gz --user= --ask-password - $ wget https://owncloud.cta-observatory.org/remote.php/webdav/1dc.south/gc-south.tar.gz --user= --ask-password - $ wget https://owncloud.cta-observatory.org/remote.php/webdav/1dc.south/egal-south.tar.gz --user= --ask-password - $ wget https://owncloud.cta-observatory.org/remote.php/webdav/1dc.south/caldb-south.tar.gz --user= --ask-password - $ wget https://owncloud.cta-observatory.org/remote.php/webdav/1dc.south/models-south.tar.gz --user= --ask-password - $ wget https://owncloud.cta-observatory.org/remote.php/webdav/1dc.south/obs-south.tar.gz --user= --ask-password + $ wget https://owncloud.cta-observatory.org/remote.php/webdav/1dc/gps.tar.gz --user= --ask-password + $ wget https://owncloud.cta-observatory.org/remote.php/webdav/1dc/gc.tar.gz --user= --ask-password + $ wget https://owncloud.cta-observatory.org/remote.php/webdav/1dc/egal.tar.gz --user= --ask-password + $ wget https://owncloud.cta-observatory.org/remote.php/webdav/1dc/caldb.tar.gz --user= --ask-password + $ wget https://owncloud.cta-observatory.org/remote.php/webdav/1dc/models.tar.gz --user= --ask-password .. warning:: ```` needs to be replaced by your CTA user name. @@ -49,29 +44,28 @@ After downloading, uncompress the files at any place by typing .. code-block:: bash - $ tar xfvz gps-south.tar.gz - $ tar xfvz gc-south.tar.gz - $ tar xfvz egal-south.tar.gz - $ tar xfvz caldb-south.tar.gz - $ tar xfvz models-south.tar.gz - $ tar xfvz obs-south.tar.gz + $ tar xfvz gps.tar.gz + $ tar xfvz gc.tar.gz + $ tar xfvz egal.tar.gz + $ tar xfvz caldb.tar.gz + $ tar xfvz models.tar.gz -You should now have a folder named ``1dc.south`` in your current working +You should now have a folder named ``1dc`` in your current working directory with the following structure: .. code-block:: bash - 1dc.south/ - 1dc.south/caldb - 1dc.south/data - 1dc.south/models - 1dc.south/obs + 1dc/ + 1dc/caldb + 1dc/data + 1dc/models + 1dc/obs Before continuing, please set the following environment variables: .. code-block:: bash - $ export CTADATA=$PWD/1dc.south + $ export CTADATA=$PWD/1dc $ export CALDB=$CTADATA/caldb .. note:: diff --git a/doc/source/users/tutorials/1dc/getting_tools.rst b/doc/source/users/tutorials/1dc/getting_tools.rst index 0bca36d..d117fad 100644 --- a/doc/source/users/tutorials/1dc/getting_tools.rst +++ b/doc/source/users/tutorials/1dc/getting_tools.rst @@ -6,14 +6,14 @@ Getting the analysis tools We recommend that you use ctools to analyse the data from the :ref:`first CTA Data Challenge `. -The reference version for the Data Challenge is ``ctools-1.3.0``. -``ctools-1.3.0`` depends on ``gammalib-1.3.0``. You may either download +The reference version for the Data Challenge is ``ctools-1.4.0``. +``ctools-1.4.0`` depends on ``gammalib-1.4.0``. You may either download the source code for both packages or use a pre-compiled binary package for Mac OS X that includes all necessary code: -* `Mac OS X binary package `_ (Mac OS X 10.7+) -* `GammaLib `_ source code tarball -* `ctools `_ source code tarball +* `Mac OS X binary package `_ (Mac OS X 10.7+) +* `GammaLib `_ source code tarball +* `ctools `_ source code tarball After downloading, configure GammaLib and ctools as follows: diff --git a/doc/source/users/tutorials/1dc/scope.rst b/doc/source/users/tutorials/1dc/scope.rst index f4882fc..7ed4f85 100644 --- a/doc/source/users/tutorials/1dc/scope.rst +++ b/doc/source/users/tutorials/1dc/scope.rst @@ -36,11 +36,7 @@ were simulated from high-level that correspond to an ideal CTA with good and stable atmosphere and instrument conditions; only zenith angles of 20 degrees and 40 degrees were simulated. - -Data are provided for the baseline arrays. So far only data for the South array -were simulated, data for the North array will be provided once the -:ref:`instrument response functions ` -for the North array are available. +Data are provided for the baseline arrays. Three Key Science Projects (KSPs) were simulated using realistic pointing patterns as defined in the CTA Science Case document: