source: DVD_images/extra_files/BatemansBay/index.html @ 7265

Last change on this file since 7265 was 7265, checked in by rwilson, 16 years ago

Commit of changes from georisk_models/inundation/DVD_images.
  • Property svn:executable set to *
File size: 8.6 KB
Line 
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        &nbsp;
16      </td>
17      <td>
18        <H1>Tsunami Inundation Models for the BATEMANS BAY region</H1>
19      </td>
20    </tr>
21  </table>
22  <hr>
23
24  <a name="introduction"><h3><b>Introduction</b></h3></a>
25
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
30  the understanding of tsunami hazard through the Australian Probabilistic Tsunami Warning System Project. The work reported here is intended
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>
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.
50
51  <a name="requirements"><h3><b>Requirements</b></h3></a>
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
62  <a name="installing"><h3><b>Installing ANUGA</b></h3></a>
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
68  <a name="simulating"><h3><b>How to run a simulation</b></h3></a>
69
70  This is how you should run the model on this DVD.
71  We assume that you are using Windows and will give examples for that operating system.
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.
74  <p>
75 
76  <p>
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>
110  Next, you prepare and execute the model:
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>
120  This should all run to completion though it may take several days, depending on
121  the hardware used.
122  <p>
123  If you get an error from <font color="red">setup_model.py</font>
124  or <font color="red">run_model.py</font> look for some explanation in the log
125  files, which you will find under <b>C:\ANUGA\data</b>. Just keep
126  drilling down from that point until you find a directory called <b>outputs</b>.
127  The latest directory in <b>outputs</b> should contain a file called <font color="red">screen_error.txt</font>
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> 
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>.
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
139  <a name="auxscripts"><h3><b>How to extract data from the simulation output files</b></h3></a>
140
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
152  One of the quickest ways to get your ANUGA questions answered is by asking them on the <b>ANUGA-user</b> mailing list.
153  You can <a href="https://lists.sourceforge.net/lists/listinfo/anuga-user">subscribe to the list</a>
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
159  <a name="FAQ"><h3><b>Frequently Asked Questions</b></h3></a>
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>.
163  Look in there and search the mailing list archives before asking questions on the ANUGA user's mailing list.
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>
Note: See TracBrowser for help on using the repository browser.