Commit 0cdc4b706f3561a901b3d229e27b5f1590bcc130

Authored by knodlseder
1 parent 831e518c

updated for ctatools-00-02-04

ChangeLog
  1 +2011-07-20 Juergen Knoedlseder <knodlseder@cesr.fr>
  2 +
  3 + * Version 0.2.4 released
  4 + ========================
  5 +
  6 + Improve configure script
  7 + Add scripts for ctatools environment setting
  8 +
1 2011-07-09 Juergen Knoedlseder <knodlseder@cesr.fr> 9 2011-07-09 Juergen Knoedlseder <knodlseder@cesr.fr>
2 10
3 * Version 0.2.3 released 11 * Version 0.2.3 released
4 ======================== 12 ========================
5 13
6 - Improve configuration script 14 + Improve configure script
7 15
8 2011-02-24 Juergen Knoedlseder <knodlseder@cesr.fr> 16 2011-02-24 Juergen Knoedlseder <knodlseder@cesr.fr>
9 17
1 -New Features and Important Changes in ctatools 00-02-03 1 +New Features and Important Changes in ctatools 00-02-04
2 2
3 Author(s) : Juergen Knoedlseder 3 Author(s) : Juergen Knoedlseder
4 4
5 -July 9th, 2011 5 +July 20, 2011
6 6
7 7
8 1. Introduction 8 1. Introduction
@@ -12,12 +12,14 @@ This document briefly summarizes executable by executable the most important cha @@ -12,12 +12,14 @@ This document briefly summarizes executable by executable the most important cha
12 12
13 2. Configuration 13 2. Configuration
14 ----------------- 14 -----------------
15 -Remove pkg-config usage from configure.ac as this introduced somas  
16 -on Mac OS X systems (by default there is no pkg-config on Mac OS X).  
17 -  
18 -Test for presence of Python.h and build Python binding only if the  
19 -file exists. This should resolve installation issues on systems that  
20 -do not have the Python development package installed. 15 +The configuration script aborts now if no C++ compiler is found.
  16 +
  17 +Added ctatools-init.sh, ctatools-init.csh and ctatools-setup
  18 +scripts. They needed to be called when ctatools is installed
  19 +in a location that differs from GammaLib, so that the
  20 +environment is set up correctly also for this case. If ctatools
  21 +is in the same location as GammaLib, these scripts do not need
  22 +to be used.
21 23
22 24
23 3. Python interface 25 3. Python interface
ctatools.pc.in
@@ -6,9 +6,9 @@ includedir=${prefix}/include @@ -6,9 +6,9 @@ includedir=${prefix}/include
6 Name: ctatools 6 Name: ctatools
7 Description: CTA science analysis tools 7 Description: CTA science analysis tools
8 URL: http://cta.irap.omp.eu/ctatools 8 URL: http://cta.irap.omp.eu/ctatools
9 -Version: 0.2.3 9 +Version: 0.2.4
10 Requires: 10 Requires:
11 -Requires.private: GammaLib >= 0.4.9 11 +Requires.private: GammaLib >= 0.4.10
12 Conflicts: 12 Conflicts:
13 Cflags: -I${includedir}/ctatools 13 Cflags: -I${includedir}/ctatools
14 Libs: -L${libdir} -lctatools 14 Libs: -L${libdir} -lctatools
doc/html/download.html
@@ -7,8 +7,8 @@ @@ -7,8 +7,8 @@
7 <body> 7 <body>
8 <p class="Header">Download</p> 8 <p class="Header">Download</p>
9 <p style="padding-top: 0pt; text-align: left;" class="Body"> 9 <p style="padding-top: 0pt; text-align: left;" class="Body">
10 -The latest ctatools release is <a href="releases/ctatools-00-02-01.tar.gz">ctatools-00-02-03</a>  
11 -(July 9, 2011).</p> 10 +The latest ctatools release is <span style="font-family: Courier New,Courier,monospace;">ctatools-00-02-04</span>
  11 +(July 20, 2011).</p>
