Installation

Compatibility and Dependencies

The dependencies of turtleFSI are:

  • FEniCS 2019.1.0
  • Numpy >1.1X
  • Python >=3.7

Basic Installation

If you have a MacOX or Linux operating system we recommend that you install turtleFSI through Anaconda. First, install Anaconda or Miniconda, depending on your need. For just installing turtleFSI we recommend Miniconda. Then execute the following command in a terminal window:

$ conda create -n your_environment -c conda-forge turtleFSI

You can then activate your environment by running source activate your_environment. Now you are all set, and can start using turtleFSI. A detailed explanation for usage of turtleFSI can be found here.

If you are using turtleFSI on a high performance computing (HPC) cluster we always recommend that you build from source, as described below. This is in accordance with the guidelines provided by the FEniCS project users to install FEniCS from source when on a HPC cluster.

Development version

Downloading

The latest development version of turtleFSI can be found on the official turtleFSI git repository on Github. To clone the turtleFSI repository, open a terminal, navigate to the directory where you wish turtleFSI to be stored, type the following command, and press Enter:

$ git clone https://github.com/KVSlab/turtleFSI

After the source distribution has been downloaded, all the files will be located in the newly created turtleFSI folder.

Building

In order to build and install turtleFSI, navigate into the turtleFSI folder, where a setup.py file will be located. First, make sure that all dependencies are installed. Then, you can install turtleFSI be executing the following:

$ python setup.py install

If you are installing turtleFSI somewhere you do not have root access, typically on a cluster, you can add --user to install locally.