diff --git a/doc/source/users/tutorials/1dc/data_organisation.rst b/doc/source/users/tutorials/1dc/data_organisation.rst index 81d913c..89e00ea 100644 --- a/doc/source/users/tutorials/1dc/data_organisation.rst +++ b/doc/source/users/tutorials/1dc/data_organisation.rst @@ -17,6 +17,10 @@ The content of the ``1dc`` folder should be as follows: caldb/data/cta/1dc/caldb.indx caldb/data/cta/1dc/bcf ... + data/baseline/agn + data/baseline/agn/agn_baseline_510000.fits + data/baseline/agn/agn_baseline_510001.fits + ... data/ data/baseline/ data/baseline/egal @@ -32,11 +36,13 @@ The content of the ``1dc`` folder should be as follows: data/baseline/gps/gps_baseline_110001.fits ... models/ + models/models_agn.xml models/models_egal.xml models/models_gc.xml models/models_gps.xml ... obs/ + obs/obs_agn_baseline.xml obs/obs_egal_baseline.xml obs/obs_gc_baseline.xml obs/obs_gps_baseline.xml @@ -75,29 +81,30 @@ and that were stored into FITS files. Event data are split into :ref:`observations ` with a fixed pointing direction (observations are also known as runs). The duration of an observation is 25 minutes for the Extragalactic Survey -and 30 minutes for the Galactic Plane and Centre surveys. -The properties of the event data for all three surveys are summarised in the +and 30 minutes for the Galactic Plane and Centre surveys and the AGN monitoring +program. +The properties of the event data for all simulations are summarised in the table below: - +-----------------------------------+---------------------+---------------------+---------------------+ - | Parameter | GPS | GC | EGAL | - +===================================+=====================+=====================+=====================+ - | 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 | 1635 h | 835.5 h | 529.58 h | - +-----------------------------------+---------------------+---------------------+---------------------+ - | Simulated event energies | 30 GeV - 160 TeV | 30 GeV - 160 TeV | 30 GeV - 160 TeV | - +-----------------------------------+---------------------+---------------------+---------------------+ - | Maximum off-axis angle | 5 deg | 5 deg | 5 deg | - +-----------------------------------+---------------------+---------------------+---------------------+ - | 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-25T14:38:51 | - +-----------------------------------+---------------------+---------------------+---------------------+ + +-----------------------------------+------------------+------------------+------------------+-----------------+ + | Parameter | GPS | GC | EGAL | AGN | + +===================================+==================+==================+==================+=================+ + | Number of observations | 3270 | 1671 | 1271 | 1920 | + +-----------------------------------+------------------+------------------+------------------+-----------------+ + | Duration of each observation | 1800 s | 1800 s | 1500 s | 1800 s | + +-----------------------------------+------------------+------------------+------------------+-----------------+ + | Deadtime fraction | 2% | 2% | 2% | 2% | + +-----------------------------------+------------------+------------------+------------------+-----------------+ + | Total exposure time of simulation | 1635 h | 835.5 h | 529.58 h | 960.00 h | + +-----------------------------------+------------------+------------------+------------------+-----------------+ + | Simulated event energies | 30 GeV - 160 TeV | 30 GeV - 160 TeV | 30 GeV - 160 TeV | 30 GeV - 50 TeV | + +-----------------------------------+------------------+------------------+------------------+-----------------+ + | Maximum off-axis angle | 5 deg | 5 deg | 5 deg | 5 deg | + +-----------------------------------+------------------+------------------+------------------+-----------------+ + | Start date of observations | 2021-01-01 | 2021-01-01 | 2021-01-01 | 2021-01-01 | + +-----------------------------------+------------------+------------------+------------------+-----------------+ + | End date of observations | 2021-04-18 | 2021-03-29 | 2021-02-25 | 2022-07-09 | + +-----------------------------------+------------------+------------------+------------------+-----------------+ Each event file contains the events for an @@ -205,8 +212,8 @@ An example of an ``EVENTS`` table is shown below. Observation Definition Files ^^^^^^^^^^^^^^^^^^^^^^^^^^^^ -The files ``obs_egal_baseline.xml``, ``obs_gc_baseline.xml``, and -``obs_gps_baseline.xml`` are so called +The files ``obs_agn_baseline.xml``, ``obs_egal_baseline.xml``, +``obs_gc_baseline.xml``, and ``obs_gps_baseline.xml`` are so called :ref:`observation definition files ` containing the information (or metadata) of a list of observations. The file is a plain ASCII files in XML format that can be inspected and @@ -218,11 +225,11 @@ Models The ``models`` folder contains the definitions of all source and background models that were used for simulating the data. -The files ``models_egal.xml``, ``models_gc.xml`` and ``models_gps.xml`` are -so called +The files ``models_agn.xml``, ``models_egal.xml``, ``models_gc.xml`` and +``models_gps.xml`` are so called :ref:`model definition files ` collecting the definition of all model components used for the three surveys. -Since the same sky model was used for all surveys the three files are +Since the same sky model was used for all surveys the four files are identical. The other files in the folder are ASCII and FITS files containing spectral, temporal and spatial information that was used in the simulations. diff --git a/doc/source/users/tutorials/1dc/getting_data.rst b/doc/source/users/tutorials/1dc/getting_data.rst index 7bb482e..1f2d331 100644 --- a/doc/source/users/tutorials/1dc/getting_data.rst +++ b/doc/source/users/tutorials/1dc/getting_data.rst @@ -10,7 +10,7 @@ data are available on the You need your usual CTA credentials to download the data. The release contains simulated data for the Galactic Plane Survey, the -Galactic Centre Survey and the Extragalactic Survey, +Galactic Centre Survey, the Extragalactic Survey and the AGN monitoring program, :ref:`instrument response functions (IRFs) `, and the :ref:`model definition files ` that were used for the simulation. @@ -21,6 +21,7 @@ by clicking on the following links: * `Galactic Plane Survey `_ (8.3 GB) * `Galactic Centre Survey `_ (4.4 GB) * `Extragalactic Survey `_ (2.5 GB) +* `AGN monitoring program `_ (??? GB) * `Instrument Response Functions `_ (1.2 MB) * `Sky and background models `_ (0.9 GB) @@ -32,6 +33,7 @@ line by typing: $ 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/agn.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 @@ -47,6 +49,7 @@ After downloading, uncompress the files at any place by typing $ tar xfvz gps.tar.gz $ tar xfvz gc.tar.gz $ tar xfvz egal.tar.gz + $ tar xfvz agn.tar.gz $ tar xfvz caldb.tar.gz $ tar xfvz models.tar.gz diff --git a/doc/source/users/tutorials/1dc/scope.rst b/doc/source/users/tutorials/1dc/scope.rst index 7ed4f85..27a4414 100644 --- a/doc/source/users/tutorials/1dc/scope.rst +++ b/doc/source/users/tutorials/1dc/scope.rst @@ -38,15 +38,16 @@ conditions; only zenith angles of 20 degrees and 40 degrees were simulated. Data are provided for the baseline arrays. -Three Key Science Projects (KSPs) were simulated using realistic pointing +Four Key Science Projects (KSPs) were simulated using realistic pointing patterns as defined in the CTA Science Case document: * the Galactic Plane Scan (GPS) * the Galactic Centre Survey (GC) * the Extragalactic Survey (EGAL) +* an AGN monitoring program (AGN) The source model used for the simulations is distributed together with the data to the CTA Consortium Science Working Groups, so that analysis results can be compared to the Monte Carlo truth. The same source model was used for -the simulation of all three surveys. +all simulations.