12 <br> 12 <br>
13 <br> 13 <br>
14 <p class="Header">Latest release</p> 14 <p class="Header">Latest release</p>
@@ -22,8 +22,12 @@ and gammalib versions.&lt;/p&gt; @@ -22,8 +22,12 @@ and gammalib versions.&lt;/p&gt;
22 <td>gammalib</td> 22 <td>gammalib</td>
23 </tr> 23 </tr>
24 <tr class="Body"> 24 <tr class="Body">
25 -<td><a href="releases/ctatools-00-02-03.tar.gz">00-02-03</a></td>  
26 -<td><a href="releases/gammalib-00-04-09.tar.gz">00-04-09</a></td> 25 +<td><a href="releases/ctatools/ctatools-00-02-04.tar.gz">00-02-04</a></td>
  26 +<td><a href="releases/gammalib/gammalib-00-04-10.tar.gz">00-04-10</a></td>
  27 +</tr>
  28 +<tr class="Body">
  29 +<td><a href="releases/ctatools/ChangeLog">ChangeLog</a></td>
  30 +<td><a href="releases/gammalib/ChangeLog">ChangeLog</a></td>
27 </tr> 31 </tr>
28 </tbody> 32 </tbody>
29 </table> 33 </table>
@@ -40,15 +44,19 @@ and gammalib versions.&lt;/p&gt; @@ -40,15 +44,19 @@ and gammalib versions.&lt;/p&gt;
40 <td>gammalib</td> 44 <td>gammalib</td>
41 </tr> 45 </tr>
42 <tr class="Body"> 46 <tr class="Body">
43 -<td><a href="releases/ctatools-00-02-01.tar.gz">00-02-01</a></td>  
44 -<td><a href="releases/gammalib-00-04-07.tar.gz">00-04-07</a></td> 47 +<td><a href="releases/ctatools/ctatools-00-02-03.tar.gz">00-02-03</a></td>
  48 +<td><a href="releases/gammalib/gammalib-00-04-09.tar.gz">00-04-09</a></td>
  49 +</tr>
  50 +<tr class="Body">
  51 +<td><a href="releases/ctatools/ctatools-00-02-01.tar.gz">00-02-01</a></td>
  52 +<td><a href="releases/gammalib/gammalib-00-04-07.tar.gz">00-04-07</a></td>
45 </tr> 53 </tr>
46 </tbody> 54 </tbody>
47 </table> 55 </table>
48 <br> 56 <br>
49 <hr size="1"> 57 <hr size="1">
50 <p class="Body">Last updated by: J&uuml;rgen 58 <p class="Body">Last updated by: J&uuml;rgen
51 -Kn&ouml;dlseder 9 July 59 +Kn&ouml;dlseder 20 July
52 2011 60 2011
53 </p> 61 </p>
54 </body></html> 62 </body></html>
55 \ No newline at end of file 63 \ No newline at end of file
doc/html/installation.html
@@ -2,7 +2,8 @@ @@ -2,7 +2,8 @@
2 <html><head> 2 <html><head>
3 <meta http-equiv="content-type" content="text/html; charset=ISO-8859-1"><title>Installation</title> 3 <meta http-equiv="content-type" content="text/html; charset=ISO-8859-1"><title>Installation</title>
4 4
5 -<link href="ctatools.css" media="screen,print" type="text/css" rel="stylesheet"></head> 5 +<link href="ctatools.css" media="screen,print" type="text/css" rel="stylesheet">
  6 +</head>
6 <body> 7 <body>
7 <p class="Header">Installation</p> 8 <p class="Header">Installation</p>
8 <p style="padding-top: 0pt; text-align: left;" class="Body"> 9 <p style="padding-top: 0pt; text-align: left;" class="Body">
@@ -10,19 +11,26 @@ @@ -10,19 +11,26 @@
10 GammaLib</a> 11 GammaLib</a>
11 </p> 12 </p>
12 <p style="padding-top: 0pt; text-align: left;" class="Body"> 13 <p style="padding-top: 0pt; text-align: left;" class="Body">
13 -<a href="#Step_2:_Setup_environment">Step 2: Setup  
14 -environment</a> 14 +<a href="#Step_2:_Setup_GammaLib_environment">Step 2:
  15 +Setup
  16 +GammaLib environment</a>
