/[escript]/trunk/escript/src/escriptcpp.cpp
ViewVC logotype

Contents of /trunk/escript/src/escriptcpp.cpp

Parent Directory Parent Directory | Revision Log Revision Log


Revision 571 - (show annotations)
Tue Feb 28 06:53:17 2006 UTC (13 years, 7 months ago) by jgs
File size: 11041 byte(s)
modify whereZero etc methods to also accept a tolerance parameter
1 //$Id$
2 /*=============================================================================
3
4 ******************************************************************************
5 * *
6 * COPYRIGHT ACcESS 2004 - All Rights Reserved *
7 * *
8 * This software is the property of ACcESS. No part of this code *
9 * may be copied in any form or by any means without the expressed written *
10 * consent of ACcESS. Copying, use or modification of this software *
11 * by any unauthorised person is illegal unless that *
12 * person has a software license agreement with ACcESS. *
13 * *
14 ******************************************************************************
15
16 ******************************************************************************/
17
18 #include "Data.h"
19 #include "DataVariable.h"
20 #include "FunctionSpace.h"
21 #include "FunctionSpaceFactory.h"
22 #include "DataFactory.h"
23 #include "AbstractContinuousDomain.h"
24 #include "AbstractDomain.h"
25 #include "Utils.h"
26 #include "AbstractSystemMatrix.h"
27
28 #include "esysExceptionTranslator.h"
29
30 #include <boost/python.hpp>
31 #include <boost/python/module.hpp>
32 #include <boost/python/def.hpp>
33 #include <boost/python/object.hpp>
34 #include <boost/python/tuple.hpp>
35 #include <boost/python/numeric.hpp>
36
37 using namespace boost::python;
38
39 /*! \mainpage Esys Documentation
40 *
41 * \version 1.0.0
42 *
43 * - \ref escript
44 *
45 * - \ref esys_exception "Esys Exception"
46 *
47 * - \ref finley
48 *
49 * - <a href=http://iservo.edu.au/esys/epydoc/index.html>Python module documentation (epydoc generated)</a>
50 *
51 */
52
53 /*! \page escript Escript
54 * Escript is the python module that contains the interfaces
55 * to the C++ side of escript.
56 *
57 * \version 1.0.0
58 *
59 * \section class_desc Class Description:
60 * Data
61 *
62 * \section class_limits Class Limitations:
63 * None
64 *
65 * \section class_conds Class Conditions of Use:
66 * None
67 *
68 * \section class_throws Throws:
69 * None
70 *
71 */
72
73 BOOST_PYTHON_MODULE(escriptcpp)
74 {
75 def("setNumberOfThreads",escript::setNumberOfThreads);
76 def("getNumberOfThreads",escript::getNumberOfThreads);
77
78 //
79 // Interface for AbstractDomain
80 //
81 class_<escript::AbstractDomain>("Domain",no_init)
82 .def("getX",&escript::AbstractDomain::getX)
83 .def("getNormal",&escript::AbstractDomain::getNormal)
84 .def("getSize",&escript::AbstractDomain::getSize)
85 .def("saveVTK",&escript::AbstractDomain::saveVTK)
86 .def("saveDX",&escript::AbstractDomain::saveDX)
87 .def(self == self)
88 .def(self != self);
89
90 //
91 // Interface for AbstractContinuousDomain
92 //
93 class_<escript::AbstractContinuousDomain, bases<escript::AbstractDomain> >("ContinuousDomain",no_init)
94 .def("getSystemMatrixTypeId",&escript::AbstractContinuousDomain::getSystemMatrixTypeId);
95
96 //
97 // Interface for FunctionSpace
98 //
99 class_<escript::FunctionSpace>("FunctionSpace",init<>())
100 .def("getDim",&escript::FunctionSpace::getDim)
101 .def("getDomain",&escript::FunctionSpace::getDomain,return_internal_reference<>())
102 .def("getX",&escript::FunctionSpace::getX)
103 .def("getNormal",&escript::FunctionSpace::getNormal)
104 .def("getSize",&escript::FunctionSpace::getSize)
105 .def("getTagFromDataPointNo",&escript::FunctionSpace::getTagFromDataPointNo)
106 .def("__str__",&escript::FunctionSpace::toString)
107 .def(self == self)
108 .def(self != self);
109
110 //
111 // Interface for DataVariable
112 //
113 class_<escript::DataVariable>("DataVariable",init<>())
114 .def(init<escript::Data*>())
115 .def("evaluate",&escript::DataVariable::evaluate)
116 .def("sum",&escript::DataVariable::sum)
117 .def("diff",&escript::DataVariable::diff);
118
119 //
120 // Interface for Data
121 //
122 class_<escript::Data>("Data","TEST DOCUMENTATION",init<>())
123 // various constructors for Data objects
124 .def(init<const numeric::array&, optional<const escript::FunctionSpace&, bool> >(args("value","what","expand")))
125 .def(init<const object&, optional<const escript::FunctionSpace&, bool> >(args("value","what","expand")))
126 .def(init<const double, const tuple&, optional<const escript::FunctionSpace&, bool> >(args("value","shape","what","expand")))
127 .def(init<const escript::Data&, const escript::FunctionSpace&>(args("value","what")))
128 .def(init<const escript::Data&>())
129 // Note for Lutz, Need to specify the call policy in order to return a
130 // reference. In this case return_internal_reference.
131 .def("__str__",&escript::Data::toString)
132 .def("getDomain",&escript::Data::getDomain,return_internal_reference<>())
133 .def("getFunctionSpace",&escript::Data::getFunctionSpace,return_internal_reference<>())
134 .def("isEmpty",&escript::Data::isEmpty)
135 .def("getShape",&escript::Data::getShapeTuple)
136 .def("getRank",&escript::Data::getDataPointRank)
137 .def("copyWithMask",&escript::Data::copyWithMask)
138 .def("setTaggedValue",&escript::Data::setTaggedValue)
139 .def("setRefValue",&escript::Data::setRefValue)
140 .def("getRefValue",&escript::Data::getRefValue)
141 .def("expand",&escript::Data::expand)
142 .def("tag",&escript::Data::tag)
143 .def("copy",&escript::Data::copy)
144 .def("convertToNumArray",&escript::Data::convertToNumArray)
145 .def("convertToNumArrayFromSampleNo",&escript::Data::convertToNumArrayFromSampleNo)
146 .def("convertToNumArrayFromDPNo",&escript::Data::convertToNumArrayFromDPNo)
147 .def("fillFromNumArray",&escript::Data::fillFromNumArray)
148 .def("interpolate",&escript::Data::interpolate)
149 .def("mindp",&escript::Data::mindp)
150 .def("saveDX",&escript::Data::saveDX)
151 .def("saveVTK",&escript::Data::saveVTK)
152 .def("getTagNumber",&escript::Data::getTagNumber)
153 .def("archiveData",&escript::Data::archiveData)
154 .def("extractData",&escript::Data::extractData)
155 // Unary functions for Data
156 .def("_interpolate",&escript::Data::interpolate)
157 .def("_grad",&escript::Data::gradOn)
158 .def("_grad",&escript::Data::grad)
159 .def("_transpose",&escript::Data::transpose)
160 .def("_trace",&escript::Data::trace)
161 .def("_maxval",&escript::Data::maxval)
162 .def("_minval",&escript::Data::minval)
163 .def("_wherePositive",&escript::Data::wherePositive,(arg("tol")=0.0))
164 .def("_whereNegative",&escript::Data::whereNegative,(arg("tol")=0.0))
165 .def("_whereNonNegative",&escript::Data::whereNonNegative,(arg("tol")=0.0))
166 .def("_whereNonPositive",&escript::Data::whereNonPositive,(arg("tol")=0.0))
167 .def("_whereZero",&escript::Data::whereZero,(arg("tol")=0.0))
168 .def("_whereNonZero",&escript::Data::whereNonZero,(arg("tol")=0.0))
169 .def("_sin",&escript::Data::sin)
170 .def("_cos",&escript::Data::cos)
171 .def("_tan",&escript::Data::tan)
172 .def("_asin",&escript::Data::asin)
173 .def("_acos",&escript::Data::acos)
174 .def("_atan",&escript::Data::atan)
175 .def("_sinh",&escript::Data::sinh)
176 .def("_cosh",&escript::Data::cosh)
177 .def("_tanh",&escript::Data::tanh)
178 .def("_asinh",&escript::Data::asinh)
179 .def("_acosh",&escript::Data::acosh)
180 .def("_atanh",&escript::Data::atanh)
181 .def("_exp",&escript::Data::exp)
182 .def("_sqrt",&escript::Data::sqrt)
183 .def("_log10",&escript::Data::log10)
184 .def("_log",&escript::Data::log)
185 .def("_sign",&escript::Data::sign)
186 // functions returning a single real number:
187 .def("_Lsup",&escript::Data::Lsup)
188 .def("_sup",&escript::Data::sup)
189 .def("_inf",&escript::Data::inf)
190 .def("_integrate",&escript::Data::integrate)
191
192 // following implements the python abs operator
193 .def("__abs__",&escript::Data::abs)
194 // following implements the python "-" negation operator
195 .def("__neg__",&escript::Data::neg)
196 // following implements the python "+" identity operator
197 .def("__pos__",&escript::Data::pos)
198 // following two functions implement the python [] operator
199 .def("__getitem__",&escript::Data::getItem)
200 .def("__setitem__",&escript::Data::setItemO)
201 .def("__setitem__",&escript::Data::setItemD)
202 // following two functions implement the python ** operator
203 .def("__pow__",&escript::Data::powO)
204 .def("__pow__",&escript::Data::powD)
205 // NOTE:: The order of these declarations is important. Anything
206 // declared before the generic declaration isn't found so the generic
207 // version will be called.
208 .def(self + other<object>())
209 .def(other<object>() + self)
210 .def(self + self)
211 .def(self += other<object>())
212 .def(self += self)
213
214 .def(self - other<object>())
215 .def(other<object>() - self)
216 .def(self - self)
217 .def(self -= other<object>())
218 .def(self -= self)
219
220 .def(self * other<object>())
221 .def(other<object>() * self)
222 .def(self * self)
223 .def(self *= other<object>())
224 .def(self *= self)
225
226 .def(self / other<object>())
227 .def(other<object>() / self)
228 .def(self / self)
229 .def(self /= other<object>())
230 .def(self /= self)
231 // Need scope resolution due to a bug either in the compiler or
232 // the boost code. This calls operator << for Data.
233 .def(self_ns::str(self));
234
235 //
236 // Factory methods for function space
237 //
238 def("ContinuousFunction",escript::continuousFunction);
239 def("Function",escript::function);
240 def("FunctionOnBoundary",escript::functionOnBoundary);
241 def("FunctionOnContactZero",escript::functionOnContactZero);
242 def("FunctionOnContactOne",escript::functionOnContactOne);
243 def("Solution",escript::solution);
244 def("ReducedSolution",escript::reducedSolution);
245 def("DiracDeltaFunction",escript::diracDeltaFunction);
246
247 //
248 // Factory methods for Data
249 //
250 def("Scalar",escript::Scalar,
251 (arg("value")=0.0,
252 arg("what")=escript::FunctionSpace(),
253 arg("expanded")=false));
254 def("Vector",escript::Vector,
255 (arg("value")=0.0,
256 arg("what")=escript::FunctionSpace(),
257 arg("expanded")=false));
258 def("Tensor",escript::Tensor,
259 (arg("value")=0.0,
260 arg("what")=escript::FunctionSpace(),
261 arg("expanded")=false));
262 def("Tensor3",escript::Tensor3,
263 (arg("value")=0.0,
264 arg("what")=escript::FunctionSpace(),
265 arg("expanded")=false));
266 def("Tensor4",escript::Tensor4,
267 (arg("value")=0.0,
268 arg("what")=escript::FunctionSpace(),
269 arg("expanded")=false));
270
271 //
272 // Interface for AbstractSystemMatrix
273 //
274 class_<escript::AbstractSystemMatrix>("Operator",init<>())
275 .def("isEmpty",&escript::AbstractSystemMatrix::isEmpty)
276 .def("solve",&escript::AbstractSystemMatrix::solve)
277 .def("of",&escript::AbstractSystemMatrix::vectorMultiply)
278 .def("saveMM",&escript::AbstractSystemMatrix::saveMM)
279 .def("saveHB",&escript::AbstractSystemMatrix::saveHB)
280 .def("resetValues",&escript::AbstractSystemMatrix::resetValues)
281 .def(self*other<escript::Data>());
282
283 //
284 // Register esysExceptionTranslator
285 //
286 register_exception_translator<esysUtils::EsysException>(&esysUtils::esysExceptionTranslator);
287
288 }

Properties

Name Value
svn:eol-style native
svn:keywords Author Date Id Revision

  ViewVC Help
Powered by ViewVC 1.1.26