diff --git a/doc/source/download.rst b/doc/source/download.rst index d6a6bf5..4ecac75 100644 --- a/doc/source/download.rst +++ b/doc/source/download.rst @@ -15,6 +15,13 @@ Releases The latest ctools release is ``ctools-0.9.0`` (22 May 2015). +.. note:: + + The cscripts in the Mac OS X binary package ctools-0.9.0-macosx10.3.dmg + were not working. If you encounter a problem please download the updated + binary package + `ctools-0.9.1-macosx10.3.dmg `_. + Below a table of ctools releases. Please note that at this stage of the project there is a strict link between the ctools and gammalib versions. Please make sure that you have the corresponding gammalib version installed @@ -30,7 +37,7 @@ gammalib. - Mac OS X package * - `0.9.0 `_ - `0.10.0 `_ - - `ctools-0.9.0-macosx10.3.dmg `_ + - `ctools-0.9.1-macosx10.3.dmg `_ * - `0.8.1 `_ - `0.9.1 `_ - `ctools-00-08-01-macosx10.3.dmg `_ @@ -71,25 +78,46 @@ gammalib. - `0.4.7 `_ - + Git repository -------------- -To clone the ctools source code, type +To clone the gammalib and ctools source codes, type .. code-block:: bash - $ git clone https://cta-git.irap.omp.eu/ctools + $ git clone https://cta-git.irap.omp.eu/gammalib + $ git clone https://cta-git.irap.omp.eu/ctools -This will create a directory named ctools under the current working directory -that will contain the ctools source code. Before you are able to compile the -code you need to generate the configuration file (make sure that you're -actually on the devel branch of the git repository): +This will create directories named gammalib and ctools under the current working +directory that will contain the gammalib and ctools source code. Before you are able +to compile the code you need to generate the configuration file using the +``autogen.sh`` script. Also make sure that you're actually on the devel branch of the git +repository. GammaLib and ctools can be compiled using the following +command sequence (the code will be installed into the ``/usr/local/gamma`` +directory): .. code-block:: bash - $ cd ctools - $ git checkout devel - $ ./autogen.sh + $ cd gammalib + $ git checkout devel + $ ./autogen.sh + $ ./configure + $ make + $ make check + $ sudo make install + $ export GAMMALIB=/usr/local/gamma + $ source $GAMMALIB/bin/gammalib-init.sh + $ cd .. + $ cd ctools + $ git checkout devel + $ ./autogen.sh + $ ./configure + $ make + $ make check + $ sudo make install + $ export CTOOLS=/usr/local/gamma + $ source $CTOOLS/bin/ctools-init.sh .. note:: diff --git a/doc/source/faq.rst b/doc/source/faq.rst index 5197bf7..9f9511b 100644 --- a/doc/source/faq.rst +++ b/doc/source/faq.rst @@ -17,6 +17,7 @@ asked. - :ref:`I want to upgrade ctools, do I have to upgrade GammaLib? ` - :ref:`Why does my ctool complain about missing parameters? ` - :ref:`Should I used binned or unbinned analysis? ` +- :ref:`How precise are ctools? ` .. _faq_ctools_gammalib: @@ -119,3 +120,20 @@ asked. the line may require a prohibitive large number of energy bins for a binned analysis. + +.. _faq_precision: + +.. topic:: How precise are ctools? + + The ctools and gammalib codes have a numerical accuracy of better than 1%. + This means that if you use ctools to determine for example the flux + received from a source or the spectral points of an SED, the relative + precision of the flux or the spectral points is better than 1%. + The same is true for spatial parameters, such as source position or + source extension. + For many cases the actual numerical precision is in fact much better + than 1%, but in any case, it should never be worse. + Note, however, that this does not imply that source parameters can be + determined with CTA with an accuracy of 1%. The accuracy depends in the + end on the precision to which the instrument response function is known, + which should be more in the 10% range.