===== FEniCS =====

==== Local installation ====

=== Fool proof(??) step by step instruction ===

create a [[programming:python:virtualenv|virtual python environment]] named fenics with --system-site-packages
<code bash>
mkvirtualenv --python=`which python` fenics
</code>

<code bash>
pip install fenics
</code>
activate it by
<code bash>
workon fenics
</code>



=== Old step by step instruction (if you need dolfin) ===

load the Eigen 3.3 module or newer
<code bash>
module load eigen/3.3.4
</code>
get the repositories from git and install
<code bash>
mkdir fenics/src
cd fenics/src
git clone https://bitbucket.org/fenics-project/fiat
git clone https://bitbucket.org/fenics-project/instant
git clone https://bitbucket.org/fenics-project/dijitso
git clone https://bitbucket.org/fenics-project/ufl
git clone https://bitbucket.org/fenics-project/ffc
git clone https://bitbucket.org/fenics-project/dolfin
git clone https://bitbucket.org/fenics-project/mshr
cd fiat    && pip3 install . && cd ..
cd instant && pip3 install . && cd ..
cd dijitso && pip3 install . && cd ..
cd ufl     && pip3 install . && cd ..
cd ffc     && pip3 install . && cd ..
cd dolfin  && mkdir build && cd build && cmake -D CMAKE_INSTALL_PREFIX:PATH=$VIRTUAL_ENV -D Eigen3_DIR=$EIGEN3_DIR .. && make install && cd ..
cd mshr    && mkdir build && cd build && cmake -D CMAKE_INSTALL_PREFIX:PATH=$VIRTUAL_ENV -D Eigen3_DIR=$EIGEN3_DIR .. && make install && cd ..
</code>

update the env variables by putting
<code>
source $VIRTUAL_ENV/share/dolfin/dolfin.conf
export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:$VIRTUAL_ENV/lib64/
</code>
at the end of 
<code>
$VIRTUAL_ENV/bin/activate
</code>

== Docker installation (backup solution) ==

Fetch the current stable version of FEniCS (usually already provided on your system)

<code bash>
docker start -i fenics

</code>

== Basic features ==

List running docker container.
<code bash>docker ps</code>


**List all local available docker container** and versions, **check** if FEniCS is available at all on your PC. 
<code bash>docker ps -a</code>