Commit 456d446b842bdd789ecf781daee27eb766723250
Set local language to English (#1370)
Showing
3 changed files
with
39 additions
and
172 deletions
ChangeLog
NEWS
| 1 | -New Features and Important Changes in ctools 1.2.0 | 1 | +New Features and Important Changes in ctools 1.3.0.dev1 |
| 2 | 2 | ||
| 3 | -9 February 2017 | 3 | +13 March 2017 |
| 4 | 4 | ||
| 5 | 5 | ||
| 6 | Introduction | 6 | Introduction |
| @@ -11,249 +11,108 @@ ctools release with respect to the precedent release. | @@ -11,249 +11,108 @@ ctools release with respect to the precedent release. | ||
| 11 | 11 | ||
| 12 | Configuration | 12 | Configuration |
| 13 | ------------- | 13 | ------------- |
| 14 | -The testing.py script has been modified so that cscripts that are executed | ||
| 15 | -from the command line are included in the coverage reports (#1827). | 14 | +None |
| 16 | 15 | ||
| 17 | 16 | ||
| 18 | Python interface | 17 | Python interface |
| 19 | ---------------- | 18 | ---------------- |
| 20 | -A pars() method has been added to the Python interface of all ctools and | ||
| 21 | -cscripts that allows assigning parameters from a dictionary or retrieving | ||
| 22 | -all parameters in a dictionary (#1838). | 19 | +None |
| 23 | 20 | ||
| 24 | 21 | ||
| 25 | Support model | 22 | Support model |
| 26 | ------------- | 23 | ------------- |
| 27 | -The ctobservation base class that derives from the ctool base class was | ||
| 28 | -introduced to provide a common base class for all ctools that hold an | ||
| 29 | -observation container. The class implements the following methods: | ||
| 30 | -- obs() Returns reference to observation container | ||
| 31 | -- first_unbinned_observation() First unbinned CTA observation in container | ||
| 32 | -- next_unbinned_observation() Next unbinned CTA observation in container | ||
| 33 | -The following ctools derive from the class: | ||
| 34 | -- ctbin | ||
| 35 | -- ctbkgcube | ||
| 36 | -- ctcubemask | ||
| 37 | -- ctedispcube | ||
| 38 | -- ctexpcube | ||
| 39 | -- ctmodel | ||
| 40 | -- ctobssim | ||
| 41 | -- ctpsfcube | ||
| 42 | -- ctselect | ||
| 43 | -- ctskymap | ||
| 44 | - | ||
| 45 | -The ctlikelihood base class that derives from the ctobservation base class | ||
| 46 | -was introduced to provide a common base class for all ctools that perform | ||
| 47 | -maximum likelihood optimisations. The class holds an optimizer member. The | ||
| 48 | -class implements the following methods: | ||
| 49 | -- opt() Returns pointer to optimizer | ||
| 50 | -- evaluate() Evaluates log-likelihood at a given parameter value | ||
| 51 | -The following ctools derive from the class: | ||
| 52 | -- ctbutterfly | ||
| 53 | -- cterror | ||
| 54 | -- ctlike | ||
| 55 | -- cttsmap | ||
| 56 | -- ctulimit | ||
| 57 | - | ||
| 58 | -The introduction of these base classes avoids code duplication. | 24 | +The ctool::init_members() method now sets the local language to English |
| 25 | +so that writing commas instead of dots is avoided (#1370). | ||
| 59 | 26 | ||
| 60 | 27 | ||
| 61 | ctobssim - CTA observation simulation | 28 | ctobssim - CTA observation simulation |
| 62 | ------------------------------------- | 29 | ------------------------------------- |
| 63 | -The clear() method now calls GApplication::clear() to conserve the properties | ||
| 64 | -of the tool (#1835). | ||
| 65 | - | ||
| 66 | -A publish() method has been added that publishes the simulated event lists on | ||
| 67 | -a VO hub (#1871). | ||
| 68 | - | ||
| 69 | -The "startindex" parameter has been added to set the initial index for multiple | ||
| 70 | -event lists (#1878). | 30 | +None |
| 71 | 31 | ||
| 72 | 32 | ||
| 73 | ctselect - CTA event selection | 33 | ctselect - CTA event selection |
| 74 | ------------------------------ | 34 | ------------------------------ |
| 75 | -The clear() method now calls GApplication::clear() to conserve the properties | ||
| 76 | -of the tool (#1835). | ||
| 77 | - | ||
| 78 | -The time_reference() method has been removed since the method is part of the | ||
| 79 | -ctool base class, and exposed in Python as _time_reference(). | ||
| 80 | - | ||
| 81 | -A publish() method has been added that publishes the simulated event lists on | ||
| 82 | -a VO hub (#1871). | 35 | +None |
| 83 | 36 | ||
| 84 | 37 | ||
| 85 | ctbin - CTA event binning | 38 | ctbin - CTA event binning |
| 86 | ------------------------- | 39 | ------------------------- |
| 87 | -The ctbin segfaulted when running on an observation container with different | ||
| 88 | -energy thresholds. This problem is now fixed (#1850). | ||
| 89 | - | ||
| 90 | -The clear() method now calls GApplication::clear() to conserve the properties | ||
| 91 | -of the tool (#1835). | ||
| 92 | - | ||
| 93 | -The save() method led to a segmentation violation in case it was applied on an | ||
| 94 | -empty ctbin instance, and specifically in case that the instance contains an | ||
| 95 | -empty observation container. This bug has been fixed (#1835). | ||
| 96 | - | ||
| 97 | -The reference time is now set to the CTA reference type (#1922). | 40 | +None |
| 98 | 41 | ||
| 99 | 42 | ||
| 100 | ctlike - Maximum likelihood fitting | 43 | ctlike - Maximum likelihood fitting |
| 101 | ----------------------------------- | 44 | ----------------------------------- |
| 102 | -The clear() method now calls GApplication::clear() to conserve the properties | ||
| 103 | -of the tool (#1835). | ||
| 104 | - | ||
| 105 | -The class now derives from ctlikelihood (#1828). | ||
| 106 | - | ||
| 107 | -The hidden parameter "outcovmat" has been added that by default is set to "NONE". | ||
| 108 | -If instead a FITS filename is given, ctlike will write the coraviance matrix of | ||
| 109 | -the fit into a FITS file (#1863). | 45 | +None |
| 110 | 46 | ||
| 111 | 47 | ||
| 112 | cttsmap - Generation of Test Statistic map | 48 | cttsmap - Generation of Test Statistic map |
| 113 | ------------------------------------------ | 49 | ------------------------------------------ |
| 114 | -The clear() method now calls GApplication::clear() to conserve the properties | ||
| 115 | -of the tool (#1835). | ||
| 116 | - | ||
| 117 | -The class now derives from ctlikelihood (#1828). | 50 | +None |
| 118 | 51 | ||
| 119 | 52 | ||
| 120 | ctskymap - CTA sky mapping | 53 | ctskymap - CTA sky mapping |
| 121 | -------------------------- | 54 | -------------------------- |
| 122 | -The clear() method now calls GApplication::clear() to conserve the properties | ||
| 123 | -of the tool (#1835). | ||
| 124 | - | ||
| 125 | -The ctskymap::map() method has been renamed to ctskymap::skymap() to avoid a | ||
| 126 | -name conflict with Python (#1828). | ||
| 127 | - | ||
| 128 | -The tool now also supports subtraction of background models that can be enabled | ||
| 129 | -using the "bkgsubtract" parameter. If this parameter is set to "IRF" the | ||
| 130 | -background templates shipped with the Instrument Response Function will be | ||
| 131 | -subtracted from the sky map (#1882). | 55 | +None |
| 132 | 56 | ||
| 133 | 57 | ||
| 134 | ctmodel - CTA counts cube modelling | 58 | ctmodel - CTA counts cube modelling |
| 135 | ----------------------------------- | 59 | ----------------------------------- |
| 136 | -The clear() method now calls GApplication::clear() to conserve the properties | ||
| 137 | -of the tool (#1835). | 60 | +None |
| 138 | 61 | ||
| 139 | 62 | ||
| 140 | ctexpcube - CTA exposure cube generation | 63 | ctexpcube - CTA exposure cube generation |
| 141 | ---------------------------------------- | 64 | ---------------------------------------- |
| 142 | -Set hidden "addbounds" parameter by default to "no" (#1819). | ||
| 143 | - | ||
| 144 | -The clear() method now calls GApplication::clear() to conserve the properties | ||
| 145 | -of the tool (#1835). | 65 | +None |
| 146 | 66 | ||
| 147 | 67 | ||
| 148 | ctpsfcube - CTA point spread function cube generation | 68 | ctpsfcube - CTA point spread function cube generation |
| 149 | ----------------------------------------------------- | 69 | ----------------------------------------------------- |
| 150 | -Set hidden "addbounds" parameter by default to "no" (#1819). | ||
| 151 | - | ||
| 152 | -The clear() method now calls GApplication::clear() to conserve the properties | ||
| 153 | -of the tool (#1835). | 70 | +None |
| 154 | 71 | ||
| 155 | 72 | ||
| 156 | ctedispcube - CTA energy dispersion cube generation | 73 | ctedispcube - CTA energy dispersion cube generation |
| 157 | --------------------------------------------------- | 74 | --------------------------------------------------- |
| 158 | -Set hidden "addbounds" parameter by default to "no" (#1819). | ||
| 159 | - | ||
| 160 | -The clear() method now calls GApplication::clear() to conserve the properties | ||
| 161 | -of the tool (#1835). | 75 | +None |
| 162 | 76 | ||
| 163 | 77 | ||
| 164 | ctbkgcube - CTA background cube generation | 78 | ctbkgcube - CTA background cube generation |
| 165 | ------------------------------------------ | 79 | ------------------------------------------ |
| 166 | -Set hidden "addbounds" parameter by default to "no" (#1819). | ||
| 167 | - | ||
| 168 | -The clear() method now calls GApplication::clear() to conserve the properties | ||
| 169 | -of the tool (#1835). | 80 | +None |
| 170 | 81 | ||
| 171 | 82 | ||
| 172 | ctmapcube - CTA map cube generation | 83 | ctmapcube - CTA map cube generation |
| 173 | ----------------------------------- | 84 | ----------------------------------- |
| 174 | -The clear() method now calls GApplication::clear() to conserve the properties | ||
| 175 | -of the tool (#1835). | 85 | +None |
| 176 | 86 | ||
| 177 | 87 | ||
| 178 | ctcubemask - CTA cube filtering | 88 | ctcubemask - CTA cube filtering |
| 179 | ------------------------------- | 89 | ------------------------------- |
| 180 | -The clear() method now calls GApplication::clear() to conserve the properties | ||
| 181 | -of the tool (#1835). | 90 | +None |
| 182 | 91 | ||
| 183 | 92 | ||
| 184 | ctbutterfly - Generate butterfly diagrams | 93 | ctbutterfly - Generate butterfly diagrams |
| 185 | ----------------------------------------- | 94 | ----------------------------------------- |
| 186 | -The clear() method now calls GApplication::clear() to conserve the properties | ||
| 187 | -of the tool (#1835). | 95 | +None |
| 188 | 96 | ||
| 189 | 97 | ||
| 190 | ctulimit - Compute upper limit | 98 | ctulimit - Compute upper limit |
| 191 | ------------------------------ | 99 | ------------------------------ |
| 192 | -The clear() method now calls GApplication::clear() to conserve the properties | ||
| 193 | -of the tool (#1835). | ||
| 194 | - | ||
| 195 | -The tool now also supports spectral models with the new naming conventions, and | ||
| 196 | -in particular the "PhotonFlux" and "EnergyFlux" names (#1832). | ||
| 197 | - | ||
| 198 | -The class now derives from ctlikelihood (#1828). | ||
| 199 | - | ||
| 200 | -The tool now makes sure that the intensity parameter of the source of interest | ||
| 201 | -is free in the model optimisation that preceeds the upper limit computation. | 100 | +None |
| 202 | 101 | ||
| 203 | 102 | ||
| 204 | cterror - Likelihood profile error computation | 103 | cterror - Likelihood profile error computation |
| 205 | ---------------------------------------------- | 104 | ---------------------------------------------- |
| 206 | -The clear() method now calls GApplication::clear() to conserve the properties | ||
| 207 | -of the tool (#1835). | ||
| 208 | - | ||
| 209 | -The class now derives from ctlikelihood (#1828). | 105 | +None |
| 210 | 106 | ||
| 211 | 107 | ||
| 212 | cscripts | 108 | cscripts |
| 213 | -------- | 109 | -------- |
| 214 | -Add the support modules "modutils" and "ioutils" to the cscripts module and | ||
| 215 | -remove the obsolete functions fit(), cterror(), cntmap() and modmap() from the | ||
| 216 | -"obsutils" module (#1830). | ||
| 217 | - | ||
| 218 | -The csroot2caldb script now takes the zenith and azimuth angles as parameters | ||
| 219 | -and writes them into the calibration database (#1835). | ||
| 220 | - | ||
| 221 | -Add csviscube script that computes the visibility cube providing the number | ||
| 222 | -of hours that a given position on the sky is observable under a given zenith | ||
| 223 | -angle by an IACT array during a given time period. The tool implements so far | ||
| 224 | -a Sun constraint, but no Moon constraint (#1835). | ||
| 225 | - | ||
| 226 | -Add publish() method to cslightcrv and csspec that publishes the results on a | ||
| 227 | -VO hub (#1871). | ||
| 228 | - | ||
| 229 | -Fix energy boundary handling in cssens that has been corrupted during code | ||
| 230 | -refactoring (#1873). | ||
| 231 | - | ||
| 232 | -Add csmodelselect script that allows selecting models from a model definition | ||
| 233 | -XML file (#1879). | ||
| 234 | - | ||
| 235 | -Add csobsselect script that allows selecting observations from an observation | ||
| 236 | -definition XML file (#1881). | ||
| 237 | - | ||
| 238 | -Add cssrcdetect script to detect sources in a sky map (#1617). | ||
| 239 | - | ||
| 240 | -The "ds9file" parameters were changed to "outds9file" to be consistent with | ||
| 241 | -the naming conventions. | ||
| 242 | - | ||
| 243 | -Improve the upper limit computation in the cslightcrv script. Now all source | ||
| 244 | -parameters, except the source intensity, are set to the initial values given | ||
| 245 | -in the model definition file for upper limit computation. | ||
| 246 | - | ||
| 247 | -The cslightcrv script no longer accepts counts cubes on input as no light | ||
| 248 | -curves can be derived from counts cubes (#1920). | 110 | +None |
| 249 | 111 | ||
| 250 | 112 | ||
| 251 | Examples | 113 | Examples |
| 252 | -------- | 114 | -------- |
| 253 | -Add show_lightcurve script to display a light curve. | ||
| 254 | - | ||
| 255 | -Replace has_key() by "in" in example scripts for Python 3.x compatibility | ||
| 256 | -(#1924). | 115 | +None |
| 257 | 116 | ||
| 258 | 117 | ||
| 259 | caldb | 118 | caldb |
doc/source/users/user_manual/getting_started/response.rst
| @@ -37,16 +37,16 @@ CTA response functions | @@ -37,16 +37,16 @@ CTA response functions | ||
| 37 | ~~~~~~~~~~~~~~~~~~~~~~ | 37 | ~~~~~~~~~~~~~~~~~~~~~~ |
| 38 | 38 | ||
| 39 | The instrument response functions for CTA are factorised into | 39 | The instrument response functions for CTA are factorised into |
| 40 | -the effective area :math:`A_{\rm eff}(d, p, E, t)` (units :math:`cm^2`), | ||
| 41 | -the point spread function :math:`PSF(p' | d, p, E, t)`, | ||
| 42 | -and the energy dispersion :math:`E_{\rm disp}(E' | d, p, E, t)` | 40 | +the effective area :math:`A_{\rm eff}(p, E, t)` (units :math:`cm^2`), |
| 41 | +the point spread function :math:`PSF(p' | p, E, t)`, | ||
| 42 | +and the energy dispersion :math:`E_{\rm disp}(E' | p, E, t)` | ||
| 43 | following: | 43 | following: |
| 44 | 44 | ||
| 45 | .. math:: | 45 | .. math:: |
| 46 | - R(p', E', t' | d, p, E, t) = | ||
| 47 | - A_{\rm eff}(d, p, E, t) \times | ||
| 48 | - PSF(p' | d, p, E, t) \times | ||
| 49 | - E_{\rm disp}(E' | d, p, E, t) | 46 | + R(p', E', t' | p, E, t) = |
| 47 | + A_{\rm eff}(p, E, t) \times | ||
| 48 | + PSF(p' | p, E, t) \times | ||
| 49 | + E_{\rm disp}(E' | p, E, t) | ||
| 50 | 50 | ||
| 51 | ctools are shipped with response functions for the northern and southern | 51 | ctools are shipped with response functions for the northern and southern |
| 52 | arrays, and variants are available that have been optimised for exposure | 52 | arrays, and variants are available that have been optimised for exposure |