ANUGA

Simulation of the shallow water equation, in particular it can be used to model tsunamis and floods.
https://github.com/geoscienceaustralia/anuga_core

Category: Climate Change
Sub Category: Natural Hazard and Storms

Keywords

finite-volume flooding shallow-water-equations tsunami

Keywords from Contributors

geodesy insar

Last synced: about 4 hours ago
JSON representation

Repository metadata

AnuGA for the simulation of the shallow water equation

• Host: GitHub
• URL: https://github.com/geoscienceaustralia/anuga_core
• Owner: GeoscienceAustralia
• License: other
• Created: 2014-12-24T00:51:55.000Z (over 11 years ago)
• Default Branch: main
• Last Pushed: 2026-04-05T01:14:15.000Z (26 days ago)
• Last Synced: 2026-04-21T01:03:11.226Z (10 days ago)
• Topics: finite-volume, flooding, shallow-water-equations, tsunami
• Language: Python
• Homepage: https://anuga.anu.edu.au
• Size: 72.7 MB
• Stars: 217
• Watchers: 53
• Forks: 106
• Open Issues: 69
• Releases: 18
• Metadata Files:
  • Readme: README.rst
  • Contributing: CONTRIBUTING.rst
  • License: LICENSE.txt
  • Citation: CITATION.cff

README.rst

          
.. |badge0| image:: https://badges.gitter.im/gitterHQ/gitter.png
    :target: https://app.gitter.im/#/room/#anuga-community:gitter.im
    :alt: Community Chat


.. |badge1| image:: https://github.com/anuga-community/anuga_core/actions/workflows/conda-setup.yml/badge.svg
    :target: https://github.com/anuga-community/anuga_core/actions/workflows/conda-setup.yml
    :alt: GitHub Actions Status


.. |badge3| image:: https://img.shields.io/pypi/v/anuga.svg
    :target: https://pypi.python.org/pypi/anuga/
    :alt: Latest PyPi Version

.. |badge4| image:: https://img.shields.io/pypi/dm/anuga.svg
    :target: https://pypistats.org/packages/anuga
    :alt: PyPi download statistics

.. |badge5| image:: https://img.shields.io/conda/vn/conda-forge/anuga.svg
    :target: https://anaconda.org/conda-forge/anuga
    :alt: Latest Conda Version
 
.. |badge6| image:: https://img.shields.io/conda/dn/conda-forge/anuga.svg
    :target: https://anaconda.org/conda-forge/anuga
    :alt: Conda Forge download statistics

.. |badge7| image:: https://readthedocs.org/projects/anuga/badge/?version=latest
    :target: https://anuga.readthedocs.io/en/latest/?badge=latest
    :alt: Documentation Status

|badge0| |badge1| |badge3| |badge4| |badge5| |badge6| |badge7|




=====
ANUGA
=====

.. contents::

What is ANUGA?
--------------

ANUGA (pronounced "AHnooGAH") is open-source software for the simulation of
the shallow water equation, in particular it can be used to model tsunamis
and floods.

ANUGA is a python 3 package with some C and Cython extensions (and an optional
fortran extension). 

ANUGA was created in a collaboration by Geoscience Australia and Mathematical Sciences Institute at the
Australian National University, though now it is further developed and maintained by a community of volunteers.

Copyright Commonwealth of Australia (Geoscience Australia) and Australian National University 2004-Now


Where can I get ANUGA?
----------------------

ANUGA is available from either https://github.com/anuga-community/anuga_core or https://github.com/GeoscienceAustralia/anuga_core.

The Python 3.x version is the default and available in the main branches of both repositories. 

If you rely on the old Python 2.7 version, it is available in branches named anuga_py2.

The python 3 version of ANUGA will continue to be developed and the most up-to-date 
versions will be available from the `anuga-community `_ repository. 



Installation
------------

If you use `conda` to provide your `python` environment, then you can install `anuga` from the conda-forge channel
as follows. First setup the `conda-forge` channel:

.. code-block::

    conda config --add channels conda-forge
    conda config --set channel_priority strict


Once the conda-forge channel has been enabled, anuga can be installed with conda:

.. code-block::

    conda install anuga


For more installation instructions, see https://anuga.readthedocs.io/en/latest/installation.html


Documentation and Help
----------------------


ANUGA documentation is available via "read the docs" at 

    https://anuga.readthedocs.io 

Also you can obtain help via the old
`user_manual `_

Also helpful information is available online at

    http://anuga.anu.edu.au

A collection of online jupyter notebooks which can run under google's colab environment can be found at:

    https://github.com/anuga-community/anuga-clinic

Mailing Lists
-------------

You can subscribe to our mailing via:

    https://lists.sourceforge.net/lists/listinfo/anuga-user

and send questions using the address

    anuga-user@lists.sourceforge.net

You can also submit issues to:

    https://github.com/anuga-community/anuga_core/issues


Web sites
---------

* http://anuga.anu.edu.au: Collection of information, talks and papers about ANUGA.
* https://en.wikipedia.org/wiki/ANUGA_Hydro: The Wikipedia site for ANUGA. 
* https://github.com/anuga-community/anuga_core: The active GitHub repository for ANUGA.
* https://github.com/GeoscienceAustralia/anuga_core: Mirror GitHub repository for ANUGA. 
* https://github.com/anuga-community/anuga-viewer: Viewer for animating the ANUGA sww output files.  



Latest source code
------------------

The latest development version of ANUGA's sources are is available at:

    https://github.com/anuga-community/anuga_core

They can be downloaded as a zip file or using the Git client as follows

