jean perrot / ctools

Commit 0cdc4b706f3561a901b3d229e27b5f1590bcc130

Authored by knodlseder
1 parent 831e518c

updated for ctatools-00-02-04

Inline Side-by-side
Showing 5 changed files with 152 additions and 52 deletions
ChangeLog
  View file @0cdc4b7
  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 9 2011-07-09 Juergen Knoedlseder <knodlseder@cesr.fr>
2 10  
3 11 * Version 0.2.3 released
4 12 ========================
5 13  
6   - Improve configuration script
  14 + Improve configure script
7 15  
8 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 3 Author(s) : Juergen Knoedlseder
4 4  
5   -July 9th, 2011
  5 +July 20, 2011
6 6  
7 7  
8 8 1. Introduction
... ... @@ -12,12 +12,14 @@ This document briefly summarizes executable by executable the most important cha
12 12  
13 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 25 3. Python interface
... ...
ctatools.pc.in
  View file @0cdc4b7
... ... @@ -6,9 +6,9 @@ includedir=${prefix}/include
6 6 Name: ctatools
7 7 Description: CTA science analysis tools
8 8 URL: http://cta.irap.omp.eu/ctatools
9   -Version: 0.2.3
  9 +Version: 0.2.4
10 10 Requires:
11   -Requires.private: GammaLib >= 0.4.9
  11 +Requires.private: GammaLib >= 0.4.10
12 12 Conflicts:
13 13 Cflags: -I${includedir}/ctatools
14 14 Libs: -L${libdir} -lctatools
... ...
doc/html/download.html
  View file @0cdc4b7
... ... @@ -7,8 +7,8 @@
7 7 <body>
8 8 <p class="Header">Download</p>
9 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 12 <br>
13 13 <br>
14 14 <p class="Header">Latest release</p>
... ... @@ -22,8 +22,12 @@ and gammalib versions.&lt;/p&gt;
22 22 <td>gammalib</td>
23 23 </tr>
24 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 31 </tr>
28 32 </tbody>
29 33 </table>
... ... @@ -40,15 +44,19 @@ and gammalib versions.&lt;/p&gt;
40 44 <td>gammalib</td>
41 45 </tr>
42 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 53 </tr>
46 54 </tbody>
47 55 </table>
48 56 <br>
49 57 <hr size="1">
50 58 <p class="Body">Last updated by: J&uuml;rgen
51   -Kn&ouml;dlseder 9 July
  59 +Kn&ouml;dlseder 20 July
52 60 2011
53 61 </p>
54 62 </body></html>
55 63 \ No newline at end of file
... ...
doc/html/installation.html
  View file @0cdc4b7
... ... @@ -2,7 +2,8 @@
2 2 <html><head>
3 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 7 <body>
7 8 <p class="Header">Installation</p>
8 9 <p style="padding-top: 0pt; text-align: left;" class="Body">
... ... @@ -10,19 +11,26 @@
10 11 GammaLib</a>
11 12 </p>
12 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 17 </p>
16 18 <p style="padding-top: 0pt; text-align: left;" class="Body">
17 19 <a href="#Step_3:_Install_ctatools">Step 3: Install
18 20 ctatools</a>
19 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 27 <p style="padding-top: 0pt; text-align: left;" class="Body"><a href="#Known_Problems">Known Problems</a></p>
21 28 <p style="padding-top: 0pt; text-align: left;" class="Body"><a href="#Getting_Help">Getting Help</a></p>
22 29 <br>
23 30 <p style="padding-top: 0pt; text-align: left;" class="Body"><span style="font-weight: bold;">
24 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 34 </p>
27 35 <br>
28 36 <p class="Title"><a name="Step_1:_Install_GammaLib"></a>Step
... ... @@ -38,17 +46,20 @@ follow the GammaLib installation instructions on
38 46 <br>
39 47 <br>
40 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 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 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 60 directory
50 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 63 or <span style="font-family: Courier New,Courier,monospace;">$HOME/.profile</span>
53 64 script on a Linux
54 65 machine:
... ... @@ -58,8 +69,8 @@ source $GAMMALIB/bin/gammalib-init.sh
58 69 </p>
59 70 <p style="padding-top: 0pt; text-align: left;" class="Body">If
60 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 74 script:
64 75 </p>
65 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 84 (for example <span style="font-family: Courier New,Courier,monospace;">/usr/local/gamma/src</span>),
74 85 and type</p>
75 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 88 </p>
78 89 <p style="padding-top: 0pt; text-align: left;" class="Body">Step
79 90 in the created directory using
80 91 </p>
81 92 <p class="Code">
82   -&gt; cd ctatools
  93 +&gt; cd ctatools-00-02-04
83 94 </p>
84 95 <p style="padding-top: 0pt; text-align: left;" class="Body">
85 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 136 &gt; ./configure --help
126 137 </p>
127 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 174 <p class="Title"><a name="Known_Problems"></a>Known
129 175 Problems</p>
130 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 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 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 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 206 some Mac OS X 10.6 installations to make ctatools compile.<br>
141   -<br>
142 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 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 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 223 <br>
  224 +<p style="padding-top: 0pt; text-align: left;" class="Body"><span style="font-weight: bold; font-size: 14px;">OpenSolaris</span>
157 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 239 </p>
159 240 <br>
  241 +<br>
160 242 <p class="Title"><a name="Getting_Help"></a>Getting
161 243 Help</p>
162 244 <p style="padding-top: 0pt; text-align: left;" class="Body">
... ... @@ -167,7 +249,7 @@ ctatools should be submitted to
167 249 <br>
168 250 <hr size="1">
169 251 <p class="Body">Last updated by: J&uuml;rgen
170   -Kn&ouml;dlseder 9 July
  252 +Kn&ouml;dlseder 16 July
171 253 2011
172 254 </p>
173 255 </body></html>
174 256 \ No newline at end of file
... ...