15 </p> 17 </p>
16 <p style="padding-top: 0pt; text-align: left;" class="Body"> 18 <p style="padding-top: 0pt; text-align: left;" class="Body">
17 <a href="#Step_3:_Install_ctatools">Step 3: Install 19 <a href="#Step_3:_Install_ctatools">Step 3: Install
18 ctatools</a> 20 ctatools</a>
19 </p> 21 </p>
  22 +<p style="padding-top: 0pt; text-align: left;" class="Body">
  23 +<a href="#Step_4:_Setup_ctatools_environment">Step 4:
  24 +Setup
  25 +ctatools environment</a>
  26 +</p>
20 <p style="padding-top: 0pt; text-align: left;" class="Body"><a href="#Known_Problems">Known Problems</a></p> 27 <p style="padding-top: 0pt; text-align: left;" class="Body"><a href="#Known_Problems">Known Problems</a></p>
21 <p style="padding-top: 0pt; text-align: left;" class="Body"><a href="#Getting_Help">Getting Help</a></p> 28 <p style="padding-top: 0pt; text-align: left;" class="Body"><a href="#Getting_Help">Getting Help</a></p>
22 <br> 29 <br>
23 <p style="padding-top: 0pt; text-align: left;" class="Body"><span style="font-weight: bold;"> 30 <p style="padding-top: 0pt; text-align: left;" class="Body"><span style="font-weight: bold;">
24 Note:</span> These installation instructions apply to 31 Note:</span> These installation instructions apply to
25 -<span style="font-family: Courier New,Courier,monospace;">ctatools-00-02-03</span> or later. 32 +<span style="font-family: Courier New,Courier,monospace;">ctatools-00-02-04</span>
  33 +or later.
26 </p> 34 </p>
27 <br> 35 <br>
28 <p class="Title"><a name="Step_1:_Install_GammaLib"></a>Step 36 <p class="Title"><a name="Step_1:_Install_GammaLib"></a>Step
@@ -38,17 +46,20 @@ follow the GammaLib installation instructions on @@ -38,17 +46,20 @@ follow the GammaLib installation instructions on
38 <br> 46 <br>
39 <br> 47 <br>
40 </p> 48 </p>
41 -<p class="Title"><a name="Step_2:_Setup_environment"></a>Step  
42 -2: Setup environment</p> 49 +<p class="Title"><a name="Step_2:_Setup_GammaLib_environment"></a>Step
  50 +2: Setup GammaLib environment</p>
43 <p style="padding-top: 0pt; text-align: left;" class="Body">Before 51 <p style="padding-top: 0pt; text-align: left;" class="Body">Before
44 -using GammaLib (and ctatools use GammaLib) you have to setup some 52 +building and installing ctatools, you have to configure GammaLib by
  53 +setting up some
45 environment variables. 54 environment variables.
46 -This will be done automatically by an initialisation script that will  
47 -be installed in the <span style="font-family: Courier New,Courier,monospace;">bin</span>  
48 -directory. Assuming that you have installed GammaLib in the default 55 +This will be done automatically by an initialisation script that is
  56 +found in the <span style="font-family: Courier New,Courier,monospace;">bin</span>
  57 +directory of the GammaLib directory (we call here "GammaLib
  58 +directory"&nbsp;the directory into which GammaLib has been
  59 +installed). Assuming that you have installed GammaLib in the default
