doc/cookbook/cookbook.tex


%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%
% Copyright (c) 2003-2010 by University of Queensland
% Earth Systems Science Computational Center (ESSCC)
% http://www.uq.edu.au/esscc
%
% Primary Business: Queensland, Australia
% Licensed under the Open Software License version 3.0
% http://www.opensource.org/licenses/osl-3.0.php
%
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%

\documentclass{manual}
%%% Table of contents to list down to subsections and no further
\setcounter{tocdepth}{3}
%%% Number down to subsubsections only
\setcounter{secnumdepth}{3}
% grab the handy definitions and \usepackage statements etc
\input{cookbook_defs}

\ifpdf
\pdfinfo {
/Author (Antony Hallam and Lutz Gross)
/Title (escript COOKBOOK)
/Keywords (escript, PDEs)
}
\fi


% title, author, etc stuff
\title{The \textit{escript} COOKBOOK}


\author{Antony Hallam, Lutz Gross, et. al.}
\authoraddress{
Earth Systems Science Computational Centre (ESSCC) \\
School of Earth Sciences \\
The University of Queensland \\
Brisbane, Australia \\
Email: \email{esys@esscc.uq.edu.au}
}                                                                                         
\date{\today}      
\release{development}
\setreleaseinfo{\\(r\RepVersion)}
\setshortversion{}

\makeindex

\begin{document}

\maketitle

% This must come after maketitle or you'll get latex in the pdf title
\ifpdf
\pdfinfo {
/Author (Antony Hallam and Lutz Gross)
/Title (escript COOKBOOK)
/Keywords (escript, PDEs)
}
\fi

\input{../user/copyrights}

\begin{abstract}
\esc is a \pyt based environment that has been developed to solve complex mathematical models, particularly coupled, non-linear and time-dependent partial differential equations. The intention of this cookbook is to introduce new users to \esc and provide a set of examples which demonstrate the major concepts and can be adapted to new problems. Although most of the examples in this cookbook are focused on the disciplines of geophysics and geology, they provide a solid introduction to \esc and its capabilities.
\end{abstract}
\tableofcontents

\newpage

\chapter{Introduction}
\label{CHAP INTRO}
\input{intro}

\chapter{Getting Started with Heat Diffusion}
\label{CHAP HEAT DIFF}
We start by examining a simple one dimensional heat diffusion equation. This problem provides a good starting example to build our knowledge of \esc and demonstrate how to solve simple partial differential equations (PDEs)\footnote{Wikipedia provides an excellent and comprehensive introduction to \textit{Partial Differential Equations} \url{http://en.wikipedia.org/wiki/Partial_differential_equation}, however their relevance to \esc and implementation should become much clearer as we develop our understanding further into the cookbook.}
\input{example01}
\input{example02}

\chapter{Heat Diffusion in Two Dimensions}
\label{CHAP HEAT 2a}
\input{example03}

\chapter{Complex Geometries}
\label{CHAP HEAT 2}
\input{steadystateheatdiff}

% Moving into 2D and 3D wave propagations in next chapters.
% not part of release 3.1
% \chapter{Seismic Wave Propagation}
% \input{twodswp001}
\appendix
%\include{einsteinETA}
\end{document}
1	ahallam	2411
2			%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
3			%
4	jfenwick	2881	% Copyright (c) 2003-2010 by University of Queensland
5	ahallam	2411	% Earth Systems Science Computational Center (ESSCC)
6			% http://www.uq.edu.au/esscc
7			%
8			% Primary Business: Queensland, Australia
9			% Licensed under the Open Software License version 3.0
10			% http://www.opensource.org/licenses/osl-3.0.php
11			%
12			%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
13
14			\documentclass{manual}
15	ahallam	2495	%%% Table of contents to list down to subsections and no further
16			\setcounter{tocdepth}{3}
17			%%% Number down to subsubsections only
18			\setcounter{secnumdepth}{3}
19	ahallam	2411	% grab the handy definitions and \usepackage statements etc
20			\input{cookbook_defs}
21	jfenwick	2971
22			\ifpdf
23			\pdfinfo {
24			/Author (Antony Hallam and Lutz Gross)
25			/Title (escript COOKBOOK)
26			/Keywords (escript, PDEs)
27			}
28			\fi
29
30
31	ahallam	2411	% title, author, etc stuff
32	ahallam	2775	\title{The \textit{escript} COOKBOOK}
33	ahallam	2411
34
35	jfenwick	2944
36	gross	2861	\author{Antony Hallam, Lutz Gross, et. al.}
37	ahallam	2411	\authoraddress{
38			Earth Systems Science Computational Centre (ESSCC) \\
39			School of Earth Sciences \\
40			The University of Queensland \\
41			Brisbane, Australia \\
42			Email: \email{esys@esscc.uq.edu.au}
43			}
44			\date{\today}
45	jfenwick	2923	\release{development}
46			\setreleaseinfo{\\(r\RepVersion)}
47	ahallam	2411	\setshortversion{}
48
49			\makeindex
50
51			\begin{document}
52
53			\maketitle
54	gross	2605
55	jfenwick	2944	% This must come after maketitle or you'll get latex in the pdf title
56			\ifpdf
57			\pdfinfo {
58			/Author (Antony Hallam and Lutz Gross)
59			/Title (escript COOKBOOK)
60			/Keywords (escript, PDEs)
61			}
62			\fi
63
64	ahallam	2634	\input{../user/copyrights}
65	gross	2605
66			\begin{abstract}
67	caltinay	2982	\esc is a \pyt based environment that has been developed to solve complex mathematical models, particularly coupled, non-linear and time-dependent partial differential equations. The intention of this cookbook is to introduce new users to \esc and provide a set of examples which demonstrate the major concepts and can be adapted to new problems. Although most of the examples in this cookbook are focused on the disciplines of geophysics and geology, they provide a solid introduction to \esc and its capabilities.
68	gross	2605	\end{abstract}
69	ahallam	2411	\tableofcontents
70
71	ahallam	2495	\newpage
72
73	ahallam	2977	\chapter{Introduction}
74			\label{CHAP INTRO}
75	ahallam	2411	\input{intro}
76
77			\chapter{Getting Started with Heat Diffusion}
78	ahallam	2634	\label{CHAP HEAT DIFF}
79	artak	2957	We start by examining a simple one dimensional heat diffusion equation. This problem provides a good starting example to build our knowledge of \esc and demonstrate how to solve simple partial differential equations (PDEs)\footnote{Wikipedia provides an excellent and comprehensive introduction to \textit{Partial Differential Equations} \url{http://en.wikipedia.org/wiki/Partial_differential_equation}, however their relevance to \esc and implementation should become much clearer as we develop our understanding further into the cookbook.}
80	gross	2949	\input{example01}
81			\input{example02}
82	ahallam	2634
83	artak	2969	\chapter{Heat Diffusion in Two Dimensions}
84	gross	2931	\label{CHAP HEAT 2a}
85	gross	2950	\input{example03}
86	gross	2931
87			\chapter{Complex Geometries}
88	ahallam	2634	\label{CHAP HEAT 2}
89	ahallam	2597	\input{steadystateheatdiff}
90	ahallam	2411
91			% Moving into 2D and 3D wave propagations in next chapters.
92	gross	2948	% not part of release 3.1
93	gross	2931	% \chapter{Seismic Wave Propagation}
94			% \input{twodswp001}
95	ahallam	2975	\appendix
96	artak	2972	%\include{einsteinETA}
97	ahallam	2411	\end{document}