From d96093252f0bfb4446958b66ae545bd647c9cedc Mon Sep 17 00:00:00 2001 From: knodlseder <> Date: Wed, 4 Apr 2012 07:50:53 +0000 Subject: [PATCH] Update for ctools-00-04-00 --- doc/html/doc/ctbin.html | 69 +++++++++++++++++++++++++++++++++++++++++++++++---------------------- doc/html/doc/ctlike.html | 55 +++++++++++++------------------------------------------ doc/html/doc/ctobssim.html | 27 ++++++++++++++++++++++----- doc/html/doc/ctselect.html | 53 +++++++++++++++++++++++++++++++++++++++++++++-------- doc/html/download.html | 20 ++++++++++---------- doc/html/home.html | 17 +++++++---------- doc/html/images/survey-pop2.jpg | Bin 0 -> 358144 bytes doc/html/installation.html | 8 ++++---- doc/html/quickstart.html | 48 ++++++++++++++++++++++++++++++------------------ 9 files changed, 178 insertions(+), 119 deletions(-) create mode 100644 doc/html/images/survey-pop2.jpg diff --git a/doc/html/doc/ctbin.html b/doc/html/doc/ctbin.html index 9e3f7d7..298de7b 100644 --- a/doc/html/doc/ctbin.html +++ b/doc/html/doc/ctbin.html @@ -4,7 +4,8 @@ - + +

ctbin

Calculates counts maps for binned maximum @@ -34,7 +35,8 @@ Parameter Usage     -Input event list. +Input event list or observation +definition XML file.   @@ -49,7 +51,22 @@ Parameter Usage     -Output counts map. +Output counts map or observation definition XML file. + + +  +  +  + + +  +(prefix = "cntmap_") +[string] + + +  +  +Prefix for counts maps in observation definition file.   @@ -149,7 +166,8 @@ yet implemented).     -Size of the Right Ascension / Galactic longitude axis (in pixels). +Size of the Right Ascension / +Galactic longitude axis (in pixels).   @@ -164,7 +182,8 @@ yet implemented).     -Size of the Declination / Galactic latitude axis (in pixels). +Size of the Declination / Galactic +latitude axis (in pixels).   @@ -194,14 +213,15 @@ yet implemented).     -Coordinate system (CEL - celestial, GAL - galactic). +Coordinate system (CEL +- celestial, GAL - galactic).       - +   xref [double] @@ -209,7 +229,8 @@ yet implemented).     -Right Ascension / Galactic longitude of image centre +Right Ascension / Galactic longitude +of image centre (J2000, in degrees). @@ -225,7 +246,8 @@ yet implemented).     -Declination / Galactic latitude of image centre (J2000, +Declination / Galactic latitude of +image centre (J2000, in degrees). @@ -235,12 +257,14 @@ in degrees).   -(axisrot = h) [double] +(axisrot += h) [double]     -Rotation angle of image axes (in degrees). +Rotation angle of image axes (in +degrees).   @@ -249,21 +273,20 @@ in degrees).   -proj = CAR [string] +proj += CAR [string]     -Projection method (only AZP,CAR,STG,TAN are supported so far). +Projection method (only AZP,CAR,STG,TAN +are supported so far).       - - -

Standard parameters

@@ -272,7 +295,7 @@ in degrees).   (chatter -= 2) [integer] += 1) [integer]   @@ -301,7 +324,8 @@ task execution     -Specifies whether an existing output counts map should be overwritten. +Specifies whether an existing output +counts map should be overwritten.   @@ -311,7 +335,7 @@ task execution   (debug -= yes) [boolean] += no) [boolean]   @@ -345,8 +369,9 @@ the executable will dump any log file output in the console.

Related FTOOLS


-

Last updated by: Jürgen Knödlseder 16 July -2011 +

Last updated by: Jürgen +Knödlseder 4 April +2012


- + \ No newline at end of file diff --git a/doc/html/doc/ctlike.html b/doc/html/doc/ctlike.html index 15730ef..74524b4 100644 --- a/doc/html/doc/ctlike.html +++ b/doc/html/doc/ctlike.html @@ -4,7 +4,8 @@ - + +

ctlike

Performs binned and unbinned maximum @@ -17,7 +18,9 @@ and source extent from a maximum likelihood analysis of CTA data. The analysis can be done in a binned or an unbinned formulation of the log-likelihood function. For binned analysis, a counts map producted by ctbin is required. For -unbinned analysis, an events list processed by ctselect is required.

+unbinned analysis, an events list processed by ctselect +is required. Based on the input file format, ctlike automatically +selects between binned and unbinned maximum likelihood analysis.


Links


-

Last updated by: Jürgen Knödlseder 8 March -2011 +

Last updated by: Jürgen +Knödlseder 3 April +2012


