updated for gammalib-00-04-10

knodlseder
1 parent 4910a009
Showing 10 changed files with 432 additions and 279 deletions
ChangeLog
NEWS
README
doc/html/about.html
doc/html/documentation.html
doc/html/doxygen.html
doc/html/home.html
doc/html/installation.html
doc/html/quickstart.html
gammalib.pc.in
-2011-07-14  Juergen Knoedlseder  <knodlseder@cesr.fr>
+2011-07-20  Juergen Knoedlseder  <knodlseder@cesr.fr>
         * Version 0.4.10 released
         =========================
-New Features and Important Changes in GammaLib 00-04-09
+New Features and Important Changes in GammaLib 00-04-10
 Author(s) : Juergen Knoedlseder
-July 9th, 2011
+July 20, 2011
 1. Introduction
@@ -12,15 +12,22 @@ This document briefly summarizes module by module the most important changes mad
 2. Configuration
 -----------------
-Remove pkg-config usage from configure.ac as this introduced somas
-on Mac OS X systems (by default there is no pkg-config on Mac OS X).
+The configuration script aborts now if no C++ compiler is found.
-Add --enable-nan-check option and add option configuration information
-to configuration summary screen dump.
+pkg-config was reintroduced for finding the cfitsio library, but
+it's only used if pkg-config is available. This may help to
+increase the portability to various platforms, although problems
+with incorrect pkg-config files have been encountered on some
+distributions (OpenSUSE).
-Test for presence of Python.h and build Python binding only if the
-file exists. This should resolve installation issues on systems that
-do not have the Python development package installed.
+The configuration script now also handles fitsio.h headers found in
+specific subdirectory (which is needed to compile on OpenSUSE and
+Scientific Linux).
+
+Set the installation directory as the default runtime library
+directory for Python. This solves a `make check' problem that occurred
+on some distributions because it could not find the cfitsio
+library that was installed in that location.
 3. Application module
@@ -40,17 +47,17 @@ None
 6. Model module
 ---------------
-Add NaN/Inf check to various spatial and spectral models.
+None
 7. Numerics module
 ------------------
-Add NaN/Inf check to GIntegral class.
+None
 8. Observation module
 ---------------------
-Add NaN/Inf check to GResponse and GObservation class.
+None
 9. Optimization module
@@ -60,20 +67,7 @@ None
 10. Sky module
 --------------
-Replaced the IDL based World Coordinate System code by wcslib based code.
-This improves performance and accuracy of the coordinate transformation
-and corrects a bug in the LONPOLE/LATPOLE keywords that were written in
-the earlier version into the FITS file.
-
-Introduced GWcslib base class for projections that are wcslib based.
-All code adapted from wcslib goes into that class. Not all functionality
-has yet been ported from wcslib to GammaLib, but the essential things
-for creating, writing and reading WCS compliant FITS files is there.
-
-Introduced a World Coordinate System registry for easy extension of the
-set of projections.
-
-Added the following projection types: AZP, STG, TAN
+Use now GWcsRegistry for alloc_wcs().
 11. Support module
@@ -98,10 +92,4 @@ None
 15. CTA interface
 -----------------
-Added a simple offset angle dependence to the CTA response. The effective
-area is assumed to vary following exp(-0.5*theta^4/sigma^2), where theta
-is the offset angle of the photon arrival direction in the camera system
-and sigma is a parameter that is set by default to 3.0 deg^2. No energy
-dependence has been assumed in the offset angle variation.
-
-Add NaN/Inf check to various classes.
+None
 GammaLib information
 ====================
-Version: 00-04-09 (July 8, 2011)
+Version: 00-04-10 (July 20, 2011)
 Author:  Juergen Knodlseder (knodlseder@cesr.fr)
@@ -64,16 +64,17 @@ directory as a shared library by typing:
 GammaLib can also benefit from the presence of the readline library
 that provides line-editing and history capabilities for text input
 (GammaLib offers however also full functionality without having 
-readline installed). readline can be downloaded from 
-http://ftp.gnu.org/gnu/readline/
+readline installed). readline requires the ncurses library. Both
+libraries can be downloaded from http://ftp.gnu.org/gnu/.
-Unix Installation
-=================
-To build and install GammaLib, simply type the following:
+Linux Installation
+==================
+To build, verify and install GammaLib, simply type the following:
      % ./configure
      % make
+     % make check
      % make install
 By default GammaLib installs itself in /usr/local/gamma.  If you need to
@@ -82,31 +83,61 @@ the --prefix option to ./configure.  For example:
      % ./configure --prefix=/home/yourname/projects
      % make
+     % make check
      % make install
 The file INSTALL details more about using configure. Also try
      % ./configure --help.
+The `make check' command will run an extensive unit test to verify that
+GammaLib was correctly built. Make sure that all tests were successful. 
+
 Macintosh OS X Installation
 ============================
-GammaLib is known to work on various flavors of OS X.  Follow the Unix
+GammaLib is known to work on various flavors of OS X.  Follow the 
+Linux installation instructions above.
+
+
+BSD Installation
+================
+GammaLib has been tested on FreeBSD successfully. Follow the Linux
 installation instructions above.
 Solaris Installation
 ====================
-GammaLib compiles on Solairs, but there is an issue with using it as a
-shared library (see "Known problems" below).
+GammaLib compiles on Solaris and openSolaris using the GNU compiler
+collection. Follow the Linux installation instructions above.
+GammaLib also compiles using the Sun Studio compiler, but due to
+some unexpected handling of global variables, it is not fully
+working (see "Known problems" below).
+Please note that these is also a cfitsio problem on Solaris, please
+refer to the section "Known problems" for more information.
+
+
+Window Installation
+===================
+There have been no efforts so far to compile GammaLib under Windows.
 Testing
 =======
