Installation

Firstly you will need to have Python 3 installed. You can do this by using Anaconda for a complete setup or the default implementation of Python.

The mango source can be downloaded here: Mango

Quickstart

git clone https://gitlab.com/mangocode/Mango.git@master

and install the resulting folder with pip:

pip install -U -e [mango folder]

Test

This should show you the internal help once installed

mango -h

The test suite can also be run on Linux with pytest

pytest [mango folder]/mango/tests

Dependencies

Minimal requirements:

• Python 3.6+

• NumPy

• SciPy

• Matplotlib

The above requirements are installed automatically when using pip.

Recommended Modules:

• pyFFTW

• Pytables

pyFFTW will speedup the fourier transform with a direct wrapper around the C FFTW library. Pytables provides an interface for hdf5 files. To use this you will also need to install the hdf5 library. This module allows for compressed and much more portable files.

pip install tables pyfftw

Optional Modules:

• mpi4py for massively parallel simulation

• Inquirer for more interactive postprocessing

• Vispy and imageio are needed to use the builtin particle visualiser, imageio-ffmpeg is needed for video production.

pip install mpi4py vispy imageio imageio-ffmpeg

Testing Modules:

• pytest to be able to run the test suite along with wurlitzer.

pip install pytest wurlitzer

It should be noted many of the tests in the test suite may fail on MacOS.