- + \ No newline at end of file diff --git a/doc/html/doc/ctobssim.html b/doc/html/doc/ctobssim.html index 2e0be02..e5991d6 100644 --- a/doc/html/doc/ctobssim.html +++ b/doc/html/doc/ctobssim.html @@ -144,7 +144,8 @@ in degrees).     -Radius of CTA field of view (simulation cone radius) (in degrees). +Radius of CTA field of view +(simulation cone radius) (in degrees).   @@ -215,6 +216,21 @@ TeV).     + +  +(deadc = 0.95) +[double] + + +  +  +Average deadtime correction factor. + + +  +  +  +

Standard parameters

@@ -263,7 +279,7 @@ event list should be overwritten.   (debug -= yes) [boolean] += no) [boolean]   @@ -297,8 +313,9 @@ the executable will dump any log file output in the console.

Related FTOOLS


-

Last updated by: Jürgen Knödlseder 8 March -2011 +

Last updated by: Jürgen +Knödlseder 3 April +2012


- + \ No newline at end of file diff --git a/doc/html/doc/ctselect.html b/doc/html/doc/ctselect.html index e84c657..b514fad 100644 --- a/doc/html/doc/ctselect.html +++ b/doc/html/doc/ctselect.html @@ -35,7 +35,8 @@ Parameter Usage     -Input event list. +Input event list of observation +definition XML file   @@ -50,7 +51,25 @@ Parameter Usage     -Output event list. +Output event list or observation +definition XML file. + + +  +  +  + + +  +(prefix += "selected_") +[string] + + +  +  +Prefix for output event lists in +observation definition file.   @@ -115,7 +134,8 @@ ROI) centre (in degrees).     -Mission elapsed start time defining the earliest event (in +Mission elapsed start time defining +the earliest event (in seconds). @@ -131,7 +151,8 @@ seconds).     -Mission elapsed stop time defining the latest event (in +Mission elapsed stop time defining +the latest event (in seconds). @@ -171,6 +192,21 @@ TeV).     + +  +(expr = "") +[string] + + +  +  +Additional event selection expression (cfitsio syntax). + + +  +  +  +

Standard parameters

@@ -219,7 +255,7 @@ event list should be overwritten.   (debug -= yes) [boolean] += no) [boolean]   @@ -253,8 +289,9 @@ the executable will dump any log file output in the console.

Related FTOOLS


-

Last updated by: Jürgen Knödlseder 8 March -2011 +

Last updated by: Jürgen +Knödlseder 3 April +2012


- + \ No newline at end of file diff --git a/doc/html/download.html b/doc/html/download.html index c475d4d..20936e4 100644 --- a/doc/html/download.html +++ b/doc/html/download.html @@ -7,18 +7,13 @@

Download

-The latest ctools release is ctools-00-03-00 -(6 October 2011).

+The latest ctools release is ctools-00-04-00 +(3 April 2012).


News: -ctools-00-03-00 and gammalib-00-04-12 are now -available as a -pre-built package for -Mac OS X 10.3 or higher, supporting ppc, i386 and x86_64 architectures -and Python versions 2.5, 2.6 and 2.7. This is our first trial of a -pre-built version. Please report any problems that you encounter with -the package. +ctools-00-04-00 and gammalib-00-05-00 are now +available to support the 1DC activities. Please provide your feedback on the dedicated Sharepoint page.


Latest release

@@ -33,6 +28,11 @@ and gammalib versions.

Mac OS X package +00-04-00 +00-05-00 +ctools-00-04-00-macosx10.3.dmg + + 00-03-00 00-04-12 ctools-00-03-00-macosx10.3.dmg @@ -77,6 +77,6 @@ and gammalib versions.


Last updated by: Jürgen -Knödlseder (21 October 2011) +Knödlseder (4 April 2012)

\ No newline at end of file diff --git a/doc/html/home.html b/doc/html/home.html index bcc3620..c321420 100644 --- a/doc/html/home.html +++ b/doc/html/home.html @@ -2,7 +2,8 @@ Home - + +

ctools

ctools @@ -28,14 +29,9 @@ license version 3.

-Example simulation
+Example simulation
Simulation -of galactic plane scan, composed of 10 half-hour observations, spaced -by -2° in Galactic longitude. A single point source with Crab -spectrum was -simulated at the Galactic centre. The top panel shows the model, the -bottom panel the simulated data. +of galactic plane scan (Dubus et al. 2012). @@ -43,5 +39,6 @@ bottom panel the simulated data.

Last updated by: Jürgen -Knödlseder (6 October 2011)
-

\ No newline at end of file +Knödlseder (4 April 2012)
+

+ \ No newline at end of file diff --git a/doc/html/images/survey-pop2.jpg b/doc/html/images/survey-pop2.jpg new file mode 100644 index 0000000..d45f094 Binary files /dev/null and b/doc/html/images/survey-pop2.jpg differ diff --git a/doc/html/installation.html b/doc/html/installation.html index 3cf1773..49ef02b 100644 --- a/doc/html/installation.html +++ b/doc/html/installation.html @@ -28,7 +28,7 @@ ctools environment

