Installation

Local installation

1. Install git and development tools ( compilers, make, etc... ) On Debian GNU/Linux:

    sudo apt-get install build-essential
    sudo apt-get install git-core

2. Install dependencies( boost, petsc, hdf5 ). Make sure to install *-dev packages, since they contain header files necessary for compilation:

    sudo apt-get install libboost-all-dev petsc-dev libhdf5-dev

3. Obtain the sources:

    git clone https://github.com/epicf/ef your-ef-dir

4. Compile:

    cd your-ef-dir 
    make 

Optional dependencies

1. Hdftools and hdfview are helpfull in order to examine output *.h5 files. Hdftools are console, hdfview is graphical.

    sudo apt-get install hdf5-tools hdfview

2. While there are many tools to work with hdf5 files, examples in the repositories use python and h5py library. Apart from it, python3, numpy and matplotlib are necessary.

    sudo apt-get install python3 python3-h5py python3-numpy python3-matplotlib

3. Ef comes with experimental FreeCAD module to simplify preparation of config files. FreeCAD is a parametric 3d-modelling software. To use the module, install FreeCAD and create a link from it's module directory (typically, ~/.FreeCAD/Mod), to freecad folder in the Ef distribution.

    sudo apt-get install freecad
    ln -s /your-ef-dir/freecad/ ~/.FreeCAD/Mod/ef

4. Paraview support. To perform complex visualization of large amount of data several excellent tools exist. Two of them are Paraview and Visit. Ef comes with Paraview 'plugin'. Install Paraview and create a link from Paraview macros directory to 'paraview/ef.py' script in Ef distribution.

    sudo apt-get install paraview
    ln -s /your-ef-dir/paraview/ef.py ~/.config/ParaView/Macros/ef.py

Note on installation on HPC clusters:

Some libraries might be missing in the system. You'll have to either contact system administrator to install all missing libraries system-wide, or to install them locally (which is more likely). The following script, used on Scientific Linux, might be usefull.

Before compilation, you'll have to specify pathes to these libraries in Makefile. Example Makefile is attached.

Before running the program, you have to ensure that libraries you installed are seen in LD_LIBRARIES_PATH. This requires exporting them each time you log in into system:

    export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:${HOME}/petsc/opt/lib/