2. Installation

Note

At present IslandsLib has been tested and works on Linux and MacOS systems. It is available at https://github.com/fmetivier/IslandsLib.

To work with IslandsLib you need first to install FreeFem++ then pyFreeFem and eventually IslandsLib

2.1. Install FreeFem++

FreeFem++ is a free and open source finite element PDE solver. FreeFem++ can be downloaded from https://freefem.org/. Running versions exist for all platforms.

If you’re using linux just use the package repository. Open a terminal and type

sudo apt-get install freefem++

This will install FreeFem properly.

2.2. Install pyFreeFem

to install pyFreeFem via pip, you must download the pyFreeFem library from the follwing fork on Github

git clone https://github.com/fmetivier/pyFreeFem.git

You must then open a terminal window in the main directory and enter

pip install .

Depending on your system and the way you work you may need administrator privileges

2.3. Install IslandsLib

Once FreeFem++ and pyFreeFem are installed you can download IslandsLib from github

git clone https://github.com/fmetivier/IslandsLib.git

open a terminal in the main directory and type

pip install .

Again depending on your environment you may need admin privileges. If everything goes swiftly, pip will install, if needed, the following dependancies: triangle, numpy, scipy, matplotlib, cartopy, shapely, geopandas, pandas

2.4. Tested

  • Debian 12

  • Debian 13

  • MacOS Sequoia 15.6.1