Note: These installation instructions apply to -ctools-00-03-00 +ctools-00-04-00 or later.


@@ -83,13 +83,13 @@ downloading the ctools tarball, save it in an appropriate location (for example /usr/local/gamma/src), and type

-> tar xvfz ctools-00-03-00.tar.gz +> tar xvfz ctools-00-04-00.tar.gz

Step in the created directory using

-> cd ctools-00-03-00 +> cd ctools-00-04-00

and build and install ctools by typing

@@ -246,6 +246,6 @@ Any questions, bug reports, or suggested enhancements related to ctools should b

Last updated by: Jürgen -Knödlseder (6 October 2011) +Knödlseder (4 April 2012)

\ No newline at end of file diff --git a/doc/html/quickstart.html b/doc/html/quickstart.html index b91fe4e..95a5c7e 100644 --- a/doc/html/quickstart.html +++ b/doc/html/quickstart.html @@ -2,7 +2,8 @@ Getting Started - + +

Getting started

First steps with ctools

@@ -377,12 +378,13 @@ and we do the fit by typing:

> ctlike
-Maximum likelihood method [BINNED]
-Calibration database [test/irf] /usr/local/gamma/share/caldb/cta
+Event list, counts map or observation definition +file [test/data/crab_cntmap.fits.gz] cntmap.fits
+Calibration +database [test/irf] /usr/local/gamma/share/caldb/cta
Instrument response function [kb_E_50h_v3]
Source model [test/data/crab.xml] /usr/local/gamma/share/models/crab.xml
-Source model output file [crab_results.xml]
-Counts map [test/data/crab_cntmap.fits.gz] cntmap.fits +Source model output file [crab_results.xml]

Fitting of the data is done in BINNED @@ -672,14 +674,12 @@ in unbinned mode, type the following:

> ctlike
-Maximum likelihood method [BINNED] UNBINNED
+Event list, counts map or observation definition +file [test/data/crab_events.fits.gz] selected_events.fits
Calibration database [test/irf] /usr/local/gamma/share/caldb/cta
Instrument response function [kb_E_50h_v3]
Source model [test/data/crab.xml] /usr/local/gamma/share/models/crab.xml
-Source model output file [crab_results.xml]
-Event data file name [test/data/crab_events.fits.gz] -selected_events.fits -

+Source model output file [crab_results.xml]

You will recognise that ctlike runs much faster in unbinned mode compared to binned mode. This is @@ -784,7 +784,8 @@ seconds of CPU time.


Some -final remarks (updated for ctools-00-02-03)

+final remarks (updated for +ctools-00-02-03)

First you should notice that ctools are in the prototyping phase. If GammaLib and ctatools are @@ -809,7 +810,14 @@ cannot guarantee that it works.

is also only one radial acceptance model defined so far, and you should use the model definition that is given in the example.


-

So far, there are four projection types supported: AZP, CAR, STG, and TAN. You can use them in Galactic (GAL) or celestial (CEL) coordinates.

+

So +far, there are four projection types supported: AZP, +CAR, +STG, +and TAN. +You can use them in Galactic (GAL) +or celestial (CEL) +coordinates.


The instrument response function that has been implemented so far in @@ -817,14 +825,19 @@ GammaLib (yes, it is in GammaLib, not in ctatools) is very simple. It just reads Konrad's effective area files to get the onaxis effective area. It is assumed that the effective area varies with offset angle, and a Gaussian as function of offset angle squared has been implemented -for the functional form of this variation. By default, the sigma of this Gaussian is fixed to 3 deg2. +for the functional form of this variation. By default, the sigma +of this Gaussian is fixed to 3 deg2. This value can not be modified using the ctatools, but it can be altered using the Python interface. In any case, this treatment of the -offset angle dependence is only preliminary and will be changed as soon as a format has been defined for the CTA response functions.

ctobssim +offset angle dependence is only preliminary and will be changed as soon as a +format has been defined for the CTA response functions.

+

+

ctobssim and ctlike query for the name of the instrument response function file, and you may specify different -response files if you want to study the impact of array configuration on the results. To see what is available, type (adjust the +response files if you want to study the impact of array configuration +on the results. To see what is available, type (adjust the path corresponding to your installation directory):

> ls @@ -877,12 +890,11 @@ Help

Any questions, bug reports, or suggested enhancements related to ctatools and GammaLib should be submitted -to knodlseder@cesr.fr -. +to jurgen.knodlseder@irap.omp.eu.


Last updated by: Jürgen -Knödlseder (6 October 2011) +Knödlseder (4 April 2012)

\ No newline at end of file -- libgit2 0.21.4