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