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

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

Parent Directory Parent Directory | Revision Log Revision Log


Revision 3390 - (show annotations)
Thu Dec 2 00:34:37 2010 UTC (8 years, 8 months ago) by jfenwick
File MIME type: application/x-tex
File size: 6694 byte(s)
RandomData added

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

  ViewVC Help
Powered by ViewVC 1.1.26