-If you want to test GammaLib before installation, type the following:
+After building and before installing GammaLib, you should run the
+extensive unit test by typing:
     % make check
+If everything works successfully you should see
+
+    ===================
+    All 14 tests passed
+    ===================
+
+at the end of the test. If no Python support was compiled in, the
+number of tests performed will be reduced by one.
+
 Setting up your environment
 ===========================
@@ -151,11 +182,17 @@ and inst/cat/test.
 Documentation
 =============
-The doc directory contains the most recent set of updated documentation
-for this release. The documentation is available in PDF format.
+The doc directory (usually at /usr/local/gamma/share/doc/gammalib)
+contains the most recent set of updated documentation for this release.
+A detailed documentation can be created using Doxygen by typing:
+
+    % make doxygen
+
+before installing the library. Doxygen can be obtained from
+http://www.stack.nl/~dimitri/doxygen/
 This is a development release and the documentation is largely, but 
-not entirely up to date.  We are working on it. Please be patient or
+not entirely up to date. We are working on it. Please be patient or
 volunteer to help.
@@ -167,13 +204,69 @@ https://sourceforge.net/tracker/?group_id=282143&amp;atid=1196795.
 Known problems
 ==============
+Python support
+  GammaLib comes with Python wrappers so that all classes can be
+  directly used from Python. To compile-in Python support, GammaLib
+  needs the Python.h header file, which on many distributions is not
+  installed by default.
+  To make Python.h available, install the Python developer package
+  in your distribution. Otherwise you will not be able to use GammaLib
+  from Python.
+
+Readline support
+  Many distributions do not have the readline header files and symbolic
+  link to the shared library set up by default. The same is true for the
+  ncurses library that is needed by readline. To properly compile-in
+  readline support in GammaLib, make sure that the redline header files
+  exist and that the symbolic links are set. In many distributions,
+  the shared redline and ncurses are located in /lib, while the symbolic
+  links are in /usr/lib. Make sure that you have symbolic links with
+  names
+
+     libreadline.so
+     libncurses.so
+
+  Symbolic links with an additional number attached, such as
+  libreadline.so.6 or libncurses.so.5 (which are found in many
+  distributions in the /lib directory) are not sufficient.
+  In many distributions, the appropriate headers and symbolic links
+  are installed if the proper readline and ncurses developer
+  packages are installed.
+
 Solaris
-  Although GammaLib compiles on Solaris using the Sun compiler, there are
+  Although GammaLib builds on Solaris using the Sun compiler, there are
   problems with global symbols in the shared library that prevent the
   model registry to work correctly. Furthermore, GammaLib is not able
   to catch its own exceptions, which prevents the FITS interface to work
