| 1 | <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd"> |
|---|
| 2 | <html> |
|---|
| 3 | <head> |
|---|
| 4 | <title>Geoscience Australia</title> |
|---|
| 5 | <link rel="stylesheet" href="browser_files/style.css"> |
|---|
| 6 | <link REL="SHORTCUT ICON" HREF="browser_files/favicon.ico"> |
|---|
| 7 | </head> |
|---|
| 8 | <body> |
|---|
| 9 | <table cellspacing="10" border="0"> |
|---|
| 10 | <tr> |
|---|
| 11 | <td> |
|---|
| 12 | <img src="browser_files/logo.jpg" alt="Australian Government, Geoscience Australia" width="327" height="80" border="0"/> |
|---|
| 13 | </td> |
|---|
| 14 | <td width="50"> |
|---|
| 15 | |
|---|
| 16 | </td> |
|---|
| 17 | <td> |
|---|
| 18 | <H1>Tsunami Inundation Models for the GOLD COAST region</H1> |
|---|
| 19 | </td> |
|---|
| 20 | </tr> |
|---|
| 21 | </table> |
|---|
| 22 | <hr> |
|---|
| 23 | <!-- |
|---|
| 24 | <ul class="navbar"> |
|---|
| 25 | <li><a href="#introduction">Introduction</a> |
|---|
| 26 | <li><a href="#installing">Installing</a> |
|---|
| 27 | <li><a href="#simulating">Running</a> |
|---|
| 28 | <li><a href="#userslist">Mailing list</a> |
|---|
| 29 | <li><a href="#auxscripts">Auxiliary scripts</a> |
|---|
| 30 | <li><a href="#FAQ">Frequently Asked Questions</a> |
|---|
| 31 | <li><a href="#extra">Extra stuff</a> |
|---|
| 32 | </ul> |
|---|
| 33 | --> |
|---|
| 34 | |
|---|
| 35 | <a name="introduction"<h3><b>Introduction</b></h3></a> |
|---|
| 36 | The information on this DVD and the associated report is intended to assist emergency managers in developing preparation and |
|---|
| 37 | response plans that can be used during a tsunami threat or emergency. |
|---|
| 38 | <p> |
|---|
| 39 | The Attorney General's Department (AGD) has supported Geoscience Australia (GA) in developing a range of products to support |
|---|
| 40 | the understanding of tsunami hazard through the Australian Tsunami Warning System Project. The work reported here is intended |
|---|
| 41 | to further build the capacity of the Jurisdictions in developing inundation models for prioritised locations. |
|---|
| 42 | <p> |
|---|
| 43 | While the associated report provides background, model results and interpretations, the DVD contains all data, scripts and |
|---|
| 44 | software necessary to reproduce and potentially augment the models underpinning the report. This will allow the Jurisdiction |
|---|
| 45 | to rerun the models with minor modifications or new elevation data as needed and also potentially replicate the methodology |
|---|
| 46 | to other locations if desired. |
|---|
| 47 | <p> |
|---|
| 48 | The data provided on this DVD is: |
|---|
| 49 | <ul> |
|---|
| 50 | <li> The Professional Opinion Report 2009/XX entitled <i>Capacity Building for Tsunami Planning and Preparation: |
|---|
| 51 | Inundation Models for Four East Coast Australian Communities</i> |
|---|
| 52 | <li> Elevation data used with the tsunami inundation model |
|---|
| 53 | <li> Input data for a range of tsunami events |
|---|
| 54 | <li> The Python scripts used to run the models |
|---|
| 55 | </ul> |
|---|
| 56 | |
|---|
| 57 | <a name="requirements"<h3><b>Requirements</b></h3></a> |
|---|
| 58 | |
|---|
| 59 | The tsunami inundation simulations are based on the Open Source software package called ANUGA. |
|---|
| 60 | For more information about ANUGA visit <a href="https://datamining.anu.edu.au/anuga">https://datamining.anu.edu.au/anuga</a>. |
|---|
| 61 | <p> |
|---|
| 62 | ANUGA has been developed and tested under the Windows XP and Linux (Ubuntu, Mint and Red Hat) operating systems. |
|---|
| 63 | ANUGA may also be installed on a Windows Vista system and Debian Linux, but these have not been extensively tested. |
|---|
| 64 | <p> |
|---|
| 65 | The ANUGA scripts on this DVD require a minimum of 3GB of memory and possibly more, if mesh resolutions are increased. For this reason |
|---|
| 66 | we recommend using 64 bit Ubuntu Linux as this operating system can use more than 3GB of memory, whereas Windows XP cannot. |
|---|
| 67 | |
|---|
| 68 | <a name="installing"<h3><b>Installing ANUGA</b></h3></a> |
|---|
| 69 | |
|---|
| 70 | You must install ANUGA according to the <a href="documents/anuga_installation_guide.pdf">Installation Guide</a>. |
|---|
| 71 | As the installation procedure comprises a number of steps we suggest that it is carried out by someone with a |
|---|
| 72 | basic understanding of how to install software packages on the operating system of choice. |
|---|
| 73 | |
|---|
| 74 | <a name="simulating"<h3><b>How to run a simulation</b></h3></a> |
|---|
| 75 | |
|---|
| 76 | <a name="userslist"<h3><b>How to join the ANUGA user's mailing list</b></h3></a> |
|---|
| 77 | |
|---|
| 78 | This is how a user should run a model from the 'Tsunami Inundation Models' DVDs. |
|---|
| 79 | We assume that you are using Windows and will give examples for that operating system. |
|---|
| 80 | The translation to Linux is left as an exercise for the student! |
|---|
| 81 | <p> |
|---|
| 82 | <hr align="left" width="100"> |
|---|
| 83 | <p> |
|---|
| 84 | First, it is assumed you have installed the ANUGA software according to the |
|---|
| 85 | <a href="documents/anuga_installation_guide.pdf">Installation Guide</a>. |
|---|
| 86 | <p> |
|---|
| 87 | <hr align="left" width="100"> |
|---|
| 88 | <p> |
|---|
| 89 | Next, you must copy the entire contents of the DVD to a place in your filesystem. Let's assume |
|---|
| 90 | that you want to put the data into <b>C:\ANUGA</b>. You would do this in a Command Prompt window: |
|---|
| 91 | <table class="code"><tr><td> |
|---|
| 92 | C:<br> |
|---|
| 93 | cd \<br> |
|---|
| 94 | mkdir ANUGA<br> |
|---|
| 95 | xcopy /e X:\ ANUGA |
|---|
| 96 | </td></tr></table> |
|---|
| 97 | <p> |
|---|
| 98 | Of course, you could just drag all files on the DVD (X:\ is the assumed drive letter) to the desired target directory with Explorer. |
|---|
| 99 | <p> |
|---|
| 100 | <hr align="left" width="100"> |
|---|
| 101 | <p> |
|---|
| 102 | Now you must create an environment variable <b>ANUGADATA</b> that points to the directory you just created: |
|---|
| 103 | <table class="code"><tr><td> |
|---|
| 104 | set ANUGADATA=C:\ANUGA |
|---|
| 105 | </td></tr></table> |
|---|
| 106 | <p> |
|---|
| 107 | Doing the above in a Command Prompt window is temporary - if you open another |
|---|
| 108 | window you will not have the ANUGADATA environment variable defined. To make |
|---|
| 109 | the variable permanent you must set it in the <b>Start|Settings|Control Panel|System</b> |
|---|
| 110 | tool (<b>Advanced</b> tab). See the <a href="documents/anuga_installation_guide.pdf">Installation Guide</a> |
|---|
| 111 | if you don't know how to do this. |
|---|
| 112 | <p> |
|---|
| 113 | <hr align="left" width="100"> |
|---|
| 114 | <p> |
|---|
| 115 | At this point you should run the <font color="red">build_elevation.py</font> |
|---|
| 116 | script to convert the raw elevation data to a set of 'combined_elevation' |
|---|
| 117 | files ready to be used by the ANUGA system. It is possible that you have not |
|---|
| 118 | been given the elevation data on the DVD as it is too large. In that case you |
|---|
| 119 | cannot run the <font color="red">build_elevation.py</font> script and you |
|---|
| 120 | should skip to the next step. |
|---|
| 121 | <table class="code"><tr><td> |
|---|
| 122 | cd C:\ANUGA<br> |
|---|
| 123 | cd project<br> |
|---|
| 124 | python build_elevation.py |
|---|
| 125 | </td></tr></table> |
|---|
| 126 | <p> |
|---|
| 127 | When you get to the point of running the model with your own data, you must |
|---|
| 128 | run <font color="red">build_elevation.py</font> to recreate the combined elevation files every time |
|---|
| 129 | you change the elevation data. |
|---|
| 130 | <p> |
|---|
| 131 | <hr align="left" width="100"> |
|---|
| 132 | <p> |
|---|
| 133 | Next, you prepare and execute the model: |
|---|
| 134 | <table class="code"><tr><td> |
|---|
| 135 | python setup_model.py<br > |
|---|
| 136 | python run_model.py |
|---|
| 137 | </td></tr></table> |
|---|
| 138 | <p> |
|---|
| 139 | <hr align="left" width="100"> |
|---|
| 140 | <p> |
|---|
| 141 | This should all run to completion, though it may take several days, depending on |
|---|
| 142 | the hardware used. |
|---|
| 143 | <p> |
|---|
| 144 | If you do get an error from <font color="red">setup_model.py</font> |
|---|
| 145 | or <font color="red">run_model.py</font> look for some explanation in the log |
|---|
| 146 | files, which you should find somewhere under <b>C:\ANUGA\data</b>. Just keep |
|---|
| 147 | drilling down from that point until you find a directory called <b>outputs</b>. |
|---|
| 148 | The latest directory in outputs should contain a file called screen_error.txt |
|---|
| 149 | with an explanation of the error at the end. |
|---|
| 150 | <p> |
|---|
| 151 | Once the simulation has completed you may view the results using the ANUGA |
|---|
| 152 | viewer as described in the <a href="documents/anuga_installation_guide.pdf">Installation Guide</a> |
|---|
| 153 | and <a href="documents/anuga_user_manual.pdf">User Manual</a>, run the script |
|---|
| 154 | <font color="red">export_results_max.py</font> to generate rasters suitable |
|---|
| 155 | for GIS mapping, or write dedicated scripts extracting timeseries at selected |
|---|
| 156 | locations. |
|---|
| 157 | <p> |
|---|
| 158 | The input waves are all derived from events available in the Australian Tsunami |
|---|
| 159 | Hazard Map. As this dataset is very large, this DVD only contains the events |
|---|
| 160 | described in the report. If other events from the Hazard Map are obtained, |
|---|
| 161 | the script <font color="red">build_urs_boundary.py</font> has been designed |
|---|
| 162 | to prepare the associated input wave for ingestion into ANUGA. This script |
|---|
| 163 | is documented in the <a href="documents/anuga_user_manual.pdf">User Manual</a>. |
|---|
| 164 | <p> |
|---|
| 165 | The ANUGA <a href="documents/anuga_user_manual.pdf">User Manual</a> describes |
|---|
| 166 | how to use the ANUGA system in general and provides some examples of its use. |
|---|
| 167 | |
|---|
| 168 | One of the quickest ways to get your ANUGA questions answered is by asking them on the <b>ANUGA-user</b> mailing list. |
|---|
| 169 | You can subscribe to the list <a href="https://lists.sourceforge.net/lists/listinfo/anuga-user">here</a> |
|---|
| 170 | and can view the mailing list <a href="https://sourceforge.net/mailarchive/forum.php?forum_name=anuga-user">archives</a>. |
|---|
| 171 | <p> |
|---|
| 172 | It costs nothing to register and you can choose to have list mail sent to you as individual emails or have them batched |
|---|
| 173 | into a few emails per day. You can unsubscribe at any time through the subscribe link above. |
|---|
| 174 | |
|---|
| 175 | <a name="auxscripts"<h3><b>How to use the auxiliary scripts</b></h3></a> |
|---|
| 176 | |
|---|
| 177 | On this disk there are a selection of auxiliary scripts that you can use to extract various pieces of information |
|---|
| 178 | from the generated SWW files. The <a href="auxiliary_scripts.html">auxiliary scripts</a> page explains how to use the scripts. |
|---|
| 179 | |
|---|
| 180 | <a name="FAQ"<h3><b>Frequently Asked Questions</b></h3></a> |
|---|
| 181 | |
|---|
| 182 | There is a <b>Frequently Asked Questions</b> (FAQ) page at |
|---|
| 183 | <a href="https://datamining.anu.edu.au/anuga/wiki/FrequentlyAskedQuestions">https://datamining.anu.edu.au/anuga/wiki/FrequentlyAskedQuestions</a>. |
|---|
| 184 | Look in here and search the mailing list archives before asking questions on the ANUGA user's mailing list. |
|---|
| 185 | Someone may already have asked your question! |
|---|
| 186 | <p> |
|---|
| 187 | 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 |
|---|
| 188 | it would be helpful to others. |
|---|
| 189 | </body> |
|---|
| 190 | </html> |
|---|
