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

Last change on this file since 7206 was 7206, checked in by rwilson, 15 years ago

Changes to documentation and 'project' files.
  • Property svn:executable set to *
File size: 9.5 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  <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  This is how a user should run the model on this DVD.
77  We assume that you are using Windows and will give examples for that operating system.
78  The translation to Linux is left as an exercise for the student!
79  <p>
80  <hr align="left" width="100">
81  <p>
82  First, it is assumed you have installed the ANUGA software according to the
83  <a href="documents/anuga_installation_guide.pdf">Installation Guide</a>.
84  <p>
85  <hr align="left" width="100">
86  <p>
87  Next, you must copy the entire contents of the DVD to a place in your filesystem. Let's assume
88  that you want to put the data into <b>C:\ANUGA</b>. You would do this in a Command Prompt window:
89  <table class="code"><tr><td>
90    C:<br>
91    cd \<br>
92    mkdir ANUGA<br>
93    xcopy /e X:\ ANUGA
94  </td></tr></table>
95  <p>
96  Of course, you could just drag all files on the DVD (X:\ is the assumed drive letter) to the desired target directory with Explorer.
97  <p>
98  <hr align="left" width="100">
99  <p>
100  Now you must create an environment variable <b>ANUGADATA</b> that points to the directory you just created:
101  <table class="code"><tr><td>
102    set ANUGADATA=C:\ANUGA
103  </td></tr></table>
104  <p>
105  Doing the above in a Command Prompt window is temporary - if you open another
106  window you will not have the ANUGADATA environment variable defined. To make
107  the variable permanent you must set it in the <b>Start|Settings|Control Panel|System</b>
108  tool (<b>Advanced</b> tab).  See the <a href="documents/anuga_installation_guide.pdf">Installation Guide</a>
109  if you don't know how to do this.
110  <p>
111  <hr align="left" width="100">
112  <p>
113  At this point you should run the <font color="red">build_elevation.py</font>
114  script to convert the raw elevation data to a set of 'combined_elevation'
115  files ready to be used by the ANUGA system. It is possible that you have not
116  been given the elevation data on the DVD as it is too large. In that case you
117  cannot run the <font color="red">build_elevation.py</font> script and you
118  should skip to the next step.
119  <table class="code"><tr><td>
120    cd C:\ANUGA<br>
121    cd project<br>
122    python build_elevation.py
123  </td></tr></table>
124  <p>
125  When you get to the point of running the model with your own data, you must
126  run <font color="red">build_elevation.py</font> to recreate the combined elevation files every time
127  you change the elevation data.
128  <p>
129  <hr align="left" width="100">
130  <p>
131  Next, you prepare and execute the model:
132  <table class="code"><tr><td>
133    python setup_model.py<br >
134    python run_model.py
135  </td></tr></table>
136  <p>
137  <hr align="left" width="100">
138  <p>
139  This should all run to completion, though it may take several days, depending on
140  the hardware used.
141  <p>
142  If you do get an error from <font color="red">setup_model.py</font>
143  or <font color="red">run_model.py</font> look for some explanation in the log
144  files, which you should find somewhere under <b>C:\ANUGA\data</b>. Just keep
145  drilling down from that point until you find a directory called <b>outputs</b>.
146  The latest directory in <b>outputs</b> should contain a file called <font color="red">screen_error.txt</font>
147  with an explanation of the error at the end.
148  <p>
149  Once the simulation has completed you may view the results using the ANUGA
150  viewer as described in the <a href="documents/anuga_installation_guide.pdf">Installation Guide</a> 
151  and <a href="documents/anuga_user_manual.pdf">User Manual</a>, run the script
152  <font color="red">export_results_max.py</font> to generate rasters suitable
153  for GIS mapping, or write dedicated scripts extracting timeseries at selected
154  locations.
155  <p>
156  The input waves are all derived from events available in the Australian Tsunami
157  Hazard Map. As this dataset is very large, this DVD only contains the events
158  described in the report. If other events from the Hazard Map are obtained,
159  the script <font color="red">build_urs_boundary.py</font> has been designed
160  to prepare the associated input wave for ingestion into ANUGA.  This script
161  is documented in the <a href="documents/anuga_user_manual.pdf">User Manual</a>.
162  <p>
163  The ANUGA <a href="documents/anuga_user_manual.pdf">User Manual</a> describes
164  how to use the ANUGA system in general and provides some examples of its use.
165
166  <a name="userslist"<h3><b>How to join the ANUGA user's mailing list</b></h3></a>
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>
Note: See TracBrowser for help on using the repository browser.