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

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

Parent Directory Parent Directory | Revision Log Revision Log


Revision 3382 - (hide annotations)
Thu Nov 25 00:43:18 2010 UTC (8 years, 8 months ago) by jfenwick
File MIME type: application/x-tex
File size: 6626 byte(s)
I've added better credits for dev team.
There is a new page just before the contents page with current dev team 
and a more detailed list in the user guide appendix.

Please check this and let me know if you think there are errors or 
omissions.

Also fixed a typo.
Removed reference to python style files we no longer use from the 
license file.


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

  ViewVC Help
Powered by ViewVC 1.1.26