Building Munipack from source codes
Remember! The standard way to prepare your binary package is described by DEBbuilder and RPMbuilder pages.
As prerequisity, it is supposed to run commands introduced by # as root
# id uid=0(root) ..
and ones denoted by $ as an ordinary user:
$ id uid=12345(user) ...
There is short summary of installation steps which will install lates stable release (replace X.Y) of Munipack to your system:
$ cd /tmp $ wget ftp://munipack.physics.muni.cz/pub/munipack/munipack-0.X.Y.tar.gz $ tar zxf munipack-0.X.Y.tar.gz $ cd munipack-0.X.Y $ ./configure $ make # make install
Read below for more detailed description.
To fit a nostandard needs, there are some alternative ways for configure:
./configure --prefix=/opt/munipack --enable-bundle
./configure --disable-gui
./configure --disable-cli
./configure --disable-vo
Together use of all the disable options (--disable-[gui|cli|vo]) eliminates completely dependency on wxWidgets. cFITSIO library is necessary in any case.
This page describes how to build Munipack from source codes. The source distribution is the most portable way how to get Munipack. Some experience with a software building is required.
The building takes phases:
At the moment, Munipack can be clearly compiled under GNU/Linux, g++, gfortran and wxWidgets ver. 3.0.0 (and above) only.
Other combinations compilers, operating systems, etc. will require some additional tuning. Munipack is designed pretty much portable and multiplatform (Mac OS X, MS Windows) but every platform needs a fine tuning of details which wasn't done yet.
There are two ways how to get sources of Munipack. Source tarball offers more reliable way opposite to Mercurial's way which is on the cutting edge.
The preferred path for placing sources is /usr/src, for example /usr/src/munipack-0.5.X. The path is available only for system administrator. If you haven't root privileges, use src (for example) directory in your home $HOME/src
$ mkdir $HOME/src
and replace all references /usr/src to $HOME/src in following text.
The tarball contains the stable branch (a relative stable and updated) version of Munipack.
Download: ftp://munipack.physics.muni.cz/pub/munipack/
To get source tree, unpack the tarball as:
# cd /usr/src # wget ftp://munipack.physics.muni.cz/pub/munipack/munipack-0.5.X.tar.gz # gzip -dc munipack-0.5.XXX.tar.gz | tar -xf -
Sources stored in Mercurial repository contains the development branch. The branch contains latest development files which can be unstable, bug compilation, etc.
To get source tree, follow instructions for Mercurial or try:
# cd /usr/src # hg clone http://munipack.physics.muni.cz/hg/munipack munipack-0.5.X/
Following tools are required for compiling of Munipack:
All libraries must be installed in development version. Your package system probably contains development libraries as -dev (-devel) packages. Without development libraries, the building will be unsuccessful.
The requirement for the latest version of wxWidgets is mainly due to support of the event handling system for the command-line interface. The instructions for its installation can be found on wiki: http://wiki.wxwidgets.org/Prerequisites.
Minpack is autodetected: If minpack library is found on target system, the system wide is used, else the internal source is used. Minpack needs Fortran 77 compiler (provided by modern Fortran compilers due backward-compatibility).
Autoconfig is required for bootstraping (the configure script generation) when source is downloaded via Mercurial version system.
Some older Linux distributions have no latest wxWidgets included (branch 3.0.x or high). wxWidgets must be prepared by the way:
Install prerequisites for Fedora/RHELL:
yum install mercurial autoconfig automake gtk2-devel gcc-gfortran gcc-c++ cfitsio-devel
and execute commands:
$ tar jxf wxWidgets-3.0.X.tar.bz2 $ cd wxWidgets-3.0.X/ $ ./configure --enable-graphics_ctx --enable-stl --enable-baseevtloop $ make # make install
Parallel installation of an older and that libraries version should be a bad idea.
Required only in case of Mercurial's source tree.
Requires:
Munipack building is on base of Autotools which is most widely portable way working under all common environments. The initialisation of building framework is required.
The building is controlled by configure.ac (top) and set of Makefile.am-s (all building directories).
This phase creates regular configure script and Makefiles by processing of the control files.
$ ./bootstrap
In case of the error is reported:
configure.ac:76: warning: macro `AM_OPTIONS_WXCONFIG' not found in library configure.ac:77: warning: macro `AM_PATH_WXCONFIG' not found in library
invoke the bootstrap with parameter pointing to directory with wxwin.m4 file (usually /usr/local/share/aclocal):
$ ./bootstrap /usr/local/share/aclocal
The unpacked and initialised source is ready for compilation. This can be done quite easy on Linux based distributions, same as other Unix's systems. The configuration, compilation and installation is provided by the standard GNU way. Simply, run the following sequence of commands:
$ ./configure $ make $ make install
Munipack will check available tools and will be installed by default under tree /usr/local.
The phase will work under any supported system. C++ and Fortran compilers and appropriate development libraries needs to be installed, of course.
There is limited possibility to fit the installation according to your needs. Running of the command
./configure --help
will display possible switches to fine tuning of building.
Some setting of the environment variables can also affect of the compilation process. For example, more progressive optimisation of the output code for 32-bit machines (64-bit machines are optimised on the level by default) and GNU compilers (g++, gfortran) is provided by FCFLAGS and CFLAGS variables
$ ./configure CXXFLAGS="-march=i686 -O3" FCFLAGS="-march=i686 -O3"
The installation under FreeBSD would work with parameters:
csh:> ./configure LDFLAGS=-L/usr/local/lib CPPFLAGS=-I/usr/local/include
The installation under Fedora/RHEL will require
./configure CXXFLAGS=-I/usr/include/cfitsio
The --enable-bundle switch provides a way to install full Munipack package to a separate directory. See Binary Builder section.
On finish, the configure command will print some summary:
Configured Munipack:
Virtual Observatory support enabled: yes
Command line interface enabled: yes
Graphical User Interface enabled: yes
Bundle installation: no
When the configure script had found successfully wxWidgets library, the first and second option will set to yes. Note that both command line and graphical interfaces requires wxWidgets. Without wxWidgets, only processing engines are compiled. Engine utilities has no user interfaces and any communication is released only via standard input and output (which can be very useful for daemons, web interfaces, etc.). The last summary option indicates no presence of --enable-bundle switch.
Use commands
# cd /usr/src/munipack-0.5.X # make uninstall
in installation directory to uninstall Munipack.
That means that it is not a good idea to remove the source directory immediately after installation (the reason to use /usr/src or an equivalent path).
The compilation might fail when you run make with parallel build enabled (by -j switch or via MAKEFLAGS). Workaround: run make as many as needed or unset the -j option. One usually appears when compiler is looking for Fortran modules.
A few actions and an import and an export of non-fits images and animations, are provided by some external utilities. Please visit the page with external utilities description to get more information.