Commit 64f9f8db348d6a12194d29821460dd547b3d7ec4
1 parent
45c08fff
Update 1DC tutorials
Showing
14 changed files
with
144 additions
and
120 deletions
doc/source/users/tutorials/1dc/data_organisation.rst
| ... | ... | @@ -6,28 +6,40 @@ Data organisation |
| 6 | 6 | Layout |
| 7 | 7 | ^^^^^^ |
| 8 | 8 | |
| 9 | -The content of the ``1dc.pre`` folder should be as follows: | |
| 9 | +The content of the ``1dc.south`` folder should be as follows: | |
| 10 | 10 | |
| 11 | 11 | .. code-block:: bash |
| 12 | 12 | |
| 13 | 13 | caldb/ |
| 14 | 14 | caldb/data |
| 15 | 15 | caldb/data/cta |
| 16 | - caldb/data/cta/prod3b | |
| 17 | - caldb/data/cta/prod3b/caldb.indx | |
| 18 | - caldb/data/cta/prod3b/bcf | |
| 16 | + caldb/data/cta/1dc | |
| 17 | + caldb/data/cta/1dc/caldb.indx | |
| 18 | + caldb/data/cta/1dc/bcf | |
| 19 | 19 | ... |
| 20 | 20 | data/ |
| 21 | 21 | data/baseline/ |
| 22 | + data/baseline/egal | |
| 23 | + data/baseline/egal/egal_baseline_220000.fits | |
| 24 | + data/baseline/egal/egal_baseline_220001.fits | |
| 25 | + ... | |
| 22 | 26 | data/baseline/gc |
| 23 | - data/baseline/gc/gc_baseline_000001.fits | |
| 24 | - data/baseline/gc/gc_baseline_000002.fits | |
| 27 | + data/baseline/gc/gc_baseline_310000.fits | |
| 28 | + data/baseline/gc/gc_baseline_310001.fits | |
| 29 | + ... | |
| 30 | + data/baseline/gps | |
| 31 | + data/baseline/gps/gps_baseline_120000.fits | |
| 32 | + data/baseline/gps/gps_baseline_120001.fits | |
| 25 | 33 | ... |
| 26 | 34 | models/ |
| 35 | + models/models_egal.xml | |
| 27 | 36 | models/models_gc.xml |
| 37 | + models/models_gps.xml | |
| 28 | 38 | ... |
| 29 | 39 | obs/ |
| 40 | + obs/obs_egal_baseline.xml | |
| 30 | 41 | obs/obs_gc_baseline.xml |
| 42 | + obs/obs_gps_baseline.xml | |
| 31 | 43 | |
| 32 | 44 | |
| 33 | 45 | Instrument Response Functions |
| ... | ... | @@ -36,10 +48,10 @@ Instrument Response Functions |
| 36 | 48 | The ``caldb`` folder contains the |
| 37 | 49 | :ref:`Instrument Response Functions <glossary_irf>` |
| 38 | 50 | that are necessary for the analysis of the simulated CTA data. |
| 39 | -The folder contains the ``prod3b`` response that should be used for the | |
| 51 | +The folder contains the ``1dc`` response that should be used for the | |
| 40 | 52 | :ref:`first CTA Data Challenge <glossary_1dc>`. |
| 41 | -In the pre-release, only the response functions for CTA South are | |
| 42 | -available for a zenith angle of 20 deg. | |
| 53 | +Currently only the response functions for CTA South are | |
| 54 | +available for zenith angles of 20 deg and 40 deg. | |
| 43 | 55 | Specifically, the following response functions are available: |
| 44 | 56 | |
| 45 | 57 | +-----------------------+-------+---------------+--------+----------+ |
| ... | ... | @@ -47,27 +59,9 @@ Specifically, the following response functions are available: |
| 47 | 59 | +=======================+=======+===============+========+==========+ |
| 48 | 60 | | ``South_z20_50h`` | South | Baseline | 20 deg | 50 hours | |
| 49 | 61 | +-----------------------+-------+---------------+--------+----------+ |
| 50 | - | ``South_z20_5h`` | South | Baseline | 20 deg | 5 hours | | |
| 51 | - +-----------------------+-------+---------------+--------+----------+ | |
| 52 | - | ``South_z20_0.5h`` | South | Baseline | 20 deg | 30 min | | |
| 53 | - +-----------------------+-------+---------------+--------+----------+ | |
| 54 | - | ``South_TS_z20_50h`` | South | Threshold | 20 deg | 50 hours | | |
| 55 | - +-----------------------+-------+---------------+--------+----------+ | |
| 56 | - | ``South_TS_z20_5h`` | South | Threshold | 20 deg | 5 hours | | |
| 57 | - +-----------------------+-------+---------------+--------+----------+ | |
| 58 | - | ``South_TS_z20_0.5h`` | South | Threshold | 20 deg | 30 min | | |
| 62 | + | ``South_z40_50h`` | South | Baseline | 40 deg | 50 hours | | |
| 59 | 63 | +-----------------------+-------+---------------+--------+----------+ |
| 60 | 64 | |
| 61 | -.. warning:: | |
| 62 | - The **50 hours** | |
| 63 | - :ref:`Instrument Response Functions <glossary_irf>` | |
| 64 | - were used for the **simulation** of the | |
| 65 | - :ref:`first CTA Data Challenge <glossary_1dc>` | |
| 66 | - data. Please use only these response functions for the analysis. If you use | |
| 67 | - :ref:`Observation Definition Files <glossary_obsdef>` | |
| 68 | - for the analysis (see below) the appropriate 50 hours response functions | |
| 69 | - will be used automatically. | |
| 70 | - | |
| 71 | 65 | |
| 72 | 66 | Event data |
| 73 | 67 | ^^^^^^^^^^ |
| ... | ... | @@ -76,9 +70,36 @@ The ``data`` folder contains the calibrated, reconstructed and background |
| 76 | 70 | reduced event data that were procuded for the |
| 77 | 71 | :ref:`first CTA Data Challenge <glossary_1dc>` |
| 78 | 72 | and that were stored into FITS files. |
| 73 | +Event data are split into :ref:`observations <glossary_obs>` with a fixed | |
| 74 | +pointing direction (observations are also known as runs). | |
| 75 | +The duration of an observation is 25 minutes for the Extragalactic Survey | |
| 76 | +and 30 minutes for the Galactic Plane and Centre surveys. | |
| 77 | +The properties of the event data for all three surveys are summarised in the | |
| 78 | +table below: | |
| 79 | + | |
| 80 | + +-----------------------------------+---------------------+---------------------+---------------------+ | |
| 81 | + | Parameter | GPS | GC | EGAL | | |
| 82 | + +===================================+=====================+=====================+=====================+ | |
| 83 | + | Number of observations | 2046 | 1671 | 489 | | |
| 84 | + +-----------------------------------+---------------------+---------------------+---------------------+ | |
| 85 | + | Duration of each observation | 1800 s | 1800 s | 1500 s | | |
| 86 | + +-----------------------------------+---------------------+---------------------+---------------------+ | |
| 87 | + | Deadtime fraction | 2% | 2% | 2% | | |
| 88 | + +-----------------------------------+---------------------+---------------------+---------------------+ | |
| 89 | + | Total exposure time of simulation | 1023 h | 835.5 h | 203.75 h | | |
| 90 | + +-----------------------------------+---------------------+---------------------+---------------------+ | |
| 91 | + | Simulated event energies | 30 GeV - 160 TeV | 30 GeV - 160 TeV | 30 GeV - 160 TeV | | |
| 92 | + +-----------------------------------+---------------------+---------------------+---------------------+ | |
| 93 | + | Maximum off-axis angle | 5 deg | 5 deg | 5 deg | | |
| 94 | + +-----------------------------------+---------------------+---------------------+---------------------+ | |
| 95 | + | Start date of observations | 2021-01-01T11:58:51 | 2021-01-01T11:58:51 | 2021-01-01T11:58:51 | | |
| 96 | + +-----------------------------------+---------------------+---------------------+---------------------+ | |
| 97 | + | End date of observations | 2021-04-18T18:52:51 | 2021-03-29T21:32:51 | 2021-02-11T20:29:51 | | |
| 98 | + +-----------------------------------+---------------------+---------------------+---------------------+ | |
| 99 | + | |
| 100 | + | |
| 79 | 101 | Each event file contains the events for an |
| 80 | -:ref:`observation <glossary_obs>` | |
| 81 | -(or run) of 30 minutes duration and comprises an | |
| 102 | +:ref:`observation <glossary_obs>` and comprises an | |
| 82 | 103 | :ref:`event list <glossary_eventlist>` |
| 83 | 104 | and a |
| 84 | 105 | :ref:`Good Time Intervals <glossary_gti>` |
| ... | ... | @@ -95,7 +116,9 @@ The header of the ``EVENTS`` table contains information about the |
| 95 | 116 | such as |
| 96 | 117 | the start and stop date and time, |
| 97 | 118 | the duration and livetime of the observation, and |
| 98 | -the pointing direction in Right Ascension and Declination (see figure below). | |
| 119 | +the pointing direction in Right Ascension and Declination. | |
| 120 | +In addition, the header contains the names and identifiers of the sources that | |
| 121 | +have been simulated (see figure below). | |
| 99 | 122 | |
| 100 | 123 | .. figure:: event_header.png |
| 101 | 124 | :width: 500px |
| ... | ... | @@ -103,18 +126,6 @@ the pointing direction in Right Ascension and Declination (see figure below). |
| 103 | 126 | |
| 104 | 127 | *Header of an event list* |
| 105 | 128 | |
| 106 | -.. note:: | |
| 107 | - The pointing direction during an observation is fixed. The simulation has | |
| 108 | - the following characteristics: | |
| 109 | - | |
| 110 | - * Number of observations (and pointings): 1673 | |
| 111 | - * Duration of each observation: 1800 sec | |
| 112 | - * Deadtime fraction: 5% | |
| 113 | - * Total exposure time of simulation: 836.5 hours | |
| 114 | - * Simulated event energies: 30 GeV - 120 TeV | |
| 115 | - * Maximum off-axis angle: 5 deg | |
| 116 | - * Start date of observations: 2021-01-01 11:58:51 | |
| 117 | - * End date of observations: 2021-03-30 12:28:51 | |
| 118 | 129 | |
| 119 | 130 | .. warning:: |
| 120 | 131 | Only the following header keywords in the ``EVENTS`` table have meaningful |
| ... | ... | @@ -124,6 +135,10 @@ the pointing direction in Right Ascension and Declination (see figure below). |
| 124 | 135 | * ``DSUNIx`` - Data sub-space unit |
| 125 | 136 | * ``DSVALx`` - Data sub-space value |
| 126 | 137 | * ``DSREFx`` - Data sub-space reference |
| 138 | + * ``NDSKEYS`` - Number of data sub-space keys | |
| 139 | + * ``NMCIDS`` - Number of Monte Carlo identifiers | |
| 140 | + * ``MIDxxxxx`` - Monte Carlo identifier | |
| 141 | + * ``MMNxxxxx`` - Model name for Monte Carlo identifier | |
| 127 | 142 | * ``OBS_ID`` - Observation identifier |
| 128 | 143 | * ``DATE_OBS`` - start date of observation (UTC) |
| 129 | 144 | * ``TIME_OBS`` - start time of observation (UTC) |
| ... | ... | @@ -169,6 +184,8 @@ Each event is characterised by |
| 169 | 184 | +--------------+-------------------------------------------+----------+ |
| 170 | 185 | | ``DETY`` | Reconstructed camera Y coordinate | deg | |
| 171 | 186 | +--------------+-------------------------------------------+----------+ |
| 187 | + | ``MC_ID`` | Monte Carlo identifier | unitless | | |
| 188 | + +--------------+-------------------------------------------+----------+ | |
| 172 | 189 | |
| 173 | 190 | An example of an ``EVENTS`` table is shown below. |
| 174 | 191 | |
| ... | ... | @@ -186,9 +203,10 @@ An example of an ``EVENTS`` table is shown below. |
| 186 | 203 | Observation Definition Files |
| 187 | 204 | ^^^^^^^^^^^^^^^^^^^^^^^^^^^^ |
| 188 | 205 | |
| 189 | -The file ``obs_gc_baseline.xml`` is a so called | |
| 190 | -:ref:`Observation Definition File <glossary_obsdef>` | |
| 191 | -that contains the information (or metadata) of a list of observations. | |
| 206 | +The files ``obs_egal_baseline.xml``, ``obs_gc_baseline.xml``, and | |
| 207 | +``obs_gps_baseline.xml`` are so called | |
| 208 | +:ref:`Observation Definition Files <glossary_obsdef>` | |
| 209 | +containing the information (or metadata) of a list of observations. | |
| 192 | 210 | The file is a plain ASCII files in XML format that can be inspected and |
| 193 | 211 | manipulated by any text editor. |
| 194 | 212 | |
| ... | ... | @@ -198,10 +216,12 @@ Models |
| 198 | 216 | |
| 199 | 217 | The ``models`` folder contains the definitions of all source and background |
| 200 | 218 | models that were used for simulating the data. |
| 201 | -The file ``models_gc.xml`` is a so called | |
| 202 | -:ref:`Model Definition File <glossary_moddef>` | |
| 203 | -that collects the definition of all model components used for the Galactic | |
| 204 | -Centre Survey simulation. | |
| 219 | +The files ``models_egal.xml``, ``models_gc.xml`` and ``models_gps.xml`` are | |
| 220 | +so called | |
| 221 | +:ref:`Model Definition Files <glossary_moddef>` | |
| 222 | +collecting the definition of all model components used for the three surveys. | |
| 223 | +Since the same sky model was used for all surveys the three files are | |
| 224 | +identical. | |
| 205 | 225 | The other files in the folder are ASCII and FITS files containing spectral, |
| 206 | 226 | temporal and spatial information that was used in the simulations. |
| 207 | 227 | ... | ... |
doc/source/users/tutorials/1dc/event_file.png
doc/source/users/tutorials/1dc/event_header.png
doc/source/users/tutorials/1dc/event_list.png
doc/source/users/tutorials/1dc/first_detect.rst
| ... | ... | @@ -40,7 +40,7 @@ sources were detected. |
| 40 | 40 | :width: 400px |
| 41 | 41 | :align: center |
| 42 | 42 | |
| 43 | - *Background subtracted sky map of the events recorded around the Galactic Centre during the Galactic Centre Survey with the detected sources overlaid* | |
| 43 | + *Background subtracted sky map of the events recorded around the Galactic Centre during the Galactic Plane Survey with the detected sources overlaid* | |
| 44 | 44 | |
| 45 | 45 | Below is the content of the |
| 46 | 46 | :ref:`model definition XML file <glossary_moddef>` |
| ... | ... | @@ -67,8 +67,8 @@ for a model fitting with :ref:`ctlike`. |
| 67 | 67 | <parameter name="PivotEnergy" value="1" scale="300000" free="0" /> |
| 68 | 68 | </spectrum> |
| 69 | 69 | <spatialModel type="PointSource"> |
| 70 | - <parameter name="RA" value="266.424004498437" error="0" scale="1" free="1" /> | |
| 71 | - <parameter name="DEC" value="-29.0049010253548" error="0" scale="1" free="1" /> | |
| 70 | + <parameter name="RA" value="266.404485683256" error="0" scale="1" free="1" /> | |
| 71 | + <parameter name="DEC" value="-28.9944817753924" error="0" scale="1" free="1" /> | |
| 72 | 72 | </spatialModel> |
| 73 | 73 | </source> |
| 74 | 74 | <source name="Src002" type="PointSource"> |
| ... | ... | @@ -78,8 +78,8 @@ for a model fitting with :ref:`ctlike`. |
| 78 | 78 | <parameter name="PivotEnergy" value="1" scale="300000" free="0" /> |
| 79 | 79 | </spectrum> |
| 80 | 80 | <spatialModel type="PointSource"> |
| 81 | - <parameter name="RA" value="266.831945177213" error="0" scale="1" free="1" /> | |
| 82 | - <parameter name="DEC" value="-28.1460284439951" error="0" scale="1" free="1" /> | |
| 81 | + <parameter name="RA" value="266.882500217018" error="0" scale="1" free="1" /> | |
| 82 | + <parameter name="DEC" value="-28.1496303606368" error="0" scale="1" free="1" /> | |
| 83 | 83 | </spatialModel> |
| 84 | 84 | </source> |
| 85 | 85 | <source name="Background" type="CTAIrfBackground"> |
| ... | ... | @@ -90,4 +90,3 @@ for a model fitting with :ref:`ctlike`. |
| 90 | 90 | </spectrum> |
| 91 | 91 | </source> |
| 92 | 92 | </source_library> |
| 93 | - | ... | ... |
doc/source/users/tutorials/1dc/first_select_events.rst
| ... | ... | @@ -32,21 +32,17 @@ the original event list file names replaced by the names of the new files: |
| 32 | 32 | |
| 33 | 33 | <?xml version="1.0" encoding="UTF-8" standalone="no"?> |
| 34 | 34 | <observation_list title="observation list"> |
| 35 | - <observation name="GC" id="000414" instrument="CTA"> | |
| 36 | - <parameter name="EventList" file="selected_gc_baseline_000414.fits" /> | |
| 37 | - <parameter name="Calibration" database="prod3b" response="South_z20_50h" /> | |
| 35 | + <observation name="GPS" id="120380" instrument="CTA"> | |
| 36 | + <parameter name="EventList" file="selected_gps_baseline_120380.fits" /> | |
| 37 | + <parameter name="Calibration" database="1dc" response="South_z20_50h" /> | |
| 38 | 38 | </observation> |
| 39 | - <observation name="GC" id="000415" instrument="CTA"> | |
| 40 | - <parameter name="EventList" file="selected_gc_baseline_000415.fits" /> | |
| 41 | - <parameter name="Calibration" database="prod3b" response="South_z20_50h" /> | |
| 42 | - </observation> | |
| 43 | - <observation name="GC" id="000416" instrument="CTA"> | |
| 44 | - <parameter name="EventList" file="selected_gc_baseline_000416.fits" /> | |
| 45 | - <parameter name="Calibration" database="prod3b" response="South_z20_50h" /> | |
| 39 | + <observation name="GPS" id="120381" instrument="CTA"> | |
| 40 | + <parameter name="EventList" file="selected_gps_baseline_120381.fits" /> | |
| 41 | + <parameter name="Calibration" database="1dc" response="South_z20_50h" /> | |
| 46 | 42 | </observation> |
| 47 | 43 | ... |
| 48 | - <observation name="GC" id="000581" instrument="CTA"> | |
| 49 | - <parameter name="EventList" file="selected_gc_baseline_000581.fits" /> | |
| 50 | - <parameter name="Calibration" database="prod3b" response="South_z20_50h" /> | |
| 44 | + <observation name="GPS" id="121177" instrument="CTA"> | |
| 45 | + <parameter name="EventList" file="selected_gps_baseline_121177.fits" /> | |
| 46 | + <parameter name="Calibration" database="1dc" response="South_z20_50h" /> | |
| 51 | 47 | </observation> |
| 52 | 48 | </observation_list> | ... | ... |
doc/source/users/tutorials/1dc/first_select_obs.rst
| ... | ... | @@ -4,7 +4,7 @@ Selecting the relevant observations |
| 4 | 4 | ----------------------------------- |
| 5 | 5 | |
| 6 | 6 | Let's assume that you want to analyse the central region of our Galaxy using |
| 7 | -the data obtained during the Galactic Centre Survey. | |
| 7 | +the data obtained during the Galactic Plane Survey. | |
| 8 | 8 | |
| 9 | 9 | As first step you should create a folder that will contain your analysis |
| 10 | 10 | results and any intermediate data products. In this example we name the |
| ... | ... | @@ -27,42 +27,39 @@ You do this with the :ref:`csobsselect` script by typing: |
| 27 | 27 | .. code-block:: bash |
| 28 | 28 | |
| 29 | 29 | $ csobsselect |
| 30 | - Input event list or observation definition XML file [obs.xml] $CTADATA/obs/obs_gc_baseline.xml | |
| 30 | + Input event list or observation definition XML file [obs.xml] $CTADATA/obs/obs_gps_baseline.xml | |
| 31 | 31 | Pointing selection region shape (CIRCLE|BOX) [CIRCLE] |
| 32 | 32 | Coordinate system (CEL - celestial, GAL - galactic) (CEL|GAL) [CEL] GAL |
| 33 | 33 | Galactic longitude of selection centre (deg) (0-360) [184.56] 0.0 |
| 34 | 34 | Galactic latitude of selection centre (deg) (-90-90) [-5.79] 0.0 |
| 35 | - Radius of selection circle (deg) (0-180) [5.0] 0.1 | |
| 35 | + Radius of selection circle (deg) (0-180) [5.0] 3.0 | |
| 36 | 36 | Output observation definition XML file [outobs.xml] obs.xml |
| 37 | 37 | |
| 38 | 38 | You selected ``CIRCLE`` as the shape of the pointing selection region, |
| 39 | 39 | specified the Galactic Centre as the centre of the selection region, and |
| 40 | -selected all observations with pointing directions within 0.1 degrees from | |
| 41 | -the Galactic Centre from the ``obs_gc_baseline.xml`` file. | |
| 40 | +selected all observations with pointing directions within 3 degrees from | |
| 41 | +the Galactic Centre from the ``obs_gps_baseline.xml`` file. | |
| 42 | 42 | The selected observations are written into the file ``obs.xml`` that will be |
| 43 | 43 | created in the ``my_first_analysis`` folder. |
| 44 | -The content of the file will look as follows: | |
| 44 | +The file will contain the definition of 57 observations and will look as | |
| 45 | +follows: | |
| 45 | 46 | |
| 46 | 47 | .. code-block:: xml |
| 47 | 48 | |
| 48 | 49 | <?xml version="1.0" encoding="UTF-8" standalone="no"?> |
| 49 | 50 | <observation_list title="observation list"> |
| 50 | - <observation name="GC" id="000414" instrument="CTA"> | |
| 51 | - <parameter name="EventList" file="/Users/jurgen/analysis/cta/dc/1dc/validation/milano-noedisp/1dc.pre/data/baseline/gc/gc_baseline_000414.fits.gz" /> | |
| 52 | - <parameter name="Calibration" database="prod3b" response="South_z20_50h" /> | |
| 51 | + <observation name="GPS" id="120380" instrument="CTA"> | |
| 52 | + <parameter name="EventList" file="/Users/jurgen/analysis/cta/dc/1dc/1dc.final/validation/1dc.south/data/baseline/gps/gps_baseline_120380.fits" /> | |
| 53 | + <parameter name="Calibration" database="1dc" response="South_z20_50h" /> | |
| 53 | 54 | </observation> |
| 54 | - <observation name="GC" id="000415" instrument="CTA"> | |
| 55 | - <parameter name="EventList" file="/Users/jurgen/analysis/cta/dc/1dc/validation/milano-noedisp/1dc.pre/data/baseline/gc/gc_baseline_000415.fits.gz" /> | |
| 56 | - <parameter name="Calibration" database="prod3b" response="South_z20_50h" /> | |
| 57 | - </observation> | |
| 58 | - <observation name="GC" id="000416" instrument="CTA"> | |
| 59 | - <parameter name="EventList" file="/Users/jurgen/analysis/cta/dc/1dc/validation/milano-noedisp/1dc.pre/data/baseline/gc/gc_baseline_000416.fits.gz" /> | |
| 60 | - <parameter name="Calibration" database="prod3b" response="South_z20_50h" /> | |
| 55 | + <observation name="GPS" id="120381" instrument="CTA"> | |
| 56 | + <parameter name="EventList" file="/Users/jurgen/analysis/cta/dc/1dc/1dc.final/validation/1dc.south/data/baseline/gps/gps_baseline_120381.fits" /> | |
| 57 | + <parameter name="Calibration" database="1dc" response="South_z20_50h" /> | |
| 61 | 58 | </observation> |
| 62 | 59 | ... |
| 63 | - <observation name="GC" id="000581" instrument="CTA"> | |
| 64 | - <parameter name="EventList" file="/Users/jurgen/analysis/cta/dc/1dc/validation/milano-noedisp/1dc.pre/data/baseline/gc/gc_baseline_000581.fits.gz" /> | |
| 65 | - <parameter name="Calibration" database="prod3b" response="South_z20_50h" /> | |
| 60 | + <observation name="GPS" id="121177" instrument="CTA"> | |
| 61 | + <parameter name="EventList" file="/Users/jurgen/analysis/cta/dc/1dc/1dc.final/validation/1dc.south/data/baseline/gps/gps_baseline_121177.fits" /> | |
| 62 | + <parameter name="Calibration" database="1dc" response="South_z20_50h" /> | |
| 66 | 63 | </observation> |
| 67 | 64 | </observation_list> |
| 68 | 65 | ... | ... |
doc/source/users/tutorials/1dc/first_skymap.png
doc/source/users/tutorials/1dc/first_skymap.rst
| ... | ... | @@ -41,7 +41,7 @@ is shown below: |
| 41 | 41 | :width: 400px |
| 42 | 42 | :align: center |
| 43 | 43 | |
| 44 | - *Sky map of the events recorded around the Galactic Centre during the Galactic Centre Survey* | |
| 44 | + *Sky map of the events recorded around the Galactic Centre during the Galactic Plane Survey* | |
| 45 | 45 | |
| 46 | 46 | The sky map shows a wide-spread distribution of events with a number of sources |
| 47 | 47 | superimposed. |
| ... | ... | @@ -80,4 +80,4 @@ of gamma-ray emission are now clearly discernable. |
| 80 | 80 | :width: 400px |
| 81 | 81 | :align: center |
| 82 | 82 | |
| 83 | - *Background subtracted sky map of the events recorded around the Galactic Centre during the Galactic Centre Survey* | |
| 83 | + *Background subtracted sky map of the events recorded around the Galactic Centre during the Galactic Plane Survey* | ... | ... |
doc/source/users/tutorials/1dc/first_skymap_bkgsubtract.png
doc/source/users/tutorials/1dc/first_skymap_sources.png
doc/source/users/tutorials/1dc/getting_data.rst
| ... | ... | @@ -3,64 +3,75 @@ |
| 3 | 3 | Getting the data |
| 4 | 4 | ================ |
| 5 | 5 | |
| 6 | -A pre-release of the data for the | |
| 6 | +The | |
| 7 | 7 | :ref:`first CTA Data Challenge <glossary_1dc>` |
| 8 | -is available on the | |
| 8 | +data are available on the | |
| 9 | 9 | `CTA ownCloud server <https://owncloud.cta-observatory.org>`_. |
| 10 | 10 | You need your usual CTA credentials to download the data. |
| 11 | -The full | |
| 12 | -:ref:`first CTA Data Challenge <glossary_1dc>` | |
| 13 | -data release is planned for the second half of March 2017. | |
| 14 | 11 | |
| 15 | -The pre-release contains simulated data for the Galactic Centre Survey, | |
| 12 | +The release contains simulated data for the Galactic Plane Survey, the | |
| 13 | +Galactic Centre Survey and the Extragalactic Survey, | |
| 16 | 14 | :ref:`Instrument Response Functions (IRFs) <glossary_irf>`, and the |
| 17 | 15 | :ref:`model definition files <glossary_moddef>` |
| 18 | 16 | that were used for the simulation. |
| 17 | +In addition, ctools metadata, including | |
| 18 | +:ref:`Observation Definition Files <glossary_obsdef>` | |
| 19 | +are available. | |
| 20 | + | |
| 19 | 21 | The data were split into the separate files that can be downloaded |
| 20 | 22 | by clicking on the following links: |
| 21 | 23 | |
| 22 | -* `Galactic Centre Survey <https://owncloud.cta-observatory.org/remote.php/webdav/1dc.pre/gc-pre.tar.gz>`_ (5.9 GB) | |
| 23 | -* `Instrument Response Functions <https://owncloud.cta-observatory.org/remote.php/webdav/1dc.pre/caldb-pre.tar.gz>`_ (0.2 MB) | |
| 24 | -* `Sky and background models <https://owncloud.cta-observatory.org/remote.php/webdav/1dc.pre/models-pre.tar.gz>`_ (0.9 GB) | |
| 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) | |
| 25 | 30 | |
| 26 | 31 | You can also download the files using the ``wget`` tool from the command |
| 27 | 32 | line by typing: |
| 28 | 33 | |
| 29 | 34 | .. code-block:: bash |
| 30 | 35 | |
| 31 | - $ wget https://owncloud.cta-observatory.org/remote.php/webdav/1dc.pre/gc-pre.tar.gz --user=<user> --ask-password | |
| 32 | - $ wget https://owncloud.cta-observatory.org/remote.php/webdav/1dc.pre/caldb-pre.tar.gz --user=<user> --ask-password | |
| 33 | - $ wget https://owncloud.cta-observatory.org/remote.php/webdav/1dc.pre/models-pre.tar.gz --user=<user> --ask-password | |
| 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 | |
| 34 | 42 | |
| 35 | 43 | .. warning:: |
| 36 | 44 | ``<user>`` needs to be replaced by your CTA user name. |
| 37 | 45 | Don't type the ``$`` symbol. It indicates that a command should be typed |
| 38 | - on the command line of a console. | |
| 46 | + on the command line of your terminal. | |
| 39 | 47 | |
| 40 | 48 | After downloading, uncompress the files at any place by typing |
| 41 | 49 | |
| 42 | 50 | .. code-block:: bash |
| 43 | 51 | |
| 44 | - $ tar xfvz gc-pre.tar.gz | |
| 45 | - $ tar xfvz caldb-pre.tar.gz | |
| 46 | - $ tar xfvz models-pre.tar.gz | |
| 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 | 58 | |
| 48 | -You should now have a folder named ``1dc.pre`` in your current working | |
| 59 | +You should now have a folder named ``1dc.south`` in your current working | |
| 49 | 60 | directory with the following structure: |
| 50 | 61 | |
| 51 | 62 | .. code-block:: bash |
| 52 | 63 | |
| 53 | - 1dc.pre/ | |
| 54 | - 1dc.pre/caldb | |
| 55 | - 1dc.pre/data | |
| 56 | - 1dc.pre/models | |
| 57 | - 1dc.pre/obs | |
| 64 | + 1dc.south/ | |
| 65 | + 1dc.south/caldb | |
| 66 | + 1dc.south/data | |
| 67 | + 1dc.south/models | |
| 68 | + 1dc.south/obs | |
| 58 | 69 | |
| 59 | 70 | Before continuing, please set the following environment variables: |
| 60 | 71 | |
| 61 | 72 | .. code-block:: bash |
| 62 | 73 | |
| 63 | - $ export CTADATA=$PWD/1dc.pre | |
| 74 | + $ export CTADATA=$PWD/1dc.south | |
| 64 | 75 | $ export CALDB=$CTADATA/caldb |
| 65 | 76 | |
| 66 | 77 | .. note:: | ... | ... |
doc/source/users/tutorials/1dc/getting_tools.rst
| ... | ... | @@ -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 pre-release of the data is ``ctools-1.2.0``. | |
| 10 | -``ctools-1.2.0`` depends on ``gammalib-1.2.0``. You may either download | |
| 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 | |
| 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.2.0-macosx10.7.dmg>`_ (Mac OS X 10.7+) | |
| 15 | -* `GammaLib <http://cta.irap.omp.eu/ctools/releases/gammalib/gammalib-1.2.0.tar.gz>`_ source code tarball | |
| 16 | -* `ctools <http://cta.irap.omp.eu/ctools/releases/ctools/ctools-1.2.0.tar.gz>`_ source code tarball | |
| 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 | |
| 17 | 17 | |
| 18 | 18 | After downloading, configure GammaLib and ctools as follows: |
| 19 | 19 | ... | ... |
doc/source/users/tutorials/1dc/scope.rst
| ... | ... | @@ -37,9 +37,10 @@ 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 have been |
| 38 | 38 | simulated. |
| 39 | 39 | |
| 40 | -Data are provided for the baseline arrays and the threshold implementation. | |
| 40 | +Data are provided for the baseline arrays. So far only data for the South array | |
| 41 | +were simulated. | |
| 41 | 42 | |
| 42 | -Three Key Science Projects (KSPs) have been simulated using realistic pointing | |
| 43 | +Three Key Science Projects (KSPs) were simulated using realistic pointing | |
| 43 | 44 | patterns as defined in the CTA Science Case document: |
| 44 | 45 | |
| 45 | 46 | * the Galactic Plane Scan (GPS) | ... | ... |