Join GitHub today
GitHub is home to over 28 million developers working together to host and review code, manage projects, and build software together.Sign up
Install ANUGA on Windows using Miniconda
Clone this wiki locally
anuga is developed on Linux (Ubuntu) and hence the installation on Linux (Ubuntu)
is more streamlined. But it is possible to install on windows.
First you need to install the required
then download the
anuga source and then compile and test.
The most time consuming part of the process is getting the
python environment setup.
This page describes how to use
miniconda as it allows you to
only install the packages that are needed (so is a bit quicker).
python as our programming environment together with a number
of standard python packages such as
numpy, scipy, matplotlib, netcdf4, gdal.
One way to install all the required packages is to use a distribution like
Anaconda and the related
environments. Also it is possible to download the appropriate
pre-compiled packages using the
But our preferred option is now Miniconda.
Download and run the Miniconda installer.
Choose either the win64 or the win32
python 2.7 version.
Python 2.7 is the version for which we are developing.
To ensure the path is set correctly, you should run the
activate.bat script. It lives in the
miniconda\scripts directory. The
miniconda directory should be located in your home directory.
You will have to run the
activate.bat script every time you open up the command line to run
anuga. I have setup a shortcut on the desktop to open the
cmd.exe and run this batch script.
Anuga python package dependencies
conda is now installed, we need to install
a number of other packages, via the
conda install command.
cmd.exe and run the
activate.bat script. Now install all the packages via
conda install -c conda-forge python=2.7 git pip nose numpy scipy netcdf4 matplotlib gdal mingwpy
Clone anuga via git
Our preferred method of installing
anuga and updating is to
git (Though you can use subverson or download a zipped file).
To obtain the anuga repo from github use
git clone i.e.
git clone https://github.com/GeoscienceAustralia/anuga_core.git
You should now have an anuga_core directory.
Now go to the directory anuga_core and build and install anuga.
From the cmd terminal, change to the
anuga_core directory and run
python setup.py build --compiler=mingw32 python setup.py install --skip-build
Hopefully no errors.
You can avoid adding the options
--skip-build if you edit the file
setup.cfg in the
anuga_core directory and set the
build option to
compiler=mingw32. Then you can simply run
python setup.py install
Run Unit tests
From the anuga_core directory run the unit tests via
Hopefully all the unit tests pass. As this is bleeding edge
there are sometimes a small number of failures as this is a
work in progress. Have a look at the examples in the directory
anuga_core/doc to see how to use anuga.
From time to time you should update your version of anuga.
cmd.exe and run
change into the
anuga_core directory and run
Then re-install the latest version of the code and check the unit tests via::
python setup.py clean python setup.py build --compiler=mingw32 python setup.py install --skip-build python runtests.py
python setup.py install python runtests.py
if you have changed the file
setup.cfg to use the compiler
mingw32 for building