/[escript]/branches/stage3.1/doc/user/guide_defs.tex
ViewVC logotype

Diff of /branches/stage3.1/doc/user/guide_defs.tex

Parent Directory Parent Directory | Revision Log Revision Log | View Patch Patch

revision 2128 by lgraham, Thu Dec 4 03:48:22 2008 UTC revision 2558 by gross, Mon Jul 27 05:03:32 2009 UTC
# Line 1  Line 1 
1    
2  %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%  %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
3  %  %
4  % Copyright (c) 2003-2008 by University of Queensland  % Copyright (c) 2003-2009 by University of Queensland
5  % Earth Systems Science Computational Center (ESSCC)  % Earth Systems Science Computational Center (ESSCC)
6  % http://www.uq.edu.au/esscc  % http://www.uq.edu.au/esscc
7  %  %
# Line 26  Line 26 
26    
27  % define some handy commands for escript stuff  % define some handy commands for escript stuff
28  \newcommand{\LINUX}{{\it Linux}\xspace}  \newcommand{\LINUX}{{\it Linux}\xspace}
29  \newcommand{\netCDF}{{\it netCDF}\cite{NETCDF}\index{netCDF} \xspace}  \newcommand{\WINDOWS}{{\it MS Windows}\xspace}
30    \newcommand{\PYTHON}{{\it python}\xspace}
31    % \newcommand{\netCDF}{{\it netCDF}\cite{NETCDF}\index{netCDF} \xspace}
32    \newcommand{\netCDF}{{\it netCDF}\index{netCDF}\xspace}
33  \newcommand{\escript}{\module{esys.escript}\xspace}  \newcommand{\escript}{\module{esys.escript}\xspace}
34  \newcommand{\finley}{\module{esys.finley}\xspace}  \newcommand{\finley}{\module{esys.finley}\xspace}
35  \newcommand{\esys}{\module{esys}\xspace}  \newcommand{\esys}{\module{esys}\xspace}
# Line 34  Line 37 
37  \newcommand{\pycad}{\module{esys.pycad}\xspace}  \newcommand{\pycad}{\module{esys.pycad}\xspace}
38  \newcommand{\gmsh}{\module{esys.pycad.gmsh}\xspace}  \newcommand{\gmsh}{\module{esys.pycad.gmsh}\xspace}
39  \newcommand{\gmshextern}{{\it Gmsh}\cite{GMSH}\index{Gmsh} \xspace}  \newcommand{\gmshextern}{{\it Gmsh}\cite{GMSH}\index{Gmsh} \xspace}
40    \newcommand{\env}[1]{\textbf{\mbox{#1}}\index{Environment!#1}}
41    % \newcommand{\MPI}{{\it MPI}\xspace\index{Message Passing Interface!MPI}\cite{MPI}\xspace}
42    % \newcommand{\OPENMP}{{\it OpenMP}\xspace\index{OpenMP!threading}\cite{OPENMP}\xspace}
43    \newcommand{\MPI}{{\it MPI}\xspace\index{Message Passing Interface!MPI}\xspace}
44    \newcommand{\OPENMP}{{\it OpenMP}\xspace\index{OpenMP!threading}\xspace}
45  \newcommand{\linearPDEs}{\module{esys.escript.linearPDEs}\xspace}  \newcommand{\linearPDEs}{\module{esys.escript.linearPDEs}\xspace}
46  \newcommand{\LinearPDE}{\class{LinearPDE}\xspace}  \newcommand{\LinearPDE}{\class{LinearPDE}\xspace}
 \newcommand{\timeseries}{\module{esys.timeseries}\xspace}  
47  \newcommand{\modelframe}{\module{esys.modelframe}\xspace}  \newcommand{\modelframe}{\module{esys.modelframe}\xspace}
48  \newcommand{\pdetools}{\module{esys.pdetools}\xspace}  \newcommand{\pdetools}{\module{esys.pdetools}\xspace}
49    \newcommand{\esysxml}{{\it esysxml}}
50    
51  \newcommand{\AdvectivePDE}{\class{AdvectivePDE}\xspace}  \newcommand{\SolverOptions}{\class{SolverOptions}\xspace}
52  \newcommand{\Poisson}{\class{Poisson}\xspace}  \newcommand{\Poisson}{\class{Poisson}\xspace}
53  \newcommand{\Helmholtz}{\class{Helmholtz}\xspace}  \newcommand{\Helmholtz}{\class{Helmholtz}\xspace}
54  \newcommand{\Lame}{\class{Lame}\xspace}  \newcommand{\Lame}{\class{Lame}\xspace}
# Line 56  Line 62 
62  \newcommand{\finleyelement}[1]{{\it #1}\index{finley!#1}}  \newcommand{\finleyelement}[1]{{\it #1}\index{finley!#1}}
63  \newcommand{\False}{\constant{False}\xspace}  \newcommand{\False}{\constant{False}\xspace}
64  \newcommand{\True}{\constant{True}\xspace}  \newcommand{\True}{\constant{True}\xspace}
65  \newcommand{\PCG}{\constant{LinearPDE.PCG}\xspace\index{linear solver!PCG}\index{PCG}}  \newcommand{\PCG}{\constant{SolverOptions.PCG}\xspace\index{linear solver!PCG}\index{PCG}}
66  \newcommand{\BiCGStab}{\constant{LinearPDE.BICGSTAB}\xspace\index{linear solver!BiCGStab}\index{BiCGStab}}  \newcommand{\BiCGStab}{\constant{SolverOptions.BICGSTAB}\xspace\index{linear solver!BiCGStab}\index{BiCGStab}}
67  \newcommand{\Direct}{\constant{LinearPDE.DIRECT}\xspace\index{linear solver!Direct}\index{Direct solver}}  \newcommand{\Direct}{\constant{SolverOptions.DIRECT}\xspace\index{linear solver!Direct}\index{Direct solver}}
68  \newcommand{\GMRES}{\constant{LinearPDE.GMRES}\xspace\index{linear solver!GMRES}\index{GMRES}}  \newcommand{\GMRES}{\constant{SolverOptions.GMRES}\xspace\index{linear solver!GMRES}\index{GMRES}}
69  \newcommand{\PRESTWENTY}{\constant{LinearPDE.PRES20}\xspace\index{linear solver!PRES20}\index{PRES20}}  \newcommand{\PRESTWENTY}{\constant{SolverOptions.PRES20}\xspace\index{linear solver!PRES20}\index{PRES20}}
70  \newcommand{\JACOBI}{\constant{LinearPDE.JACOBI}\xspace\index{preconditioner!Jacobi}\index{Jacobi}}  \newcommand{\JACOBI}{\constant{SolverOptions.JACOBI}\xspace\index{preconditioner!Jacobi}\index{Jacobi}}
71  \newcommand{\ILU}{\constant{LinearPDE.ILU0}\xspace\index{preconditioner!ILU0}\index{ILU0}}  \newcommand{\ILU}{\constant{SolverOptions.ILU0}\xspace\index{preconditioner!ILU0}\index{ILU0}}
72  \newcommand{\ILUT}{\constant{LinearPDE.ILUT}\xspace\index{preconditioner!ILUT}\index{ILUT}}  \newcommand{\ILUT}{\constant{SolverOptions.ILUT}\xspace\index{preconditioner!ILUT}\index{ILUT}}
73  \newcommand{\LUMPING}{\constant{LinearPDE.LUMPING}\xspace\index{linear solver!lumping}\index{lumping}}  \newcommand{\RILU}{\constant{SolverOptions.RILU}\xspace\index{preconditioner!RILU}\index{RILU}}
74  \newcommand{\NOREORDERING}{\constant{LinearPDE.NO\hackscore REORDERING}\xspace}  \newcommand{\LUMPING}{\constant{SolverOptions.LUMPING}\xspace\index{linear solver!lumping}\index{lumping}}
75  \newcommand{\MINIMUMFILLIN}{\constant{LinearPDE.MINIMUM\hackscore FILL\hackscore IN}\xspace\index{linear solver!minimum fill-in ordering}\index{minimum fill-in ordering}}  \newcommand{\NOREORDERING}{\constant{SolverOptions.NO\hackscore REORDERING}\xspace}
76  \newcommand{\NESTEDDESCTION}{\constant{LinearPDE.NESTED\hackscore DISSECTION}\xspace\index{linear solver!nested dissection ordering}\index{nested dissection}}  \newcommand{\MINIMUMFILLIN}{\constant{SolverOptions.MINIMUM\hackscore FILL\hackscore IN}\xspace\index{linear solver!minimum fill-in ordering}\index{minimum fill-in ordering}}
77    \newcommand{\NESTEDDESCTION}{\constant{SolverOptions.NESTED\hackscore DISSECTION}\xspace\index{linear solver!nested dissection ordering}\index{nested dissection}}
78    \newcommand{\AMG}{\constant{SolverOptions.AMG}\xspace\index{linear solver!AMG}\index{algebraic Multi-grid}\index{AMG}}
79    \newcommand{\GAUSSSEIDEL}{\constant{SolverOptions.GAUSS\hackscore SEIDEL}\xspace\index{linear solver!Gauss-Seidel}\index{preconditioner!Gauss-Seidel}\index{Gauss-Seidel Scheme}}
80    \newcommand{\MKL}{\texttt{MKL}\xspace\index{packages!MKL}\index{MKL}}
81    \newcommand{\UMFPACK}{\texttt{UMFPACK}\xspace\index{packages!UMFPACK}\index{UMFPACK}}
82    \newcommand{\PASO}{\texttt{PASO}\xspace\index{packages!PASO}\index{PASO}}
83    
84  \newcommand{\FunctionSpace}{\class{FunctionSpace}\xspace}  \newcommand{\FunctionSpace}{\class{FunctionSpace}\xspace}
85  \newcommand{\Operator}{\class{Operator}\xspace}  \newcommand{\Operator}{\class{Operator}\xspace}
# Line 87  Line 99 
99  \newcommand{\Scalar}{{scalar \Data object}\xspace}  \newcommand{\Scalar}{{scalar \Data object}\xspace}
100  \newcommand{\DataSample}{{data sample}\index{data sample}\xspace}  \newcommand{\DataSample}{{data sample}\index{data sample}\xspace}
101  \newcommand{\DataSamplePoints}{{data sample points}\index{data sample!points}\xspace}  \newcommand{\DataSamplePoints}{{data sample points}\index{data sample!points}\xspace}
102  \newcommand{\numarray}{\module{numarray}\xspace}  \newcommand{\numpy}{\module{numpy}\xspace}
103  \newcommand{\numarrayNA}{\module{numarray}.\class{NumArray}\xspace}  \newcommand{\numpyNDA}{\module{numpy.\class{ndarray}\xspace}}
104    
105  \newcommand{\Shape}{shape\xspace\index{shape}}  \newcommand{\Shape}{shape\xspace\index{shape}}
106  \newcommand{\Rank}{rank\xspace\index{shape}}  \newcommand{\Rank}{rank\xspace\index{shape}}
107  \newcommand{\ExampleDirectory}{example directory\xspace}  \newcommand{\ExampleDirectory}{example directory\xspace}
108  \newcommand{\ReferenceGuide}{\url{http://shake200.esscc.uq.edu.au/esys/esys13/release/epydoc/index.html}\xspace}  \newcommand{\ReferenceGuide}{\url{http://esys.esscc.uq.edu.au/docs.html}\xspace}
109  \newcommand{\Point}{\class{Point} \xspace}  \newcommand{\Point}{\class{Point} \xspace}
110  \newcommand{\PropertySet}{\class{PropertySet} \xspace}  \newcommand{\PropertySet}{\class{PropertySet} \xspace}
111  \newcommand{\Design}{\class{Design} \xspace}  \newcommand{\Design}{\class{Design} \xspace}
# Line 227  Line 240 
240  % add the listings package to pretty print the code output  % add the listings package to pretty print the code output
241  \usepackage{listings}  \usepackage{listings}
242    
243    
244    %Some colour definitions added to keep pdflatex happy
245    %I make no claim that these values are particularly good
246    \definecolor{Purple}{rgb}{0.7, 0, 0.6}
247    \definecolor{Tan}{rgb}{0.5,0.5,0.5}
248    \definecolor{BrickRed}{rgb}{0.7, 0.2, 0.2}
249    \definecolor{Black}{rgb}{0, 0, 0}
250    
251    % All the \color{x} used to be \color[named]{x}
252    %end color defs
253    
254  \lstdefinestyle{myC++}{%  \lstdefinestyle{myC++}{%
255  %\lstset{%  %\lstset{%
256  language=C++,  language=C++,
257  showstringspaces=false,  showstringspaces=false,
258  basicstyle=\small\ttfamily,  basicstyle=\small\ttfamily,
259  commentstyle=\color[named]{BrickRed}\ttfamily,  commentstyle=\color{BrickRed}\ttfamily,
260  keywordstyle=\color[named]{Purple}\ttfamily,  keywordstyle=\color{Purple}\ttfamily,
261  %identifierstyle=\color[named]{Blue}\ttfamily,  %identifierstyle=\color{Blue}\ttfamily,
262  %functionstyle=\color[named]{Blue}\ttfamily,  %functionstyle=\color{Blue}\ttfamily,
263  %typestyle=\color[named]{ForestGreen}\ttfamily,  %typestyle=\color{ForestGreen}\ttfamily,
264  stringstyle=\color[named]{Tan}\ttfamily,%  stringstyle=\color{Tan}\ttfamily,%
265  morekeywords={,complex,}%  morekeywords={,complex,}%
266  frame=none,%  frame=none,%
267  backgroundcolor=\color{LightGrey}%  backgroundcolor=\color{LightGrey}%
# Line 248  backgroundcolor=\color{LightGrey}% Line 272  backgroundcolor=\color{LightGrey}%
272  language=Matlab,  language=Matlab,
273  showstringspaces=false,  showstringspaces=false,
274  basicstyle=\small\ttfamily,  basicstyle=\small\ttfamily,
275  commentstyle=\color[named]{BrickRed}\ttfamily,  commentstyle=\color{BrickRed}\ttfamily,
276  keywordstyle=\color[named]{Purple}\ttfamily,  keywordstyle=\color{Purple}\ttfamily,
277  %identifierstyle=\color[named]{Blue}\ttfamily,  %identifierstyle=\color{Blue}\ttfamily,
278  %functionstyle=\color[named]{Blue}\ttfamily,  %functionstyle=\color{Blue}\ttfamily,
279  %typestyle=\color[named]{ForestGreen}\ttfamily,  %typestyle=\color{ForestGreen}\ttfamily,
280  stringstyle=\color[named]{Tan}\ttfamily,%  stringstyle=\color{Tan}\ttfamily,%
281  frame=none,%  frame=none,%
282  backgroundcolor=\color{LightGrey}%  backgroundcolor=\color{LightGrey}%
283  }  }
# Line 263  backgroundcolor=\color{LightGrey}% Line 287  backgroundcolor=\color{LightGrey}%
287  language=Scilab,  language=Scilab,
288  showstringspaces=false,  showstringspaces=false,
289  basicstyle=\small\ttfamily,  basicstyle=\small\ttfamily,
290  commentstyle=\color[named]{BrickRed}\ttfamily,  commentstyle=\color{BrickRed}\ttfamily,
291  keywordstyle=\color[named]{Purple}\ttfamily,  keywordstyle=\color{Purple}\ttfamily,
292  %identifierstyle=\color[named]{Blue}\ttfamily,  %identifierstyle=\color{Blue}\ttfamily,
293  %functionstyle=\color[named]{Blue}\ttfamily,  %functionstyle=\color{Blue}\ttfamily,
294  %typestyle=\color[named]{ForestGreen}\ttfamily,  %typestyle=\color{ForestGreen}\ttfamily,
295  stringstyle=\color[named]{Tan}\ttfamily,%  stringstyle=\color{Tan}\ttfamily,%
296  frame=none,%  frame=none,%
297  backgroundcolor=\color{LightGrey}%  backgroundcolor=\color{LightGrey}%
298  }  }
# Line 278  backgroundcolor=\color{LightGrey}% Line 302  backgroundcolor=\color{LightGrey}%
302  language=ksh,  language=ksh,
303  showstringspaces=false,  showstringspaces=false,
304  basicstyle=\small\ttfamily,  basicstyle=\small\ttfamily,
305  commentstyle=\color[named]{Black}\ttfamily,  commentstyle=\color{Black}\ttfamily,
306  keywordstyle=\color[named]{Black}\ttfamily,  keywordstyle=\color{Black}\ttfamily,
307  %identifierstyle=\color[named]{Blue}\ttfamily,  %identifierstyle=\color{Blue}\ttfamily,
308  %functionstyle=\color[named]{Blue}\ttfamily,  %functionstyle=\color{Blue}\ttfamily,
309  %typestyle=\color[named]{ForestGreen}\ttfamily,  %typestyle=\color{ForestGreen}\ttfamily,
310  stringstyle=\color[named]{Black}\ttfamily,%  stringstyle=\color{Black}\ttfamily,%
311  frame=none,%  frame=none,%
312  backgroundcolor=\color{LightGrey}%  backgroundcolor=\color{LightGrey}%
313  }  }
# Line 293  backgroundcolor=\color{LightGrey}% Line 317  backgroundcolor=\color{LightGrey}%
317  language=python,  language=python,
318  showstringspaces=false,  showstringspaces=false,
319  basicstyle=\small\ttfamily,  basicstyle=\small\ttfamily,
320  commentstyle=\color[named]{BrickRed}\ttfamily,  commentstyle=\color{BrickRed}\ttfamily,
321  keywordstyle=\color[named]{Purple}\ttfamily,  keywordstyle=\color{Purple}\ttfamily,
322  %identifierstyle=\color[named]{Blue}\ttfamily,  %identifierstyle=\color{Blue}\ttfamily,
323  %functionstyle=\color[named]{Blue}\ttfamily,  %functionstyle=\color{Blue}\ttfamily,
324  %typestyle=\color[named]{ForestGreen}\ttfamily,  %typestyle=\color{ForestGreen}\ttfamily,
325  stringstyle=\color[named]{Tan}\ttfamily,%  stringstyle=\color{Tan}\ttfamily,%
326  frame=none,%  frame=none,%
327  %backgroundcolor=\color{LightGrey}%  %backgroundcolor=\color{LightGrey}%
328  }  }
# Line 308  frame=none,% Line 332  frame=none,%
332  language=xml,  language=xml,
333  showstringspaces=false,  showstringspaces=false,
334  basicstyle=\small\ttfamily,  basicstyle=\small\ttfamily,
335  commentstyle=\color[named]{BrickRed}\ttfamily,  commentstyle=\color{BrickRed}\ttfamily,
336  keywordstyle=\color[named]{Purple}\ttfamily,  keywordstyle=\color{Purple}\ttfamily,
337  %identifierstyle=\color[named]{Blue}\ttfamily,  %identifierstyle=\color{Blue}\ttfamily,
338  %functionstyle=\color[named]{Blue}\ttfamily,  %functionstyle=\color{Blue}\ttfamily,
339  %typestyle=\color[named]{ForestGreen}\ttfamily,  %typestyle=\color{ForestGreen}\ttfamily,
340  stringstyle=\color[named]{Tan}\ttfamily,  stringstyle=\color{Tan}\ttfamily,
341  morekeywords={,simulation,prop_dim,error_check,stochastic,%  morekeywords={,simulation,prop_dim,error_check,stochastic,%
342    globals,field,dimensions,lattice,domains,samples,vector,%    globals,field,dimensions,lattice,domains,samples,vector,%
343    components,fourier_space,sequence,integrate,algorithm,%    components,fourier_space,sequence,integrate,algorithm,%
# Line 351  backgroundcolor=\color{LightGrey}% Line 375  backgroundcolor=\color{LightGrey}%
375  % this implements nicely formatted scilab code  % this implements nicely formatted scilab code
376  \lstnewenvironment{scilabCode}{\lstset{style=myScilab}}{}  \lstnewenvironment{scilabCode}{\lstset{style=myScilab}}{}
377    
378    %Ensures that latex doesn't have an error if we don't specify the version
379    \providecommand{\RepVersion}{Unknown\xspace}
380    % to set this value use:
381    % (pdf)latex '\newcommand{\RepVersion}{version\xspace}\input{guide.tex}'
382    % as your command-line

Legend:
Removed from v.2128  
changed lines
  Added in v.2558

  ViewVC Help
Powered by ViewVC 1.1.26