ctools 1.6 release (29 May 2019)

Overview

ctools 1.6 is a major release that adds significant functionality.

In particular, this release provides:

• Support for H.E.S.S. public data release analysis
• Support for Xspec spectral analysis
• Improved computation speed for :ref:`ctskymap` and :ref:`csphagen`
• Parallelisation of various cscripts
• Support for source variability searches
• Support for Python pickeling
• Code Generator to facilitate adding ctools and cscripts

Bug fixes

• :ref:`csspec` now properly propagates instrument name for On/Off observations
• [2883] - :ref:`csresspec` now also works for observation specific models
• [2839] - Fix ring background computation in :ref:`ctskymap` for small roiradius
• [2721] - Apply event bin weighting in :ref:`ctmodel` for stacked computation
• [2694] - Compute DETX and DETY in :ref:`ctmodel` if they are not available
• [2686] - Do no longer set missing boundaries in ctool::get_observations and ctool::setup_observations
• [2682] - Avoid :ref:`ctselect` error in case that RoI radius is unchanged
• [2652] - Defer import of ROOT module in :ref:`csroot2caldb` to run method
• [2456] - Handle zero model for SUBDIV method in show_response.py
• [2448] - Fix bug when using precomputed model in :ref:`csresspec`
• [2420] - Keep existing library path in installation script on Mac OS X

Improvements

• [2878] - Add more spatial models to :ref:`csbkgmodel`
• [2868] - Add GAUSS(E) model to :ref:`csbkgmodel`
• [2842] - Log warning if edisp=no
• Add max_iter parameter to :ref:`ctbutterfly`, :ref:`cterror`, :ref:`ctlike`, :ref:`cttsmap`, :ref:`ctulimit`, and :ref:`cstsmapsplit` to allow controlling the maximum number of fit iterations.
• [2763] - :ref:`ctbkgcube` now requires an input counts cube
• [2725] - Add exclusion_map() methods to :ref:`ctskymap`, :ref:`csphagen`, :ref:`cslightcrv` and :ref:`csphasecrv`
• [2714] - Enable :ref:`ctbin` to produce counts cubes for a joint binned analysis. Rename outcube to outobs parameter.
• [2712] - Add Jupyter notebooks for H.E.S.S. DR1
• [2711] - :ref:`csphagen` now creates appropriate model for likelihood fitting
• [2685] - Add ctbkgcube::cntcube() method Account for varying energy thresholds in :ref:`ctbin` weight computation Unnormalize background cube values in :ref:`ctbkgcube`
• Add use_model_bkg parameter to :ref:`cslightcrv`
• [2671] - Do not skip bins with zero counts in :ref:`csspec`
• [2670] - Use ENERG instead of ETRUE in energy dispersion axis names in :ref:`csroot2caldb`
• [2662] - Add like_accuracy parameter to :ref:`ctbutterfly`, :ref:`cterror`, :ref:`ctlike`, :ref:`cttsmap`, :ref:`ctulimit`, and :ref:`cstsmapsplit` to allow controlling the accuracy of the maximum likelihood computation
• [2659] - Add hidden use_model_bkg parameter to :ref:`csphagen`
• [2656] - Use full RMF true energy range for On/Off analysis in :ref:`csspec`
• [2513] - Transparently update parameter files
• [2498] - Make :ref:`cssrcdetect` more robust
• [2490] - Change formula for number of true energy bins in :ref:`csphagen`
• [2421] - Add nthreads parameter to :ref:`ctobssim`, :ref:`ctbin`, :ref:`ctlike`, :ref:`cterror` and :ref:`ctmodel` to control parallel computations
• [2404] - :ref:`csphagen` produces Xspec compliant data
• Add show_rmf.py example script
• [2343] - Change CTA 3D background BGD keywords to BKG
• [2313] - Add ras() and decs() methods to :ref:`csobsinfo`
• [2312] - Also compute TS in :ref:`csspec` for On/Off analysis using wstat statistic
• [2311] - Allow specifying of input skymap to :ref:`ctskymap` tool
• [2309] - Accelerate IRF and RING background methods in :ref:`ctskymap`
• [2233] - Add upper limit computation is :ref:`csspec` for NODES method
• [2054] - Define MET with respect to the observation time reference or the mjdref user parameter

New features

• [2723] - Add show_significance_distribution.py example script
• [2713] - Add :ref:`ctfindvar` tool
• [2709] - Add code generator
• [2694] - Add :ref:`csbkgmodel` script
• [2421] - Parallelise :ref:`cslightcrv`, :ref:`csphasecrv`, :ref:`csspec`, :ref:`cssens`, :ref:`csphagen`, :ref:`cspull` and :ref:`cstsdist`
• [1938] - Support pickeling of ctools and cscripts in Python

Clean up

• Move ctool::set_obs_bounds() to ctobservation::set_obs_bounds()
• [2758] - CTA background rates are now per ontime
• Remove ctools::is_valid_filename() method
• [2045] - Remove ctools::time_reference constant