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

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

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

trunk/esys2/doc/user/guide_defs.tex revision 82 by jgs, Tue Oct 26 06:53:54 2004 UTC trunk/doc/user/guide_defs.tex revision 1081 by jongui, Wed Apr 11 06:13:46 2007 UTC
# Line 1  Line 1 
1  % $Id$  % $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}  \usepackage{epsfig}
12  \usepackage{graphicx,color}  \usepackage{graphicx,color}
# Line 12  Line 20 
20    
21    
22  % define some handy commands for escript stuff  % define some handy commands for escript stuff
23  \newcommand{\ESyS}{\module{ESyS}\xspace}  \newcommand{\LINUX}{{\it Linux}\xspace}
24  \newcommand{\escript}{\module{escript}\xspace}  \newcommand{\netCDF}{{\it netCDF}\cite{NETCDF}\index{netCDF} \xspace}
25  \newcommand{\finley}{\module{finley}\xspace}  \newcommand{\escript}{\module{esys.escript}\xspace}
26  \newcommand{\linearPDE}{\class{linearPDE}\xspace}  \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}  \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{\PyvisiExampleDirectory}{/trunk/doc/examples/pyvisi/}
140    \newcommand{\thumbnailwidth}{50mm}
141    
142  % default width for figures  % default width for figures
143  \newcommand{\figwidth}{100mm}  \newcommand{\figwidth}{100mm}
   
144  % commands useful in cross-referencing  % commands useful in cross-referencing
145  \newcommand {\Ref}[1] {Reference~\cite{#1}}  \newcommand {\Ref}[1] {Reference~\cite{#1}}
146  \newcommand {\Sec}[1] {Section~\ref{#1}}  \newcommand {\Sec}[1] {Section~\ref{#1}}
# Line 31  Line 151 
151  \newcommand {\eqn}[1] {Equation~(\ref{#1})}  \newcommand {\eqn}[1] {Equation~(\ref{#1})}
152  \newcommand {\tab}[1] {Table~\ref{#1}}  \newcommand {\tab}[1] {Table~\ref{#1}}
153    
154    % 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  % improved version of caption handling  % improved version of caption handling
159  \usepackage{ccaption}  \usepackage{ccaption}
160  \captionnamefont{\scshape}  \captionnamefont{\scshape}
# Line 51  Line 175 
175  \vskip\belowcaptionskip}  \vskip\belowcaptionskip}
176  \makeatother  \makeatother
177    
178  \usepackage{fancyvrb}  % fancy verbatim stuff.  Needed so code below goes  % \usepackage{fancyvrb}  % fancy verbatim stuff.  Needed so code below goes
179  %%% this code grabbed from the PyScript docs  %%% this code grabbed from the PyScript docs
180  %%% pyscript.sourceforge.net  %%% pyscript.sourceforge.net
181    
# Line 59  Line 183 
183  % Code format within \Verb  % Code format within \Verb
184  % --------------------------------------------------------------  % --------------------------------------------------------------
185    
186  \definecolor{pycolor}{rgb}{0,0.4,0}  % \definecolor{pycolor}{rgb}{0,0.4,0}
187    
188  \DefineVerbatimEnvironment{python}{Verbatim}  %% \DefineVerbatimEnvironment{python}{Verbatim}
189  {frame=leftline,framerule=.5mm,rulecolor=\color{pycolor},  %% {frame=leftline,framerule=.5mm,rulecolor=\color{pycolor},
190  formatcom=\color{pycolor}\small,fontshape=rm}  %% formatcom=\color{pycolor}\small,fontshape=rm}
191    
192  %\DefineShortVerb[formatcom=\color{dgreen}\small,fontshape=sl]{\|}  %\DefineShortVerb[formatcom=\color{dgreen}\small,fontshape=sl]{\|}
193    
194  \RecustomVerbatimCommand{\Verb}{Verb}{formatcom=\color{pycolor}\small,fontshape=rm}  % \RecustomVerbatimCommand{\Verb}{Verb}{formatcom=\color{pycolor}\small,fontshape=rm}
195    
196  %%% end of grabbed code  %%% end of grabbed code
197    
# Line 80  formatcom=\color{pycolor}\small,fontshap Line 204  formatcom=\color{pycolor}\small,fontshap
204  \else  \else
205      \DeclareGraphicsExtensions{.eps}      \DeclareGraphicsExtensions{.eps}
206  \fi  \fi
207    
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    

Legend:
Removed from v.82  
changed lines
  Added in v.1081

  ViewVC Help
Powered by ViewVC 1.1.26