Puma-EM comes with bash scripts that are supposed to help you in installing the third party software. We strongly advise you to read and use the script corresponding to your machine. They are contained within the installScripts, which you can download alongside Puma-EM itself. You'll need root password to run any of these scripts. Ask your administrator to run/explain it for/to you.

If you decide to go on your own, the third party software should be installed in the same order as given below. It has to be installed on each machine on which you plan to run Puma-EM.

gmsh is a three-dimensional finite element mesh generator. It will be used for generating the triangles that Puma-EM uses for the computations. You have 3 choices, given by order of preference, when it comes to installing gmsh:

Binary install

The easiest way. Download the most recent binary package, extract it, and copy the "gmsh" executable in the "/usr/bin" or "/usr/local/bin" directory of the machine

Package install

gmsh is available as a package, available through the package manager, for Ubuntu Linux flavors. Search it through the package manager. It is however less complete than the binary package mentioned above

Source install

You can of course compile gmsh from source, although the advantage wrt a binary install is not clear. Note also that this method requires to install many more libraries not mentioned in this guide

Puma-EM uses g++ and g77 compilers. It does not work with intel compilers.

g++

to be installed through the package manager

g77

on Ubuntu, search for g77 in the package manager. On OpenSUSE and Fedora/RedHat, search for "compat-g77" and install related files.

C++ fast array library, providing performances near those of fortran. On most Ubuntu/Debian flavors, Blitz++ exists as a package. Otherwise, you have to compile the library. First, go download the source. Then issue the commands:

.....Lots of output.....

.....little output.....

the installation command must be done as root.

A scientific library for python, which allows for the efficient use of arrays within python. Installation depends upon Linux distribution:

Ubuntu/Debian flavors

scipy is usually available through the package manager. Otherwise go to Others

OpenSuse 10.0/10.1

add as repository "http://download.opensuse.org/repositories/science/SUSE_Linux_10.x/", where x = 0 or 1. Then install through the package manager

OpenSuse 10.2/10.3

add as repository "http://download.opensuse.org/repositories/science/openSUSE_10.x/", where x = 0 or 1. Then install through the package manager

Others

try a search through the package manager. On rpm-based Linux systems, you may try a rpm search. If unsuccessful, check this link for installation instructions.

User-friendly plotting library for python. On Ubuntu/OpenSuse it normally exists a package repository. If not, check this link for easy installation instructions. Also, you have to install the "texlive" and "texlive-extra" packages, which are available through your package manager.

MPI runtime environment and development files for running and compiling Puma-EM programs. User has two choices:

LAM/MPI

classic open-source LAM environment, available through the package manager. Install also the development files.

Open-MPI

the future replacement of LAM/MPI. Install also the development files.

mpi4py is MPI for python. Please note that it will be compiled and installed using the parallel environment that you installed previously, namely, LAM/MPI or Open-MPI. If for some reason you change your parallel environment, please recompile mpi4py accordingly. Usually, it is not available through a package manager. To install, grab the source file, extract the tarball and then do the following commands:

.....Lots of output.....

the last command must be done as root.