source: DVD_images/extra_files/Hobart/installation.html @ 7331

Last change on this file since 7331 was 7331, checked in by kristy, 15 years ago

updated all scripts to reflect batemans bay changes

File size: 7.2 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 south east Tasmania</H1>
19      </td>
20    </tr>
21  </table>
22  <hr>
23
24  <a name="introduction"><h2><b>Installing, Running and Changing the Simulation</b></h2></a>
25
26  This document describes the installation and running of the simulation software.
27  <p>
28  In addition, we show how to change your simulation, add new elevation data, etc, and how to get help if you have trouble.
29
30  <a name="requirements"><h3><b>Requirements</b></h3></a>
31
32  The tsunami inundation simulations are based on the Open Source software package called ANUGA.
33  For more information about ANUGA visit <a href="https://datamining.anu.edu.au/anuga">https://datamining.anu.edu.au/anuga</a>.
34  <p>
35  ANUGA has been developed and tested under the Windows XP and Linux (Ubuntu, Mint and Red Hat) operating systems.
36  ANUGA may also be installed on a Windows Vista system and Debian Linux, but these have not been extensively tested.
37  <p>
38  The ANUGA scripts on this DVD require a minimum of 3GB of memory and possibly more, if mesh resolutions are increased. For this reason
39  we recommend using 64 bit Ubuntu Linux as this operating system can use more than 3GB of memory, whereas Windows XP cannot.
40
41  <a name="installing"><h3><b>Installing ANUGA</b></h3></a>
42  <a href="http://sourceforge.net/projects/anuga/">Download Software</a><i>: please note Internet Explorer has the habit of renaming the
43  .tgz file to .gz - the remedy is to rename them back or use another browser such as Firefox.</i>
44  <p>
45  You must install ANUGA according to the <a href="documents/anuga_installation_guide.pdf">Installation Guide</a>.
46  As the installation procedure comprises a number of steps we suggest that it is carried out by someone with a
47  basic understanding of how to install software packages on the operating system of choice.
48
49  <a name="simulating"><h3><b>How to run a simulation</b></h3></a>
50
51  This is how you should run the model on this DVD.
52  We assume that you are using Windows and will give examples for that operating system.
53  The translation to Linux should be obvious, but the <a href="#userslist">ANUGA user's mailing list</a>
54  can be used to get help.
55  <p>
56
57  <p>
58  <hr align="left" width="100">
59  <p>
60  First, it is assumed you have installed the ANUGA software according to the
61  <a href="documents/anuga_installation_guide.pdf">Installation Guide</a>.
62  <p>
63  <hr align="left" width="100">
64  <p>
65  Next, you must copy the entire contents of the DVD to a place in your file system. Let's assume
66  that you want to put the data into <b>C:\ANUGA</b>. You could drag all files from the DVD into this folder with Explorer.
67  Or through the Command Prompt window:
68  <pre><font color="brown">
69    C:
70    cd
71    mkdir ANUGA
72    xcopy /e X:\ ANUGA
73  </font></pre>
74  X:\ is the assumed to be the CD drive letter.
75  <p>
76  <hr align="left" width="100">
77  <p>
78  Now you must create an environment variable <b>ANUGADATA</b> that points to the directory you just created:
79  <pre><font color="brown">
80    set ANUGADATA=C:\ANUGA
81  </font></pre>
82  Doing the above in a Command Prompt window is temporary - if you open another
83  window you will not have the ANUGADATA environment variable defined. To make
84  the variable permanent you must set it in the <b>Start|Settings|Control Panel|System</b>
85  tool (<b>Advanced</b> tab).  See the <a href="documents/anuga_installation_guide.pdf">Installation Guide</a>
86  if you don't know how to do this.
87  <hr align="left" width="100">
88  Next, you prepare and execute the model:
89  <pre><font color="brown">
90    cd C:\ANUGA
91    cd project
92    python setup_model.py
93    python run_model.py
94  </font></pre>
95  <hr align="left" width="100">
96  This should all run to completion though it may take several days, depending on
97  the hardware used.
98  <p>
99  If you get an error from <font color="red">setup_model.py</font>
100  or <font color="red">run_model.py</font> look for some explanation in the log
101  files, which you will find under <b>C:\ANUGA\data</b>. Just keep
102  drilling down from that point until you find a directory called <b>outputs</b>.
103  The latest directory in <b>outputs</b> should contain a file called <font color="red">screen_error.txt</font>
104  with an explanation of the error at the end.
105  <p>
106  Once the simulation has completed you may view the results using the ANUGA
107  viewer as described in the <a href="documents/anuga_installation_guide.pdf">Installation Guide</a>
108  and <a href="documents/anuga_user_manual.pdf">User Manual</a>.  You may also
109  generate rasters suitable for GIS mapping or write dedicated scripts extracting timeseries at selected
110  locations.  Some hints to help you do this are at the <a href="analysis.html">analysis page</a>.
111  <p>
112  The ANUGA <a href="documents/anuga_user_manual.pdf">User Manual</a> describes
113  how to use the ANUGA system in general and provides some examples of its use.
114
115  <a name="auxscripts"><h3><b>How to extract data from the simulation output files</b></h3></a>
116
117  After you have run a simulation you may wish to extract information from the generated SWW file.
118  On this disk there are a selection of example analysis scripts that you can use or modify.
119  The <a href="analysis.html">analysis</a> page explains how to use the scripts.
120
121  <a name="modifications"><h3><b>How to modify a simulation</b></h3></a>
122
123  After you have run the supplied simulation you may wish to change it in some way, such as adding improved bathymetry data, for example.
124  The <a href="modifications.html">modifications</a> page explains how to do this.
125
126  <a name="userslist"><h3><b>How to join the ANUGA user's mailing list</b></h3></a>
127
128  One of the quickest ways to get your ANUGA questions answered is by asking them on the <b>ANUGA-user</b> mailing list.
129  You can <a href="https://lists.sourceforge.net/lists/listinfo/anuga-user">subscribe to the list</a>
130  and can view the mailing list <a href="https://sourceforge.net/mailarchive/forum.php?forum_name=anuga-user">archives</a>.
131  <p>
132  It costs nothing to register and you can choose to have list mail sent to you as individual emails or have them batched
133  into a few emails per day.  You can unsubscribe at any time through the subscribe link above.
134
135  <a name="FAQ"><h3><b>Frequently Asked Questions</b></h3></a>
136
137  Look in <b><a href="https://datamining.anu.edu.au/anuga/wiki/FrequentlyAskedQuestions">Frequently Asked Questions</a></b> (FAQ) and search the mailing list archives before asking questions on the ANUGA user's mailing list.
138  Someone may already have asked and answered your question!
139  <p>
140  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
141  it would be helpful to others.
142</body>
143</html>
Note: See TracBrowser for help on using the repository browser.