1 |
% $Id$ |
2 |
% |
3 |
% Copyright © 2006 by ACcESS MNRF |
4 |
% \url{http://www.access.edu.au |
5 |
% Primary Business: Queensland, Australia. |
6 |
% Licensed under the Open Software License version 3.0 |
7 |
% http://www.opensource.org/licenses/osl-3.0.php |
8 |
% |
9 |
|
10 |
|
11 |
\usepackage{epsfig} |
12 |
\usepackage{graphicx,color} |
13 |
\usepackage{makeidx} % handle the index properly |
14 |
\usepackage{xspace} % handle spaces after commands more nicely |
15 |
% use the ams math stuff, as it makes the maths easier to code, and |
16 |
% nicer output than the standard LaTeX stuff |
17 |
\usepackage{amsmath,amsfonts,amssymb} % this is handy for mathematicians and physicists |
18 |
% see http://www.ams.org/tex/amslatex.html |
19 |
\usepackage{alltt} % handy verbatim stuff |
20 |
|
21 |
|
22 |
% define some handy commands for escript stuff |
23 |
\newcommand{\LINUX}{{\it Linux}\xspace} |
24 |
\newcommand{\netCDF}{{\it netCDF}\cite{NETCDF}\index{netCDF} \xspace} |
25 |
\newcommand{\escript}{\module{esys.escript}\xspace} |
26 |
\newcommand{\finley}{\module{esys.finley}\xspace} |
27 |
\newcommand{\esys}{\module{esys}\xspace} |
28 |
\newcommand{\bruce}{\module{esys.bruce}\xspace} |
29 |
\newcommand{\pyvisi}{\module{esys.pyvisi}\xspace} |
30 |
\newcommand{\pycad}{\module{esys.pycad}\xspace} |
31 |
\newcommand{\gmsh}{\module{esys.pycad.gmsh}\xspace} |
32 |
\newcommand{\gmshextern}{{\it Gmsh}\cite{GMSH}\index{Gmsh} \xspace} |
33 |
|
34 |
|
35 |
\newcommand{\linearPDEs}{\module{esys.escript.linearPDEs}\xspace} |
36 |
\newcommand{\LinearPDE}{\class{LinearPDE}\xspace} |
37 |
\newcommand{\timeseries}{\module{esys.timeseries}\xspace} |
38 |
\newcommand{\modelframe}{\module{esys.modelframe}\xspace} |
39 |
\newcommand{\pdetools}{\module{esys.pdetools}\xspace} |
40 |
|
41 |
\newcommand{\AdvectivePDE}{\class{AdvectivePDE}\xspace} |
42 |
\newcommand{\Poisson}{\class{Poisson}\xspace} |
43 |
\newcommand{\Helmholtz}{\class{Helmholtz}\xspace} |
44 |
\newcommand{\Lame}{\class{Lame}\xspace} |
45 |
\newcommand{\Data}{\class{Data}\xspace} |
46 |
\newcommand{\EmptyData}{empty \class{Data} \index{empty Data}\xspace} |
47 |
\newcommand{\Domain}{\class{Domain}\xspace} |
48 |
%\newcommand{\VTK}{{\it vtk} \cite{VTK}\index{visualization!vtk} \xspace} |
49 |
\newcommand{\GnuPlot}{{\it gnuplot} \cite{GNUPLOT}\index{visualization!gnuplot}\index{gnuplot}} |
50 |
\newcommand{\mayavi}{{\it mayavi} \index{visualization!mayavi}\index{mayavi}} |
51 |
\newcommand{\OpenDX}{{\it OpenDX} \cite{OPENDX}\xspace} |
52 |
\newcommand{\finleyelement}[1]{{\it #1}\index{finley!#1}} |
53 |
\newcommand{\False}{\constant{False}\xspace} |
54 |
\newcommand{\True}{\constant{True}\xspace} |
55 |
\newcommand{\PCG}{\constant{LinearPDE.PCG}\xspace\index{linear solver!PCG}\index{PCG}} |
56 |
\newcommand{\BiCGStab}{\constant{LinearPDE.BICGSTAB}\xspace\index{linear solver!BiCGStab}\index{BiCGStab}} |
57 |
\newcommand{\Direct}{\constant{LinearPDE.DIRECT}\xspace\index{linear solver!Direct}\index{Direct solver}} |
58 |
\newcommand{\GMRES}{\constant{LinearPDE.GMRES}\xspace\index{linear solver!GMRES}\index{GMRES}} |
59 |
\newcommand{\PRESTWENTY}{\constant{LinearPDE.PRES20}\xspace\index{linear solver!PRES20}\index{PRES20}} |
60 |
\newcommand{\JACOBI}{\constant{LinearPDE.JACOBI}\xspace\index{preconditioner!Jacobi}\index{Jacobi}} |
61 |
\newcommand{\ILU}{\constant{LinearPDE.ILU0}\xspace\index{preconditioner!ILU0}\index{ILU0}} |
62 |
\newcommand{\ILUT}{\constant{LinearPDE.ILUT}\xspace\index{preconditioner!ILUT}\index{ILUT}} |
63 |
\newcommand{\LUMPING}{\constant{LinearPDE.LUMPING}\xspace\index{linear solver!lumping}\index{lumping}} |
64 |
\newcommand{\NOREORDERING}{\constant{LinearPDE.NO\hackscore REORDERING}\xspace} |
65 |
\newcommand{\MINIMUMFILLIN}{\constant{LinearPDE.MINIMUM\hackscore FILL\hackscore IN}\xspace\index{linear solver!minimum fill-in ordering}\index{minimum fill-in ordering}} |
66 |
\newcommand{\NESTEDDESCTION}{\constant{LinearPDE.NESTED\hackscore DISSECTION}\xspace\index{linear solver!nested dissection ordering}\index{nested dissection}} |
67 |
|
68 |
\newcommand{\FunctionSpace}{\class{FunctionSpace}\xspace} |
69 |
\newcommand{\Operator}{\class{Operator}\xspace} |
70 |
\newcommand{\SolutionFS}{solution \class{FunctionSpace}\index{solution}\xspace} |
71 |
\newcommand{\ReducedSolutionFS}{reduced solution \class{FunctionSpace}\index{solution!reduced}\xspace} |
72 |
\newcommand{\FunctionOnBoundary}{boundary \class{FunctionSpace}\xspace} |
73 |
\newcommand{\Function}{general \class{FunctionSpace}\xspace} |
74 |
\newcommand{\FunctionOnContactZero}{contact \class{FunctionSpace} on side 0\xspace} |
75 |
\newcommand{\FunctionOnContactOne}{contact \class{FunctionSpace} on side 1\xspace} |
76 |
\newcommand{\ContinuousFunction}{continuous \class{FunctionSpace}\xspace} |
77 |
\newcommand{\RankOne}{{rank-1 \Data object}\xspace} |
78 |
\newcommand{\RankTwo}{{rank-2 \Data object}\xspace} |
79 |
\newcommand{\RankThree}{{rank-3 \Data object}\xspace} |
80 |
\newcommand{\RankFour}{{rank-4 \Data object}\xspace} |
81 |
\newcommand{\Tensor}{{tensor \Data object}\xspace} |
82 |
\newcommand{\Vector}{{vector \Data object}\xspace} |
83 |
\newcommand{\Scalar}{{scalar \Data object}\xspace} |
84 |
\newcommand{\DataSample}{{data sample} \index{data sample}\xspace} |
85 |
\newcommand{\DataSamplePoints}{{data sample points} \index{data sample!points}\xspace} |
86 |
\newcommand{\numarray}{\module{numarray}\xspace} |
87 |
\newcommand{\Shape}{shape\xspace\index{shape}} |
88 |
\newcommand{\Rank}{rank\xspace\index{shape}} |
89 |
\newcommand{\ExampleDirectory}{example directory\xspace} |
90 |
\newcommand{\ReferenceGuide}{\url{http://www.iservo.edu.au/esys/epydoc/index.html} \xspace} |
91 |
\newcommand{\Point}{\class{Point} \xspace} |
92 |
\newcommand{\PropertySet}{\class{PropertySet} \xspace} |
93 |
\newcommand{\Design}{\class{Design} \xspace} |
94 |
\newcommand{\TagMap}{\class{TagMap} \xspace} |
95 |
\newcommand{\ManifoldOneD}{\class{Manifold1D} \xspace} |
96 |
\newcommand{\ManifoldTwoD}{\class{Manifold2D} \xspace} |
97 |
\newcommand{\ManifoldThreeD}{\class{Manifold3D} \xspace} |
98 |
|
99 |
% handy commands for pyvisi |
100 |
\newcommand{\VTK}{{\it VTK} \xspace} |
101 |
\newcommand{\VTKUrl}{\url{http://www.vtk.org/}\xspace} |
102 |
\newcommand{\Scene}{\class{Scene}\xspace} |
103 |
\newcommand{\Camera}{\class{Camera}\xspace} |
104 |
\newcommand{\Light}{\class{Light}\xspace} |
105 |
\newcommand{\DataCollector}{\class{DataCollector}\xspace} |
106 |
\newcommand{\ImageReader}{\class{ImageReader}\xspace} |
107 |
\newcommand{\TextTwoD}{\class{Text2D}\xspace} |
108 |
\newcommand{\ActorTwoD}{\class{Actor2D}\xspace} |
109 |
\newcommand{\ActorThreeD}{\class{Actor3D}\xspace} |
110 |
\newcommand{\Transform}{\class{Transform}\xspace} |
111 |
\newcommand{\Clipper}{\class{Clipper}\xspace} |
112 |
\newcommand{\Map}{\class{Map}\xspace} |
113 |
\newcommand{\MapOnPlaneCut}{\class{MapOnPlaneCut}\xspace} |
114 |
\newcommand{\MapOnPlaneClip}{\class{MapOnPlaneClip}\xspace} |
115 |
\newcommand{\MapOnScalarClip}{\class{MapOnScalarClip}\xspace} |
116 |
\newcommand{\GlyphThreeD}{\class{Glyph3D}\xspace} |
117 |
\newcommand{\MaskPoints}{\class{MaskPoints}\xspace} |
118 |
\newcommand{\Velocity}{\class{Velocity}\xspace} |
119 |
\newcommand{\VelocityOnPlaneCut}{\class{VelocityOnPlaneCut}\xspace} |
120 |
\newcommand{\VelocityOnPlaneClip}{\class{VelocityOnPlaneClip}\xspace} |
121 |
\newcommand{\Sphere}{\class{Sphere}\xspace} |
122 |
\newcommand{\TensorGlyph}{\class{TensorGlyph}\xspace} |
123 |
\newcommand{\Ellipsoid}{\class{Ellipsoid}\xspace} |
124 |
\newcommand{\EllipsoidOnPlaneCut}{\class{EllipsoidOnPlaneCut}\xspace} |
125 |
\newcommand{\EllipsoidOnPlaneClip}{\class{EllipsoidOnPlaneClip}\xspace} |
126 |
\newcommand{\ContourModule}{\class{ContourModule}\xspace} |
127 |
\newcommand{\Contour}{\class{Contour}\xspace} |
128 |
\newcommand{\ContourOnPlaneCut}{\class{ContourOnPlaneCut}\xspace} |
129 |
\newcommand{\ContourOnPlaneClip}{\class{ContourOnPlaneClip}\xspace} |
130 |
\newcommand{\PointSource}{\class{PointSource}\xspace} |
131 |
\newcommand{\StreamLineModule}{\class{StreamLineModule}\xspace} |
132 |
\newcommand{\Tube}{\class{Tube}\xspace} |
133 |
\newcommand{\StreamLine}{\class{StreamLine}\xspace} |
134 |
\newcommand{\Warp}{\class{Warp}\xspace} |
135 |
\newcommand{\Carpet}{\class{Carpet}\xspace} |
136 |
\newcommand{\PlaneSource}{\class{PlaneSource}\xspace} |
137 |
\newcommand{\Image}{\class{Image}\xspace} |
138 |
\newcommand{\Position}{\class{Position}\xspace} |
139 |
\newcommand{\thumbnailwidth}{50mm} |
140 |
|
141 |
% default width for figures |
142 |
\newcommand{\figwidth}{100mm} |
143 |
% commands useful in cross-referencing |
144 |
\newcommand {\Ref}[1] {Reference~\cite{#1}} |
145 |
\newcommand {\Sec}[1] {Section~\ref{#1}} |
146 |
\newcommand {\App}[1] {Appendix~\ref{#1}} |
147 |
\newcommand {\Chap}[1] {Chapter~\ref{#1}} |
148 |
\newcommand {\etal} {\emph{~et~al.}} |
149 |
\newcommand {\fig}[1] {Figure~\ref{#1}} |
150 |
\newcommand {\eqn}[1] {Equation~(\ref{#1})} |
151 |
\newcommand {\tab}[1] {Table~\ref{#1}} |
152 |
|
153 |
% this stops one figure taking up a whole page and lets more text onto |
154 |
% the one page when a figure exists |
155 |
\renewcommand{\floatpagefraction}{0.8} % Default = 0.5 |
156 |
|
157 |
% improved version of caption handling |
158 |
\usepackage{ccaption} |
159 |
\captionnamefont{\scshape} |
160 |
\captionstyle{} |
161 |
\makeatletter |
162 |
\renewcommand{\fnum@figure}[1]{\quad\small\textsc{\figurename~\thefigure}:} |
163 |
\renewcommand{\@makecaption}[2]{% |
164 |
\vskip\abovecaptionskip |
165 |
\sbox\@tempboxa{#1: #2}% |
166 |
\ifdim \wd\@tempboxa >\hsize |
167 |
\def\baselinestretch{1}\@normalsize |
168 |
#1: #2\par |
169 |
\def\baselinestretch{1.5}\@normalsize |
170 |
\else |
171 |
\global \@minipagefalse |
172 |
\hb@xt@\hsize{\hfil\box\@tempboxa\hfil}% |
173 |
\fi |
174 |
\vskip\belowcaptionskip} |
175 |
\makeatother |
176 |
|
177 |
% \usepackage{fancyvrb} % fancy verbatim stuff. Needed so code below goes |
178 |
%%% this code grabbed from the PyScript docs |
179 |
%%% pyscript.sourceforge.net |
180 |
|
181 |
% -------------------------------------------------------------- |
182 |
% Code format within \Verb |
183 |
% -------------------------------------------------------------- |
184 |
|
185 |
% \definecolor{pycolor}{rgb}{0,0.4,0} |
186 |
|
187 |
%% \DefineVerbatimEnvironment{python}{Verbatim} |
188 |
%% {frame=leftline,framerule=.5mm,rulecolor=\color{pycolor}, |
189 |
%% formatcom=\color{pycolor}\small,fontshape=rm} |
190 |
|
191 |
%\DefineShortVerb[formatcom=\color{dgreen}\small,fontshape=sl]{\|} |
192 |
|
193 |
% \RecustomVerbatimCommand{\Verb}{Verb}{formatcom=\color{pycolor}\small,fontshape=rm} |
194 |
|
195 |
%%% end of grabbed code |
196 |
|
197 |
% this is for when one uses pdflatex and therefore needs to load pdf |
198 |
% figures into \includegraphics |
199 |
\ifpdf |
200 |
\DeclareGraphicsExtensions{.pdf} % this command defined in graphicx |
201 |
\pdfcompresslevel=9 % 0: no compression, 9: highest compression |
202 |
% or, set compress_level 9 in file pdftex.cfg |
203 |
\else |
204 |
\DeclareGraphicsExtensions{.eps} |
205 |
\fi |
206 |
|
207 |
% defines the colour for the background of code examples |
208 |
\definecolor{LightGrey}{gray}{0.9} |
209 |
|
210 |
% add the listings package to pretty print the code output |
211 |
\usepackage{listings} |
212 |
|
213 |
\lstdefinestyle{myC++}{% |
214 |
%\lstset{% |
215 |
language=C++, |
216 |
showstringspaces=false, |
217 |
basicstyle=\small\ttfamily, |
218 |
commentstyle=\color[named]{BrickRed}\ttfamily, |
219 |
keywordstyle=\color[named]{Purple}\ttfamily, |
220 |
%identifierstyle=\color[named]{Blue}\ttfamily, |
221 |
%functionstyle=\color[named]{Blue}\ttfamily, |
222 |
%typestyle=\color[named]{ForestGreen}\ttfamily, |
223 |
stringstyle=\color[named]{Tan}\ttfamily,% |
224 |
morekeywords={,complex,}% |
225 |
frame=none,% |
226 |
backgroundcolor=\color{LightGrey}% |
227 |
} |
228 |
|
229 |
\lstdefinestyle{myMatlab}{% |
230 |
%\lstset{% |
231 |
language=Matlab, |
232 |
showstringspaces=false, |
233 |
basicstyle=\small\ttfamily, |
234 |
commentstyle=\color[named]{BrickRed}\ttfamily, |
235 |
keywordstyle=\color[named]{Purple}\ttfamily, |
236 |
%identifierstyle=\color[named]{Blue}\ttfamily, |
237 |
%functionstyle=\color[named]{Blue}\ttfamily, |
238 |
%typestyle=\color[named]{ForestGreen}\ttfamily, |
239 |
stringstyle=\color[named]{Tan}\ttfamily,% |
240 |
frame=none,% |
241 |
backgroundcolor=\color{LightGrey}% |
242 |
} |
243 |
|
244 |
\lstdefinestyle{myScilab}{% |
245 |
%\lstset{% |
246 |
language=Scilab, |
247 |
showstringspaces=false, |
248 |
basicstyle=\small\ttfamily, |
249 |
commentstyle=\color[named]{BrickRed}\ttfamily, |
250 |
keywordstyle=\color[named]{Purple}\ttfamily, |
251 |
%identifierstyle=\color[named]{Blue}\ttfamily, |
252 |
%functionstyle=\color[named]{Blue}\ttfamily, |
253 |
%typestyle=\color[named]{ForestGreen}\ttfamily, |
254 |
stringstyle=\color[named]{Tan}\ttfamily,% |
255 |
frame=none,% |
256 |
backgroundcolor=\color{LightGrey}% |
257 |
} |
258 |
|
259 |
\lstdefinestyle{myShell}{% |
260 |
%\lstset{% |
261 |
language=ksh, |
262 |
showstringspaces=false, |
263 |
basicstyle=\small\ttfamily, |
264 |
commentstyle=\color[named]{Black}\ttfamily, |
265 |
keywordstyle=\color[named]{Black}\ttfamily, |
266 |
%identifierstyle=\color[named]{Blue}\ttfamily, |
267 |
%functionstyle=\color[named]{Blue}\ttfamily, |
268 |
%typestyle=\color[named]{ForestGreen}\ttfamily, |
269 |
stringstyle=\color[named]{Black}\ttfamily,% |
270 |
frame=none,% |
271 |
backgroundcolor=\color{LightGrey}% |
272 |
} |
273 |
|
274 |
\lstdefinestyle{myPython}{% |
275 |
%\lstset{% |
276 |
language=python, |
277 |
showstringspaces=false, |
278 |
basicstyle=\small\ttfamily, |
279 |
commentstyle=\color[named]{BrickRed}\ttfamily, |
280 |
keywordstyle=\color[named]{Purple}\ttfamily, |
281 |
%identifierstyle=\color[named]{Blue}\ttfamily, |
282 |
%functionstyle=\color[named]{Blue}\ttfamily, |
283 |
%typestyle=\color[named]{ForestGreen}\ttfamily, |
284 |
stringstyle=\color[named]{Tan}\ttfamily,% |
285 |
frame=none,% |
286 |
%backgroundcolor=\color{LightGrey}% |
287 |
} |
288 |
|
289 |
\lstdefinestyle{myhtml}{% |
290 |
%\lstset{% |
291 |
language=xml, |
292 |
showstringspaces=false, |
293 |
basicstyle=\small\ttfamily, |
294 |
commentstyle=\color[named]{BrickRed}\ttfamily, |
295 |
keywordstyle=\color[named]{Purple}\ttfamily, |
296 |
%identifierstyle=\color[named]{Blue}\ttfamily, |
297 |
%functionstyle=\color[named]{Blue}\ttfamily, |
298 |
%typestyle=\color[named]{ForestGreen}\ttfamily, |
299 |
stringstyle=\color[named]{Tan}\ttfamily, |
300 |
morekeywords={,simulation,prop_dim,error_check,stochastic,% |
301 |
globals,field,dimensions,lattice,domains,samples,vector,% |
302 |
components,fourier_space,sequence,integrate,algorithm,% |
303 |
interval,k_operators,constant,operator_names,vectors,% |
304 |
output,filename,group,sampling,moments,benchmark,use_double,% |
305 |
use_wisdom,use_prefs,binary_output,cycles,filter,post_propagation,% |
306 |
default_value,argv,arg,iterations,cross_propagation,% |
307 |
use_mpi,paths,seed,noises,author,description,name,type,% |
308 |
} |
309 |
frame=none,% |
310 |
%framerule=2pt,% |
311 |
backgroundcolor=\color{LightGrey}% |
312 |
} |
313 |
|
314 |
% this implements producing nice code blocks |
315 |
% it also saves time, typing and |
316 |
% *should* reduce errors in the text by removing doubling up of code |
317 |
\lstnewenvironment{xmdsCode}[1][]{\lstset{style=myhtml}\lstset{#1}}{} |
318 |
|
319 |
% this implements nicely formatted shell code |
320 |
\lstnewenvironment{shellCode}[1][]{\lstset{style=myShell}\lstset{#1}}{} |
321 |
|
322 |
% this implements nicely formatted Perl code |
323 |
\lstnewenvironment{perlCode}[1][]{\lstset{style=myPerl}\lstset{#1}}{} |
324 |
|
325 |
% this implements nicely formatted Python code |
326 |
\lstnewenvironment{python}[1][]{\lstset{style=myPython}\lstset{#1}}{} |
327 |
|
328 |
% this implements nicely formatted C++ code |
329 |
\lstnewenvironment{CCode}{\lstset{style=myC++}}{} |
330 |
|
331 |
% this implements nicely formatted matlab code |
332 |
\lstnewenvironment{matlabCode}{\lstset{style=myMatlab}}{} |
333 |
|
334 |
% this implements nicely formatted scilab code |
335 |
\lstnewenvironment{scilabCode}{\lstset{style=myScilab}}{} |
336 |
|