49 directory 60 directory
50 <span style="font-family: Courier New,Courier,monospace;">/usr/local/gamma</span> 61 <span style="font-family: Courier New,Courier,monospace;">/usr/local/gamma</span>
51 -you need to add the following to your <span style="font-family: Courier New,Courier,monospace;">.bashrc</span> 62 +you need to add the following to your <span style="font-family: Courier New,Courier,monospace;">$HOME/.bashrc</span>
52 or <span style="font-family: Courier New,Courier,monospace;">$HOME/.profile</span> 63 or <span style="font-family: Courier New,Courier,monospace;">$HOME/.profile</span>
53 script on a Linux 64 script on a Linux
54 machine: 65 machine:
@@ -58,8 +69,8 @@ source $GAMMALIB/bin/gammalib-init.sh @@ -58,8 +69,8 @@ source $GAMMALIB/bin/gammalib-init.sh
58 </p> 69 </p>
59 <p style="padding-top: 0pt; text-align: left;" class="Body">If 70 <p style="padding-top: 0pt; text-align: left;" class="Body">If
60 you use C shell or a variant then add the following to your 71 you use C shell or a variant then add the following to your
61 -<span style="font-family: Courier New,Courier,monospace;">.cshrc</span>  
62 -or <span style="font-family: Courier New,Courier,monospace;">.tcshrc</span> 72 +<span style="font-family: Courier New,Courier,monospace;">$HOME/.cshrc</span>
  73 +or <span style="font-family: Courier New,Courier,monospace;">$HOME/.tcshrc</span>
63 script: 74 script:
64 </p> 75 </p>
65 <p class="Code">setenv GAMMALIB /usr/local/gamma<br> 76 <p class="Code">setenv GAMMALIB /usr/local/gamma<br>
@@ -73,13 +84,13 @@ downloading the ctatools tarball, save it in an appropriate location @@ -73,13 +84,13 @@ downloading the ctatools tarball, save it in an appropriate location
73 (for example <span style="font-family: Courier New,Courier,monospace;">/usr/local/gamma/src</span>), 84 (for example <span style="font-family: Courier New,Courier,monospace;">/usr/local/gamma/src</span>),
74 and type</p> 85 and type</p>
75 <p class="Code"> 86 <p class="Code">
76 -&gt; tar xvfz ctatools-00-02-03.tar.gz 87 +&gt; tar xvfz ctatools-00-02-04.tar.gz
77 </p> 88 </p>
78 <p style="padding-top: 0pt; text-align: left;" class="Body">Step 89 <p style="padding-top: 0pt; text-align: left;" class="Body">Step
79 in the created directory using 90 in the created directory using
80 </p> 91 </p>
81 <p class="Code"> 92 <p class="Code">
82 -&gt; cd ctatools 93 +&gt; cd ctatools-00-02-04
83 </p> 94 </p>
84 <p style="padding-top: 0pt; text-align: left;" class="Body"> 95 <p style="padding-top: 0pt; text-align: left;" class="Body">
85 and build and install ctatools by typing</p> 96 and build and install ctatools by typing</p>
@@ -125,38 +136,109 @@ full list of configuration options can be found using&lt;/p&gt; @@ -125,38 +136,109 @@ full list of configuration options can be found using&lt;/p&gt;
125 &gt; ./configure --help 136 &gt; ./configure --help
126 </p> 137 </p>
127 <br> 138 <br>
  139 +<br>
  140 +<p class="Title"><a name="Step_4:_Setup_ctatools_environment"></a>Step
  141 +4: Setup ctatools environment</p>
  142 +<p style="padding-top: 0pt; text-align: left;" class="Body">If
  143 +ctatools have been installed in the same directory as GammaLib (which is
  144 +the default configuration for ctatools) you are done.</p>
  145 +<br>
  146 +<p style="padding-top: 0pt; text-align: left;" class="Body">If
  147 +you decided to install ctatools in a different directory, you have to
  148 +configure ctatools by
  149 +setting up some
  150 +environment variables.
  151 +This will be done automatically by an initialisation script that is
  152 +found in the <span style="font-family: Courier New,Courier,monospace;">bin</span>
  153 +directory of the directory into which ctatools has been installed.
  154 +Assuming that you have installed ctatools into
  155 +<span style="font-family: Courier New,Courier,monospace;">/usr/local/ctatools</span>
  156 +you need to add the following to your <span style="font-family: Courier New,Courier,monospace;">$HOME/.bashrc</span>
  157 +or <span style="font-family: Courier New,Courier,monospace;">$HOME/.profile</span>
  158 +script on a Linux
  159 +machine:
  160 +</p>
  161 +<p class="Code">export CTATOOLS=/usr/local/ctatools<br>
  162 +source $CTATOOLS/bin/ctatools-init.sh
  163 +</p>
  164 +<p style="padding-top: 0pt; text-align: left;" class="Body">If
  165 +you use C shell or a variant then add the following to your
  166 +<span style="font-family: Courier New,Courier,monospace;">$HOME/.cshrc</span>
  167 +or <span style="font-family: Courier New,Courier,monospace;">$HOME/.tcshrc</span>
  168 +script:
  169 +</p>
  170 +<p class="Code">setenv CTATOOLS /usr/local/ctatools<br>
  171 +source $CTATOOLS/bin/ctatools-init.csh </p>
  172 +<br>
  173 +<br>
