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

Revision 2474 - (hide annotations)
Tue Jun 16 06:32:15 2009 UTC (10 years, 2 months ago) by gross
File MIME type: application/x-tex
File size: 3064 byte(s)
linearPDEs has is now using the SolverOptions class to talk to PASO

 1 jfenwick 2463 2 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% 3 % 4 % Copyright (c) 2009 by University of Queensland 5 % Earth Systems Science Computational Center (ESSCC) 6 7 % 8 % Primary Business: Queensland, Australia 9 % Licensed under the Open Software License version 3.0 10 11 % 12 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% 13 14 \section{Changes from previous releases} 15 \label{app:changes} 16 17 \subsection*{2.0 to 3.0} 18 gross 2474 \begin{itemize} 19 \item The major change here was replacing \module{numarray} with \numpy. 20 jfenwick 2463 For general instructions on converting scripts to use numpy see \url{http://www.stsci.edu/resources/software_hardware/numarray/numarray2numpy.pdf}. 21 The specific changes to \escript are: 22 \begin{itemize} 23 \item getValueOfDataPoint() which returned a \module{numarray}.array has been replaced by 24 getTupleForDataPoint() which returns a \PYTHON tuple containing 25 gross 2470 the components of the data point. In the case of matricies or higher ranked data, the tuples will be nested. Use 26 \numpy.array(data.getTupleForDataPoint()) if a \numpyNDA opbject is required. 27 jfenwick 2463 \item getValueOfGlobalDataPoint has similarly been replaced by getTupleForGlobalDataPoint(). 28 \item integrate(data) now returns a \numpyNDA instead of a \module{numarray}.array. 29 \end{itemize} 30 Any python methods which previously accepted \module{numarray} objects will accept \numpy objects instead. 31 32 gross 2474 \item 33 The way solver options are defined for \LinearPDE objects has been changed. There is now a \SolverOptions object attached to the \LinearPDE object which is handeling the options of solvers used to solve the PDE. The following changes apply: 34 \begin{itemize} 35 \item The \method{setTolerance} and \method{setAbsoluteTolerance} methods have been removed. Use now \method{getSolverOptions().setTolerance} 36 and \method{getSolverOptions().setAbsoluteTolerance} 37 38 \item The \method{setSolverPackage} and \method{setSolverMethod} methods have been removed. Use now \method{getSolverOptions().setPackage}, 39 \method{getSolverOptions().setSolverMethod} and 40 \method{getSolverOptions().setPreconditioner}. 41 42 \item The \method{setSolverPackage} and \method{setSolverMethod} methods have been removed. Use now \method{getSolverOptions().setPackage}, 43 \method{getSolverOptions().setSolverMethod} and 44 \method{getSolverOptions().setPreconditioner}. 45 46 \item The static class variables defining packages, solvers and preconditioners have been removed and are now accessed via the corresponding static class variables in \SolverOptions. For instance use \method{SolverOptions.PCG} instead of 47 \method{LinearPDE.PCG} to select the preconditioned conjugate gradient method. 48 49 \item The \method{getSolution} takes now no argument. Use the corresponding 50 methods of the \SolverOptions object returned by \method{getSolverOptions()} 51 to set values, e.g. use 52 \method{getSolverOptions().setVerbosityOn()} instead of argument \code{verbose=True} 53 and \method{getSolverOptions().setIterMax(1000)} instead of argument \code{iter_max=1000} 54 \end{itemize} 55 56 57 \end{itemize}