-  correctly. Possible it will work using gcc on Solaris, yet this has not
-  so far been tested.
+  correctly.
+  GammaLib has however been built and tested successfully using the GNU
+  compiler, and this is the only build method that is currently supported.
+  Problems have also been encountered when compiling cfitsio versions
+  more recent than 3.250. The problems have been reported to the cfitsio
+  developer team, and are likely to be solved in the future. For the
+  time being, it is recommended to use cfitsio version 3.250 on Solaris.
+
+OpenSolaris
+  On OpenSolaris, the same problems concerning the SunStudio compiler
+  occur as for Solaris, and also here, the GNU compiler is the recommended
+  tool to build GammaLib. Also here, cfitsio version 3.250 is the
+  recommended library as more recent version feature relocation
+  problems. GammaLib has been tested using gcc 4.3.2 on 
+  OpenSolaris 2009.06. Make sure to create the symbolic links
+
+     ln -s /usr/bin/gcc4.3.2 /usr/bin/gcc
+     ln -s /usr/bin/g++4.3.2 /usr/bin/g++
+
+  which are not there by default to avoid excess warnings during
+  compilation. 
+  For OpenSolaris 2009.06, no readline package is available, hence 
+  readline support is not readily available. Readline support can however
+  be enabled by directly installing the GNU ncurses and readline packages
+  from source (http://ftp.gnu.org/gnu). This has been done successfully
+  on OpenSolaris 2009.06 for ncurses-5.9 and readline-6.2. Make sure
+  to specify the `--with-shared' option when configuring ncurses, so
+  that the shared library will be built and installed. Otherwise,
+  relocation errors may occur during compilation of GammaLib.
 Contact
@@ -4,7 +4,6 @@
 <link rel="stylesheet" type="text/css" media="screen,print" href="gammalib.css">
 </head>
-
 <body>
 <p class="Header">About</p>
 <p style="padding-top: 0pt; text-align: left;" class="Body">
@@ -22,9 +21,9 @@ data analysis framework that enables simultaneous multi-mission
 analysis.</p>
 <br>
 <p style="padding-top: 0pt; text-align: left;" class="Body">The
-GammaLib project has been initiated by J. Knödlseder from the
-Insitut de Recherche en Astrophysique et Planétologie
-(IRAP), a mixed CNRS / Université Paul Sabatier laboratory
+GammaLib project has been initiated by J. Kn&ouml;dlseder from the
+Insitut de Recherche en Astrophysique et Plan&eacute;tologie
+(IRAP), a mixed CNRS / Universit&eacute; Paul Sabatier laboratory
 in Toulouse, France.</p>
 <br>
 <p style="padding-top: 0pt; text-align: left;" class="Body">As
@@ -57,4 +56,9 @@ Source Lines of Code (SLOC)&lt;/td&gt;
 </tbody>
 </table>
 <br>
+<hr size="1">
+<p class="Body">Last updated by: J&uuml;rgen
+Kn&ouml;dlseder 20 July
+2011
+</p>
 </body></html>
 \ No newline at end of file
 <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
-<html>
-<head>
+<html><head>
+<meta content="text/html; charset=ISO-8859-1" http-equiv="content-type"><title>Documentation</title>
-
-  
-  <meta content="text/html; charset=ISO-8859-1" http-equiv="content-type">
-
-  
-
-
-  
-  <title>Documentation</title>
-  <link rel="stylesheet" type="text/css" media="screen,print" href="gammalib.css">
+<link rel="stylesheet" type="text/css" media="screen,print" href="gammalib.css">
 </head>
-
 <body>
-
-
 <p class="Header">Documentation</p>
-
-
-<p style="padding-top: 0pt; text-align: left;" class="Body"><a href="doxygen/index.html">GammaLib code documentation (generated by Doxygen)</a>
+<p style="padding-top: 0pt; text-align: left;" class="Body"><a href="doxygen/index.html">GammaLib code documentation
+(generated by Doxygen)</a>
 </p>
-
-
-<br>
-
-
 <br>
-
-
-</body>
-</html>
+<hr size="1">
+<p class="Body">Last updated by: J&uuml;rgen
+Kn&ouml;dlseder 20 July
+2011
+</p>
+</body></html>
 \ No newline at end of file
 <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
-<html>
-<head>
-
-  <meta content="text/html; charset=ISO-8859-1" http-equiv="content-type">
-  <title>Doxygen</title>
-
-
-  <link rel="stylesheet" type="text/css" media="screen,print" href="gammalib.css">
-
-  <meta content="Jurgen Knodlseder" name="author">
-
-  <meta content="No Doxygen installed page" name="description">
-
-  <meta http-equiv="Refresh" content="30">
+<html><head>
+<meta content="text/html; charset=ISO-8859-1" http-equiv="content-type"><title>Doxygen</title>
+<link rel="stylesheet" type="text/css" media="screen,print" href="gammalib.css">
+<meta content="Jurgen Knodlseder" name="author">
+<meta content="No Doxygen installed page" name="description">
+<meta http-equiv="Refresh" content="30">
 </head>
-
 <body>
-
 <p class="Header">Doxygen</p>
-
 <p style="padding-top: 0pt; text-align: left;" class="Body">There
 seems to be no Doxygen documentation installed for GammaLib.
 </p>
-
 <br>
-
 <p style="padding-top: 0pt; text-align: left;" class="Body">To
 install Doxygen documentation, make sure that <a href="http://www.stack.nl/%7Edimitri/doxygen/" target="_blank">Doxygen</a>
 is installed on your system. If installed, then type the following in
 the GammaLib source directory:
 </p>
-
 <p class="Code">&gt; ./configure<br>
-
 &gt; make doxygen<br>
-
 &gt; make doxygen-install
 </p>
-
 <p style="padding-top: 0pt; text-align: left;" class="Body">
 Now the Doxygen documentation should be installed on your system. To
-verify if this is indeed the case, simply reload this page (or wait for 30 seconds).
+verify if this is indeed the case, simply reload this page (or wait for
+30 seconds).
 </p>
-
-<br>
-
 <br>
-
-</body>
-</html>
+<hr size="1">
+<p class="Body">Last updated by: J&uuml;rgen
+Kn&ouml;dlseder 20 July
+2011
+</p>
+</body></html>
 \ No newline at end of file
@@ -2,7 +2,8 @@
 <html><head>
 <meta content="text/html; charset=ISO-8859-1" http-equiv="content-type"><title>Home</title>
-<link rel="stylesheet" type="text/css" media="screen,print" href="gammalib.css"></head>
+<link rel="stylesheet" type="text/css" media="screen,print" href="gammalib.css">
+</head>
 <body>
 <p class="Header">GammaLib</p>
 <p style="padding-top: 0pt; text-align: left;" class="Body">
@@ -20,9 +21,14 @@ data analysis framework that enables simultaneous multi-mission
 analysis.</p>
 <br>
 <p style="padding-top: 0pt; text-align: left;" class="Body">GammaLib
-is free software distributed under the <a href="http://www.gnu.org/licenses/gpl.html" target="_blank">GNU GPL
+is free software distributed under the <a href="http://www.gnu.org/licenses/gpl.html" target="_blank">GNU
+GPL
 license version 3</a>.
 </p>
 <br>
-<br>
+<hr size="1">
+<p class="Body">Last updated by: J&uuml;rgen
+Kn&ouml;dlseder 20 July
+2011
+</p>
 </body></html>
 \ No newline at end of file
 <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
-<html>
-<head>
-
-  <meta http-equiv="content-type" content="text/html; charset=ISO-8859-1">
-  <title>Installation</title>
-
-
-  <link href="gammalib.css" media="screen,print" type="text/css" rel="stylesheet">
+<html><head>
+<meta http-equiv="content-type" content="text/html; charset=ISO-8859-1"><title>Installation</title>
+<link href="gammalib.css" media="screen,print" type="text/css" rel="stylesheet">
 </head>
-
 <body>
-
 <p class="Header">Installation</p>
-
 <p style="padding-top: 0pt; text-align: left;" class="Body"><a href="#Getting_GammaLib">
 Getting GammaLib
 </a><br>
-
 </p>
-
 <p style="padding-top: 0pt; text-align: left;" class="Body">
 <a href="#Prerequisites">Prerequisites</a></p>
-
 <p style="padding-top: 0pt; text-align: left;" class="Body">
 <a href="#Building_GammaLib">Building GammaLib</a></p>
-
 <p style="padding-top: 0pt; text-align: left;" class="Body">
 <a href="#Testing_GammaLib">Testing GammaLib</a></p>
-
 <p style="padding-top: 0pt; text-align: left;" class="Body"><a href="#Installing_GammaLib">Installing GammaLib</a></p>
-
 <p style="padding-top: 0pt; text-align: left;" class="Body"><a href="#Setting_up_your_environment">Setting up your
 environment</a></p>
-
 <p style="padding-top: 0pt; text-align: left;" class="Body"><a href="#Installing_documentation">Installing documentation</a></p>
-
 <p style="padding-top: 0pt; text-align: left;" class="Body">
 <a href="#Known_Problems">Known Problems</a></p>
-
 <p style="padding-top: 0pt; text-align: left;" class="Body">
 <a href="#Getting_Help">Getting Help</a></p>
-
 <br>
-
 <p style="padding-top: 0pt; text-align: left;" class="Body"><span style="font-weight: bold;">
-Note:</span> These installation instructions apply to
-GammaLib-00-04-06 and
-later.
+Note:</span> These installation instructions apply to <span style="font-family: Courier New,Courier,monospace;">gammalib-00-04-10</span>
+and
+later.&nbsp;<span style="font-family: Courier New,Courier,monospace;">gammalib-00-04-10</span>
+has been built, installed and tested successfully&nbsp;on Debian,
+Ubuntu,
+Mandriva, OpenSUSE, Scientific Linux, CentOS, gentoo, Mac OS X,
+FreeBSD, and OpenSolaris (using gcc), so hopefully it also installs on
+your distribution. In case you encounter problems, please post a report
+on the bug tracker on <a href="https://sourceforge.net/projects/gammalib/" target="_blank">https://sourceforge.net/projects/gammalib/</a>
+or send an e-mail to the
+<a href="mailto:gammalib-users@lists.soureforge.net">gammalib-users@lists.sourceforge.net</a>
+mailing list.
 </p>
-
 <br>
-
 <br>
-
 <p class="Title"><a name="Getting_GammaLib"></a>Getting
 GammaLib</p>
-
 <p style="padding-top: 0pt; text-align: left;" class="Body">
 The latest version of the GammaLib source code, documentation, and
 example programs are available on the World-Wide Web from <a href="https://sourceforge.net/projects/gammalib/" target="_blank">https://sourceforge.net/projects/gammalib/</a>.
 </p>
-
 <br>
-
 <br>
-
 <p class="Title"><a name="Prerequisites"></a>Prerequisites</p>
-
 <p style="padding-top: 0pt; text-align: left;" class="Body">
-GammaLib should compile on every modern Unix system <span style="font-weight: bold;">without any need to
-install other libraries</span>.
+GammaLib should compile on every modern Unix system without any need to
+install other libraries. To enable support for FITS file handling,
+however, <span style="font-weight: bold;">the cfitsio
+library
+from HEASARC needs to be installed</span>. cfitsio
+exists on many distributions as a prebuilt library, so in general you
+can
+directly install it using your package manager. Make sure that you
+install the library and the development package, as the cfitsio header
+file (which usually comes in the development package) is needed to
+compiling GammaLib.</p>
 <br>
-
-<br>
-
-To enable support for FITS file handling, however, the cfitsio library
-from HEASARC needs to be installed. cfitsio can be downloaded from
+<p style="padding-top: 0pt; text-align: left;" class="Body">If
+cfitsio is not available as a prebuilt package, or if you encounter
+some
+problems with the prebuilt package, cfitsio can be downloaded from
 <a href="http://heasarc.gsfc.nasa.gov/fitsio" target="_blank">http://heasarc.gsfc.nasa.gov/fitsio</a>
-and detailed installation instructions can be found there.
-If cfitsio does not already exist on your system, we recommend
-installation of cfitsio
-in the default GammaLib install directory as a shared library by
+and be installed from the source (for details, please refer to the
+installation
+instructions on the
+<a href="http://heasarc.gsfc.nasa.gov/fitsio" target="_blank">HESEARC</a>
+site).
+We recommend installation of cfitsio in the default GammaLib install
+directory as a shared library by
 typing:
 </p>
-
 <p class="Code">&gt; ./configure
 --prefix=/usr/local/gamma<br>
-
 &gt; make shared<br>
-
 &gt; make install
 </p>
-
 <p style="padding-top: 0pt; text-align: left;" class="Body">
 GammaLib can also benefit from the presence of the readline library
 that provides line-editing
 and history capabilities for text input (GammaLib offers however also
 full functionality without having
 readline installed).
-readline can be downloaded from
-<a href="http://ftp.gnu.org/gnu/readline/" target="_blank">http://ftp.gnu.org/gnu/readline/</a>
+readline (which depends on ncurses) is available on most system as a
+prebuilt library, so also here we recommend to use your package manager
+to install the libraries. Also here, the readline (and ncurses)
+development packages are required, so that the header files become
+available and the symbolic links are set correctly.</p>
+<p style="padding-top: 0pt; text-align: left;" class="Body"></p>
+<p style="padding-top: 0pt; text-align: left;" class="Body">If
+readline and ncurses are not available as a prebuilt package, or if you
+encounter some problems with the prebuilt packages, both libraries can
+be downloaded from <a href="http://ftp.gnu.org/gnu/" target="_blank">http://ftp.gnu.org/gnu/</a>.
 </p>
-
 <br>
-
 <br>
-
 <p class="Title"><a name="Building_GammaLib"></a>Building
 GammaLib</p>
-
 <p style="padding-top: 0pt; text-align: left;" class="Body">
 Download the latest source tarball, save it in an appropriate location,
 and type</p>
-
 <p class="Code">
 &gt; tar xvfz GammaLib-XX-XX-XX.tar.gz
 </p>
-
 <p style="padding-top: 0pt; text-align: left;" class="Body">
 where <span style="font-family: Courier New,Courier,monospace;">XX-XX-XX</span>
 is the version number of the library.
 Step in the created directory using
 </p>
-
 <p class="Code">
-&gt; cd GammaLib-XX-XX-XX
+&gt; cd gammalib-XX-XX-XX
 </p>
-
 <p style="padding-top: 0pt; text-align: left;" class="Body">
 and build GammaLib by typing</p>
-
 <p class="Code">
 &gt; ./configure<br>
-
 &gt; make
 </p>
-
 <p style="padding-top: 0pt; text-align: left;" class="Body">
 at the operating system prompt.
 The configuration command customizes the Makefiles for the particular
@@ -161,11 +147,9 @@ argument should be
 given,
 for example:
 </p>
-
 <p class="Code">
 &gt; ./configure --prefix=/usr/local
 </p>
-
 <p style="padding-top: 0pt; text-align: left;" class="Body">
 If cfitsio and/or readline is not installed in a standard location for
 libraries (such
@@ -175,45 +159,32 @@ the appropriate location(s) can be specified using the &lt;span style=&quot;font-family:
 (for the library directory) and <span style="font-family: Courier New,Courier,monospace;">CPPFLAGS</span>
 (for the include directory) options:
 </p>
-
 <p class="Code">
 &gt; ./configure LDFLAGS='-L/opt/local/lib'
 CPPFLAGS='-I/opt/local/include'
 </p>
-
 <p style="padding-top: 0pt; text-align: left;" class="Body">A
 full list of configuration options can be found using</p>
-
 <p class="Code">
 &gt; ./configure --help
 </p>
-
 <br>
-
 <br>
-
 <p class="Title"><a name="Testing_GammaLib"></a>Testing
 GammaLib</p>
-
 <p style="padding-top: 0pt; text-align: left;" class="Body">
 GammaLib should be tested by typing:</p>
-
 <p class="Code">
 &gt; make check
 </p>
-
 <p style="padding-top: 0pt; text-align: left;" class="Body">
 This will execute an extensive testing suite that should terminate with
 </p>
-
 <p class="Code">
 ===================<br>
-
 All 14 tests passed<br>
-
 ===================
 </p>
-
 <p style="padding-top: 0pt; text-align: left;" class="Body">Eventually,
 loading the shared cfitsio and/or readline libraries may fail during
 the test if the libraries are not located in standard locations. In
@@ -221,48 +192,34 @@ this case, add the library directories to the &lt;span style=&quot;font-family: Courier 
 environment variables (<span style="font-family: Courier New,Courier,monospace;">DYLD_LIBRARY_PATH</span>
 on Mac OS X), e.g.
 </p>
-
 <p class="Code">
 export LD_LIBRARY_PATH=/opt/local/lib:$LD_LIBRARY_PATH
 </p>
-
 <p style="padding-top: 0pt; text-align: left;" class="Body">
 or
 </p>
-
 <p class="Code">
 setenv LD_LIBRARY_PATH /opt/local/lib:$LD_LIBRARY_PATH
 </p>
-
 <p style="padding-top: 0pt; text-align: left;" class="Body">
 on C shell variants.</p>
-
 <br>
-
 <br>
-
 <p class="Title"><a name="Installing_GammaLib"></a>Installing
 GammaLib</p>
-
 <span style="font-family: 'Arial','Arial','Arial',sans-serif;"></span>
 <p style="padding-top: 0pt; text-align: left;" class="Body"><span style="font-family: 'Arial','Arial','Arial',sans-serif;">I</span>nstall
 GammaLib by typing</p>
-
 <p class="Code">
 &gt;&nbsp;make install
 </p>
-
 <p style="padding-top: 0pt; text-align: left;" class="Body">
 at the operating system prompt.
 </p>
-
 <br>
-
 <br>
-
 <p class="Title"><a name="Setting_up_your_environment"></a>Setting
 up your environment</p>
-
 <p style="padding-top: 0pt; text-align: left;" class="Body">
 Before using GammaLib you have to setup some environment variables.
 This will be done automatically by an initialisation script that will
@@ -270,44 +227,33 @@ be installed in the &lt;span style=&quot;font-family: Courier New,Courier,monospace;&quot;&gt;bi
 directory. Assuming that you have installed GammaLib in the default
 directory
 <span style="font-family: Courier New,Courier,monospace;">/usr/local/gamma</span>
-you need to add the following to your <span style="font-family: Courier New,Courier,monospace;">.bashrc</span>
+you need to add the following to your <span style="font-family: Courier New,Courier,monospace;">$HOME/.bashrc</span>
 or <span style="font-family: Courier New,Courier,monospace;">$HOME/.profile</span>
 script on a Linux
 machine:
 </p>
-
 <p class="Code">export GAMMALIB=/usr/local/gamma<br>
-
 source $GAMMALIB/bin/gammalib-init.sh
 </p>
-
 <p style="padding-top: 0pt; text-align: left;" class="Body">If
 you use C shell or a variant then add the following to your
-<span style="font-family: Courier New,Courier,monospace;">.cshrc</span>
-or <span style="font-family: Courier New,Courier,monospace;">.tcshrc</span>
+<span style="font-family: Courier New,Courier,monospace;">$HOME/.cshrc</span>
+or <span style="font-family: Courier New,Courier,monospace;">$HOME/.tcshrc</span>
 script:
 </p>
-
 <p class="Code">setenv GAMMALIB /usr/local/gamma<br>
-
 source $GAMMALIB/bin/gammalib-init.csh </p>
-
 <br>
-
 <br>
-
 <p class="Title"><a name="Installing_documentation"></a>Installing
 documentation</p>
-
 <p style="padding-top: 0pt; text-align: left;" class="Body">
 The GammaLib web pages are shipped together with the source code and
 will be installed in the directory <span style="font-family: Courier New,Courier,monospace;">$(prefix)/share/doc/gammalib/html</span>,
 where <span style="font-family: Courier New,Courier,monospace;">$(prefix)</span>
 is the installation base path, by default <span style="font-family: Courier New,Courier,monospace;">/usr/local/gamma</span>.
 </p>
-
 <br>
-
 <p style="padding-top: 0pt; text-align: left;" class="Body">
 For developers, a more detailed documentation can be built from the
 source code using Doxygen. Doxygen will scan the source files for code
@@ -318,73 +264,110 @@ command. If you have not installed Doxygen on your machine, but you
 need the development documentation, please visit <a href="http://www.stack.nl/%7Edimitri/doxygen/index.html" target="_blank">http://www.stack.nl/~dimitri/doxygen/index.html</a>
 to download and install the Doxygen package.
 </p>
-
 <br>
-
 <p style="padding-top: 0pt; text-align: left;" class="Body">
 Once Doxygen is install, type the following to build and to install the
 Doxygen documentation:
 </p>
-
 <p class="Code">&gt; ./configure<br>
-
 &gt; make doxygen<br>
-
 &gt; make doxygen-install
 </p>
-
 <p style="padding-top: 0pt; text-align: left;" class="Body">
 The Doxygen documentation will be installed into
 <span style="font-family: Courier New,Courier,monospace;">$(prefix)/share/doc/gammalib/html/doxygen</span>
 and can be browsed using a regular web browser.
 </p>
-
 <br>
-
 <p style="padding-top: 0pt; text-align: left;" class="Body">
 To check <span style="font-family: Courier New,Courier,monospace;">man</span>
 support, type for example
 </p>
-
 <p class="Code">&gt; man GObservations
 </p>
-
 <p style="padding-top: 0pt; text-align: left;" class="Body">
 and you should see the documentation for the <span style="font-family: Courier New,Courier,monospace;">GObservations</span>
 C++ class.
 </p>
-
 <br>
-
 <br>
-
 <p class="Title"><a name="Known_Problems"></a>Known
 Problems</p>
-
 <p style="padding-top: 0pt; text-align: left;" class="Body">
-<span style="font-weight: bold; font-size: 14px;">Solaris</span>
+<span style="font-weight: bold; font-size: 14px;">Python
+support</span>
 <br>
-
-GammaLib has been compiled successfully on Solaris 2.10 using the Sun
-Studio compiler. However, when linked as a shared library, symbols are
-not globally exported. This prevents the GammaLib library from catching
-its own exceptions and from registering models. Consequently, many unit
-tests will fail.
+GammaLib comes with Python wrappers so that all classes can be
+directly used from Python. To compile-in Python support, GammaLib
+needs the <span style="font-family: Courier New,Courier,monospace;">Python.h</span>
+header file, which on many distributions is not
+installed by default.
+To make <span style="font-family: Courier New,Courier,monospace;">Python.h</span>
+available, install the Python developer package
+in your distribution using the package manager. Otherwise you will not
+be able to use GammaLib
+from Python.
+</p>
 <br>
-
+<p style="padding-top: 0pt; text-align: left;" class="Body">
+<span style="font-weight: bold; font-size: 14px;">Mac OS X</span>
 <br>
-
-Using gcc (version 3.4.3), GammaLib works correctly on Solaris 2.10,
-yet loading GammaLib as a Python module fails.
+The Python development package is not installed as default on Mac
+OS X, and consequently, the <span style="font-family: Courier New,Courier,monospace;">Python.h</span>
+header file is missing that is
+needed to compile in the Python bindings. The <span style="font-family: Courier New,Courier,monospace;">configure</span>
+script recognises this fact and adjust the build procedure accordingly,
+but you
+will not be able to use GammaLib from Python. So better install the
+Python development package before installing&nbsp;GammaLib (see
+above).</p>
+<p style="padding-top: 0pt; text-align: left;" class="Body">It
+was also reported that adding of&nbsp;<span style="font-family: Courier New,Courier,monospace;">export
+MACOSX_DEPLOYMENT_TARGET=10.6</span> to the <span style="font-family: Courier New,Courier,monospace;">$HOME/.bashrc</span>
+file was necessary one
+some Mac OS X 10.6 installations to make&nbsp;GammaLib compile.<br>
+</p>
+<br>
+<p style="padding-top: 0pt; text-align: left;" class="Body"><span style="font-weight: bold; font-size: 14px;">Solaris</span>
+<br>
+Although&nbsp;GammaLib builds on Solaris using the Sun compiler,
+there are
+problems with global symbols in shared libraries and exception
+catching, which prevents the FITS interface to work
+correctly.&nbsp;GammaLib has however been built and tested
+successfully
+using the GNU
+compiler, and this is the only build method that is currently
+supported.
+Problems have also been encountered when compiling cfitsio versions
+more recent than 3.250. The problems have been reported to the cfitsio
+developer team, and are likely to be solved in the future. For the
+time being, it is recommended to use cfitsio version 3.250 on Solaris.
+</p>
+<br>
+<p style="padding-top: 0pt; text-align: left;" class="Body"><span style="font-weight: bold; font-size: 14px;">OpenSolaris</span>
+<br>
+On OpenSolaris, the same problems concerning the SunStudio compiler
+occur as for Solaris, and also here, the GNU compiler is the
+recommended
+tool to build&nbsp;GammaLib. Also here, cfitsio version 3.250 is
+the
+recommended library as more recent version feature relocation
+problems.&nbsp;GammaLib has been tested using gcc 4.3.2 on
+OpenSolaris
+2009.06. Make sure to create the symbolic links
+</p>
+<p class="Code">ln -s /usr/bin/gcc4.3.2 /usr/bin/gcc<br>
+ln -s /usr/bin/g++4.3.2 /usr/bin/g++</p>
+<p style="padding-top: 0pt; text-align: left;" class="Body">
+which are not there by default to avoid excess warnings during
+compilation.
 </p>
-
 <br>
-
 <br>
 <p class="Title"><a name="Getting_Help"></a>Getting
 Help</p>
-
 <p style="padding-top: 0pt; text-align: left;" class="Body">
 Any questions, bug reports, or suggested enhancements related to
 GammaLib should be submitted
@@ -393,6 +376,10 @@ or the
 <a href="mailto:gammalib-users@lists.soureforge.net">gammalib-users@lists.sourceforge.net</a>
 mailing list.
 </p>
-
-</body>
-</html>
+<br>
+<hr size="1">
+<p class="Body">Last updated by: J&uuml;rgen
+Kn&ouml;dlseder 20 July
+2011
+</p>
+</body></html>
 \ No newline at end of file
 <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
-<html>
-<head>
-
-  <meta http-equiv="content-type" content="text/html; charset=ISO-8859-1">
-  <title>Getting Started</title>
-
-
-  <link href="gammalib.css" media="screen,print" type="text/css" rel="stylesheet">
+<html><head>
+<meta http-equiv="content-type" content="text/html; charset=ISO-8859-1"><title>Getting Started</title>
+<link href="gammalib.css" media="screen,print" type="text/css" rel="stylesheet">
 </head>
-
 <body>
-
 <p class="Header">Getting started</p>
-
 <p style="padding-top: 0pt; text-align: left;" class="Body"><a href="#First%20steps%20with%20GammaLib">
 First steps with GammaLib</a><br>
-
 <a href="#Getting_Help">
 Getting Help</a>
 </p>
-
 <br>
-
 <p class="Title"><a name="First steps with GammaLib"></a>First
 steps with GammaLib</p>
-
 <p style="padding-top: 0pt; text-align: left;" class="Body">GammaLib
-comes with a Python interface, and as first step you should verify that the
+comes with a Python interface, and as first step you should verify that
+the
 Python interfaces workes correctly. You do this by typing:
 </p>
-
 <p class="Code">&gt; python<br>
-
 &gt;&gt;&gt; from gammalib import *<br>
-
 &gt;&gt;&gt;
 </p>
-
-<p style="padding-top: 0pt; text-align: left;" class="Body">If everything works fine you should just get a new Python prompt after importing GammaLib.
+<p style="padding-top: 0pt; text-align: left;" class="Body">If
+everything works fine you should just get a new Python prompt after
+importing GammaLib. If you get an error message, make sure that you've
+setup correctly the GammaLib environment. You basically need the <span style="font-family: Courier New,Courier,monospace;">PYTHONPATH</span>
+variable set to GammaLib's Python site-package, and you also have to
+make sure that GammaLib and any dependent library (cfitsio, readline,
+ncurses) is in the library load path (eventually you may need to adjust
+<span style="font-family: Courier New,Courier,monospace;">LD_LIBRARY_PATH</span>).
+This is all done automatically if you set up the environment as
+described <a href="installation.html#Setting_up_your_environment">here</a>.</p>
+<br>
+<p style="padding-top: 0pt; text-align: left;" class="Body">Now
+try:
 </p>
-
+<p class="Code">&gt;&gt;&gt; models=GModels()<br>
+&gt;&gt;&gt; print models<br>
+=== GModels ===<br>
+Number of models ..........: 0<br>
+Number of parameters ......: 0<br>
+&gt;&gt;&gt;
+</p>
+<p style="padding-top: 0pt; text-align: left;" class="Body">You
+just alloacted
+your first GammaLib object, which is an empty model container.</p>
 <br>
-
+<p style="padding-top: 0pt; text-align: left;" class="Body">Now
+let's append a model to this container. For this, type:
+</p>
+<p class="Code">&gt;&gt;&gt; pos = GSkyDir()<br>
+&gt;&gt;&gt; pos.radec_deg(83.6331, 22.0145)<br>
+&gt;&gt;&gt; spatial = GModelSpatialPtsrc(pos)<br>
+&gt;&gt;&gt; spectral = GModelSpectralPlaw(1.0, -2.0)<br>
+&gt;&gt;&gt; model = GModelPointSource(spatial, spectral)<br>
+&gt;&gt;&gt; models.append(model)<br>
+&gt;&gt;&gt; print models<br>
+=== GModels ===<br>
+Number of models ..........: 1<br>
+Number of parameters ......: 6<br>
+=== GModelPointSource ===<br>
+Name ......................:<br>
+Instruments ...............: all<br>
+Model type ................: "SkyDirFunction" * "PowerLaw" * "Constant"<br>
+Number of parameters ......: 6<br>
+Number of spatial par's ...: 2<br>
+&nbsp;RA .......................: 83.6331 deg (fixed,scale=1)<br>
+&nbsp;DEC ......................: 22.0145 deg (fixed,scale=1)<br>
+Number of spectral par's ..: 3<br>
+&nbsp;Prefactor ................: 1 +/- 0 [0,infty[ ph/cm2/s/MeV
+(free,scale=1,gradient)<br>
+&nbsp;Index ....................: -2 +/- 0 [-10,10]
+(free,scale=1,gradient)<br>
+&nbsp;PivotEnergy ..............: 100 MeV (fixed,scale=1,gradient)<br>
+Number of temporal par's ..: 1<br>
+&nbsp;Constant .................: 1 (relative value)
+(fixed,scale=1,gradient)<br>
+&gt;&gt;&gt;
+</p>
+<p style="padding-top: 0pt; text-align: left;" class="Body">With
+this
+sequence of commands you first defined a sky direction in celestial
+coordinates using <span style="font-family: Courier New,Courier,monospace;">GSkyDir</span>.
+You may easily recognise that this is the position of the Crab. You
+then used this position to define the spatial component of a sky model
+using <span style="font-family: Courier New,Courier,monospace;">GModelSpatialPtsrc</span>.
+As the name suggests, the spatial component is a point source. Next,
+you defined the spectral component using <span style="font-family: Courier New,Courier,monospace;">GModelSpactralPlaw</span>:
+a power law with normalisation of 1 and index of -2. Then, you combined
+the spatial and spectral components in a point source model using <span style="font-family: Courier New,Courier,monospace;">GModelPointSource</span>.
+And finally you appended the point source to the model container
+allocated previously using the <span style="font-family: Courier New,Courier,monospace;">append</span>
+method. When you then print the model container you see that is
+contains now one model with 6 parameters. Among them, you find the
+specified source position (parameters <span style="font-family: Courier New,Courier,monospace;">RA</span>
+and <span style="font-family: Courier New,Courier,monospace;">DEC</span>),
+the power law normalisation (parameter <span style="font-family: Courier New,Courier,monospace;">Prefactor</span>)
+and the spectral index (parameter <span style="font-family: Courier New,Courier,monospace;">Index</span>).
+In addition, the reference energy for the normalisation has been set
+automatically to 100 MeV (parameter <span style="font-family: Courier New,Courier,monospace;">PivotEnergy</span>)
+and the temporal component has been set by default to a constant
+(parameter <span style="font-family: Courier New,Courier,monospace;">Constant</span>).</p>
+<br>
+<p style="padding-top: 0pt; text-align: left;" class="Body">Suppose
+you want
+to change one of these parameters, such as the <span style="font-family: Courier New,Courier,monospace;">PivotEnergy</span>
+that you want
+to set to 1 TeV. This can be done using:</p>
+<p class="Code">&gt;&gt;&gt;
+models[0]['PivotEnergy'].value(1.0e6)<br>
+&gt;&gt;&gt; print models<br>
+...<br>
+&nbsp;PivotEnergy ..............: 1e+06 MeV (fixed,scale=1,gradient)<br>
+...<br>
+</p>
+<p style="padding-top: 0pt; text-align: left;" class="Body">As
+the units are MeV, we had to specify a value of 1e6 to set the
+reference energy to 1 TeV. We did this by accessing the first model in
+the container using <span style="font-family: Courier New,Courier,monospace;">models[0]</span>
+(counting in GammaLib always starts from 0). Then we addressed the <span style="font-family: Courier New,Courier,monospace;">PivotEnergy</span>
+parameter by specifying <span style="font-family: Courier New,Courier,monospace;">['PivotEnergy']</span>.
+And finally we called the <span style="font-family: Courier New,Courier,monospace;">value</span>
+method that sets the value of a particular parameter.</p>
+<br>
+<p style="padding-top: 0pt; text-align: left;" class="Body">After
+all this
+hard work, you may save your model into a XML file by typing:</p>
+<p class="Code">&gt;&gt;&gt;
+models.save('test.xml')<br>
+&gt;&gt;&gt;<br>
+</p>
+<p style="padding-top: 0pt; text-align: left;" class="Body">and
+you
+can load it from an XML file in memory using</p>
+<p class="Code">&gt;&gt;&gt;
+newmodels=GModels('test.xml')<br>
+&gt;&gt;&gt; print newmodels<br>
+</p>
+<p style="padding-top: 0pt; text-align: left;" class="Body">The
+last
+print command is to convince yourself that the models have been
+loaded properly.</p>
+<br>
+<p style="padding-top: 0pt; text-align: left;" class="Body">Much
+more is still to come. Please be a little bit patient, I'm working on
+it. In the meantime you may check the <a href="doxygen.html">Doxygen
+documentation</a> to see what classes and methods are available.</p>
 <br>
-
 <p class="Title"><a name="Getting_Help"></a>Getting
 Help</p>
-
 <p style="padding-top: 0pt; text-align: left;" class="Body">
 Any questions, bug reports, or suggested enhancements related to
 GammaLib should be submitted
@@ -57,6 +160,10 @@ or the
 <a href="mailto:gammalib-users@lists.soureforge.net">gammalib-users@lists.sourceforge.net</a>
 mailing list.
 </p>
-
-</body>
-</html>
+<br>
+<hr size="1">
+<p class="Body">Last updated by: J&uuml;rgen
+Kn&ouml;dlseder 20 July
+2011
+</p>
+</body></html>
 \ No newline at end of file
@@ -6,7 +6,7 @@ includedir=${prefix}/include
 Name: GammaLib
 Description: Versatile toolbox for analysis of astronomical gamma-ray data
 URL: http://gammalib.sourceforge.net/
-Version: 0.4.9
+Version: 0.4.10
 Requires: 
 Requires.private: @CFITSIO@
 Conflicts: