Changeset 4875

Timestamp:

Dec 4, 2007, 5:21:38 PM (16 years ago)

Author:

sexton

Message:

updates to manual - highlighting the hypothetical nature of the Cairns demo

File:

• anuga_core/documentation/user_manual/anuga_user_manual.tex (modified) (8 diffs)

anuga_core/documentation/user_manual/anuga_user_manual.tex

@@ -889 +889 @@
 concepts introduced through the \file{runup.py} example and
 introduces a second example, \file{runcairns.py}.  This refers to
-a real-life scenario, in which the domain of interest surrounds the
+a {\bf hypothetical} scenario using real-life data, 
+in which the domain of interest surrounds the
 Cairns region. Two scenarios are given; firstly, a
 hypothetical tsunami wave is generated by a submarine mass failure
 situated on the edge of the continental shelf, and secondly, a fixed wave
 of given amplitude and period is introduced through the boundary.
+
+{\bf
+Each scenario has been designed to generate a tsunami which will
+inundate the Cairns region. To achieve this, suitably large 
+parameters were chosen and were not based on any known tsunami sources
+or realistic amplitudes.
+}
 
 \subsection{Overview}
@@ -1140 +1148 @@
 width, thickness, slope, etc), its location (origin) and the depth at that
 location. For this example, we choose to apply the slide function
-at a specified time into the simulation.
+at a specified time into the simulation. {\bf Note, the parameters used
+in this example have been deliberately chosen to generate a suitably 
+large amplitude tsunami which would inundate the Cairns region.}
 
 \subsubsection{Friction}
@@ -1268 +1278 @@
 Figures \ref{fig:maxdepthcairnsslide} and \ref{fig:maxdepthcairnsfixedwave} show
 the maximum water depth within the defined region for the slide and fixed wave scenario
-respectively.
+respectively. {\bf Note, these inundation maps have been based on purely hypothetical
+scenarios and were designed explicitly for demonstration purposes only.}
 The user could develop a maximum absolute momentum or other expressions which can be
 derived from the quantities.
@@ -1280 +1291 @@
 \begin{figure}[hbt]
 \centerline{\includegraphics[scale=0.5]{graphics/slidedepth.jpg}}
-\caption{Maximum inundation map for the Cairns slide scenario.}
+\caption{Maximum inundation map for the Cairns slide scenario. \bf Note, this
+inundaiton map has been based on a purely hypothetical scenario which was
+designed explictiy for demonstration purposes only.}
 \label{fig:maxdepthcairnsslide}
 \end{figure}
@@ -1286 +1299 @@
 \begin{figure}[hbt]
 \centerline{\includegraphics[scale=0.5]{graphics/fixedwavedepth.jpg}}
-\caption{Maximum inundation map for the Cairns fixed wave scenario.}
+\caption{Maximum inundation map for the Cairns fixed wave scenario. 
+\bf Note, this
+inundaiton map has been based on a purely hypothetical scenario which was
+designed explictiy for demonstration purposes only.}
 \label{fig:maxdepthcairnsfixedwave}
 \end{figure}
@@ -1325 +1341 @@
 Figure \ref{fig:reef} shows the time series for the quantity stage for the 
 Elford Reef location for each scenario (the elevation at this location is negative, 
-thereby showing stage).
+thereby showing stage). Note the large negative stage value when the slide was
+introduced. This is due to the double gaussian form of the initial surface
+displacement of the slide. By contrast, the time series for depth is shown for the onshore location of the Cairns
+Airport for each scenario is Figure \ref{fig:airportboth}.
 
 \begin{figure}[hbt]
@@ -1333 +1352 @@
 \label{fig:reef}
 \end{figure}
-
-By contrast, the time series for depth is shown for the onshore location of the Cairns
-Airport for each scenario is Figure \ref{fig:airportboth}.
 
 \begin{figure}[hbt]
@@ -4026 +4042 @@
 
 This technique can be expanded to handle point data sets as well. In the case
-of a bathymetry data set available in text format in an \code{.xya} file, then
+of a bathymetry data set available in text format in an \code{.csv} file, then
 the geospatial addition is updated to
 {\small \begin{verbatim}
-G3 = Geospatial_data(file_name = bathy_data_name + '.xya')
+G3 = Geospatial_data(file_name = bathy_data_name + '.csv')
 G = G1 + G2.clip_outside(Geospatial_data(poly1)) + G3
 \end{verbatim}}
-The \code{.xya} file has the data stored as \code{x,y,elevation} with the text \code{elevation}
+The \code{.csv} file has the data stored as \code{x,y,elevation} with the text \code{elevation}
 on the first line.