128 <p class="Title"><a name="Known_Problems"></a>Known 174 <p class="Title"><a name="Known_Problems"></a>Known
129 Problems</p> 175 Problems</p>
130 <p style="padding-top: 0pt; text-align: left;" class="Body"> 176 <p style="padding-top: 0pt; text-align: left;" class="Body">
  177 +<span style="font-weight: bold; font-size: 14px;">Python
  178 +support</span>
  179 +<br>
  180 +ctatools comes with Python wrappers so that all classes can be
  181 +directly used from Python. To compile-in Python support, ctatools
  182 +needs the <span style="font-family: Courier New,Courier,monospace;">Python.h</span>
  183 +header file, which on many distributions is not
  184 +installed by default.
  185 +To make <span style="font-family: Courier New,Courier,monospace;">Python.h</span>
  186 +available, install the Python developer package
  187 +in your distribution. Otherwise you will not be able to use ctatools
  188 +from Python.
  189 +</p>
  190 +<br>
  191 +<p style="padding-top: 0pt; text-align: left;" class="Body">
131 <span style="font-weight: bold; font-size: 14px;">Mac OS X</span> 192 <span style="font-weight: bold; font-size: 14px;">Mac OS X</span>
132 -<br>The Python development package is not installed as default on Mac  
133 -OS X, and consequently, the <span style="font-family: Courier New,Courier,monospace;">Python.h</span> header file is missing that is  
134 -needed to compile in the Python bindings. The <span style="font-family: Courier New,Courier,monospace;">configure</span> script should  
135 -recognise this fact and adjust the build procedure accordingly, but you 193 +<br>
  194 +The Python development package is not installed as default on Mac
  195 +OS X, and consequently, the <span style="font-family: Courier New,Courier,monospace;">Python.h</span>
  196 +header file is missing that is
  197 +needed to compile in the Python bindings. The <span style="font-family: Courier New,Courier,monospace;">configure</span>
  198 +script recognises this fact and adjust the build procedure accordingly,
  199 +but you
136 will not be able to use ctatools from Python. So better install the 200 will not be able to use ctatools from Python. So better install the
137 -Python development package before installing ctatools.</p><p style="padding-top: 0pt; text-align: left;" class="Body"></p><p style="padding-top: 0pt; text-align: left;" class="Body">It 201 +Python development package before installing ctatools.</p>
  202 +<p style="padding-top: 0pt; text-align: left;" class="Body">It
138 was also reported that adding of&nbsp;<span style="font-family: Courier New,Courier,monospace;">export 203 was also reported that adding of&nbsp;<span style="font-family: Courier New,Courier,monospace;">export
139 -MACOSX_DEPLOYMENT_TARGET=10.6</span> to the <span style="font-family: Courier New,Courier,monospace;">.bashrc</span> file was necessary one 204 +MACOSX_DEPLOYMENT_TARGET=10.6</span> to the <span style="font-family: Courier New,Courier,monospace;">.bashrc</span>
  205 +file was necessary one
