Content

Munipack ‒ Installation

After successful download of Munipack, we can try to install one.

Binary distribution

The package can be easy installed by running the command via a terminal:

$ sh ./munipack_current.Linux-x86_64.bin

You can specify the installation path in displayed installation wizard. Simply specify /opt (or ~/opt/, /tmp/opt etc.) for the path. Note that munipack_current-x86_64.bin must be replaced by an appropriate package for your system.

Munipack's binaries will be prepared for use in sub-directory of the top directory what you specified, for example in /opt/munipack/bin. It's recommended to add the directory to your binaries's search path. Bash users may do it including of following line to ~/.bashrc:

PATH=$PATH:/opt/munipack/bin; export PATH

Csh users will add to their ~/.csh files:

set path = ( $path /opt/munipack/bin )

All Munipack's routines can be used imediatelly after succesfull installation. The GUI will be started by the command via the terminal:

bash$ xmunipack

Source Tarball Installation

Munipack is also distributed as a source code tarball and you need to compile it. This could be done quite easily on Linux based distributions, same as other *nix systems. First, step is unpacking the tarball. It may be done by following command:

 bash$ gzip -dc munipack_current.tar.gz | tar -xf -

Munipack installation itself is provided by GNU tools. Simply, install requirements and than run the following sequence of commands:

 bash$ ./configure
 bash$ make
 bash$ make install

Munipack will be installed without any GUI to /usr/local tree.

There is limited possibility to fit the installation according to your needs. By running of the command

 ./configure --help

you will display all possible switches to fine tuning of the compilation. Currently, there is only one switch to enable its GUI:

 --with-xmunipack        build with GUI, wxWidgets (no)

The switch is disabled by default due to compatibility with previous versions and to reduce of a possible dependencies. Better description of requirements and dependencies is summarized in paragraph Installation requirements.

Some setting of the environment variables can also affect of the compilation. For example, more progressive optimization of the output code for GNU compilers (gcc, gfortran) is provided by FCFLAGS and CFLAGS variables

 bash$ ./configure --with-xmunipack CFLAGS="-march=i686 -O3" FCFLAGS=$CFLAGS

Note. The installation under FreeBSD would be work with parameters:

 csh:> ./configure --with-xmunipack LDFLAGS=-L/usr/local/lib CPPFLAGS=-I/usr/local/include

Un-installation

Type

 make uninstall

in installation directory to do it.

Installation requirements

Any Linux distribution or Unix-like system.
Fortran 90 a C compilers.
The cfitsio library (build as shared library with Fortran support).
(Optional) C++ compiler and wxWidgets library.
Some basics knowledge of installation of software under *nix systems or any good friend.

Ubuntu

R. Novák take down his experience with installation under Ubuntu in how-to,

External utilities

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.

Step by step for Debian & Ubuntu

A guide for users which wants to compile Munipack itself WITH its GUI. Required packages are: gfortran, gcc, g++ and development versions of cfitsio and wxWidgets (as a layer on top of Gtk+). Modify the guide as you need.

bash$ su                                   # log as root in Debian
bash$ sudo bash                            #   ..        in Ubuntu
bash# aptitude install gfortran            # install Fortran compiler
bash# aptitude install gcc                 # install C compiler
bash# aptitude install g++                 # install C++ compiler
bash# aptitude install libcfitsio3-dev     # install development(!) version
bash# aptitude install libwxgtk2.8-dev     # 
bash# exit
bash$ cd ~/install                         # a dir with install packages
bash$ wget ftp://integral.physics.muni.cz/pub/munipack/munipack_current.tar.gz
bash$ tar zxf munipack_current.tar.gz
bash$ cd munipack
bash$ ./configure --with-xmunipack
bash$ make
bash$ su                                   # or sudo bash
bash# make install
bash# [make uninstall]                     # remove Munipack

If you have any problems or you found a bug or you have any question, please contact Munipack community.

Munipack's usage is briefly described at Basics page.

Last modification: Date