/[escript]/trunk/doc/user/guide_defs.tex
ViewVC logotype

Annotation of /trunk/doc/user/guide_defs.tex

Parent Directory Parent Directory | Revision Log Revision Log


Revision 1081 - (hide annotations)
Wed Apr 11 06:13:46 2007 UTC (12 years, 8 months ago) by jongui
File MIME type: application/x-tex
File size: 13984 byte(s)
Made some updates to the guide.
1 jgs 82 % $Id$
2 gross 625 %
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 jgs 82
10 gross 625
11 jgs 82 \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 gross 565 \newcommand{\LINUX}{{\it Linux}\xspace}
24 gross 993 \newcommand{\netCDF}{{\it netCDF}\cite{NETCDF}\index{netCDF} \xspace}
25 jgs 107 \newcommand{\escript}{\module{esys.escript}\xspace}
26     \newcommand{\finley}{\module{esys.finley}\xspace}
27 gross 999 \newcommand{\esys}{\module{esys}\xspace}
28 gross 606 \newcommand{\bruce}{\module{esys.bruce}\xspace}
29 gross 565 \newcommand{\pyvisi}{\module{esys.pyvisi}\xspace}
30 gross 993 \newcommand{\pycad}{\module{esys.pycad}\xspace}
31 gross 999 \newcommand{\gmsh}{\module{esys.pycad.gmsh}\xspace}
32     \newcommand{\gmshextern}{{\it Gmsh}\cite{GMSH}\index{Gmsh} \xspace}
33 gross 565
34 gross 999
35 gross 565 \newcommand{\linearPDEs}{\module{esys.escript.linearPDEs}\xspace}
36 jgs 102 \newcommand{\LinearPDE}{\class{LinearPDE}\xspace}
37 jgs 121 \newcommand{\timeseries}{\module{esys.timeseries}\xspace}
38     \newcommand{\modelframe}{\module{esys.modelframe}\xspace}
39     \newcommand{\pdetools}{\module{esys.pdetools}\xspace}
40 gross 565
41 jgs 102 \newcommand{\AdvectivePDE}{\class{AdvectivePDE}\xspace}
42     \newcommand{\Poisson}{\class{Poisson}\xspace}
43 gross 568 \newcommand{\Helmholtz}{\class{Helmholtz}\xspace}
44 gross 653 \newcommand{\Lame}{\class{Lame}\xspace}
45 jgs 82 \newcommand{\Data}{\class{Data}\xspace}
46 jgs 102 \newcommand{\EmptyData}{empty \class{Data} \index{empty Data}\xspace}
47     \newcommand{\Domain}{\class{Domain}\xspace}
48 jongui 1002 %\newcommand{\VTK}{{\it vtk} \cite{VTK}\index{visualization!vtk} \xspace}
49 gross 606 \newcommand{\GnuPlot}{{\it gnuplot} \cite{GNUPLOT}\index{visualization!gnuplot}\index{gnuplot}}
50 gross 565 \newcommand{\mayavi}{{\it mayavi} \index{visualization!mayavi}\index{mayavi}}
51 gross 599 \newcommand{\OpenDX}{{\it OpenDX} \cite{OPENDX}\xspace}
52 jgs 102 \newcommand{\finleyelement}[1]{{\it #1}\index{finley!#1}}
53     \newcommand{\False}{\constant{False}\xspace}
54     \newcommand{\True}{\constant{True}\xspace}
55 gross 653 \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 jgs 82
68 jgs 102 \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 gross 565 \newcommand{\RankOne}{{rank-1 \Data object}\xspace}
78 jgs 102 \newcommand{\RankTwo}{{rank-2 \Data object}\xspace}
79     \newcommand{\RankThree}{{rank-3 \Data object}\xspace}
80     \newcommand{\RankFour}{{rank-4 \Data object}\xspace}
81 gross 660 \newcommand{\Tensor}{{tensor \Data object}\xspace}
82     \newcommand{\Vector}{{vector \Data object}\xspace}
83 jgs 102 \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 gross 565 \newcommand{\Rank}{rank\xspace\index{shape}}
89 jgs 102 \newcommand{\ExampleDirectory}{example directory\xspace}
90 jongui 1002 \newcommand{\ReferenceGuide}{\url{http://www.iservo.edu.au/esys/epydoc/index.html} \xspace}
91 gross 999 \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 jgs 102
99 jongui 879 % handy commands for pyvisi
100 jongui 1002 \newcommand{\VTK}{{\it VTK} \xspace}
101     \newcommand{\VTKUrl}{\url{http://www.vtk.org/}\xspace}
102 jongui 879 \newcommand{\Scene}{\class{Scene}\xspace}
103     \newcommand{\Camera}{\class{Camera}\xspace}
104 jongui 886 \newcommand{\Light}{\class{Light}\xspace}
105 jongui 1035 \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 jongui 879 \newcommand{\Map}{\class{Map}\xspace}
113 jongui 1035 \newcommand{\MapOnPlaneCut}{\class{MapOnPlaneCut}\xspace}
114     \newcommand{\MapOnPlaneClip}{\class{MapOnPlaneClip}\xspace}
115 jongui 886 \newcommand{\MapOnScalarClip}{\class{MapOnScalarClip}\xspace}
116 jongui 1035 \newcommand{\GlyphThreeD}{\class{Glyph3D}\xspace}
117 jongui 1078 \newcommand{\MaskPoints}{\class{MaskPoints}\xspace}
118 jongui 1035 \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 jongui 879 \newcommand{\Contour}{\class{Contour}\xspace}
128 jongui 1035 \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 jongui 879 \newcommand{\Carpet}{\class{Carpet}\xspace}
136 jongui 1035 \newcommand{\PlaneSource}{\class{PlaneSource}\xspace}
137     \newcommand{\Image}{\class{Image}\xspace}
138 jongui 879 \newcommand{\Position}{\class{Position}\xspace}
139 jongui 1081 \newcommand{\PyvisiExampleDirectory}{/trunk/doc/examples/pyvisi/}
140     \newcommand{\thumbnailwidth}{50mm}
141 jgs 102
142 jgs 82 % default width for figures
143     \newcommand{\figwidth}{100mm}
144     % commands useful in cross-referencing
145     \newcommand {\Ref}[1] {Reference~\cite{#1}}
146     \newcommand {\Sec}[1] {Section~\ref{#1}}
147     \newcommand {\App}[1] {Appendix~\ref{#1}}
148     \newcommand {\Chap}[1] {Chapter~\ref{#1}}
149     \newcommand {\etal} {\emph{~et~al.}}
150     \newcommand {\fig}[1] {Figure~\ref{#1}}
151     \newcommand {\eqn}[1] {Equation~(\ref{#1})}
152     \newcommand {\tab}[1] {Table~\ref{#1}}
153    
154 jgs 102 % this stops one figure taking up a whole page and lets more text onto
155     % the one page when a figure exists
156     \renewcommand{\floatpagefraction}{0.8} % Default = 0.5
157    
158 jgs 82 % improved version of caption handling
159     \usepackage{ccaption}
160     \captionnamefont{\scshape}
161     \captionstyle{}
162     \makeatletter
163     \renewcommand{\fnum@figure}[1]{\quad\small\textsc{\figurename~\thefigure}:}
164     \renewcommand{\@makecaption}[2]{%
165     \vskip\abovecaptionskip
166     \sbox\@tempboxa{#1: #2}%
167     \ifdim \wd\@tempboxa >\hsize
168     \def\baselinestretch{1}\@normalsize
169     #1: #2\par
170     \def\baselinestretch{1.5}\@normalsize
171     \else
172     \global \@minipagefalse
173     \hb@xt@\hsize{\hfil\box\@tempboxa\hfil}%
174     \fi
175     \vskip\belowcaptionskip}
176     \makeatother
177    
178 gross 572 % \usepackage{fancyvrb} % fancy verbatim stuff. Needed so code below goes
179 jgs 82 %%% this code grabbed from the PyScript docs
180     %%% pyscript.sourceforge.net
181    
182     % --------------------------------------------------------------
183     % Code format within \Verb
184     % --------------------------------------------------------------
185    
186 gross 572 % \definecolor{pycolor}{rgb}{0,0.4,0}
187 jgs 82
188 jgs 102 %% \DefineVerbatimEnvironment{python}{Verbatim}
189     %% {frame=leftline,framerule=.5mm,rulecolor=\color{pycolor},
190     %% formatcom=\color{pycolor}\small,fontshape=rm}
191 jgs 82
192     %\DefineShortVerb[formatcom=\color{dgreen}\small,fontshape=sl]{\|}
193    
194 gross 572 % \RecustomVerbatimCommand{\Verb}{Verb}{formatcom=\color{pycolor}\small,fontshape=rm}
195 jgs 82
196     %%% end of grabbed code
197    
198     % this is for when one uses pdflatex and therefore needs to load pdf
199     % figures into \includegraphics
200     \ifpdf
201     \DeclareGraphicsExtensions{.pdf} % this command defined in graphicx
202     \pdfcompresslevel=9 % 0: no compression, 9: highest compression
203     % or, set compress_level 9 in file pdftex.cfg
204     \else
205     \DeclareGraphicsExtensions{.eps}
206     \fi
207 jgs 102
208     % defines the colour for the background of code examples
209     \definecolor{LightGrey}{gray}{0.9}
210    
211     % add the listings package to pretty print the code output
212     \usepackage{listings}
213    
214     \lstdefinestyle{myC++}{%
215     %\lstset{%
216     language=C++,
217     showstringspaces=false,
218     basicstyle=\small\ttfamily,
219     commentstyle=\color[named]{BrickRed}\ttfamily,
220     keywordstyle=\color[named]{Purple}\ttfamily,
221     %identifierstyle=\color[named]{Blue}\ttfamily,
222     %functionstyle=\color[named]{Blue}\ttfamily,
223     %typestyle=\color[named]{ForestGreen}\ttfamily,
224     stringstyle=\color[named]{Tan}\ttfamily,%
225     morekeywords={,complex,}%
226     frame=none,%
227     backgroundcolor=\color{LightGrey}%
228     }
229    
230     \lstdefinestyle{myMatlab}{%
231     %\lstset{%
232     language=Matlab,
233     showstringspaces=false,
234     basicstyle=\small\ttfamily,
235     commentstyle=\color[named]{BrickRed}\ttfamily,
236     keywordstyle=\color[named]{Purple}\ttfamily,
237     %identifierstyle=\color[named]{Blue}\ttfamily,
238     %functionstyle=\color[named]{Blue}\ttfamily,
239     %typestyle=\color[named]{ForestGreen}\ttfamily,
240     stringstyle=\color[named]{Tan}\ttfamily,%
241     frame=none,%
242     backgroundcolor=\color{LightGrey}%
243     }
244    
245     \lstdefinestyle{myScilab}{%
246     %\lstset{%
247     language=Scilab,
248     showstringspaces=false,
249     basicstyle=\small\ttfamily,
250     commentstyle=\color[named]{BrickRed}\ttfamily,
251     keywordstyle=\color[named]{Purple}\ttfamily,
252     %identifierstyle=\color[named]{Blue}\ttfamily,
253     %functionstyle=\color[named]{Blue}\ttfamily,
254     %typestyle=\color[named]{ForestGreen}\ttfamily,
255     stringstyle=\color[named]{Tan}\ttfamily,%
256     frame=none,%
257     backgroundcolor=\color{LightGrey}%
258     }
259    
260     \lstdefinestyle{myShell}{%
261     %\lstset{%
262     language=ksh,
263     showstringspaces=false,
264     basicstyle=\small\ttfamily,
265     commentstyle=\color[named]{Black}\ttfamily,
266     keywordstyle=\color[named]{Black}\ttfamily,
267     %identifierstyle=\color[named]{Blue}\ttfamily,
268     %functionstyle=\color[named]{Blue}\ttfamily,
269     %typestyle=\color[named]{ForestGreen}\ttfamily,
270     stringstyle=\color[named]{Black}\ttfamily,%
271     frame=none,%
272     backgroundcolor=\color{LightGrey}%
273     }
274    
275     \lstdefinestyle{myPython}{%
276     %\lstset{%
277     language=python,
278     showstringspaces=false,
279     basicstyle=\small\ttfamily,
280     commentstyle=\color[named]{BrickRed}\ttfamily,
281     keywordstyle=\color[named]{Purple}\ttfamily,
282     %identifierstyle=\color[named]{Blue}\ttfamily,
283     %functionstyle=\color[named]{Blue}\ttfamily,
284     %typestyle=\color[named]{ForestGreen}\ttfamily,
285     stringstyle=\color[named]{Tan}\ttfamily,%
286     frame=none,%
287     %backgroundcolor=\color{LightGrey}%
288     }
289    
290     \lstdefinestyle{myhtml}{%
291     %\lstset{%
292     language=xml,
293     showstringspaces=false,
294     basicstyle=\small\ttfamily,
295     commentstyle=\color[named]{BrickRed}\ttfamily,
296     keywordstyle=\color[named]{Purple}\ttfamily,
297     %identifierstyle=\color[named]{Blue}\ttfamily,
298     %functionstyle=\color[named]{Blue}\ttfamily,
299     %typestyle=\color[named]{ForestGreen}\ttfamily,
300     stringstyle=\color[named]{Tan}\ttfamily,
301     morekeywords={,simulation,prop_dim,error_check,stochastic,%
302     globals,field,dimensions,lattice,domains,samples,vector,%
303     components,fourier_space,sequence,integrate,algorithm,%
304     interval,k_operators,constant,operator_names,vectors,%
305     output,filename,group,sampling,moments,benchmark,use_double,%
306     use_wisdom,use_prefs,binary_output,cycles,filter,post_propagation,%
307     default_value,argv,arg,iterations,cross_propagation,%
308     use_mpi,paths,seed,noises,author,description,name,type,%
309     }
310     frame=none,%
311     %framerule=2pt,%
312     backgroundcolor=\color{LightGrey}%
313     }
314    
315     % this implements producing nice code blocks
316     % it also saves time, typing and
317     % *should* reduce errors in the text by removing doubling up of code
318     \lstnewenvironment{xmdsCode}[1][]{\lstset{style=myhtml}\lstset{#1}}{}
319    
320     % this implements nicely formatted shell code
321     \lstnewenvironment{shellCode}[1][]{\lstset{style=myShell}\lstset{#1}}{}
322    
323     % this implements nicely formatted Perl code
324     \lstnewenvironment{perlCode}[1][]{\lstset{style=myPerl}\lstset{#1}}{}
325    
326     % this implements nicely formatted Python code
327     \lstnewenvironment{python}[1][]{\lstset{style=myPython}\lstset{#1}}{}
328    
329     % this implements nicely formatted C++ code
330     \lstnewenvironment{CCode}{\lstset{style=myC++}}{}
331    
332     % this implements nicely formatted matlab code
333     \lstnewenvironment{matlabCode}{\lstset{style=myMatlab}}{}
334    
335     % this implements nicely formatted scilab code
336     \lstnewenvironment{scilabCode}{\lstset{style=myScilab}}{}
337    

Properties

Name Value
svn:eol-style native
svn:keywords Author Date Id Revision

  ViewVC Help
Powered by ViewVC 1.1.26