Get Feel++

Feel++ can be installed on Windows 10, Debian/Ubuntu systems.

We created two delivery channels: stable and latest.

stable: Docker and Debian/Ubuntu packages with latest Feel++ release following the master branch.
latest: Docker and Debian/Ubuntu packages with latest Feel++ development following the develop branch.

Ubuntu
Debian
Fedora
Windows 10
Docker

Ubuntu LTS distributions focal(20.04-preferred) is supported.

We may support short term distributions.

Focal (20.04)

Command lines to install the latest Feel++ channel on ubuntu/focal

wget -qO - http://apt.feelpp.org/apt.gpg | sudo apt-key add
echo "deb http://apt.feelpp.org/ubuntu/focal focal latest" | sudo tee -a /etc/apt/sources.list.d/feelpp.list
sudo apt update

Jammy (22.04)

Command lines to install the latest Feel++ channel on ubuntu/jammy

wget -qO - http://apt.feelpp.org/apt.gpg | sudo apt-key add
echo "deb http://apt.feelpp.org/ubuntu/jammy jammy latest" | sudo tee -a /etc/apt/sources.list.d/feelpp.list
sudo apt update

The supported systems are described below

Table 1. Table Feel++ Ubuntu distributions
Distribution	Release	Version	Supported Channels	Comment
ubuntu	focal	20.04	latest	LTS
ubuntu	jammy	22.04	latest	LTS

Other Ubuntu systems

Feel++ is also compiled regularly on the latest Ubuntu distribition, currently Kinetic (22.10), see how to build Feel++ from sources.

Ubuntu Kinetic (22.10)

$ docker run --rm -it ghcr.io/feelpp/feelpp-env:ubuntu-22.10

Install Feel++ Debian/Ubuntu packages

We describe here the installation of the debian packages for LTS distributions.

Table 2. Table Feel++ Ubuntu packages
Name	Description
libfeelpp1	shared libraries
libfeelpp-dev	development headers and libraries
feelpp-tools	mesh partitioners and remote data upload/download
feelpp-quickstart	quickstart applications (laplacian cg an hdg), stokes, elasticity(cg and hdg)
python3-feelpp	Python3 bindings
feelpp-data	data files (geometry and config files) for Feel++ applications (e.g. feelpp-quickstart)
libfeelpp-toolboxes1	toolboxes shared libraries
libfeelpp-toolboxes-dev	toolboxes development headers and libraries
feelpp-toolboxes	toolbox applications
feelpp-toolboxes-data	data files (geometry and config files) for Feel++ toolboxes

Installation examples

Install the library

$ sudo apt install libfeelpp1

Install the tools

$ sudo apt install feelpp-tools

Install the quickstart applications and associated data

$ sudo apt install feelpp-quickstart feelpp-data

Install the toolboxes applications and associated data

$ sudo apt install feelpp-toolboxes feelpp-toolboxes-data

Install the toolboxes development environment

$ sudo apt install libfeelpp-toolboxes-dev

Reinstall the runtime environment feelpp, the toolboxes and the python3 packages

$ sudo apt install --reinstall 'feelpp-*' 'libfeelpp1' 'python3-feelpp-*'

Reinstall the development environment for feelpp and the toolboxes

$ sudo apt install --reinstall 'libfeelpp*'

Debian LTS distributions bullseye(11) is supported.

The supported systems are described below

Table 3. Table Feel++ Debian distributions
Distribution	Release	Version	Supported Channels	Comment
debian	bullseye	11	latest	LTS
debian	testing	-	latest	testing
debian	sid	-	latest	unstable

Bullseye (11)

Command lines to install the latest Feel++ channel on debian/bullseye

wget -qO - http://apt.feelpp.org/apt.gpg | sudo apt-key add
echo "deb http://apt.feelpp.org/debian/bullseye bullseye latest" | sudo tee -a /etc/apt/sources.list.d/feelpp.list
sudo apt update

Testing (testing)

Command lines to install the latest Feel++ channel on debian/testing

wget -qO - http://apt.feelpp.org/apt.gpg | sudo apt-key add
echo "deb http://apt.feelpp.org/debian/testing testing latest" | sudo tee -a /etc/apt/sources.list.d/feelpp.list
sudo apt update

Sid (unstable)

Command lines to install the latest Feel++ channel on debian/sid

wget -qO - http://apt.feelpp.org/apt.gpg | sudo apt-key add
echo "deb http://apt.feelpp.org/debian/sid sid latest" | sudo tee -a /etc/apt/sources.list.d/feelpp.list
sudo apt update

Other Debian systems

Feel++ is also compiled regularly on the latest Debian distribitions testing and unstable (sid). See how to build Feel++ from sources.

Debian testing

