Installation procedure ---------------------- Requirements ~~~~~~~~~~~~ The installation of the basic SKYCORR binary package requires: - C99 compatible compiler (e.g. gcc or clang) - glibc 2.11 or newer on Linux or OS X 10.7 or newer - common unix utilities (bash, tar, sed, grep, ...) The optional GUI interface to SKYCORR requires: - Python v2.6 or v2.7 (but not Python v3) - wxPython v2.8 or newer - Python matplotlib v1.0 or newer - PyFITS v2.4 or newer The command line client also has optional display features which require: - gnuplot v4.2 patchlevel 3 or newer Binary installation ~~~~~~~~~~~~~~~~~~~ First the downloaded installer needs to be made executable. To do this change into the directory the installer was downloaded to and run following command (replacing `skycorr_installer.run` with the actual downloaded filename): chmod u+x ./skycorr_installer.run Now the installer can be executed from the same folder with: ./skycorr_installer.run It will ask for an installation directory where it will extract its contents to. It is recommended to choose an empty directory to avoid overwriting existing files. After the installer has successfully finished, the skycorr executables are installed into the `bin` subdirectory of the chosen installation folder. They can be executed by specifying the full or relative path. Also installed are a set of example parameter files for several instruments in the `examples/config` directory. To run a SINFONI example type: /bin/skycorr /examples/config/sctest_sinfo_H.par The following directory structure is created by the installation routine: | |-- bin |-- config |-- doc |-- examples | |-- config | |-- data | |-- sysdata -> /sysdata/ |-- output |-- sysdata In detail: * `bin`: location of binary files * `config/`: directory containing template configuration files * `doc/`: documentation * `examples/`: directory with examples * `output/`: default output directory * `sysdata/`: directory containing data required for SKYCORR GUI dependencies ~~~~~~~~~~~~~~~~ The GUI requires some additional dependencies to be installed on the system. To check if the python installation is able to run the GUI following commands can be run: python -c 'import wx' python -c 'import matplotlib; import matplotlib.backends.backend_wxagg' python -c 'import pyfits' If these commands fail please see following site for instructions on how to install these packages: http://www.eso.org/pipelines/reflex_workflows/ Package contents ~~~~~~~~~~~~~~~~ The installation package is a self extracting tarball containing the molecfit source code and pre-built versions of its third party dependencies: - Common Pipeline Library CPL v6.6.0 and its dependencies cfitsio v3.350, wcslib v4.16 and fftw3 v3.3.4 Source Installation: ~~~~~~~~~~~~~~~~~~~~ Advanced users may want to install everything from source, the basic instructions for this are outlined in this section. CPL compilation +++++++++++++++ The CPL sources can be obtained from http://www.eso.org/cpl/ For molecfit, CPL only requires cfitsio. It can be installed as follows: ./configure --prefix=/install-location make make shared make install Then CPL can be install with: ./configure --prefix=/install-location --with-cfitsio=/install-location make make install See the respective packages documentation for details on the installation procedure. SKYCORR compilation +++++++++++++++++++ After all dependencies have been installed SKYCORR can be compiled from source into the same location. This is the only step required if one wants to update SKYCORR from source after previously installing the third party dependencies with the binary installer. ./configure --prefix=/install-location --with-cpl=/install-location make make install In order to use SKYCORR from this location the environment variable `LD_LIBRARY_PATH` (or `DYLD_LIBRARY_PATH` on Mac OS) need to be set. With the bash shell this is done with following command: export LD_LIBRARY_PATH=/install-location/lib Now skycorr is ready to be used from `/install-location/bin`.