Tsunami Inundation Models for the BATEMANS BAY region

The Attorney General's Department (AGD) has supported Geoscience Australia (GA) in developing a range of products to support the understanding of tsunami hazard through the Australian Tsunami Warning System Project. The work reported here is intended to further build the capacity of the Jurisdictions in developing inundation models for prioritised locations.

While the associated report provides background, model results and interpretations, the DVD contains all data, scripts and software necessary to reproduce and potentially augment the models underpinning the report. This will allow the Jurisdiction to rerun the models with minor modifications or new elevation data as needed and also potentially replicate the methodology to other locations if desired.

The data provided on this DVD is:

• The Professional Opinion Report 2009/XX entitled Capacity Building for Tsunami Planning and Preparation: Inundation Models for Four East Coast Australian Communities
• Elevation data used with the tsunami inundation model
• Input data for a range of tsunami events
• The Python scripts used to run the models

ANUGA has been developed and tested under the Windows XP and Linux (Ubuntu, Mint and Red Hat) operating systems. ANUGA may also be installed on a Windows Vista system and Debian Linux, but these have not been extensively tested.

The ANUGA scripts on this DVD require a minimum of 3GB of memory and possibly more, if mesh resolutions are increased. For this reason we recommend using 64 bit Ubuntu Linux as this operating system can use more than 3GB of memory, whereas Windows XP cannot. Installing ANUGA You must install ANUGA according to the Installation Guide. As the installation procedure comprises a number of steps we suggest that it is carried out by someone with a basic understanding of how to install software packages on the operating system of choice. How to run a simulation This is how a user should run the model on this DVD. We assume that you are using Windows and will give examples for that operating system. The translation to Linux is left as an exercise for the student!

First, it is assumed you have installed the ANUGA software according to the Installation Guide.

Next, you must copy the entire contents of the DVD to a place in your filesystem. Let's assume that you want to put the data into C:\ANUGA. You would do this in a Command Prompt window:

Of course, you could just drag all files on the DVD (X:\ is the assumed drive letter) to the desired target directory with Explorer.

Now you must create an environment variable ANUGADATA that points to the directory you just created:

Doing the above in a Command Prompt window is temporary - if you open another window you will not have the ANUGADATA environment variable defined. To make the variable permanent you must set it in the Start|Settings|Control Panel|System tool (Advanced tab). See the Installation Guide if you don't know how to do this.

At this point you should run the build_elevation.py script to convert the raw elevation data to a set of 'combined_elevation' files ready to be used by the ANUGA system. It is possible that you have not been given the elevation data on the DVD as it is too large. In that case you cannot run the build_elevation.py script and you should skip to the next step.

When you get to the point of running the model with your own data, you must run build_elevation.py to recreate the combined elevation files every time you change the elevation data.

Next, you prepare and execute the model:

This should all run to completion, though it may take several days, depending on the hardware used.

If you do get an error from setup_model.py or run_model.py look for some explanation in the log files, which you should find somewhere under C:\ANUGA\data. Just keep drilling down from that point until you find a directory called outputs. The latest directory in outputs should contain a file called screen_error.txt with an explanation of the error at the end.

Once the simulation has completed you may view the results using the ANUGA viewer as described in the Installation Guide and User Manual, run the script export_results_max.py to generate rasters suitable for GIS mapping, or write dedicated scripts extracting timeseries at selected locations.

The input waves are all derived from events available in the Australian Tsunami Hazard Map. As this dataset is very large, this DVD only contains the events described in the report. If other events from the Hazard Map are obtained, the script build_urs_boundary.py has been designed to prepare the associated input wave for ingestion into ANUGA. This script is documented in the User Manual.

The ANUGA User Manual describes how to use the ANUGA system in general and provides some examples of its use. How to join the ANUGA user's mailing list One of the quickest ways to get your ANUGA questions answered is by asking them on the ANUGA-user mailing list. You can subscribe to the list here and can view the mailing list archives.

It costs nothing to register and you can choose to have list mail sent to you as individual emails or have them batched into a few emails per day. You can unsubscribe at any time through the subscribe link above. How to use the auxiliary scripts On this disk there are a selection of auxiliary scripts that you can use to extract various pieces of information from the generated SWW files. The auxiliary scripts page explains how to use the scripts. Frequently Asked Questions There is a Frequently Asked Questions (FAQ) page at https://datamining.anu.edu.au/anuga/wiki/FrequentlyAskedQuestions. Look in here and search the mailing list archives before asking questions on the ANUGA user's mailing list. Someone may already have asked your question!

Note that you can edit the FAQ pages, so it is helpful if you can update the FAQ with your question and its answer if you feel it would be helpful to others.