.. code-block::

    git clone https://github.com/anuga-community/anuga_core #(for read only)
    git clone git@github.com:anuga-community/anuga_core.git #(to contribute)

For the latter option see e.g. https://help.github.com/articles/adding-a-new-ssh-key-to-your-github-account/ for instructions on how to authenticate using ssh keys.

Bug reports
-----------

To search for bugs or report them, please use the ANUGA's Bug Tracker at:

    https://github.com/anuga-community/anuga_core/issues


Developer information
---------------------

If you would like to take part in ANUGA development, take a look
at `CONTRIBUTING.rst `_.


License information
-------------------

See the file `LICENSE.txt `_
for information on the history of this software, terms & conditions for usage,
and a DISCLAIMER OF ALL WARRANTIES.

Contacts
--------

At the Australian National University:
**Stephen Roberts**
*Lead Developer*


At Geoscience Australia:
**Gareth Davies**
*Developer*


ANUGA Community:
**Ole Nielsen**
*Architect and Developer*


        

Citation (CITATION.cff)

# This CITATION.cff file was generated with cffinit.
# Visit https://bit.ly/cffinit to generate yours today!

cff-version: 1.2.0
title: ANUGA Github Repository
message: >-
  If you use this software, please cite it using the
  metadata from this file.
type: software
authors:
  - given-names: Stephen
    family-names: Roberts
    email: stephen.roberts@anu.edu.au
    affiliation: Australian National University
    orcid: 'https://orcid.org/0000-0002-6730-3108'
  - given-names: Gareth
    family-names: Davies
    affiliation: Geoscience Australia
    email: gareth.davies@ga.gov.au
  - given-names: Ole
    family-names: Nielsen
    email: ole.moller.nielsen@gmail.com
repository-code: 'https://github.com/anuga-community/anuga_core'
url: 'https://en.wikipedia.org/wiki/ANUGA_Hydro'
abstract: >-
  ANUGA is a free and open source software tool for
  hydrodynamic modelling, suitable for predicting the
  consequences of hydrological disasters such as riverine
  flooding, storm surges and tsunamis. For example, ANUGA
  can be used to create predicted inundation maps based on
  hypothetical tsunami or flood scenarios. 
keywords:
  - flooding
  - tsunami
  - shallow water equations
  - finite volume method
license: Apache License, Version 2.0
commit: 564d7c88b06d7ae3b3a3a2862673d597b7a950bd
version: 3.1.9
date-released: '2022-06-26'

---

Owner metadata

• Name: Geoscience Australia
• Login: GeoscienceAustralia
• Email:
• Kind: organization
• Description:
• Website: http://www.ga.gov.au/
• Location: Canberra, Australia
• Twitter:
• Company:
• Icon url: https://avatars.githubusercontent.com/u/4704285?v=4
• Repositories: 333
• Last ynced at: 2024-04-14T15:25:37.066Z
• Profile URL: https://github.com/GeoscienceAustralia

---

GitHub Events

Total

• Release event: 3
• Delete event: 1
• Pull request event: 5
• Fork event: 1
• Issues event: 6
• Watch event: 22
• Issue comment event: 15
• Push event: 8
• Pull request review event: 2
• Create event: 5

Last Year

• Release event: 3
• Delete event: 1
• Pull request event: 4
• Issues event: 4
• Watch event: 7
• Issue comment event: 7
• Push event: 8
• Pull request review event: 2
• Create event: 5

---

Committers metadata

Last synced: 3 days ago

Name	Email	Commits
Stephen Roberts	s****s@a****u	2773
Ole	O****n@g****m	1186
Stephen Roberts	s****r@g****m	550
duncan	d****y@g****u	352
rwilson	r****n@g****u	216
davies	g****s@g****u	208
rkwi	k****a@g****m	135
nick	n****k@g****u	132
hudson	h****n@g****u	116
sexton	j****n@g****u	102
mungkasi	s****i@a****u	90
Nariman Habili	n****i@g****m	84
jack	j****k@g****u	44
davies	n****e@n****m	39
Jorge Galvez Vallejo	j****o@a****u	37
kristy	k****y@g****u	36
John Jakeman	j****n@g****m	24
wilsonr	w****r@g****u	22
ninnghazad	n****d@d****e	15
rutvikgulhane	r****x@g****m	15
herve	h****e@g****u	13
Wollongong City Council	p****i@g****m	13
AcerLinux	h****g@h****m	10
Max Rietmann	m****n@n****m	10
nariman	n****i@g****u	10
dependabot[bot]	4****]	8
Christian Clauss	c****s@m****m	6
Jorge L GV	j****4@g****m	6
Padarn Wilson	p****n@g****m	5
Samir Shaikh	s****0@g****m	5
and 27 more...

Committer domains:

• ga.gov.au: 18
• anu.edu.au: 4
• gadi-login-01.gadi.nci.org.au: 1
• gadi-login-05.gadi.nci.org.au: 1
• gadi-cpu-clx-0422.gadi.nci.org.au: 1
• gareth-p410.com: 1
• gadi-login-06.gadi.nci.org.au: 1
• rienco.com.au: 1
• gadi-login-08.gadi.nci.org.au: 1
• me.com: 1
• nvidia.com: 1
• dnophos.de: 1
• none.com: 1

---

Issue and Pull Request metadata

Last synced: 4 days ago

More stats: https://issues.ecosyste.ms/repositories/lookup?url=https://github.com/geoscienceaustralia/anuga_core

---

---

---

Package metadata

• Total packages: 1
• Total downloads: unknown
• Total dependent packages: 0
• Total dependent repositories: 0
• Total versions: 2
• Total maintainers: 1

---

Dependencies

Score: 9.699043078654402