Contents
ANUGA is a python package with some C extensions (and an optional fortran extension). At present ANUGA has only been run and tested using python 2.x and Python 3.8.x We recommend python 2.8.2
AnuGA requires the following packages:
- numpy
- scipy
- matplotlib
- gdal
- netcdf
- nose
- dill
- A C compiler (preferably GCC or TDM-GCC MinGW on Windows) # Possibly deprecated by the use of Cython?
- Cython <https://cython.org/>
- future <https://pypi.org/project/future # Possible superfluous if we ditch backward compatibility with Python 2.7
AnuGA is developed on Ubuntu. The preferred way to install the dependencies is
to use the standard ubuntu apt-get method.
We suggest installing the latest version of ANUGA from Github. We try to maintain the master branch stable and passing all tests, so it should be safe to use.
Follow these instructions to Install ANUGA on Ubuntu (using apt-get)
An alternative is to install the dependencies using the Anaconda or the Miniconda Python distributions by Continuum Analytics.
Miniconda has the advantage of allowing you to create multiple python environments and is particularly useful if you want to keep multiple versions of AnuGA.
Both Anaconda and Miniconda do not require administrative rights to your computer and do not interfere with the Python installed in your system.
Follow these instructions to Install ANUGA on Ubuntu (using Miniconda)
Starting from Windows 10, it is possible to run an Ubuntu Bash console from Windows. This can greatly simplify the install for Windows users. You'll still need administrator access though.
Follow the instructions Install ANUGA on Window 10 using Ubuntu for Windows
We have successfully installed AnuGA 'natively' on windows using Gohlke Binaries and using Miniconda. At present we recommend using the Miniconda.
Follow the instructions install ANUGA on Windows using Miniconda
Alternatively follow the instructions install ANUGA on Windows using the Gohlke Binaries
Unfortunately, the gcc compiler MinGW included in Anaconda or
installable via Miniconda doesn't have OpenMP support. This is required to compile
some extension modules in ANUGA (those that have multi-threaded parallel code).
We suggest that you download and install the version of MinGW provided by TDM-GCC
after you've installed Anaconda and before you install ANUGA.
Don't forget to mark the openmp and gfortran options in the "Choose Components" part of
the installation. See this excellent documentation for Windows users
(they even have screenshots!). The same applies if you are using Miniconda.
Note
The Windows installer from older versions is no longer supported.