140 some Mac OS X 10.6 installations to make ctatools compile.<br> 206 some Mac OS X 10.6 installations to make ctatools compile.<br>
141 -<br>  
142 </p> 207 </p>
143 -<p style="padding-top: 0pt; text-align: left;" class="Body">  
144 -<span style="font-weight: bold; font-size: 14px;">Solaris</span>  
145 <br> 208 <br>
146 -ctatools has been compiled successfully on Solaris 2.10 using the Sun  
147 -Studio compiler. However, GammaLib symbols are  
148 -not globally exported due to a strage behaviour of the Sun Studio  
149 -compiler. This prevents for example GammaLib library from catching  
150 -its own exceptions and from registering models. Consequently, many  
151 -functionnalities will not work.</p> 209 +<p style="padding-top: 0pt; text-align: left;" class="Body"><span style="font-weight: bold; font-size: 14px;">Solaris</span>
152 <br> 210 <br>
153 -<p style="padding-top: 0pt; text-align: left;" class="Body">Using  
154 -gcc (version 3.4.3), ctatools and GammaLib works correctly on Solaris  
155 -2.10, yet loading ctatools or GammaLib as a Python module fails. 211 +Although ctatools builds on Solaris using the Sun compiler, there are
  212 +problems with global symbols in shared libraries and exception
  213 +catching, which prevents the FITS interface to work
  214 +correctly. ctatools has however been built and tested successfully
  215 +using the GNU
  216 +compiler, and this is the only build method that is currently
  217 +supported.
  218 +Problems have also been encountered when compiling cfitsio versions
  219 +more recent than 3.250. The problems have been reported to the cfitsio
  220 +developer team, and are likely to be solved in the future. For the
  221 +time being, it is recommended to use cfitsio version 3.250 on Solaris.
  222 +</p>
156 <br> 223 <br>
  224 +<p style="padding-top: 0pt; text-align: left;" class="Body"><span style="font-weight: bold; font-size: 14px;">OpenSolaris</span>
157 <br> 225 <br>
  226 +On OpenSolaris, the same problems concerning the SunStudio compiler
  227 +occur as for Solaris, and also here, the GNU compiler is the
  228 +recommended
  229 +tool to build ctatools. Also here, cfitsio version 3.250 is the
  230 +recommended library as more recent version feature relocation
  231 +problems. ctatools has been tested using gcc 4.3.2 on OpenSolaris
  232 +2009.06. Make sure to create the symbolic links
  233 +</p>
  234 +<p class="Code">ln -s /usr/bin/gcc4.3.2 /usr/bin/gcc<br>
  235 +ln -s /usr/bin/g++4.3.2 /usr/bin/g++</p>
  236 +<p style="padding-top: 0pt; text-align: left;" class="Body">
  237 +which are not there by default to avoid excess warnings during
  238 +compilation.
158 </p> 239 </p>
159 <br> 240 <br>
  241 +<br>
160 <p class="Title"><a name="Getting_Help"></a>Getting 242 <p class="Title"><a name="Getting_Help"></a>Getting
161 Help</p> 243 Help</p>
162 <p style="padding-top: 0pt; text-align: left;" class="Body"> 244 <p style="padding-top: 0pt; text-align: left;" class="Body">
@@ -167,7 +249,7 @@ ctatools should be submitted to @@ -167,7 +249,7 @@ ctatools should be submitted to
167 <br> 249 <br>
168 <hr size="1"> 250 <hr size="1">
169 <p class="Body">Last updated by: J&uuml;rgen 251 <p class="Body">Last updated by: J&uuml;rgen
170 -Kn&ouml;dlseder 9 July 252 +Kn&ouml;dlseder 16 July
171 2011 253 2011
172 </p> 254 </p>
173 </body></html> 255 </body></html>
174 \ No newline at end of file 256 \ No newline at end of file