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

Contents of /trunk/doc/user/changes.tex

Parent Directory Parent Directory | Revision Log Revision Log


Revision 3989 - (show annotations)
Tue Sep 25 02:21:54 2012 UTC (6 years, 10 months ago) by jfenwick
File MIME type: application/x-tex
File size: 6897 byte(s)
More copyright fixes.
pyvisi traces removed.
Some install doco
1
2 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
3 % Copyright (c) 2003-2012 by University of Queensland
4 % http://www.uq.edu.au
5 %
6 % Primary Business: Queensland, Australia
7 % Licensed under the Open Software License version 3.0
8 % http://www.opensource.org/licenses/osl-3.0.php
9 %
10 % Development until 2012 by Earth Systems Science Computational Center (ESSCC)
11 % Development since 2012 by School of Earth Sciences
12 %
13 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
14
15 \chapter{Changes from previous releases}
16 \label{app:changes}
17
18 \subsection*{3.2.1 to 3.3}
19 \begin{itemize}
20 \item Experimental support for \pythonthree.
21 \item Parameter order for the table interpolation methods has changed to be consistant.
22 Please test your scripts if you use these functions.
23 \item setX on \finley and \dudley domains will now only accept coordinates from ContinuousFunction spaces.
24 This is to avoid some potentially nasty behaviour when use periodic boundary conditions.
25 You can still use setX, just make sure that you interpolate first.
26 \end{itemize}
27
28
29 \subsection*{3.1 to 3.2}
30 \begin{itemize}
31 \item The deprecated name for the launcher has been removed. To run scripts use
32 \emph{run-escript} not \emph{escript}.
33 \item \escript is no longer automatically imported by importing \finley.
34 You will need to import escript explicitly. (All of our example scripts do this anyway.)
35 \item An experimental version of the new Dudley domain is now available.
36 \item Various bug fixes and optimisations.
37 \item New algorithms for gmsh support.
38 \item Improvements to the AMG solver. AMG is the recommended solver for symmetric problems.
39 \item Fixed compilation issues using netcdf.
40 \item Redesigned configuration files to make it easier to compile from source
41 without finding the locations of all your libraries.
42 \item Faster rendering of documentation.
43 \item Documentation is now hyperlinked.
44 \item New data export module \weipa. The \texttt{saveVTK} functionality has
45 been moved into this module, and while calling \texttt{saveVTK} from the
46 \escript module still works it is discouraged and will be removed in a
47 future release.
48 \item New \texttt{esys.escript.DataManager} class for convenient checkpointing
49 and exporting of escript data.
50 \item \VisIt simulation interface for online data access and visualization.
51 \item Simpler interpolation and support for interpolation from 3D vectors.
52 \item HRZ lumping has been added and some claification on how to use it.
53 \item Data objects populated with ``random'' values can be created.
54 \end{itemize}
55
56 \subsection*{3.0 to 3.1}
57 \begin{itemize}
58 \item The \emph{escript} launcher has been renamed to \emph{run-escript}. The
59 old name will still work in this version but will be removed in the future.
60 \item Lazy evaluation features have been improved and documented (see \Sec{sec:lazy}).
61 \item The \emph{escript} documentation now includes a new Cookbook which
62 demonstrates how to solve sample problems using escript.
63 \item Macro elements have been introduced.
64 \item The \var{saveDataCSV} method allows one or more \Data objects to be
65 exported in CSV format (see \Sec{sec:savedatacsv}).
66 \item \Data objects can be populated by interpolating from values in a table.
67 \item The new \var{getInfLocator} and \var{getSupLocator} functions in
68 \pdetools return Locators to a minimal/maximal point over the
69 data.
70 \item There is a new class to model fault systems (\var{esys.escript.faultsystems.FaultSystem}).
71 \item A beta version of an Algebraic Multigrid (AMG) solver is included.
72 \item Inverting square matrices larger than 3x3 is now permitted if escript is
73 compiled with Lapack support.
74 \item If escript is compiled with a modern compiler, then inf/sup/Lsup will now
75 report NaN, +/-inf as appropriate if those values appear in the data.
76 \item Data.setTags will take tag names as well as tag numbers.
77 \item The Scalar, Vector, Tensor, Tensor3, Tensor4 factory methods can now take
78 arrays/nested sequence like objects as their initial values.
79 \item escript.util.mkDir can now take a list of directories to create.
80 \item Behind the scenes, \PYTHON docstrings have been rewritten from epydoc to
81 restructured text.
82 \item Various other bug fixes and performance tweaks.
83 \end{itemize}
84
85 \subsection*{2.0 to 3.0}
86 \begin{itemize}
87 \item The major change here was replacing \module{numarray} with \numpy.
88 For general instructions on converting scripts to use numpy see \url{http://www.stsci.edu/resources/software_hardware/numarray/numarray2numpy.pdf}.
89 The specific changes to \escript are:
90 \begin{itemize}
91 \item getValueOfDataPoint() which returned a \module{numarray}.array has been
92 replaced by getTupleForDataPoint() which returns a \PYTHON tuple
93 containing the components of the data point. In the case of matrices or
94 higher ranked data, the tuples will be nested.
95 Use \numpy.array(data.getTupleForDataPoint()) if a \numpyNDA object is
96 required.
97 \item getValueOfGlobalDataPoint() has similarly been replaced by
98 getTupleForGlobalDataPoint().
99 \item \code{integrate(data)} now returns a \numpyNDA instead of a
100 \module{numarray}.array.
101 \end{itemize}
102 Any python methods which previously accepted \module{numarray} objects now
103 accept \numpy objects instead.
104
105 \item The way to define solver options for \LinearPDE objects has changed.
106 There is now a \SolverOptions object attached to the \LinearPDE
107 object which handles the options of solvers used to solve the PDE.
108 The following changes apply:
109 \begin{itemize}
110 \item The \method{setTolerance} and \method{setAbsoluteTolerance} methods
111 have been removed. Instead use \method{setTolerance} and
112 \method{setAbsoluteTolerance} on the \SolverOptions object. For example:
113 \method{getSolverOptions().setTolerance(\ldots)}
114 \item The \method{setSolverPackage} and \method{setSolverMethod} methods have
115 been removed. Instead use the methods \method{setPackage},
116 \method{setSolverMethod} and \method{setPreconditioner}. For example:
117 getSolverOptions().setPackage(\ldots).
118 \item The static class variables defining packages, solvers and
119 preconditioners have been removed and are now accessed via the
120 corresponding static class variables in \SolverOptions.
121 For instance use \method{SolverOptions.PCG} instead of
122 \method{LinearPDE.PCG} to select the preconditioned conjugate gradient
123 method.
124 \item The \method{getSolution} now takes no argument. Use the corresponding
125 methods of the \SolverOptions object returned by
126 \method{getSolverOptions()} to set values,\\ e.g. use
127 \method{getSolverOptions().setVerbosityOn()} instead of argument
128 \code{verbose=True} and \method{getSolverOptions().setIterMax(1000)}
129 instead of argument \code{iter_max=1000}.
130 \end{itemize}
131 \end{itemize}
132

  ViewVC Help
Powered by ViewVC 1.1.26