$ docker run --rm -it ghcr.io/feelpp/feelpp-env:debian-testing

Debian unstable (sid)

$ docker run --rm -it ghcr.io/feelpp/feelpp-env:debian-sid

Install Feel++ Debian/Ubuntu packages

We describe here the installation of the debian packages for LTS distributions.

Table 4. Table Feel++ Ubuntu packages
Name	Description
libfeelpp1	shared libraries
libfeelpp-dev	development headers and libraries
feelpp-tools	mesh partitioners and remote data upload/download
feelpp-quickstart	quickstart applications (laplacian cg an hdg), stokes, elasticity(cg and hdg)
python3-feelpp	Python3 bindings
feelpp-data	data files (geometry and config files) for Feel++ applications (e.g. feelpp-quickstart)
libfeelpp-toolboxes1	toolboxes shared libraries
libfeelpp-toolboxes-dev	toolboxes development headers and libraries
feelpp-toolboxes	toolbox applications
feelpp-toolboxes-data	data files (geometry and config files) for Feel++ toolboxes

Installation examples

Install the library

$ sudo apt install libfeelpp1

Install the tools

$ sudo apt install feelpp-tools

Install the quickstart applications and associated data

$ sudo apt install feelpp-quickstart feelpp-data

Install the toolboxes applications and associated data

$ sudo apt install feelpp-toolboxes feelpp-toolboxes-data

Install the toolboxes development environment

$ sudo apt install libfeelpp-toolboxes-dev

Reinstall the runtime environment feelpp, the toolboxes and the python3 packages

$ sudo apt install --reinstall 'feelpp-*' 'libfeelpp1' 'python3-feelpp-*'

Reinstall the development environment for feelpp and the toolboxes

$ sudo apt install --reinstall 'libfeelpp*'

Feel++ is not yet packaged for Fedora. However

it is possible to compile it from source for Fedora:36 and Fedora:37
a docker image containing Feel++ development environment is available for both systems

Fedora 36(stable)

$ docker run --rm -it ghcr.io/feelpp/feelpp-env:fedora-36

Fedora 37(beta)

$ docker run --rm -it ghcr.io/feelpp/feelpp-env:fedora-37

see how to build Feel++ from sources.

To use Feel++ on Windows 10, follow these steps:

install WSL (Windows Subsystem for Linux)
install Ubuntu focal (20.04) Ubuntu jammy(22.04) or Debian bullseye(11)
follow the corresponding Ubuntu or Debian Feel++ installation steps

Install Feel++ Debian/Ubuntu packages

We describe here the installation of the debian packages for LTS distributions.

Table 5. Table Feel++ Ubuntu packages
Name	Description
libfeelpp1	shared libraries
libfeelpp-dev	development headers and libraries
feelpp-tools	mesh partitioners and remote data upload/download
feelpp-quickstart	quickstart applications (laplacian cg an hdg), stokes, elasticity(cg and hdg)
python3-feelpp	Python3 bindings
feelpp-data	data files (geometry and config files) for Feel++ applications (e.g. feelpp-quickstart)
libfeelpp-toolboxes1	toolboxes shared libraries
libfeelpp-toolboxes-dev	toolboxes development headers and libraries
feelpp-toolboxes	toolbox applications
feelpp-toolboxes-data	data files (geometry and config files) for Feel++ toolboxes

Installation examples

Install the library

$ sudo apt install libfeelpp1

Install the tools

$ sudo apt install feelpp-tools

Install the quickstart applications and associated data

$ sudo apt install feelpp-quickstart feelpp-data

Install the toolboxes applications and associated data

$ sudo apt install feelpp-toolboxes feelpp-toolboxes-data

Install the toolboxes development environment

$ sudo apt install libfeelpp-toolboxes-dev

Reinstall the runtime environment feelpp, the toolboxes and the python3 packages

$ sudo apt install --reinstall 'feelpp-*' 'libfeelpp1' 'python3-feelpp-*'

Reinstall the development environment for feelpp and the toolboxes

$ sudo apt install --reinstall 'libfeelpp*'

A docker image is generated with the deb packages. The image is based on the LTS distribution Ubuntu Focal 20.04.

To download and execute it, follow the steps described below

Download and run the feelpp docker image: contains feelpp, feelpp-toolboxes, feelpp-mor and feelpp-python

docker pull ghcr.io/feelpp/feelpp:focal
docker run --rm -it -v $HOME/feel:/feel ghcr.io/feelpp/feelpp:focal

Download and run the feelpp docker image including the development kit: contains feelpp, feelpp-toolboxes, feelpp-mor and feelpp-python

docker pull ghcr.io/feelpp/feelpp-dev:focal
docker run --rm -it -v $HOME/feel:/feel ghcr.io/feelpp/feelpp-dev:focal