/[escript]/trunk/escript/src/Data.h
ViewVC logotype

Diff of /trunk/escript/src/Data.h

Parent Directory Parent Directory | Revision Log Revision Log | View Patch Patch

trunk/esys2/escript/src/Data/Data.h revision 97 by jgs, Tue Dec 14 05:39:33 2004 UTC trunk/escript/src/Data.h revision 2644 by jfenwick, Wed Sep 2 04:14:03 2009 UTC
# Line 1  Line 1 
 // $Id$  
 /*=============================================================================  
1    
2   ******************************************************************************  /*******************************************************
3   *                                                                            *  *
4   *       COPYRIGHT ACcESS 2004 -  All Rights Reserved                         *  * Copyright (c) 2003-2009 by University of Queensland
5   *                                                                            *  * Earth Systems Science Computational Center (ESSCC)
6   * This software is the property of ACcESS.  No part of this code             *  * http://www.uq.edu.au/esscc
7   * may be copied in any form or by any means without the expressed written    *  *
8   * consent of ACcESS.  Copying, use or modification of this software          *  * Primary Business: Queensland, Australia
9   * by any unauthorised person is illegal unless that                          *  * Licensed under the Open Software License version 3.0
10   * person has a software license agreement with ACcESS.                       *  * http://www.opensource.org/licenses/osl-3.0.php
11   *                                                                            *  *
12   ******************************************************************************  *******************************************************/
13    
14  ******************************************************************************/  
15    /** \file Data.h */
16    
17  #ifndef DATA_H  #ifndef DATA_H
18  #define DATA_H  #define DATA_H
19    #include "system_dep.h"
20    
21    #include "DataTypes.h"
22    #include "DataAbstract.h"
23    #include "DataAlgorithm.h"
24    #include "FunctionSpace.h"
25    #include "BinaryOp.h"
26    #include "UnaryOp.h"
27    #include "DataException.h"
28    
 #include "escript/Data/DataAbstract.h"  
 #include "escript/Data/DataTagged.h"  
 #include "escript/Data/FunctionSpace.h"  
 #include "escript/Data/BinaryOp.h"  
 #include "escript/Data/UnaryOp.h"  
29    
30  extern "C" {  extern "C" {
31  #include "escript/Data/DataC.h"  #include "DataC.h"
32    //#include <omp.h>
33  }  }
34    
35  #include <iostream>  #include "esysmpi.h"
36  #include <string>  #include <string>
 #include <memory>  
37  #include <algorithm>  #include <algorithm>
38    #include <sstream>
39    
40  #include <boost/shared_ptr.hpp>  #include <boost/shared_ptr.hpp>
41  #include <boost/python/object.hpp>  #include <boost/python/object.hpp>
 #include <boost/python/list.hpp>  
42  #include <boost/python/tuple.hpp>  #include <boost/python/tuple.hpp>
 #include <boost/python/numeric.hpp>  
43    
44  /**  #include "BufferGroup.h"
    \brief  
    Data is essentially a factory class which creates the appropriate Data  
    object for the given construction arguments. It retains control over  
    the object created for the lifetime of the object.  
    The type of Data object referred to may change during the lifetime of  
    the Data object.  
   
    Description:  
    Data is essentially a factory class which creates the appropriate Data  
    object for the given construction arguments. It retains control over  
    the object created for the lifetime of the object.  
    The type of Data object referred to may change during the lifetime of  
    the Data object.  
 */  
45    
46  namespace escript {  namespace escript {
47    
48  //  //
49  // Forward declaration for various implimentations of Data.  // Forward declaration for various implementations of Data.
 class DataEmpty;  
50  class DataConstant;  class DataConstant;
51  class DataTagged;  class DataTagged;
52  class DataExpanded;  class DataExpanded;
53    class DataLazy;
54    
55    /**
56       \brief
57       Data represents a collection of datapoints.
58    
59       Description:
60       Internally, the datapoints are actually stored by a DataAbstract object.
61       The specific instance of DataAbstract used may vary over the lifetime
62       of the Data object.
63       Some methods on this class return references (eg getShape()).
64       These references should not be used after an operation which changes the underlying DataAbstract object.
65       Doing so will lead to invalid memory access.
66       This should not affect any methods exposed via boost::python.
67    */
68  class Data {  class Data {
69    
70    public:    public:
71    
72      // These typedefs allow function names to be cast to pointers
73      // to functions of the appropriate type when calling unaryOp etc.
74    typedef double (*UnaryDFunPtr)(double);    typedef double (*UnaryDFunPtr)(double);
75    typedef double (*BinaryDFunPtr)(double,double);    typedef double (*BinaryDFunPtr)(double,double);
76    
77    
78    /**    /**
79       Constructors.       Constructors.
80    */    */
# Line 80  class Data { Line 84  class Data {
84       Default constructor.       Default constructor.
85       Creates a DataEmpty object.       Creates a DataEmpty object.
86    */    */
87      ESCRIPT_DLL_API
88    Data();    Data();
89    
90    /**    /**
# Line 87  class Data { Line 92  class Data {
92       Copy constructor.       Copy constructor.
93       WARNING: Only performs a shallow copy.       WARNING: Only performs a shallow copy.
94    */    */
95      ESCRIPT_DLL_API
96    Data(const Data& inData);    Data(const Data& inData);
97    
98    /**    /**
# Line 95  class Data { Line 101  class Data {
101       function space of inData the inData are tried to be interpolated to what,       function space of inData the inData are tried to be interpolated to what,
102       otherwise a shallow copy of inData is returned.       otherwise a shallow copy of inData is returned.
103    */    */
104      ESCRIPT_DLL_API
105    Data(const Data& inData,    Data(const Data& inData,
106         const FunctionSpace& what);         const FunctionSpace& what);
107    
108    /**    /**
109       \brief      \brief Copy Data from an existing vector
110       Constructor which copies data from a DataArrayView.    */
111    
112       \param value - Input - Data value for a single point.    ESCRIPT_DLL_API
113       \param what - Input - A description of what this data represents.    Data(const DataTypes::ValueType& value,
114       \param expanded - Input - Flag, if true fill the entire container with           const DataTypes::ShapeType& shape,
115                         the value. Otherwise a more efficient storage                   const FunctionSpace& what=FunctionSpace(),
116                         mechanism will be used.                   bool expanded=false);
   */  
   Data(const DataArrayView& value,  
        const FunctionSpace& what=FunctionSpace(),  
        bool expanded=false);  
117    
118    /**    /**
119       \brief       \brief
120       Constructor which creates a Data from a DataArrayView shape.       Constructor which creates a Data with points having the specified shape.
121    
122       \param value - Input - Single value applied to all Data.       \param value - Input - Single value applied to all Data.
123       \param dataPointShape - Input - The shape of each data point.       \param dataPointShape - Input - The shape of each data point.
# Line 123  class Data { Line 126  class Data {
126                         the given value. Otherwise a more efficient storage                         the given value. Otherwise a more efficient storage
127                         mechanism will be used.                         mechanism will be used.
128    */    */
129      ESCRIPT_DLL_API
130    Data(double value,    Data(double value,
131         const DataArrayView::ShapeType& dataPointShape=DataArrayView::ShapeType(),         const DataTypes::ShapeType& dataPointShape=DataTypes::ShapeType(),
132         const FunctionSpace& what=FunctionSpace(),         const FunctionSpace& what=FunctionSpace(),
133         bool expanded=false);         bool expanded=false);
134    
# Line 135  class Data { Line 139  class Data {
139       \param inData - Input - Input Data object.       \param inData - Input - Input Data object.
140       \param region - Input - Region to copy.       \param region - Input - Region to copy.
141    */    */
142      ESCRIPT_DLL_API
143    Data(const Data& inData,    Data(const Data& inData,
144         const DataArrayView::RegionType& region);         const DataTypes::RegionType& region);
145    
146    /**    /**
147       \brief       \brief
148       Constructor which will create Tagged data if expanded is false.       Constructor which copies data from any object that can be treated like a python array/sequence.
      No attempt is made to ensure the tag keys match the tag keys  
      within the function space.  
   
      \param tagKeys - Input - List of tag values.  
      \param values - Input - List of values, one for each tag.  
      \param defaultValue - Input - A default value, used if tag doesn't exist.  
      \param what - Input - A description of what this data represents.  
      \param expanded - Input - Flag, if true fill the entire container with  
                        the appropriate values.  
   */  
   Data(const DataTagged::TagListType& tagKeys,  
        const DataTagged::ValueListType& values,  
        const DataArrayView& defaultValue,  
        const FunctionSpace& what=FunctionSpace(),  
        bool expanded=false);  
   
   /**  
      \brief  
      Constructor which copies data from a python numarray.  
   
      \param value - Input - Data value for a single point.  
      \param what - Input - A description of what this data represents.  
      \param expanded - Input - Flag, if true fill the entire container with  
                        the value. Otherwise a more efficient storage  
                        mechanism will be used.  
   */  
   Data(const boost::python::numeric::array& value,  
        const FunctionSpace& what=FunctionSpace(),  
        bool expanded=false);  
   
   /**  
      \brief  
      Constructor which copies data from any object that can be converted into  
      a python numarray.  
149    
150       \param value - Input - Input data.       \param value - Input - Input data.
151       \param what - Input - A description of what this data represents.       \param what - Input - A description of what this data represents.
# Line 182  class Data { Line 153  class Data {
153                         the value. Otherwise a more efficient storage                         the value. Otherwise a more efficient storage
154                         mechanism will be used.                         mechanism will be used.
155    */    */
156      ESCRIPT_DLL_API
157    Data(const boost::python::object& value,    Data(const boost::python::object& value,
158         const FunctionSpace& what=FunctionSpace(),         const FunctionSpace& what=FunctionSpace(),
159         bool expanded=false);         bool expanded=false);
# Line 189  class Data { Line 161  class Data {
161    /**    /**
162       \brief       \brief
163       Constructor which creates a DataConstant.       Constructor which creates a DataConstant.
164       Copies data from any object that can be converted       Copies data from any object that can be treated like a python array/sequence.
165       into a numarray. All other parameters are copied from other.       All other parameters are copied from other.
166    
167       \param value - Input - Input data.       \param value - Input - Input data.
168       \param other - Input - contains all other parameters.       \param other - Input - contains all other parameters.
169    */    */
170      ESCRIPT_DLL_API
171    Data(const boost::python::object& value,    Data(const boost::python::object& value,
172         const Data& other);         const Data& other);
173    
# Line 202  class Data { Line 175  class Data {
175       \brief       \brief
176       Constructor which creates a DataConstant of "shape" with constant value.       Constructor which creates a DataConstant of "shape" with constant value.
177    */    */
178    Data(double value,    ESCRIPT_DLL_API
179         const boost::python::tuple& shape=boost::python::make_tuple(),    Data(double value,
180           const boost::python::tuple& shape=boost::python::make_tuple(),
181         const FunctionSpace& what=FunctionSpace(),         const FunctionSpace& what=FunctionSpace(),
182         bool expanded=false);         bool expanded=false);
183    
184    
185    
186      /**
187        \brief Create a Data using an existing DataAbstract. Warning: The new object assumes ownership of the pointer!
188        Once you have passed the pointer, do not delete it.
189      */
190      ESCRIPT_DLL_API
191      explicit Data(DataAbstract* underlyingdata);
192    
193      /**
194        \brief Create a Data based on the supplied DataAbstract
195      */
196      ESCRIPT_DLL_API
197      explicit Data(DataAbstract_ptr underlyingdata);
198    
199    /**    /**
200       \brief       \brief
201       Perform a deep copy.       Destructor
202      */
203      ESCRIPT_DLL_API
204      ~Data();
205    
206      /**
207         \brief Make this object a deep copy of "other".
208    */    */
209      ESCRIPT_DLL_API
210    void    void
211    copy(const Data& other);    copy(const Data& other);
212    
213    /**    /**
214         \brief Return a pointer to a deep copy of this object.
215      */
216      ESCRIPT_DLL_API
217      Data
218      copySelf();
219    
220    
221      /**
222         \brief produce a delayed evaluation version of this Data.
223      */
224      ESCRIPT_DLL_API
225      Data
226      delay();
227    
228      /**
229         \brief convert the current data into lazy data.
230      */
231      ESCRIPT_DLL_API
232      void
233      delaySelf();
234    
235    
236      /**
237       Member access methods.       Member access methods.
238    */    */
239    
240    /**    /**
241       \brief       \brief
242         switches on update protection
243    
244      */
245      ESCRIPT_DLL_API
246      void
247      setProtection();
248    
249      /**
250         \brief
251         Returns true, if the data object is protected against update
252    
253      */
254      ESCRIPT_DLL_API
255      bool
256      isProtected() const;
257    
258    
259    /**
260       \brief
261       Return the value of a data point as a python tuple.
262    */
263      ESCRIPT_DLL_API
264      const boost::python::object
265      getValueOfDataPointAsTuple(int dataPointNo);
266    
267      /**
268         \brief
269         sets the values of a data-point from a python object on this process
270      */
271      ESCRIPT_DLL_API
272      void
273      setValueOfDataPointToPyObject(int dataPointNo, const boost::python::object& py_object);
274    
275      /**
276         \brief
277         sets the values of a data-point from a array-like object on this process
278      */
279      ESCRIPT_DLL_API
280      void
281      setValueOfDataPointToArray(int dataPointNo, const boost::python::object&);
282    
283      /**
284         \brief
285         sets the values of a data-point on this process
286      */
287      ESCRIPT_DLL_API
288      void
289      setValueOfDataPoint(int dataPointNo, const double);
290    
291      /**
292         \brief Return a data point across all processors as a python tuple.
293      */
294      ESCRIPT_DLL_API
295      const boost::python::object
296      getValueOfGlobalDataPointAsTuple(int procNo, int dataPointNo);
297    
298      /**
299         \brief
300         Return the tag number associated with the given data-point.
301    
302      */
303      ESCRIPT_DLL_API
304      int
305      getTagNumber(int dpno);
306    
307      /**
308         \brief
309       Return the C wrapper for the Data object.       Return the C wrapper for the Data object.
310    */    */
311      ESCRIPT_DLL_API
312    escriptDataC    escriptDataC
313    getDataC();    getDataC();
314    
315    
316    
317    /**    /**
318       \brief       \brief
319       Return the C wrapper for the Data object - const version.       Return the C wrapper for the Data object - const version.
320    */    */
321      ESCRIPT_DLL_API
322    escriptDataC    escriptDataC
323    getDataC() const;    getDataC() const;
324    
325    /**    /**
326       \brief      \brief How much space is required to evaulate a sample of the Data.
      Write the data as a string.  
327    */    */
328    inline    ESCRIPT_DLL_API
329    std::string    size_t
330    toString() const    getSampleBufferSize() const;
331    {  
332      return m_data->toString();  
   }  
333    
334    /**    /**
335       \brief       \brief
336       Return the DataArrayView of the point data. This essentially contains       Write the data as a string. For large amounts of data, a summary is printed.
      the shape information for each data point although it also may be used  
      to manipulate the point data.  
337    */    */
338    inline    ESCRIPT_DLL_API
339    const DataArrayView&    std::string
340    getPointDataView() const    toString() const;
   {  
      return m_data->getPointDataView();  
   }  
341    
342    /**    /**
343       \brief       \brief
344       Whatever the current Data type make this into a DataExpanded.       Whatever the current Data type make this into a DataExpanded.
345    */    */
346      ESCRIPT_DLL_API
347    void    void
348    expand();    expand();
349    
# Line 269  class Data { Line 353  class Data {
353       Constant data to be converted to tagged. An attempt to convert       Constant data to be converted to tagged. An attempt to convert
354       Expanded data to tagged will throw an exception.       Expanded data to tagged will throw an exception.
355    */    */
356      ESCRIPT_DLL_API
357    void    void
358    tag();    tag();
359    
360    /**    /**
361        \brief If this data is lazy, then convert it to ready data.
362        What type of ready data depends on the expression. For example, Constant+Tagged==Tagged.
363      */
364      ESCRIPT_DLL_API
365      void
366      resolve();
367    
368    
369      /**
370       \brief Ensures data is ready for write access.
371      This means that the data will be resolved if lazy and will be copied if shared with another Data object.
372      \warning This method should only be called in single threaded sections of code. (It modifies m_data).
373      Do not create any Data objects from this one between calling requireWrite and getSampleDataRW.
374      Doing so might introduce additional sharing.
375      */
376      ESCRIPT_DLL_API
377      void
378      requireWrite();
379    
380      /**
381       \brief       \brief
382       Return true if this Data is expanded.       Return true if this Data is expanded.
383         \note To determine if a sample will contain separate values for each datapoint. Use actsExpanded instead.
384    */    */
385      ESCRIPT_DLL_API
386    bool    bool
387    isExpanded() const;    isExpanded() const;
388    
389    /**    /**
390       \brief       \brief
391         Return true if this Data is expanded or resolves to expanded.
392         That is, if it has a separate value for each datapoint in the sample.
393      */
394      ESCRIPT_DLL_API
395      bool
396      actsExpanded() const;
397      
398    
399      /**
400         \brief
401       Return true if this Data is tagged.       Return true if this Data is tagged.
402    */    */
403      ESCRIPT_DLL_API
404    bool    bool
405    isTagged() const;    isTagged() const;
406    
# Line 290  class Data { Line 408  class Data {
408       \brief       \brief
409       Return true if this Data is constant.       Return true if this Data is constant.
410    */    */
411      ESCRIPT_DLL_API
412    bool    bool
413    isConstant() const;    isConstant() const;
414    
415    /**    /**
416         \brief Return true if this Data is lazy.
417      */
418      ESCRIPT_DLL_API
419      bool
420      isLazy() const;
421    
422      /**
423         \brief Return true if this data is ready.
424      */
425      ESCRIPT_DLL_API
426      bool
427      isReady() const;
428    
429      /**
430       \brief       \brief
431       Return true if this Data is empty.       Return true if this Data holds an instance of DataEmpty. This is _not_ the same as asking if the object
432    contains datapoints.
433    */    */
434      ESCRIPT_DLL_API
435    bool    bool
436    isEmpty() const;    isEmpty() const;
437    
# Line 304  class Data { Line 439  class Data {
439       \brief       \brief
440       Return the function space.       Return the function space.
441    */    */
442      ESCRIPT_DLL_API
443    inline    inline
444    const FunctionSpace&    const FunctionSpace&
445    getFunctionSpace() const    getFunctionSpace() const
# Line 315  class Data { Line 451  class Data {
451       \brief       \brief
452       Return a copy of the function space.       Return a copy of the function space.
453    */    */
454      ESCRIPT_DLL_API
455    const FunctionSpace    const FunctionSpace
456    getCopyOfFunctionSpace() const;    getCopyOfFunctionSpace() const;
457    
# Line 322  class Data { Line 459  class Data {
459       \brief       \brief
460       Return the domain.       Return the domain.
461    */    */
462      ESCRIPT_DLL_API
463    inline    inline
464    const AbstractDomain&  //   const AbstractDomain&
465      const_Domain_ptr
466    getDomain() const    getDomain() const
467    {    {
468       return getFunctionSpace().getDomain();       return getFunctionSpace().getDomain();
469    }    }
470    
471    
472      /**
473         \brief
474         Return the domain.
475         TODO: For internal use only.   This should be removed.
476      */
477      ESCRIPT_DLL_API
478      inline
479    //   const AbstractDomain&
480      Domain_ptr
481      getDomainPython() const
482      {
483         return getFunctionSpace().getDomainPython();
484      }
485    
486    /**    /**
487       \brief       \brief
488       Return a copy of the domain.       Return a copy of the domain.
489    */    */
490      ESCRIPT_DLL_API
491    const AbstractDomain    const AbstractDomain
492    getCopyOfDomain() const;    getCopyOfDomain() const;
493    
# Line 340  class Data { Line 495  class Data {
495       \brief       \brief
496       Return the rank of the point data.       Return the rank of the point data.
497    */    */
498      ESCRIPT_DLL_API
499    inline    inline
500    int    unsigned int
501    getDataPointRank() const    getDataPointRank() const
502    {    {
503      return m_data->getPointDataView().getRank();      return m_data->getRank();
504    }    }
505    
506    /**    /**
507       \brief       \brief
508         Return the number of data points
509      */
510      ESCRIPT_DLL_API
511      inline
512      int
513      getNumDataPoints() const
514      {
515        return getNumSamples() * getNumDataPointsPerSample();
516      }
517      /**
518         \brief
519       Return the number of samples.       Return the number of samples.
520    */    */
521      ESCRIPT_DLL_API
522    inline    inline
523    int    int
524    getNumSamples() const    getNumSamples() const
# Line 362  class Data { Line 530  class Data {
530       \brief       \brief
531       Return the number of data points per sample.       Return the number of data points per sample.
532    */    */
533      ESCRIPT_DLL_API
534    inline    inline
535    int    int
536    getNumDataPointsPerSample() const    getNumDataPointsPerSample() const
# Line 369  class Data { Line 538  class Data {
538      return m_data->getNumDPPSample();      return m_data->getNumDPPSample();
539    }    }
540    
541    
542      /**
543        \brief
544        Return the number of values in the shape for this object.
545      */
546      ESCRIPT_DLL_API
547      int
548      getNoValues() const
549      {
550        return m_data->getNoValues();
551      }
552    
553    
554      /**
555         \brief
556         dumps the object into a netCDF file
557      */
558      ESCRIPT_DLL_API
559      void
560      dump(const std::string fileName) const;
561    
562     /**
563      \brief returns the values of the object as a list of tuples (one for each datapoint).
564    
565      \param scalarastuple If true, scalar data will produce single valued tuples [(1,) (2,) ...]
566    If false, the result is a list of scalars [1, 2, ...]
567     */
568      ESCRIPT_DLL_API
569      const boost::python::object
570      toListOfTuples(bool scalarastuple=true);
571    
572    
573     /**
574        \brief
575        Return the sample data for the given sample no. This is not the
576        preferred interface but is provided for use by C code.
577        The bufferg parameter is only required for LazyData.
578        \param sampleNo - Input - the given sample no.
579        \param bufferg - A buffer to compute (and store) sample data in will be selected from this group.
580        \return pointer to the sample data.
581    */
582      ESCRIPT_DLL_API
583      inline
584      const DataAbstract::ValueType::value_type*
585      getSampleDataRO(DataAbstract::ValueType::size_type sampleNo, BufferGroup* bufferg=0);
586    
587    
588    /**    /**
589       \brief       \brief
590       Return the sample data for the given sample no. This is not the       Return the sample data for the given sample no. This is not the
591       preferred interface but is provided for use by C code.       preferred interface but is provided for use by C code.
592       \param sampleNo - Input - the given sample no.       \param sampleNo - Input - the given sample no.
593         \return pointer to the sample data.
594    */    */
595      ESCRIPT_DLL_API
596    inline    inline
597    DataAbstract::ValueType::value_type*    DataAbstract::ValueType::value_type*
598    getSampleData(DataAbstract::ValueType::size_type sampleNo)    getSampleDataRW(DataAbstract::ValueType::size_type sampleNo);
599    {  
     return m_data->getSampleData(sampleNo);  
   }  
600    
601    /**    /**
602       \brief       \brief
# Line 388  class Data { Line 604  class Data {
604       access data that isn't tagged an exception will be thrown.       access data that isn't tagged an exception will be thrown.
605       \param tag - Input - the tag key.       \param tag - Input - the tag key.
606    */    */
607      ESCRIPT_DLL_API
608    inline    inline
609    DataAbstract::ValueType::value_type*    DataAbstract::ValueType::value_type*
610    getSampleDataByTag(int tag)    getSampleDataByTag(int tag)
# Line 397  class Data { Line 614  class Data {
614    
615    /**    /**
616       \brief       \brief
617       Return a view into the data for the data point specified.       Return a reference into the DataVector which points to the specified data point.
618       NOTE: Construction of the DataArrayView is a relatively expensive       \param sampleNo - Input -
619       operation.       \param dataPointNo - Input -
620      */
621      ESCRIPT_DLL_API
622      DataTypes::ValueType::const_reference
623      getDataPointRO(int sampleNo, int dataPointNo);
624    
625      /**
626         \brief
627         Return a reference into the DataVector which points to the specified data point.
628       \param sampleNo - Input -       \param sampleNo - Input -
629       \param dataPointNo - Input -       \param dataPointNo - Input -
630    */    */
631      ESCRIPT_DLL_API
632      DataTypes::ValueType::reference
633      getDataPointRW(int sampleNo, int dataPointNo);
634    
635    
636    
637      /**
638         \brief
639         Return the offset for the given sample and point within the sample
640      */
641      ESCRIPT_DLL_API
642    inline    inline
643    DataArrayView    DataTypes::ValueType::size_type
644    getDataPoint(int sampleNo,    getDataOffset(int sampleNo,
645                 int dataPointNo)                 int dataPointNo)
646    {    {
647      return m_data->getDataPoint(sampleNo,dataPointNo);        return m_data->getPointOffset(sampleNo,dataPointNo);
648    }    }
649    
650    /**    /**
651       \brief       \brief
652       Return a reference to the data point shape.       Return a reference to the data point shape.
653    */    */
654    const DataArrayView::ShapeType&    ESCRIPT_DLL_API
655    getDataPointShape() const;    inline
656      const DataTypes::ShapeType&
657      getDataPointShape() const
658      {
659        return m_data->getShape();
660      }
661    
662    /**    /**
663       \brief       \brief
664       Return the data point shape as a tuple of integers.       Return the data point shape as a tuple of integers.
665    */    */
666    boost::python::tuple    ESCRIPT_DLL_API
667      const boost::python::tuple
668    getShapeTuple() const;    getShapeTuple() const;
669    
670    /**    /**
# Line 430  class Data { Line 672  class Data {
672       Return the size of the data point. It is the product of the       Return the size of the data point. It is the product of the
673       data point shape dimensions.       data point shape dimensions.
674    */    */
675      ESCRIPT_DLL_API
676    int    int
677    getDataPointSize() const;    getDataPointSize() const;
678    
# Line 437  class Data { Line 680  class Data {
680       \brief       \brief
681       Return the number of doubles stored for this Data.       Return the number of doubles stored for this Data.
682    */    */
683    DataArrayView::ValueType::size_type    ESCRIPT_DLL_API
684      DataTypes::ValueType::size_type
685    getLength() const;    getLength() const;
686    
687    
688    
689    /**    /**
690       \brief       \brief
691       Assign the given value to the tag. Implicitly converts this       Assign the given value to the tag assocciated with name. Implicitly converts this
692       object to type DataTagged. Throws an exception if this object       object to type DataTagged. Throws an exception if this object
693       cannot be converted to a DataTagged object.       cannot be converted to a DataTagged object or name cannot be mapped onto a tag key.
694         \param name - Input - name of tag.
695         \param value - Input - Value to associate with given key.
696      */
697      ESCRIPT_DLL_API
698      void
699      setTaggedValueByName(std::string name,
700                           const boost::python::object& value);
701    
702      /**
703         \brief
704         Assign the given value to the tag. Implicitly converts this
705         object to type DataTagged if it is constant.
706    
707       \param tagKey - Input - Integer key.       \param tagKey - Input - Integer key.
708       \param value - Input - Value to associate with given key.       \param value - Input - Value to associate with given key.
709        ==>*
710    */    */
711      ESCRIPT_DLL_API
712    void    void
713    setTaggedValue(int tagKey,    setTaggedValue(int tagKey,
714                   const boost::python::object& value);                   const boost::python::object& value);
# Line 455  class Data { Line 716  class Data {
716    /**    /**
717       \brief       \brief
718       Assign the given value to the tag. Implicitly converts this       Assign the given value to the tag. Implicitly converts this
719       object to type DataTagged. Throws an exception if this object       object to type DataTagged if it is constant.
720       cannot be converted to a DataTagged object.  
721       \param tagKey - Input - Integer key.       \param tagKey - Input - Integer key.
722         \param pointshape - Input - The shape of the value parameter
723       \param value - Input - Value to associate with given key.       \param value - Input - Value to associate with given key.
724       Note: removed for now - this version not needed, and breaks escript.cpp       \param dataOffset - Input - Offset of the begining of the point within the value parameter
725    */    */
726    /*    ESCRIPT_DLL_API
727    void    void
728    setTaggedValue(int tagKey,    setTaggedValueFromCPP(int tagKey,
729                   const DataArrayView& value);              const DataTypes::ShapeType& pointshape,
730    */                          const DataTypes::ValueType& value,
731                int dataOffset=0);
732    
733    
734    
735    /**    /**
736      \brief      \brief
737      Copy other Data object into this Data object where mask is positive.      Copy other Data object into this Data object where mask is positive.
738    */    */
739      ESCRIPT_DLL_API
740    void    void
741    copyWithMask(const Data& other,    copyWithMask(const Data& other,
742                 const Data& mask);                 const Data& mask);
# Line 481  class Data { Line 747  class Data {
747    
748    /**    /**
749       \brief       \brief
750         set all values to zero
751         *
752      */
753      ESCRIPT_DLL_API
754      void
755      setToZero();
756    
757      /**
758         \brief
759       Interpolates this onto the given functionspace and returns       Interpolates this onto the given functionspace and returns
760       the result as a Data object.       the result as a Data object.
761         *
762    */    */
763      ESCRIPT_DLL_API
764    Data    Data
765    interpolate(const FunctionSpace& functionspace) const;    interpolate(const FunctionSpace& functionspace) const;
766    
767    
768      ESCRIPT_DLL_API
769      Data
770      interpolateFromTable2D(const WrappedArray& table, double Amin, double Astep,
771                           double undef, Data& B, double Bmin, double Bstep);
772    
773    
774      // This signature needs to be tuned
775      ESCRIPT_DLL_API
776      Data
777      interpolateFromTable(boost::python::object table, double Amin, double Astep,
778                           double undef, Data& B, double Bmin, double Bstep);
779    
780    /**    /**
781       \brief       \brief
782       Calculates the gradient of the data at the data points of functionspace.       Calculates the gradient of the data at the data points of functionspace.
783       If functionspace is not present the function space of Function(getDomain()) is used.       If functionspace is not present the function space of Function(getDomain()) is used.
784         *
785    */    */
786      ESCRIPT_DLL_API
787    Data    Data
788    gradOn(const FunctionSpace& functionspace) const;    gradOn(const FunctionSpace& functionspace) const;
789    
790      ESCRIPT_DLL_API
791    Data    Data
792    grad() const;    grad() const;
793    
794    /**    /**
795       \brief      \brief
796       Calculate the integral over the function space domain.       Calculate the integral over the function space domain as a python tuple.
797    */    */
798    boost::python::numeric::array    ESCRIPT_DLL_API
799    integrate() const;    boost::python::object
800      integrateToTuple_const() const;
801    
802    
803    /**    /**
804        \brief
805         Calculate the integral over the function space domain as a python tuple.
806      */
807      ESCRIPT_DLL_API
808      boost::python::object
809      integrateToTuple();
810    
811    
812    
813      /**
814         \brief
815         Returns 1./ Data object
816         *
817      */
818      ESCRIPT_DLL_API
819      Data
820      oneOver() const;
821      /**
822       \brief       \brief
823       Return a Data with a 1 for +ive values and a 0 for 0 or -ive values.       Return a Data with a 1 for +ive values and a 0 for 0 or -ive values.
824         *
825    */    */
826      ESCRIPT_DLL_API
827    Data    Data
828    wherePositive() const;    wherePositive() const;
829    
830    /**    /**
831       \brief       \brief
832       Return a Data with a 1 for -ive values and a 0 for +ive or 0 values.       Return a Data with a 1 for -ive values and a 0 for +ive or 0 values.
833         *
834    */    */
835      ESCRIPT_DLL_API
836    Data    Data
837    whereNegative() const;    whereNegative() const;
838    
839    /**    /**
840       \brief       \brief
841       Return a Data with a 1 for +ive or 0 values and a 0 for -ive values.       Return a Data with a 1 for +ive or 0 values and a 0 for -ive values.
842         *
843    */    */
844      ESCRIPT_DLL_API
845    Data    Data
846    whereNonNegative() const;    whereNonNegative() const;
847    
848    /**    /**
849       \brief       \brief
850       Return a Data with a 1 for -ive or 0 values and a 0 for +ive values.       Return a Data with a 1 for -ive or 0 values and a 0 for +ive values.
851         *
852    */    */
853      ESCRIPT_DLL_API
854    Data    Data
855    whereNonPositive() const;    whereNonPositive() const;
856    
857    /**    /**
858       \brief       \brief
859       Return a Data with a 1 for 0 values and a 0 for +ive or -ive values.       Return a Data with a 1 for 0 values and a 0 for +ive or -ive values.
860         *
861    */    */
862      ESCRIPT_DLL_API
863    Data    Data
864    whereZero() const;    whereZero(double tol=0.0) const;
865    
866    /**    /**
867       \brief       \brief
868       Return a Data with a 0 for 0 values and a 1 for +ive or -ive values.       Return a Data with a 0 for 0 values and a 1 for +ive or -ive values.
869         *
870    */    */
871      ESCRIPT_DLL_API
872    Data    Data
873    whereNonZero() const;    whereNonZero(double tol=0.0) const;
874    
875      /**
876         \brief
877         Return the maximum absolute value of this Data object.
878    
879         The method is not const because lazy data needs to be expanded before Lsup can be computed.
880         The _const form can be used when the Data object is const, however this will only work for
881         Data which is not Lazy.
882    
883         For Data which contain no samples (or tagged Data for which no tags in use have a value)
884         zero is returned.
885      */
886      ESCRIPT_DLL_API
887      double
888      Lsup();
889    
890      ESCRIPT_DLL_API
891      double
892      Lsup_const() const;
893    
894    
895      /**
896         \brief
897         Return the maximum value of this Data object.
898    
899         The method is not const because lazy data needs to be expanded before sup can be computed.
900         The _const form can be used when the Data object is const, however this will only work for
901         Data which is not Lazy.
902    
903         For Data which contain no samples (or tagged Data for which no tags in use have a value)
904         a large negative value is returned.
905      */
906      ESCRIPT_DLL_API
907      double
908      sup();
909    
910      ESCRIPT_DLL_API
911      double
912      sup_const() const;
913    
914    
915      /**
916         \brief
917         Return the minimum value of this Data object.
918    
919         The method is not const because lazy data needs to be expanded before inf can be computed.
920         The _const form can be used when the Data object is const, however this will only work for
921         Data which is not Lazy.
922    
923         For Data which contain no samples (or tagged Data for which no tags in use have a value)
924         a large positive value is returned.
925      */
926      ESCRIPT_DLL_API
927      double
928      inf();
929    
930      ESCRIPT_DLL_API
931      double
932      inf_const() const;
933    
934    
935    
936      /**
937         \brief
938         Return the absolute value of each data point of this Data object.
939         *
940      */
941      ESCRIPT_DLL_API
942      Data
943      abs() const;
944    
945      /**
946         \brief
947         Return the maximum value of each data point of this Data object.
948         *
949      */
950      ESCRIPT_DLL_API
951      Data
952      maxval() const;
953    
954      /**
955         \brief
956         Return the minimum value of each data point of this Data object.
957         *
958      */
959      ESCRIPT_DLL_API
960      Data
961      minval() const;
962    
963      /**
964         \brief
965         Return the (sample number, data-point number) of the data point with
966         the minimum component value in this Data object.
967         \note If you are working in python, please consider using Locator
968    instead of manually manipulating process and point IDs.
969      */
970      ESCRIPT_DLL_API
971      const boost::python::tuple
972      minGlobalDataPoint() const;
973    
974      /**
975         \brief
976         Return the (sample number, data-point number) of the data point with
977         the minimum component value in this Data object.
978         \note If you are working in python, please consider using Locator
979    instead of manually manipulating process and point IDs.
980      */
981      ESCRIPT_DLL_API
982      const boost::python::tuple
983      maxGlobalDataPoint() const;
984    
985    
986    
987      /**
988         \brief
989         Return the sign of each data point of this Data object.
990         -1 for negative values, zero for zero values, 1 for positive values.
991         *
992      */
993      ESCRIPT_DLL_API
994      Data
995      sign() const;
996    
997      /**
998         \brief
999         Return the symmetric part of a matrix which is half the matrix plus its transpose.
1000         *
1001      */
1002      ESCRIPT_DLL_API
1003      Data
1004      symmetric() const;
1005    
1006      /**
1007         \brief
1008         Return the nonsymmetric part of a matrix which is half the matrix minus its transpose.
1009         *
1010      */
1011      ESCRIPT_DLL_API
1012      Data
1013      nonsymmetric() const;
1014    
1015      /**
1016         \brief
1017         Return the trace of a matrix
1018         *
1019      */
1020      ESCRIPT_DLL_API
1021      Data
1022      trace(int axis_offset) const;
1023    
1024      /**
1025         \brief
1026         Transpose each data point of this Data object around the given axis.
1027         *
1028      */
1029      ESCRIPT_DLL_API
1030      Data
1031      transpose(int axis_offset) const;
1032    
1033      /**
1034         \brief
1035         Return the eigenvalues of the symmetric part at each data point of this Data object in increasing values.
1036         Currently this function is restricted to rank 2, square shape, and dimension 3.
1037         *
1038      */
1039      ESCRIPT_DLL_API
1040      Data
1041      eigenvalues() const;
1042    
1043      /**
1044         \brief
1045         Return the eigenvalues and corresponding eigenvcetors of the symmetric part at each data point of this Data object.
1046         the eigenvalues are ordered in increasing size where eigenvalues with relative difference less than
1047         tol are treated as equal. The eigenvectors are orthogonal, normalized and the sclaed such that the
1048         first non-zero entry is positive.
1049         Currently this function is restricted to rank 2, square shape, and dimension 3
1050         *
1051      */
1052      ESCRIPT_DLL_API
1053      const boost::python::tuple
1054      eigenvalues_and_eigenvectors(const double tol=1.e-12) const;
1055    
1056      /**
1057         \brief
1058         swaps the components axis0 and axis1
1059         *
1060      */
1061      ESCRIPT_DLL_API
1062      Data
1063      swapaxes(const int axis0, const int axis1) const;
1064    
1065      /**
1066         \brief
1067         Return the error function erf of each data point of this Data object.
1068         *
1069      */
1070      ESCRIPT_DLL_API
1071      Data
1072      erf() const;
1073    
1074    /**    /**
1075       \brief       \brief
1076       Return the sin of each data point of this Data object.       Return the sin of each data point of this Data object.
1077         *
1078    */    */
1079      ESCRIPT_DLL_API
1080    Data    Data
1081    sin() const;    sin() const;
1082    
1083    /**    /**
1084       \brief       \brief
1085       Return the cos of each data point of this Data object.       Return the cos of each data point of this Data object.
1086         *
1087    */    */
1088      ESCRIPT_DLL_API
1089    Data    Data
1090    cos() const;    cos() const;
1091    
1092    /**    /**
1093       \brief       \brief
1094       Return the tan of each data point of this Data object.       Return the tan of each data point of this Data object.
1095         *
1096    */    */
1097      ESCRIPT_DLL_API
1098    Data    Data
1099    tan() const;    tan() const;
1100    
1101    /**    /**
1102       \brief       \brief
1103       Return the log to base 10 of each data point of this Data object.       Return the asin of each data point of this Data object.
1104         *
1105    */    */
1106      ESCRIPT_DLL_API
1107    Data    Data
1108    log() const;    asin() const;
1109    
1110    /**    /**
1111       \brief       \brief
1112       Return the natural log of each data point of this Data object.       Return the acos of each data point of this Data object.
1113         *
1114    */    */
1115      ESCRIPT_DLL_API
1116    Data    Data
1117    ln() const;    acos() const;
1118    
1119    /**    /**
1120       \brief       \brief
1121       Return the maximum absolute value of this Data object.       Return the atan of each data point of this Data object.
1122         *
1123    */    */
1124    double    ESCRIPT_DLL_API
1125    Lsup() const;    Data
1126      atan() const;
1127    
1128    /**    /**
1129       \brief       \brief
1130       Return the maximum value of this Data object.       Return the sinh of each data point of this Data object.
1131         *
1132    */    */
1133    double    ESCRIPT_DLL_API
1134    sup() const;    Data
1135      sinh() const;
1136    
1137    /**    /**
1138       \brief       \brief
1139       Return the minimum value of this Data object.       Return the cosh of each data point of this Data object.
1140         *
1141    */    */
1142    double    ESCRIPT_DLL_API
1143    inf() const;    Data
1144      cosh() const;
1145    
1146    /**    /**
1147       \brief       \brief
1148       Return the absolute value of each data point of this Data object.       Return the tanh of each data point of this Data object.
1149         *
1150    */    */
1151      ESCRIPT_DLL_API
1152    Data    Data
1153    abs() const;    tanh() const;
1154    
1155    /**    /**
1156       \brief       \brief
1157       Return the maximum value of each data point of this Data object.       Return the asinh of each data point of this Data object.
1158         *
1159    */    */
1160      ESCRIPT_DLL_API
1161    Data    Data
1162    maxval() const;    asinh() const;
1163    
1164    /**    /**
1165       \brief       \brief
1166       Return the minimum value of each data point of this Data object.       Return the acosh of each data point of this Data object.
1167         *
1168    */    */
1169      ESCRIPT_DLL_API
1170    Data    Data
1171    minval() const;    acosh() const;
1172    
1173    /**    /**
1174       \brief       \brief
1175       Return the length of each data point of this Data object.       Return the atanh of each data point of this Data object.
1176       sqrt(sum(A[i,j,k,l]^2))       *
1177    */    */
1178      ESCRIPT_DLL_API
1179    Data    Data
1180    length() const;    atanh() const;
1181    
1182    /**    /**
1183       \brief       \brief
1184       Return the sign of each data point of this Data object.       Return the log to base 10 of each data point of this Data object.
1185       -1 for negative values, zero for zero values, 1 for positive values.       *
1186    */    */
1187      ESCRIPT_DLL_API
1188    Data    Data
1189    sign() const;    log10() const;
1190    
1191    /**    /**
1192      \transpose       \brief
1193      Transpose each data point of this Data object around the given axis.       Return the natural log of each data point of this Data object.
1194         *
1195    */    */
1196      ESCRIPT_DLL_API
1197    Data    Data
1198    transpose(int axis) const;    log() const;
1199    
1200    /**    /**
1201      \trace       \brief
1202      Calculate the trace of each data point of this Data object.       Return the exponential function of each data point of this Data object.
1203      sum(A[i,i,i,i])       *
1204    */    */
1205      ESCRIPT_DLL_API
1206    Data    Data
1207    trace() const;    exp() const;
1208    
1209    /**    /**
1210      \exp       \brief
1211      Return the exponential function of each data point of this Data object.       Return the square root of each data point of this Data object.
1212         *
1213    */    */
1214      ESCRIPT_DLL_API
1215    Data    Data
1216    exp() const;    sqrt() const;
1217    
1218    /**    /**
1219      \sqrt       \brief
1220      Return the square root of each data point of this Data object.       Return the negation of each data point of this Data object.
1221         *
1222    */    */
1223      ESCRIPT_DLL_API
1224    Data    Data
1225    sqrt() const;    neg() const;
1226    
1227      /**
1228         \brief
1229         Return the identity of each data point of this Data object.
1230         Simply returns this object unmodified.
1231         *
1232      */
1233      ESCRIPT_DLL_API
1234      Data
1235      pos() const;
1236    
1237    /**    /**
1238       \brief       \brief
1239       Return the given power of each data point of this Data object.       Return the given power of each data point of this Data object.
1240    
1241         \param right Input - the power to raise the object to.
1242         *
1243    */    */
1244      ESCRIPT_DLL_API
1245    Data    Data
1246    powD(const Data& right) const;    powD(const Data& right) const;
1247    
1248      /**
1249         \brief
1250         Return the given power of each data point of this boost python object.
1251    
1252         \param right Input - the power to raise the object to.
1253         *
1254       */
1255      ESCRIPT_DLL_API
1256    Data    Data
1257    powO(const boost::python::object& right) const;    powO(const boost::python::object& right) const;
1258    
1259    /**    /**
1260      \brief       \brief
1261      Return the negation of each data point of this Data object.       Return the given power of each data point of this boost python object.
1262    */  
1263         \param left Input - the bases
1264         *
1265       */
1266    
1267      ESCRIPT_DLL_API
1268    Data    Data
1269    neg() const;    rpowO(const boost::python::object& left) const;
1270    
1271    /**    /**
1272      \brief       \brief
1273      Return the identity of each data point of this Data object.       writes the object to a file in the DX file format
     Simply returns this object unmodified.  
1274    */    */
1275    Data    ESCRIPT_DLL_API
1276    pos() const;    void
1277      saveDX(std::string fileName) const;
1278    
1279      /**
1280         \brief
1281         writes the object to a file in the VTK file format
1282      */
1283      ESCRIPT_DLL_API
1284      void
1285      saveVTK(std::string fileName) const;
1286    
1287    
1288    
1289    /**    /**
1290       \brief       \brief
1291       Overloaded operator +=       Overloaded operator +=
1292       \param right - Input - The right hand side.       \param right - Input - The right hand side.
1293         *
1294    */    */
1295      ESCRIPT_DLL_API
1296    Data& operator+=(const Data& right);    Data& operator+=(const Data& right);
1297      ESCRIPT_DLL_API
1298    Data& operator+=(const boost::python::object& right);    Data& operator+=(const boost::python::object& right);
1299    
1300      ESCRIPT_DLL_API
1301      Data& operator=(const Data& other);
1302    
1303    /**    /**
1304       \brief       \brief
1305       Overloaded operator -=       Overloaded operator -=
1306       \param right - Input - The right hand side.       \param right - Input - The right hand side.
1307         *
1308    */    */
1309      ESCRIPT_DLL_API
1310    Data& operator-=(const Data& right);    Data& operator-=(const Data& right);
1311      ESCRIPT_DLL_API
1312    Data& operator-=(const boost::python::object& right);    Data& operator-=(const boost::python::object& right);
1313    
1314   /**   /**
1315       \brief       \brief
1316       Overloaded operator *=       Overloaded operator *=
1317       \param right - Input - The right hand side.       \param right - Input - The right hand side.
1318         *
1319    */    */
1320      ESCRIPT_DLL_API
1321    Data& operator*=(const Data& right);    Data& operator*=(const Data& right);
1322      ESCRIPT_DLL_API
1323    Data& operator*=(const boost::python::object& right);    Data& operator*=(const boost::python::object& right);
1324    
1325   /**   /**
1326       \brief       \brief
1327       Overloaded operator /=       Overloaded operator /=
1328       \param right - Input - The right hand side.       \param right - Input - The right hand side.
1329         *
1330    */    */
1331      ESCRIPT_DLL_API
1332    Data& operator/=(const Data& right);    Data& operator/=(const Data& right);
1333      ESCRIPT_DLL_API
1334    Data& operator/=(const boost::python::object& right);    Data& operator/=(const boost::python::object& right);
1335    
1336    /**    /**
1337       \brief       \brief
1338       Returns true if this can be interpolated to functionspace.       Returns true if this can be interpolated to functionspace.
1339    */    */
1340      ESCRIPT_DLL_API
1341    bool    bool
1342    probeInterpolation(const FunctionSpace& functionspace) const;    probeInterpolation(const FunctionSpace& functionspace) const;
1343    
# Line 748  class Data { Line 1356  class Data {
1356       \param key - Input - python slice tuple specifying       \param key - Input - python slice tuple specifying
1357       slice to return.       slice to return.
1358    */    */
1359      ESCRIPT_DLL_API
1360    Data    Data
1361    getItem(const boost::python::object& key) const;    getItem(const boost::python::object& key) const;
1362    
# Line 755  class Data { Line 1364  class Data {
1364       \brief       \brief
1365       Copies slice from value into this Data object.       Copies slice from value into this Data object.
1366    
      \description  
1367       Implements the [] set operator in python.       Implements the [] set operator in python.
1368       Calls setSlice.       Calls setSlice.
1369    
# Line 763  class Data { Line 1371  class Data {
1371       slice to copy from value.       slice to copy from value.
1372       \param value - Input - Data object to copy from.       \param value - Input - Data object to copy from.
1373    */    */
1374      ESCRIPT_DLL_API
1375    void    void
1376    setItemD(const boost::python::object& key,    setItemD(const boost::python::object& key,
1377             const Data& value);             const Data& value);
1378    
1379      ESCRIPT_DLL_API
1380    void    void
1381    setItemO(const boost::python::object& key,    setItemO(const boost::python::object& key,
1382             const boost::python::object& value);             const boost::python::object& value);
# Line 779  class Data { Line 1389  class Data {
1389       this Data object.       this Data object.
1390    */    */
1391    template <class UnaryFunction>    template <class UnaryFunction>
1392      ESCRIPT_DLL_API
1393    inline    inline
1394    void    void
1395    unaryOp(UnaryFunction operation);    unaryOp2(UnaryFunction operation);
1396    
1397    /**    /**
1398       \brief       \brief
1399       Return a Data object containing the specified slice of       Return a Data object containing the specified slice of
1400       this Data object.       this Data object.
1401       \param region - Input - Region to copy.       \param region - Input - Region to copy.
1402         *
1403    */    */
1404      ESCRIPT_DLL_API
1405    Data    Data
1406    getSlice(const DataArrayView::RegionType& region) const;    getSlice(const DataTypes::RegionType& region) const;
1407    
1408    /**    /**
1409       \brief       \brief
# Line 798  class Data { Line 1411  class Data {
1411       Data object.       Data object.
1412       \param value - Input - Data to copy from.       \param value - Input - Data to copy from.
1413       \param region - Input - Region to copy.       \param region - Input - Region to copy.
1414         *
1415    */    */
1416      ESCRIPT_DLL_API
1417    void    void
1418    setSlice(const Data& value,    setSlice(const Data& value,
1419             const DataArrayView::RegionType& region);             const DataTypes::RegionType& region);
1420    
1421      /**
1422         \brief
1423         print the data values to stdout. Used for debugging
1424      */
1425      ESCRIPT_DLL_API
1426      void
1427            print(void);
1428    
1429      /**
1430         \brief
1431         return the MPI rank number of the local data
1432                     MPI_COMM_WORLD is assumed and the result of MPI_Comm_size()
1433                     is returned
1434      */
1435      ESCRIPT_DLL_API
1436            int
1437            get_MPIRank(void) const;
1438    
1439      /**
1440         \brief
1441         return the MPI rank number of the local data
1442                     MPI_COMM_WORLD is assumed and the result of MPI_Comm_rank()
1443                     is returned
1444      */
1445      ESCRIPT_DLL_API
1446            int
1447            get_MPISize(void) const;
1448    
1449      /**
1450         \brief
1451         return the MPI rank number of the local data
1452                     MPI_COMM_WORLD is assumed and returned.
1453      */
1454      ESCRIPT_DLL_API
1455            MPI_Comm
1456            get_MPIComm(void) const;
1457    
1458      /**
1459         \brief
1460         return the object produced by the factory, which is a DataConstant or DataExpanded
1461        TODO Ownership of this object should be explained in doco.
1462      */
1463      ESCRIPT_DLL_API
1464            DataAbstract*
1465            borrowData(void) const;
1466    
1467      ESCRIPT_DLL_API
1468            DataAbstract_ptr
1469            borrowDataPtr(void) const;
1470    
1471      ESCRIPT_DLL_API
1472            DataReady_ptr
1473            borrowReadyPtr(void) const;
1474    
1475    
1476    
1477      /**
1478         \brief
1479         Return a pointer to the beginning of the datapoint at the specified offset.
1480         TODO Eventually these should be inlined.
1481         \param i - position(offset) in the underlying datastructure
1482      */
1483    
1484      ESCRIPT_DLL_API
1485            DataTypes::ValueType::const_reference
1486            getDataAtOffsetRO(DataTypes::ValueType::size_type i);
1487    
1488    
1489      ESCRIPT_DLL_API
1490            DataTypes::ValueType::reference
1491            getDataAtOffsetRW(DataTypes::ValueType::size_type i);
1492    
1493    
1494    
1495    /**
1496       \brief Create a buffer for use by getSample
1497       Allocates a DataVector large enough for DataLazy::resolveSample to operate on for the current Data.
1498       Do not use this buffer for other Data instances (unless you are sure they will be the same size).
1499      
1500       In multi-threaded sections, this needs to be called on each thread.
1501    
1502       \return A BufferGroup* if Data is lazy, NULL otherwise.
1503       \warning This pointer must be deallocated using freeSampleBuffer to avoid cross library memory issues.
1504    */
1505      ESCRIPT_DLL_API
1506      BufferGroup*
1507      allocSampleBuffer() const;
1508    
1509    /**
1510       \brief Free a buffer allocated with allocSampleBuffer.
1511       \param buffer Input - pointer to the buffer to deallocate.
1512    */
1513    ESCRIPT_DLL_API void freeSampleBuffer(BufferGroup* buffer);
1514    
1515   protected:   protected:
1516    
1517   private:   private:
1518    
1519      double
1520      LsupWorker() const;
1521    
1522      double
1523      supWorker() const;
1524    
1525      double
1526      infWorker() const;
1527    
1528      boost::python::object
1529      integrateWorker() const;
1530    
1531      void
1532      calc_minGlobalDataPoint(int& ProcNo,  int& DataPointNo) const;
1533    
1534      void
1535      calc_maxGlobalDataPoint(int& ProcNo,  int& DataPointNo) const;
1536    
1537    
1538    /**    /**
1539       \brief       \brief
1540       Check *this and the right operand are compatible. Throws       Check *this and the right operand are compatible. Throws
# Line 823  class Data { Line 1551  class Data {
1551    /**    /**
1552       \brief       \brief
1553       Perform the specified reduction algorithm on every element of every data point in       Perform the specified reduction algorithm on every element of every data point in
1554       this Data object and return the single double value result.       this Data object according to the given function and return the single value result.
1555    */    */
1556    template <class UnaryFunction>    template <class BinaryFunction>
1557    inline    inline
1558    double    double
1559    algorithm(UnaryFunction operation) const;    algorithm(BinaryFunction operation,
1560                double initial_value) const;
1561    
1562    /**    /**
1563       \brief       \brief
1564       Perform the given binary operation on all of the data's elements.       Reduce each data-point in this Data object using the given operation. Return a Data
1565       The underlying type of the right hand side (right) determines the final       object with the same number of data-points, but with each data-point containing only
1566       type of *this after the operation. For example if the right hand side       one value - the result of the reduction operation on the corresponding data-point in
1567       is expanded *this will be expanded if necessary.       this Data object
      RHS is a Data object.  
1568    */    */
1569    template <class BinaryFunction>    template <class BinaryFunction>
1570    inline    inline
1571    void    Data
1572    binaryOp(const Data& right,    dp_algorithm(BinaryFunction operation,
1573             BinaryFunction operation);                 double initial_value) const;
1574    
1575    /**    /**
1576       \brief       \brief
1577       Perform the given binary operation on all of the data's elements.       Perform the given binary operation on all of the data's elements.
1578       RHS is a boost::python object.       The underlying type of the right hand side (right) determines the final
1579         type of *this after the operation. For example if the right hand side
1580         is expanded *this will be expanded if necessary.
1581         RHS is a Data object.
1582    */    */
1583    template <class BinaryFunction>    template <class BinaryFunction>
1584    inline    inline
1585    void    void
1586    binaryOp(const boost::python::object& right,    binaryOp(const Data& right,
1587             BinaryFunction operation);             BinaryFunction operation);
1588    
1589    /**    /**
# Line 875  class Data { Line 1606  class Data {
1606       \brief       \brief
1607       Construct a Data object of the appropriate type.       Construct a Data object of the appropriate type.
1608    */    */
1609    template <class IValueType>  
1610    void    void
1611    initialise(const IValueType& value,    initialise(const DataTypes::ValueType& value,
1612             const DataTypes::ShapeType& shape,
1613               const FunctionSpace& what,               const FunctionSpace& what,
1614               bool expanded);               bool expanded);
1615    
   /**  
      \brief  
      Reshape the data point if the data point is currently rank 0.  
      Will throw an exception if the data points are not rank 0.  
      The original data point value is used for all values of the new  
      data point.  
   */  
1616    void    void
1617    reshapeDataPoint(const DataArrayView::ShapeType& shape);    initialise(const WrappedArray& value,
1618                     const FunctionSpace& what,
1619                     bool expanded);
1620    
1621      //
1622      // flag to protect the data object against any update
1623      bool m_protected;
1624      mutable bool m_shared;
1625      bool m_lazy;
1626    
1627    //    //
1628    // pointer to the actual data object    // pointer to the actual data object
1629    boost::shared_ptr<DataAbstract> m_data;  //   boost::shared_ptr<DataAbstract> m_data;
1630      DataAbstract_ptr m_data;
1631    
1632  };  // If possible please use getReadyPtr instead.
1633    // But see warning below.
1634      const DataReady*
1635      getReady() const;
1636    
1637  template <class IValueType>    DataReady*
1638  void    getReady();
1639  Data::initialise(const IValueType& value,  
1640                   const FunctionSpace& what,  
1641                   bool expanded)  // Be wary of using this for local operations since it (temporarily) increases reference count.
1642  {  // If you are just using this to call a method on DataReady instead of DataAbstract consider using
1643    // getReady() instead
1644      DataReady_ptr
1645      getReadyPtr();
1646    
1647      const_DataReady_ptr
1648      getReadyPtr() const;
1649    
1650    
1651      /**
1652       \brief Update the Data's shared flag
1653       This indicates that the DataAbstract used by this object is now shared (or no longer shared).
1654       For internal use only.
1655      */
1656      void updateShareStatus(bool nowshared) const
1657      {
1658        m_shared=nowshared;     // m_shared is mutable
1659      }
1660    
1661      // In the isShared() method below:
1662      // A problem would occur if m_data (the address pointed to) were being modified
1663      // while the call m_data->is_shared is being executed.
1664      //
1665      // Q: So why do I think this code can be thread safe/correct?
1666      // A: We need to make some assumptions.
1667      // 1. We assume it is acceptable to return true under some conditions when we aren't shared.
1668      // 2. We assume that no constructions or assignments which will share previously unshared
1669      //    will occur while this call is executing. This is consistent with the way Data:: and C are written.
1670    //    //
1671    // Construct a Data object of the appropriate type.    // This means that the only transition we need to consider, is when a previously shared object is
1672    // Construct the object first as there seems to be a bug which causes    // not shared anymore. ie. the other objects have been destroyed or a deep copy has been made.
1673    // undefined behaviour if an exception is thrown during construction    // In those cases the m_shared flag changes to false after m_data has completed changing.
1674    // within the shared_ptr constructor.    // For any threads executing before the flag switches they will assume the object is still shared.
1675    if (expanded) {    bool isShared() const
1676      DataAbstract* temp=new DataExpanded(value,what);    {
1677      boost::shared_ptr<DataAbstract> temp_data(temp);      return m_shared;
1678      m_data=temp_data;  /*  if (m_shared) return true;
1679    } else {      if (m_data->isShared())        
1680      DataAbstract* temp=new DataConstant(value,what);      {                  
1681      boost::shared_ptr<DataAbstract> temp_data(temp);          updateShareStatus(true);
1682      m_data=temp_data;          return true;
1683        }
1684        return false;*/
1685      }
1686    
1687      void forceResolve()
1688      {
1689        if (isLazy())
1690        {
1691            #ifdef _OPENMP
1692            if (omp_in_parallel())
1693            {   // Yes this is throwing an exception out of an omp thread which is forbidden.
1694            throw DataException("Please do not call forceResolve() in a parallel region.");
1695            }
1696            #endif
1697            resolve();
1698        }
1699      }
1700    
1701      /**
1702      \brief if another object is sharing out member data make a copy to work with instead.
1703      This code should only be called from single threaded sections of code.
1704      */
1705      void exclusiveWrite()
1706      {
1707    #ifdef _OPENMP
1708      if (omp_in_parallel())
1709      {
1710    // *((int*)0)=17;
1711        throw DataException("Programming error. Please do not run exclusiveWrite() in multi-threaded sections.");
1712      }
1713    #endif
1714        forceResolve();
1715        if (isShared())
1716        {
1717            DataAbstract* t=m_data->deepCopy();
1718            set_m_data(DataAbstract_ptr(t));
1719        }
1720      }
1721    
1722      /**
1723      \brief checks if caller can have exclusive write to the object
1724      */
1725      void checkExclusiveWrite()
1726      {
1727        if  (isLazy() || isShared())
1728        {
1729            throw DataException("Programming error. ExclusiveWrite required - please call requireWrite()");
1730        }
1731    }    }
1732    
1733      /**
1734      \brief Modify the data abstract hosted by this Data object
1735      For internal use only.
1736      Passing a pointer to null is permitted (do this in the destructor)
1737      \warning Only to be called in single threaded code or inside a single/critical section. This method needs to be atomic.
1738      */
1739      void set_m_data(DataAbstract_ptr p);
1740    
1741      friend class DataAbstract;        // To allow calls to updateShareStatus
1742    
1743    };
1744    
1745    }   // end namespace escript
1746    
1747    
1748    // No, this is not supposed to be at the top of the file
1749    // DataAbstact needs to be declared first, then DataReady needs to be fully declared
1750    // so that I can dynamic cast between them below.
1751    #include "DataReady.h"
1752    #include "DataLazy.h"
1753    
1754    namespace escript
1755    {
1756    
1757    inline
1758    const DataReady*
1759    Data::getReady() const
1760    {
1761       const DataReady* dr=dynamic_cast<const DataReady*>(m_data.get());
1762       EsysAssert((dr!=0), "Error - casting to DataReady.");
1763       return dr;
1764    }
1765    
1766    inline
1767    DataReady*
1768    Data::getReady()
1769    {
1770       DataReady* dr=dynamic_cast<DataReady*>(m_data.get());
1771       EsysAssert((dr!=0), "Error - casting to DataReady.");
1772       return dr;
1773  }  }
1774    
1775    // Be wary of using this for local operations since it (temporarily) increases reference count.
1776    // If you are just using this to call a method on DataReady instead of DataAbstract consider using
1777    // getReady() instead
1778    inline
1779    DataReady_ptr
1780    Data::getReadyPtr()
1781    {
1782       DataReady_ptr dr=boost::dynamic_pointer_cast<DataReady>(m_data);
1783       EsysAssert((dr.get()!=0), "Error - casting to DataReady.");
1784       return dr;
1785    }
1786    
1787    
1788    inline
1789    const_DataReady_ptr
1790    Data::getReadyPtr() const
1791    {
1792       const_DataReady_ptr dr=boost::dynamic_pointer_cast<const DataReady>(m_data);
1793       EsysAssert((dr.get()!=0), "Error - casting to DataReady.");
1794       return dr;
1795    }
1796    
1797    inline
1798    DataAbstract::ValueType::value_type*
1799    Data::getSampleDataRW(DataAbstract::ValueType::size_type sampleNo)
1800    {
1801       if (isLazy())
1802       {
1803        throw DataException("Error, attempt to acquire RW access to lazy data. Please call requireWrite() first.");
1804       }
1805       return getReady()->getSampleDataRW(sampleNo);
1806    }
1807    
1808    inline
1809    const DataAbstract::ValueType::value_type*
1810    Data::getSampleDataRO(DataAbstract::ValueType::size_type sampleNo, BufferGroup* bufferg)
1811    {
1812       DataLazy* l=dynamic_cast<DataLazy*>(m_data.get());
1813       if (l!=0)
1814       {
1815        size_t offset=0;
1816        if (bufferg==NULL)
1817        {
1818            throw DataException("Error, attempt to getSampleDataRO for lazy Data with buffer==NULL");
1819        }
1820        const DataTypes::ValueType* res=l->resolveSample(*bufferg,sampleNo,offset);
1821        return &((*res)[offset]);
1822       }
1823       return getReady()->getSampleDataRO(sampleNo);
1824    }
1825    
1826    
1827    
1828    /**
1829       Modify a filename for MPI parallel output to multiple files
1830    */
1831    char *Escript_MPI_appendRankToFileName(const char *, int, int);
1832    
1833  /**  /**
1834     Binary Data object operators.     Binary Data object operators.
1835  */  */
1836    inline double rpow(double x,double y)
1837    {
1838        return pow(y,x);
1839    }
1840    
1841  /**  /**
1842    \brief    \brief
1843    Operator+    Operator+
1844    Takes two Data objects.    Takes two Data objects.
1845  */  */
1846  Data operator+(const Data& left, const Data& right);  ESCRIPT_DLL_API Data operator+(const Data& left, const Data& right);
1847    
1848  /**  /**
1849    \brief    \brief
1850    Operator-    Operator-
1851    Takes two Data objects.    Takes two Data objects.
1852  */  */
1853  Data operator-(const Data& left, const Data& right);  ESCRIPT_DLL_API Data operator-(const Data& left, const Data& right);
1854    
1855  /**  /**
1856    \brief    \brief
1857    Operator*    Operator*
1858    Takes two Data objects.    Takes two Data objects.
1859  */  */
1860  Data operator*(const Data& left, const Data& right);  ESCRIPT_DLL_API Data operator*(const Data& left, const Data& right);
1861    
1862  /**  /**
1863    \brief    \brief
1864    Operator/    Operator/
1865    Takes two Data objects.    Takes two Data objects.
1866  */  */
1867  Data operator/(const Data& left, const Data& right);  ESCRIPT_DLL_API Data operator/(const Data& left, const Data& right);
1868    
1869  /**  /**
1870    \brief    \brief
# Line 957  Data operator/(const Data& left, const D Line 1872  Data operator/(const Data& left, const D
1872    Takes LHS Data object and RHS python::object.    Takes LHS Data object and RHS python::object.
1873    python::object must be convertable to Data type.    python::object must be convertable to Data type.
1874  */  */
1875  Data operator+(const Data& left, const boost::python::object& right);  ESCRIPT_DLL_API Data operator+(const Data& left, const boost::python::object& right);
1876    
1877  /**  /**
1878    \brief    \brief
# Line 965  Data operator+(const Data& left, const b Line 1880  Data operator+(const Data& left, const b
1880    Takes LHS Data object and RHS python::object.    Takes LHS Data object and RHS python::object.
1881    python::object must be convertable to Data type.    python::object must be convertable to Data type.
1882  */  */
1883  Data operator-(const Data& left, const boost::python::object& right);  ESCRIPT_DLL_API Data operator-(const Data& left, const boost::python::object& right);
1884    
1885  /**  /**
1886    \brief    \brief
# Line 973  Data operator-(const Data& left, const b Line 1888  Data operator-(const Data& left, const b
1888    Takes LHS Data object and RHS python::object.    Takes LHS Data object and RHS python::object.
1889    python::object must be convertable to Data type.    python::object must be convertable to Data type.
1890  */  */
1891  Data operator*(const Data& left, const boost::python::object& right);  ESCRIPT_DLL_API Data operator*(const Data& left, const boost::python::object& right);
1892    
1893  /**  /**
1894    \brief    \brief
# Line 981  Data operator*(const Data& left, const b Line 1896  Data operator*(const Data& left, const b
1896    Takes LHS Data object and RHS python::object.    Takes LHS Data object and RHS python::object.
1897    python::object must be convertable to Data type.    python::object must be convertable to Data type.
1898  */  */
1899  Data operator/(const Data& left, const boost::python::object& right);  ESCRIPT_DLL_API Data operator/(const Data& left, const boost::python::object& right);
1900    
1901  /**  /**
1902    \brief    \brief
# Line 989  Data operator/(const Data& left, const b Line 1904  Data operator/(const Data& left, const b
1904    Takes LHS python::object and RHS Data object.    Takes LHS python::object and RHS Data object.
1905    python::object must be convertable to Data type.    python::object must be convertable to Data type.
1906  */  */
1907  Data operator+(const boost::python::object& left, const Data& right);  ESCRIPT_DLL_API Data operator+(const boost::python::object& left, const Data& right);
1908    
1909  /**  /**
1910    \brief    \brief
# Line 997  Data operator+(const boost::python::obje Line 1912  Data operator+(const boost::python::obje
1912    Takes LHS python::object and RHS Data object.    Takes LHS python::object and RHS Data object.
1913    python::object must be convertable to Data type.    python::object must be convertable to Data type.
1914  */  */
1915  Data operator-(const boost::python::object& left, const Data& right);  ESCRIPT_DLL_API Data operator-(const boost::python::object& left, const Data& right);
1916    
1917  /**  /**
1918    \brief    \brief
# Line 1005  Data operator-(const boost::python::obje Line 1920  Data operator-(const boost::python::obje
1920    Takes LHS python::object and RHS Data object.    Takes LHS python::object and RHS Data object.
1921    python::object must be convertable to Data type.    python::object must be convertable to Data type.
1922  */  */
1923  Data operator*(const boost::python::object& left, const Data& right);  ESCRIPT_DLL_API Data operator*(const boost::python::object& left, const Data& right);
1924    
1925  /**  /**
1926    \brief    \brief
# Line 1013  Data operator*(const boost::python::obje Line 1928  Data operator*(const boost::python::obje
1928    Takes LHS python::object and RHS Data object.    Takes LHS python::object and RHS Data object.
1929    python::object must be convertable to Data type.    python::object must be convertable to Data type.
1930  */  */
1931  Data operator/(const boost::python::object& left, const Data& right);  ESCRIPT_DLL_API Data operator/(const boost::python::object& left, const Data& right);
1932    
1933    
1934    
1935  /**  /**
1936    \brief    \brief
1937    Output operator    Output operator
1938  */  */
1939  std::ostream& operator<<(std::ostream& o, const Data& data);  ESCRIPT_DLL_API std::ostream& operator<<(std::ostream& o, const Data& data);
1940    
1941  /**  /**
1942    \brief    \brief
1943    Return true if operands are equivalent, else return false.    Compute a tensor product of two Data objects
1944    NB: this operator does very little at this point, and isn't to    \param arg_0 - Input - Data object
1945    be relied on. Requires further implementation.    \param arg_1 - Input - Data object
1946      \param axis_offset - Input - axis offset
1947      \param transpose - Input - 0: transpose neither, 1: transpose arg0, 2: transpose arg1
1948  */  */
1949  //bool operator==(const Data& left, const Data& right);  ESCRIPT_DLL_API
1950    Data
1951    C_GeneralTensorProduct(Data& arg_0,
1952                         Data& arg_1,
1953                         int axis_offset=0,
1954                         int transpose=0);
1955    
1956  /**  /**
1957    \brief    \brief
# Line 1042  Data::binaryOp(const Data& right, Line 1966  Data::binaryOp(const Data& right,
1966  {  {
1967     //     //
1968     // if this has a rank of zero promote it to the rank of the RHS     // if this has a rank of zero promote it to the rank of the RHS
1969     if (getPointDataView().getRank()==0 && right.getPointDataView().getRank()!=0) {     if (getDataPointRank()==0 && right.getDataPointRank()!=0) {
1970       reshapeDataPoint(right.getPointDataView().getShape());       throw DataException("Error - attempt to update rank zero object with object with rank bigger than zero.");
1971       }
1972    
1973       if (isLazy() || right.isLazy())
1974       {
1975         throw DataException("Programmer error - attempt to call binaryOp with Lazy Data.");
1976     }     }
1977     //     //
1978     // initially make the temporary a shallow copy     // initially make the temporary a shallow copy
1979     Data tempRight(right);     Data tempRight(right);
1980    
1981     if (getFunctionSpace()!=right.getFunctionSpace()) {     if (getFunctionSpace()!=right.getFunctionSpace()) {
1982       if (right.probeInterpolation(getFunctionSpace())) {       if (right.probeInterpolation(getFunctionSpace())) {
1983         //         //
1984         // an interpolation is required so create a new Data         // an interpolation is required so create a new Data
1985         tempRight=Data(right,this->getFunctionSpace());         tempRight=Data(right,this->getFunctionSpace());
1986       } else if (probeInterpolation(right.getFunctionSpace())) {       } else if (probeInterpolation(right.getFunctionSpace())) {
1987         //         //
1988         // interpolate onto the RHS function space         // interpolate onto the RHS function space
1989         Data tempLeft(*this,right.getFunctionSpace());         Data tempLeft(*this,right.getFunctionSpace());
1990         m_data=tempLeft.m_data;  //        m_data=tempLeft.m_data;
1991           set_m_data(tempLeft.m_data);
1992       }       }
1993     }     }
1994     operandCheck(tempRight);     operandCheck(tempRight);
# Line 1073  Data::binaryOp(const Data& right, Line 2004  Data::binaryOp(const Data& right,
2004       // of any data type       // of any data type
2005       DataExpanded* leftC=dynamic_cast<DataExpanded*>(m_data.get());       DataExpanded* leftC=dynamic_cast<DataExpanded*>(m_data.get());
2006       EsysAssert((leftC!=0), "Programming error - casting to DataExpanded.");       EsysAssert((leftC!=0), "Programming error - casting to DataExpanded.");
2007       escript::binaryOp(*leftC,*(tempRight.m_data.get()),operation);       escript::binaryOp(*leftC,*(tempRight.getReady()),operation);
2008     } else if (isTagged()) {     } else if (isTagged()) {
2009       //       //
2010       // Tagged data is operated on serially, the right hand side can be       // Tagged data is operated on serially, the right hand side can be
# Line 1099  Data::binaryOp(const Data& right, Line 2030  Data::binaryOp(const Data& right,
2030    
2031  /**  /**
2032    \brief    \brief
   Perform the given binary operation with this and right as operands.  
   Right is a boost::python object.  
 */  
 template <class BinaryFunction>  
 inline  
 void  
 Data::binaryOp(const boost::python::object& right,  
                BinaryFunction operation)  
 {  
    DataArray temp(right);  
    //  
    // if this has a rank of zero promote it to the rank of the RHS.  
    if (getPointDataView().getRank()==0 && temp.getView().getRank()!=0) {  
       reshapeDataPoint(temp.getView().getShape());  
    }  
    //  
    // Always allow scalar values for the RHS but check other shapes  
    if (temp.getView().getRank()!=0) {  
      if (!getPointDataView().checkShape(temp.getView().getShape())) {  
        throw DataException(getPointDataView().createShapeErrorMessage(  
                   "Error - RHS shape doesn't match LHS shape.",temp.getView().getShape()));  
      }  
    }  
    if (isExpanded()) {  
      DataExpanded* leftC=dynamic_cast<DataExpanded*>(m_data.get());  
      EsysAssert((leftC!=0),"Programming error - casting to DataExpanded.");  
      escript::binaryOp(*leftC,temp.getView(),operation);  
    } else if (isTagged()) {  
      DataTagged* leftC=dynamic_cast<DataTagged*>(m_data.get());  
      EsysAssert((leftC!=0), "Programming error - casting to DataTagged.");  
      escript::binaryOp(*leftC,temp.getView(),operation);  
    } else if (isConstant()) {  
      DataConstant* leftC=dynamic_cast<DataConstant*>(m_data.get());  
      EsysAssert((leftC!=0),"Programming error - casting to DataConstant.");  
      escript::binaryOp(*leftC,temp.getView(),operation);  
    }  
 }  
   
 /**  
   \brief  
   Perform the given unary operation on other and return the result.  
   Given operation is performed on each element of each data point, thus  
   argument object is a rank n Data object, and returned object is a rank n  
   Data object.  
   Calls Data::unaryOp.  
 */  
 template <class UnaryFunction>  
 inline  
 Data  
 unaryOp(const Data& other,  
         UnaryFunction operation)  
 {  
   Data result;  
   result.copy(other);  
   result.unaryOp(operation);  
   return result;  
 }  
   
 /**  
   \brief  
   Perform the given unary operation on this.  
   Given operation is performed on each element of each data point.  
   Calls escript::unaryOp.  
 */  
 template <class UnaryFunction>  
 inline  
 void  
 Data::unaryOp(UnaryFunction operation)  
 {  
   if (isExpanded()) {  
     DataExpanded* leftC=dynamic_cast<DataExpanded*>(m_data.get());  
     EsysAssert((leftC!=0), "Programming error - casting to DataExpanded.");  
     escript::unaryOp(*leftC,operation);  
   } else if (isTagged()) {  
     DataTagged* leftC=dynamic_cast<DataTagged*>(m_data.get());  
     EsysAssert((leftC!=0), "Programming error - casting to DataTagged.");  
     escript::unaryOp(*leftC,operation);  
   } else if (isConstant()) {  
     DataConstant* leftC=dynamic_cast<DataConstant*>(m_data.get());  
     EsysAssert((leftC!=0), "Programming error - casting to DataConstant.");  
     escript::unaryOp(*leftC,operation);  
   }  
 }  
   
 /**  
   \brief  
2033    Perform the given Data object reduction algorithm on this and return the result.    Perform the given Data object reduction algorithm on this and return the result.
2034    Given operation combines each element of each data point, thus argument    Given operation combines each element of each data point, thus argument
2035    object (*this) is a rank n Data object, and returned object is a scalar.    object (*this) is a rank n Data object, and returned object is a scalar.
2036    Calls escript::algorithm.    Calls escript::algorithm.
2037  */  */
2038  template <class UnaryFunction>  template <class BinaryFunction>
2039  inline  inline
2040  double  double
2041  Data::algorithm(UnaryFunction operation) const  Data::algorithm(BinaryFunction operation, double initial_value) const
2042  {  {
2043    if (isExpanded()) {    if (isExpanded()) {
2044      DataExpanded* leftC=dynamic_cast<DataExpanded*>(m_data.get());      DataExpanded* leftC=dynamic_cast<DataExpanded*>(m_data.get());
2045      EsysAssert((leftC!=0), "Programming error - casting to DataExpanded.");      EsysAssert((leftC!=0), "Programming error - casting to DataExpanded.");
2046      return escript::algorithm(*leftC,operation);      return escript::algorithm(*leftC,operation,initial_value);
2047    } else if (isTagged()) {    } else if (isTagged()) {
2048      DataTagged* leftC=dynamic_cast<DataTagged*>(m_data.get());      DataTagged* leftC=dynamic_cast<DataTagged*>(m_data.get());
2049      EsysAssert((leftC!=0), "Programming error - casting to DataTagged.");      EsysAssert((leftC!=0), "Programming error - casting to DataTagged.");
2050      return escript::algorithm(*leftC,operation);      return escript::algorithm(*leftC,operation,initial_value);
2051    } else if (isConstant()) {    } else if (isConstant()) {
2052      DataConstant* leftC=dynamic_cast<DataConstant*>(m_data.get());      DataConstant* leftC=dynamic_cast<DataConstant*>(m_data.get());
2053      EsysAssert((leftC!=0), "Programming error - casting to DataConstant.");      EsysAssert((leftC!=0), "Programming error - casting to DataConstant.");
2054      return escript::algorithm(*leftC,operation);      return escript::algorithm(*leftC,operation,initial_value);
2055      } else if (isEmpty()) {
2056        throw DataException("Error - Operations not permitted on instances of DataEmpty.");
2057      } else if (isLazy()) {
2058        throw DataException("Error - Operations not permitted on instances of DataLazy.");
2059      } else {
2060        throw DataException("Error - Data encapsulates an unknown type.");
2061    }    }
   return 0;  
2062  }  }
2063    
2064  /**  /**
2065    \brief    \brief
2066    Perform the given data point reduction algorithm on data and return the result.    Perform the given data point reduction algorithm on data and return the result.
2067    Given operation combines each element within each data point into a scalar,    Given operation combines each element within each data point into a scalar,
2068    thus argument object is a rank n Data object, and returned object is a    thus argument object is a rank n Data object, and returned object is a
2069    rank 0 Data object.    rank 0 Data object.
2070    Calls escript::dp_algorithm.    Calls escript::dp_algorithm.
2071  */  */
2072  template <class UnaryFunction>  template <class BinaryFunction>
2073  inline  inline
2074  Data  Data
2075  dp_algorithm(const Data& data,  Data::dp_algorithm(BinaryFunction operation, double initial_value) const
              UnaryFunction operation)  
2076  {  {
2077    Data result(0,DataArrayView::ShapeType(),data.getFunctionSpace(),data.isExpanded());    if (isEmpty()) {
2078    if (data.isExpanded()) {      throw DataException("Error - Operations not permitted on instances of DataEmpty.");
2079      DataExpanded* dataE=dynamic_cast<DataExpanded*>(data.m_data.get());    }
2080      else if (isExpanded()) {
2081        Data result(0,DataTypes::ShapeType(),getFunctionSpace(),isExpanded());
2082        DataExpanded* dataE=dynamic_cast<DataExpanded*>(m_data.get());
2083      DataExpanded* resultE=dynamic_cast<DataExpanded*>(result.m_data.get());      DataExpanded* resultE=dynamic_cast<DataExpanded*>(result.m_data.get());
2084      EsysAssert((dataE!=0), "Programming error - casting data to DataExpanded.");      EsysAssert((dataE!=0), "Programming error - casting data to DataExpanded.");
2085      EsysAssert((resultE!=0), "Programming error - casting result to DataExpanded.");      EsysAssert((resultE!=0), "Programming error - casting result to DataExpanded.");
2086      escript::dp_algorithm(*dataE,*resultE,operation);      escript::dp_algorithm(*dataE,*resultE,operation,initial_value);
2087    } else if (data.isTagged()) {      return result;
2088      DataTagged* dataT=dynamic_cast<DataTagged*>(data.m_data.get());    }
2089      DataTagged* resultT=dynamic_cast<DataTagged*>(result.m_data.get());    else if (isTagged()) {
2090        DataTagged* dataT=dynamic_cast<DataTagged*>(m_data.get());
2091      EsysAssert((dataT!=0), "Programming error - casting data to DataTagged.");      EsysAssert((dataT!=0), "Programming error - casting data to DataTagged.");
2092      EsysAssert((resultT!=0), "Programming error - casting result to DataTagged.");      DataTypes::ValueType defval(1);
2093      escript::dp_algorithm(*dataT,*resultT,operation);      defval[0]=0;
2094    } else if (data.isConstant()) {      DataTagged* resultT=new DataTagged(getFunctionSpace(), DataTypes::scalarShape, defval, dataT);
2095      DataConstant* dataC=dynamic_cast<DataConstant*>(data.m_data.get());      escript::dp_algorithm(*dataT,*resultT,operation,initial_value);
2096        return Data(resultT);   // note: the Data object now owns the resultT pointer
2097      }
2098      else if (isConstant()) {
2099        Data result(0,DataTypes::ShapeType(),getFunctionSpace(),isExpanded());
2100        DataConstant* dataC=dynamic_cast<DataConstant*>(m_data.get());
2101      DataConstant* resultC=dynamic_cast<DataConstant*>(result.m_data.get());      DataConstant* resultC=dynamic_cast<DataConstant*>(result.m_data.get());
2102      EsysAssert((dataC!=0), "Programming error - casting data to DataConstant.");      EsysAssert((dataC!=0), "Programming error - casting data to DataConstant.");
2103      EsysAssert((resultC!=0), "Programming error - casting result to DataConstant.");      EsysAssert((resultC!=0), "Programming error - casting result to DataConstant.");
2104      escript::dp_algorithm(*dataC,*resultC,operation);      escript::dp_algorithm(*dataC,*resultC,operation,initial_value);
2105        return result;
2106      } else if (isLazy()) {
2107        throw DataException("Error - Operations not permitted on instances of DataLazy.");
2108      } else {
2109        throw DataException("Error - Data encapsulates an unknown type.");
2110    }    }
2111    return result;  }
2112    
2113    /**
2114      \brief
2115      Compute a tensor operation with two Data objects
2116      \param arg_0 - Input - Data object
2117      \param arg_1 - Input - Data object
2118      \param operation - Input - Binary op functor
2119    */
2120    template <typename BinaryFunction>
2121    inline
2122    Data
2123    C_TensorBinaryOperation(Data const &arg_0,
2124                            Data const &arg_1,
2125                            BinaryFunction operation)
2126    {
2127      if (arg_0.isEmpty() || arg_1.isEmpty())
2128      {
2129         throw DataException("Error - Operations not permitted on instances of DataEmpty.");
2130      }
2131      if (arg_0.isLazy() || arg_1.isLazy())
2132      {
2133         throw DataException("Error - Operations not permitted on lazy data.");
2134      }
2135      // Interpolate if necessary and find an appropriate function space
2136      Data arg_0_Z, arg_1_Z;
2137      if (arg_0.getFunctionSpace()!=arg_1.getFunctionSpace()) {
2138        if (arg_0.probeInterpolation(arg_1.getFunctionSpace())) {
2139          arg_0_Z = arg_0.interpolate(arg_1.getFunctionSpace());
2140          arg_1_Z = Data(arg_1);
2141        }
2142        else if (arg_1.probeInterpolation(arg_0.getFunctionSpace())) {
2143          arg_1_Z=arg_1.interpolate(arg_0.getFunctionSpace());
2144          arg_0_Z =Data(arg_0);
2145        }
2146        else {
2147          throw DataException("Error - C_TensorBinaryOperation: arguments have incompatible function spaces.");
2148        }
2149      } else {
2150          arg_0_Z = Data(arg_0);
2151          arg_1_Z = Data(arg_1);
2152      }
2153      // Get rank and shape of inputs
2154      int rank0 = arg_0_Z.getDataPointRank();
2155      int rank1 = arg_1_Z.getDataPointRank();
2156      DataTypes::ShapeType shape0 = arg_0_Z.getDataPointShape();
2157      DataTypes::ShapeType shape1 = arg_1_Z.getDataPointShape();
2158      int size0 = arg_0_Z.getDataPointSize();
2159      int size1 = arg_1_Z.getDataPointSize();
2160      // Declare output Data object
2161      Data res;
2162    
2163      if (shape0 == shape1) {
2164        if (arg_0_Z.isConstant()   && arg_1_Z.isConstant()) {
2165          res = Data(0.0, shape0, arg_1_Z.getFunctionSpace());      // DataConstant output
2166          const double *ptr_0 = &(arg_0_Z.getDataAtOffsetRO(0));
2167          const double *ptr_1 = &(arg_1_Z.getDataAtOffsetRO(0));
2168          double *ptr_2 = &(res.getDataAtOffsetRW(0));
2169    
2170          tensor_binary_operation(size0, ptr_0, ptr_1, ptr_2, operation);
2171        }
2172        else if (arg_0_Z.isConstant()   && arg_1_Z.isTagged()) {
2173    
2174          // Prepare the DataConstant input
2175          DataConstant* tmp_0=dynamic_cast<DataConstant*>(arg_0_Z.borrowData());
2176    
2177          // Borrow DataTagged input from Data object
2178          DataTagged* tmp_1=dynamic_cast<DataTagged*>(arg_1_Z.borrowData());
2179    
2180          // Prepare a DataTagged output 2
2181          res = Data(0.0, shape0, arg_1_Z.getFunctionSpace());      // DataTagged output
2182          res.tag();
2183          DataTagged* tmp_2=dynamic_cast<DataTagged*>(res.borrowData());
2184    
2185          // Prepare offset into DataConstant
2186          int offset_0 = tmp_0->getPointOffset(0,0);
2187          const double *ptr_0 = &(arg_0_Z.getDataAtOffsetRO(offset_0));
2188    
2189          // Get the pointers to the actual data
2190          const double *ptr_1 = &(tmp_1->getDefaultValueRO(0));
2191          double *ptr_2 = &(tmp_2->getDefaultValueRW(0));
2192    
2193          // Compute a result for the default
2194          tensor_binary_operation(size0, ptr_0, ptr_1, ptr_2, operation);
2195          // Compute a result for each tag
2196          const DataTagged::DataMapType& lookup_1=tmp_1->getTagLookup();
2197          DataTagged::DataMapType::const_iterator i; // i->first is a tag, i->second is an offset into memory
2198          for (i=lookup_1.begin();i!=lookup_1.end();i++) {
2199            tmp_2->addTag(i->first);
2200            const double *ptr_1 = &(tmp_1->getDataByTagRO(i->first,0));
2201            double *ptr_2 = &(tmp_2->getDataByTagRW(i->first,0));
2202    
2203            tensor_binary_operation(size0, ptr_0, ptr_1, ptr_2, operation);
2204          }
2205    
2206        }
2207        else if (arg_0_Z.isConstant()   && arg_1_Z.isExpanded()) {
2208          res = Data(0.0, shape0, arg_1_Z.getFunctionSpace(),true); // DataExpanded output
2209          DataConstant* tmp_0=dynamic_cast<DataConstant*>(arg_0_Z.borrowData());
2210          DataExpanded* tmp_1=dynamic_cast<DataExpanded*>(arg_1_Z.borrowData());
2211          DataExpanded* tmp_2=dynamic_cast<DataExpanded*>(res.borrowData());
2212    
2213          int sampleNo_1,dataPointNo_1;
2214          int numSamples_1 = arg_1_Z.getNumSamples();
2215          int numDataPointsPerSample_1 = arg_1_Z.getNumDataPointsPerSample();
2216          int offset_0 = tmp_0->getPointOffset(0,0);
2217          res.requireWrite();
2218          #pragma omp parallel for private(sampleNo_1,dataPointNo_1) schedule(static)
2219          for (sampleNo_1 = 0; sampleNo_1 < numSamples_1; sampleNo_1++) {
2220            for (dataPointNo_1 = 0; dataPointNo_1 < numDataPointsPerSample_1; dataPointNo_1++) {
2221              int offset_1 = tmp_1->getPointOffset(sampleNo_1,dataPointNo_1);
2222              int offset_2 = tmp_2->getPointOffset(sampleNo_1,dataPointNo_1);
2223              const double *ptr_0 = &(arg_0_Z.getDataAtOffsetRO(offset_0));
2224              const double *ptr_1 = &(arg_1_Z.getDataAtOffsetRO(offset_1));
2225              double *ptr_2 = &(res.getDataAtOffsetRW(offset_2));
2226              tensor_binary_operation(size0, ptr_0, ptr_1, ptr_2, operation);
2227            }
2228          }
2229    
2230        }
2231        else if (arg_0_Z.isTagged()     && arg_1_Z.isConstant()) {
2232          // Borrow DataTagged input from Data object
2233          DataTagged* tmp_0=dynamic_cast<DataTagged*>(arg_0_Z.borrowData());
2234    
2235          // Prepare the DataConstant input
2236          DataConstant* tmp_1=dynamic_cast<DataConstant*>(arg_1_Z.borrowData());
2237    
2238          // Prepare a DataTagged output 2
2239          res = Data(0.0, shape0, arg_0_Z.getFunctionSpace());      // DataTagged output
2240          res.tag();
2241          DataTagged* tmp_2=dynamic_cast<DataTagged*>(res.borrowData());
2242    
2243          // Prepare offset into DataConstant
2244          int offset_1 = tmp_1->getPointOffset(0,0);
2245    
2246          const double *ptr_1 = &(arg_1_Z.getDataAtOffsetRO(offset_1));
2247          // Get the pointers to the actual data
2248          const double *ptr_0 = &(tmp_0->getDefaultValueRO(0));
2249          double *ptr_2 = &(tmp_2->getDefaultValueRW(0));
2250          // Compute a result for the default
2251          tensor_binary_operation(size0, ptr_0, ptr_1, ptr_2, operation);
2252          // Compute a result for each tag
2253          const DataTagged::DataMapType& lookup_0=tmp_0->getTagLookup();
2254          DataTagged::DataMapType::const_iterator i; // i->first is a tag, i->second is an offset into memory
2255          for (i=lookup_0.begin();i!=lookup_0.end();i++) {
2256            tmp_2->addTag(i->first);
2257            const double *ptr_0 = &(tmp_0->getDataByTagRO(i->first,0));
2258            double *ptr_2 = &(tmp_2->getDataByTagRW(i->first,0));
2259            tensor_binary_operation(size0, ptr_0, ptr_1, ptr_2, operation);
2260          }
2261    
2262        }
2263        else if (arg_0_Z.isTagged()     && arg_1_Z.isTagged()) {
2264          // Borrow DataTagged input from Data object
2265          DataTagged* tmp_0=dynamic_cast<DataTagged*>(arg_0_Z.borrowData());
2266    
2267          // Borrow DataTagged input from Data object
2268          DataTagged* tmp_1=dynamic_cast<DataTagged*>(arg_1_Z.borrowData());
2269    
2270          // Prepare a DataTagged output 2
2271          res = Data(0.0, shape0, arg_1_Z.getFunctionSpace());
2272          res.tag();        // DataTagged output
2273          DataTagged* tmp_2=dynamic_cast<DataTagged*>(res.borrowData());
2274    
2275          // Get the pointers to the actual data
2276          const double *ptr_0 = &(tmp_0->getDefaultValueRO(0));
2277          const double *ptr_1 = &(tmp_1->getDefaultValueRO(0));
2278          double *ptr_2 = &(tmp_2->getDefaultValueRW(0));
2279    
2280          // Compute a result for the default
2281          tensor_binary_operation(size0, ptr_0, ptr_1, ptr_2, operation);
2282          // Merge the tags
2283          DataTagged::DataMapType::const_iterator i; // i->first is a tag, i->second is an offset into memory
2284          const DataTagged::DataMapType& lookup_0=tmp_0->getTagLookup();
2285          const DataTagged::DataMapType& lookup_1=tmp_1->getTagLookup();
2286          for (i=lookup_0.begin();i!=lookup_0.end();i++) {
2287            tmp_2->addTag(i->first); // use tmp_2 to get correct shape
2288          }
2289          for (i=lookup_1.begin();i!=lookup_1.end();i++) {
2290            tmp_2->addTag(i->first);
2291          }
2292          // Compute a result for each tag
2293          const DataTagged::DataMapType& lookup_2=tmp_2->getTagLookup();
2294          for (i=lookup_2.begin();i!=lookup_2.end();i++) {
2295    
2296            const double *ptr_0 = &(tmp_0->getDataByTagRO(i->first,0));
2297            const double *ptr_1 = &(tmp_1->getDataByTagRO(i->first,0));
2298            double *ptr_2 = &(tmp_2->getDataByTagRW(i->first,0));
2299    
2300            tensor_binary_operation(size0, ptr_0, ptr_1, ptr_2, operation);
2301          }
2302    
2303        }
2304        else if (arg_0_Z.isTagged()     && arg_1_Z.isExpanded()) {
2305          // After finding a common function space above the two inputs have the same numSamples and num DPPS
2306          res = Data(0.0, shape0, arg_1_Z.getFunctionSpace(),true); // DataExpanded output
2307          DataTagged*   tmp_0=dynamic_cast<DataTagged*>(arg_0_Z.borrowData());
2308          DataExpanded* tmp_1=dynamic_cast<DataExpanded*>(arg_1_Z.borrowData());
2309          DataExpanded* tmp_2=dynamic_cast<DataExpanded*>(res.borrowData());
2310    
2311          int sampleNo_0,dataPointNo_0;
2312          int numSamples_0 = arg_0_Z.getNumSamples();
2313          int numDataPointsPerSample_0 = arg_0_Z.getNumDataPointsPerSample();
2314          res.requireWrite();
2315          #pragma omp parallel for private(sampleNo_0,dataPointNo_0) schedule(static)
2316          for (sampleNo_0 = 0; sampleNo_0 < numSamples_0; sampleNo_0++) {
2317            int offset_0 = tmp_0->getPointOffset(sampleNo_0,0); // They're all the same, so just use #0
2318            const double *ptr_0 = &(arg_0_Z.getDataAtOffsetRO(offset_0));
2319            for (dataPointNo_0 = 0; dataPointNo_0 < numDataPointsPerSample_0; dataPointNo_0++) {
2320              int offset_1 = tmp_1->getPointOffset(sampleNo_0,dataPointNo_0);
2321              int offset_2 = tmp_2->getPointOffset(sampleNo_0,dataPointNo_0);
2322              const double *ptr_1 = &(arg_1_Z.getDataAtOffsetRO(offset_1));
2323              double *ptr_2 = &(res.getDataAtOffsetRW(offset_2));
2324              tensor_binary_operation(size0, ptr_0, ptr_1, ptr_2, operation);
2325            }
2326          }
2327    
2328        }
2329        else if (arg_0_Z.isExpanded()   && arg_1_Z.isConstant()) {
2330          res = Data(0.0, shape0, arg_1_Z.getFunctionSpace(),true); // DataExpanded output
2331          DataExpanded* tmp_0=dynamic_cast<DataExpanded*>(arg_0_Z.borrowData());
2332          DataConstant* tmp_1=dynamic_cast<DataConstant*>(arg_1_Z.borrowData());
2333          DataExpanded* tmp_2=dynamic_cast<DataExpanded*>(res.borrowData());
2334    
2335          int sampleNo_0,dataPointNo_0;
2336          int numSamples_0 = arg_0_Z.getNumSamples();
2337          int numDataPointsPerSample_0 = arg_0_Z.getNumDataPointsPerSample();
2338          int offset_1 = tmp_1->getPointOffset(0,0);
2339          res.requireWrite();
2340          #pragma omp parallel for private(sampleNo_0,dataPointNo_0) schedule(static)
2341          for (sampleNo_0 = 0; sampleNo_0 < numSamples_0; sampleNo_0++) {
2342            for (dataPointNo_0 = 0; dataPointNo_0 < numDataPointsPerSample_0; dataPointNo_0++) {
2343              int offset_0 = tmp_0->getPointOffset(sampleNo_0,dataPointNo_0);
2344              int offset_2 = tmp_2->getPointOffset(sampleNo_0,dataPointNo_0);
2345    
2346              const double *ptr_0 = &(arg_0_Z.getDataAtOffsetRO(offset_0));
2347              const double *ptr_1 = &(arg_1_Z.getDataAtOffsetRO(offset_1));
2348              double *ptr_2 = &(res.getDataAtOffsetRW(offset_2));
2349    
2350    
2351              tensor_binary_operation(size0, ptr_0, ptr_1, ptr_2, operation);
2352            }
2353          }
2354    
2355        }
2356        else if (arg_0_Z.isExpanded()   && arg_1_Z.isTagged()) {
2357          // After finding a common function space above the two inputs have the same numSamples and num DPPS
2358          res = Data(0.0, shape0, arg_1_Z.getFunctionSpace(),true); // DataExpanded output
2359          DataExpanded* tmp_0=dynamic_cast<DataExpanded*>(arg_0_Z.borrowData());
2360          DataTagged*   tmp_1=dynamic_cast<DataTagged*>(arg_1_Z.borrowData());
2361          DataExpanded* tmp_2=dynamic_cast<DataExpanded*>(res.borrowData());
2362    
2363          int sampleNo_0,dataPointNo_0;
2364          int numSamples_0 = arg_0_Z.getNumSamples();
2365          int numDataPointsPerSample_0 = arg_0_Z.getNumDataPointsPerSample();
2366          res.requireWrite();
2367          #pragma omp parallel for private(sampleNo_0,dataPointNo_0) schedule(static)
2368          for (sampleNo_0 = 0; sampleNo_0 < numSamples_0; sampleNo_0++) {
2369            int offset_1 = tmp_1->getPointOffset(sampleNo_0,0);
2370            const double *ptr_1 = &(arg_1_Z.getDataAtOffsetRO(offset_1));
2371            for (dataPointNo_0 = 0; dataPointNo_0 < numDataPointsPerSample_0; dataPointNo_0++) {
2372              int offset_0 = tmp_0->getPointOffset(sampleNo_0,dataPointNo_0);
2373              int offset_2 = tmp_2->getPointOffset(sampleNo_0,dataPointNo_0);
2374              const double *ptr_0 = &(arg_0_Z.getDataAtOffsetRO(offset_0));
2375              double *ptr_2 = &(res.getDataAtOffsetRW(offset_2));
2376              tensor_binary_operation(size0, ptr_0, ptr_1, ptr_2, operation);
2377            }
2378          }
2379    
2380        }
2381        else if (arg_0_Z.isExpanded()   && arg_1_Z.isExpanded()) {
2382          // After finding a common function space above the two inputs have the same numSamples and num DPPS
2383          res = Data(0.0, shape0, arg_1_Z.getFunctionSpace(),true); // DataExpanded output
2384          DataExpanded* tmp_0=dynamic_cast<DataExpanded*>(arg_0_Z.borrowData());
2385          DataExpanded* tmp_1=dynamic_cast<DataExpanded*>(arg_1_Z.borrowData());
2386          DataExpanded* tmp_2=dynamic_cast<DataExpanded*>(res.borrowData());
2387    
2388          int sampleNo_0,dataPointNo_0;
2389          int numSamples_0 = arg_0_Z.getNumSamples();
2390          int numDataPointsPerSample_0 = arg_0_Z.getNumDataPointsPerSample();
2391          res.requireWrite();
2392          #pragma omp parallel for private(sampleNo_0,dataPointNo_0) schedule(static)
2393          for (sampleNo_0 = 0; sampleNo_0 < numSamples_0; sampleNo_0++) {
2394            for (dataPointNo_0 = 0; dataPointNo_0 < numDataPointsPerSample_0; dataPointNo_0++) {
2395              int offset_0 = tmp_0->getPointOffset(sampleNo_0,dataPointNo_0);
2396              int offset_1 = tmp_1->getPointOffset(sampleNo_0,dataPointNo_0);
2397              int offset_2 = tmp_2->getPointOffset(sampleNo_0,dataPointNo_0);
2398              const double *ptr_0 = &(arg_0_Z.getDataAtOffsetRO(offset_0));
2399              const double *ptr_1 = &(arg_1_Z.getDataAtOffsetRO(offset_1));
2400              double *ptr_2 = &(res.getDataAtOffsetRW(offset_2));
2401              tensor_binary_operation(size0, ptr_0, ptr_1, ptr_2, operation);
2402            }
2403          }
2404    
2405        }
2406        else {
2407          throw DataException("Error - C_TensorBinaryOperation: unknown combination of inputs");
2408        }
2409    
2410      } else if (0 == rank0) {
2411        if (arg_0_Z.isConstant()   && arg_1_Z.isConstant()) {
2412          res = Data(0.0, shape1, arg_1_Z.getFunctionSpace());      // DataConstant output
2413          const double *ptr_0 = &(arg_0_Z.getDataAtOffsetRO(0));
2414          const double *ptr_1 = &(arg_1_Z.getDataAtOffsetRO(0));
2415          double *ptr_2 = &(res.getDataAtOffsetRW(0));
2416          tensor_binary_operation(size1, ptr_0[0], ptr_1, ptr_2, operation);
2417        }
2418        else if (arg_0_Z.isConstant()   && arg_1_Z.isTagged()) {
2419    
2420          // Prepare the DataConstant input
2421          DataConstant* tmp_0=dynamic_cast<DataConstant*>(arg_0_Z.borrowData());
2422    
2423          // Borrow DataTagged input from Data object
2424          DataTagged* tmp_1=dynamic_cast<DataTagged*>(arg_1_Z.borrowData());
2425    
2426          // Prepare a DataTagged output 2
2427          res = Data(0.0, shape1, arg_1_Z.getFunctionSpace());      // DataTagged output
2428          res.tag();
2429          DataTagged* tmp_2=dynamic_cast<DataTagged*>(res.borrowData());
2430    
2431          // Prepare offset into DataConstant
2432          int offset_0 = tmp_0->getPointOffset(0,0);
2433          const double *ptr_0 = &(arg_0_Z.getDataAtOffsetRO(offset_0));
2434    
2435          const double *ptr_1 = &(tmp_1->getDefaultValueRO(0));
2436          double *ptr_2 = &(tmp_2->getDefaultValueRW(0));
2437    
2438          // Compute a result for the default
2439          tensor_binary_operation(size1, ptr_0[0], ptr_1, ptr_2, operation);
2440          // Compute a result for each tag
2441          const DataTagged::DataMapType& lookup_1=tmp_1->getTagLookup();
2442          DataTagged::DataMapType::const_iterator i; // i->first is a tag, i->second is an offset into memory
2443          for (i=lookup_1.begin();i!=lookup_1.end();i++) {
2444            tmp_2->addTag(i->first);
2445            const double *ptr_1 = &(tmp_1->getDataByTagRO(i->first,0));
2446            double *ptr_2 = &(tmp_2->getDataByTagRW(i->first,0));
2447            tensor_binary_operation(size1, ptr_0[0], ptr_1, ptr_2, operation);
2448          }
2449    
2450        }
2451        else if (arg_0_Z.isConstant()   && arg_1_Z.isExpanded()) {
2452    
2453          res = Data(0.0, shape1, arg_1_Z.getFunctionSpace(),true); // DataExpanded output
2454          DataConstant* tmp_0=dynamic_cast<DataConstant*>(arg_0_Z.borrowData());
2455          DataExpanded* tmp_1=dynamic_cast<DataExpanded*>(arg_1_Z.borrowData());
2456          DataExpanded* tmp_2=dynamic_cast<DataExpanded*>(res.borrowData());
2457    
2458          int sampleNo_1,dataPointNo_1;
2459          int numSamples_1 = arg_1_Z.getNumSamples();
2460          int numDataPointsPerSample_1 = arg_1_Z.getNumDataPointsPerSample();
2461          int offset_0 = tmp_0->getPointOffset(0,0);
2462          res.requireWrite();
2463          #pragma omp parallel for private(sampleNo_1,dataPointNo_1) schedule(static)
2464          for (sampleNo_1 = 0; sampleNo_1 < numSamples_1; sampleNo_1++) {
2465            for (dataPointNo_1 = 0; dataPointNo_1 < numDataPointsPerSample_1; dataPointNo_1++) {
2466              int offset_1 = tmp_1->getPointOffset(sampleNo_1,dataPointNo_1);
2467              int offset_2 = tmp_2->getPointOffset(sampleNo_1,dataPointNo_1);
2468              const double *ptr_0 = &(arg_0_Z.getDataAtOffsetRO(offset_0));
2469              const double *ptr_1 = &(arg_1_Z.getDataAtOffsetRO(offset_1));
2470              double *ptr_2 = &(res.getDataAtOffsetRW(offset_2));
2471              tensor_binary_operation(size1, ptr_0[0], ptr_1, ptr_2, operation);
2472    
2473            }
2474          }
2475    
2476        }
2477        else if (arg_0_Z.isTagged()     && arg_1_Z.isConstant()) {
2478    
2479          // Borrow DataTagged input from Data object
2480          DataTagged* tmp_0=dynamic_cast<DataTagged*>(arg_0_Z.borrowData());
2481    
2482          // Prepare the DataConstant input
2483          DataConstant* tmp_1=dynamic_cast<DataConstant*>(arg_1_Z.borrowData());
2484    
2485          // Prepare a DataTagged output 2
2486          res = Data(0.0, shape1, arg_0_Z.getFunctionSpace());      // DataTagged output
2487          res.tag();
2488          DataTagged* tmp_2=dynamic_cast<DataTagged*>(res.borrowData());
2489    
2490          // Prepare offset into DataConstant
2491          int offset_1 = tmp_1->getPointOffset(0,0);
2492          const double *ptr_1 = &(arg_1_Z.getDataAtOffsetRO(offset_1));
2493    
2494          // Get the pointers to the actual data
2495          const double *ptr_0 = &(tmp_0->getDefaultValueRO(0));
2496          double *ptr_2 = &(tmp_2->getDefaultValueRW(0));
2497    
2498    
2499          // Compute a result for the default
2500          tensor_binary_operation(size1, ptr_0[0], ptr_1, ptr_2, operation);
2501          // Compute a result for each tag
2502          const DataTagged::DataMapType& lookup_0=tmp_0->getTagLookup();
2503          DataTagged::DataMapType::const_iterator i; // i->first is a tag, i->second is an offset into memory
2504          for (i=lookup_0.begin();i!=lookup_0.end();i++) {
2505            tmp_2->addTag(i->first);
2506            const double *ptr_0 = &(tmp_0->getDataByTagRO(i->first,0));
2507            double *ptr_2 = &(tmp_2->getDataByTagRW(i->first,0));
2508    
2509            tensor_binary_operation(size1, ptr_0[0], ptr_1, ptr_2, operation);
2510          }
2511    
2512        }
2513        else if (arg_0_Z.isTagged()     && arg_1_Z.isTagged()) {
2514    
2515          // Borrow DataTagged input from Data object
2516          DataTagged* tmp_0=dynamic_cast<DataTagged*>(arg_0_Z.borrowData());
2517    
2518          // Borrow DataTagged input from Data object
2519          DataTagged* tmp_1=dynamic_cast<DataTagged*>(arg_1_Z.borrowData());
2520    
2521          // Prepare a DataTagged output 2
2522          res = Data(0.0, shape1, arg_1_Z.getFunctionSpace());
2523          res.tag();        // DataTagged output
2524          DataTagged* tmp_2=dynamic_cast<DataTagged*>(res.borrowData());
2525    
2526          // Get the pointers to the actual data
2527          const double *ptr_0 = &(tmp_0->getDefaultValueRO(0));
2528          const double *ptr_1 = &(tmp_1->getDefaultValueRO(0));
2529          double *ptr_2 = &(tmp_2->getDefaultValueRW(0));
2530    
2531          // Compute a result for the default
2532          tensor_binary_operation(size1, ptr_0[0], ptr_1, ptr_2, operation);
2533          // Merge the tags
2534          DataTagged::DataMapType::const_iterator i; // i->first is a tag, i->second is an offset into memory
2535          const DataTagged::DataMapType& lookup_0=tmp_0->getTagLookup();
2536          const DataTagged::DataMapType& lookup_1=tmp_1->getTagLookup();
2537          for (i=lookup_0.begin();i!=lookup_0.end();i++) {
2538            tmp_2->addTag(i->first); // use tmp_2 to get correct shape
2539          }
2540          for (i=lookup_1.begin();i!=lookup_1.end();i++) {
2541            tmp_2->addTag(i->first);
2542          }
2543          // Compute a result for each tag
2544          const DataTagged::DataMapType& lookup_2=tmp_2->getTagLookup();
2545          for (i=lookup_2.begin();i!=lookup_2.end();i++) {
2546            const double *ptr_0 = &(tmp_0->getDataByTagRO(i->first,0));
2547            const double *ptr_1 = &(tmp_1->getDataByTagRO(i->first,0));
2548            double *ptr_2 = &(tmp_2->getDataByTagRW(i->first,0));
2549    
2550            tensor_binary_operation(size1, ptr_0[0], ptr_1, ptr_2, operation);
2551          }
2552    
2553        }
2554        else if (arg_0_Z.isTagged()     && arg_1_Z.isExpanded()) {
2555    
2556          // After finding a common function space above the two inputs have the same numSamples and num DPPS
2557          res = Data(0.0, shape1, arg_1_Z.getFunctionSpace(),true); // DataExpanded output
2558          DataTagged*   tmp_0=dynamic_cast<DataTagged*>(arg_0_Z.borrowData());
2559          DataExpanded* tmp_1=dynamic_cast<DataExpanded*>(arg_1_Z.borrowData());
2560          DataExpanded* tmp_2=dynamic_cast<DataExpanded*>(res.borrowData());
2561    
2562          int sampleNo_0,dataPointNo_0;
2563          int numSamples_0 = arg_0_Z.getNumSamples();
2564          int numDataPointsPerSample_0 = arg_0_Z.getNumDataPointsPerSample();
2565          res.requireWrite();
2566          #pragma omp parallel for private(sampleNo_0,dataPointNo_0) schedule(static)
2567          for (sampleNo_0 = 0; sampleNo_0 < numSamples_0; sampleNo_0++) {
2568            int offset_0 = tmp_0->getPointOffset(sampleNo_0,0); // They're all the same, so just use #0
2569            const double *ptr_0 = &(arg_0_Z.getDataAtOffsetRO(offset_0));
2570            for (dataPointNo_0 = 0; dataPointNo_0 < numDataPointsPerSample_0; dataPointNo_0++) {
2571              int offset_1 = tmp_1->getPointOffset(sampleNo_0,dataPointNo_0);
2572              int offset_2 = tmp_2->getPointOffset(sampleNo_0,dataPointNo_0);
2573              const double *ptr_1 = &(arg_1_Z.getDataAtOffsetRO(offset_1));
2574              double *ptr_2 = &(res.getDataAtOffsetRW(offset_2));
2575              tensor_binary_operation(size1, ptr_0[0], ptr_1, ptr_2, operation);
2576            }
2577          }
2578    
2579        }
2580        else if (arg_0_Z.isExpanded()   && arg_1_Z.isConstant()) {
2581          res = Data(0.0, shape1, arg_1_Z.getFunctionSpace(),true); // DataExpanded output
2582          DataExpanded* tmp_0=dynamic_cast<DataExpanded*>(arg_0_Z.borrowData());
2583          DataConstant* tmp_1=dynamic_cast<DataConstant*>(arg_1_Z.borrowData());
2584          DataExpanded* tmp_2=dynamic_cast<DataExpanded*>(res.borrowData());
2585    
2586          int sampleNo_0,dataPointNo_0;
2587          int numSamples_0 = arg_0_Z.getNumSamples();
2588          int numDataPointsPerSample_0 = arg_0_Z.getNumDataPointsPerSample();
2589          int offset_1 = tmp_1->getPointOffset(0,0);
2590          res.requireWrite();
2591          #pragma omp parallel for private(sampleNo_0,dataPointNo_0) schedule(static)
2592          for (sampleNo_0 = 0; sampleNo_0 < numSamples_0; sampleNo_0++) {
2593            for (dataPointNo_0 = 0; dataPointNo_0 < numDataPointsPerSample_0; dataPointNo_0++) {
2594              int offset_0 = tmp_0->getPointOffset(sampleNo_0,dataPointNo_0);
2595              int offset_2 = tmp_2->getPointOffset(sampleNo_0,dataPointNo_0);
2596              const double *ptr_0 = &(arg_0_Z.getDataAtOffsetRO(offset_0));
2597              const double *ptr_1 = &(arg_1_Z.getDataAtOffsetRO(offset_1));
2598              double *ptr_2 = &(res.getDataAtOffsetRW(offset_2));
2599              tensor_binary_operation(size1, ptr_0[0], ptr_1, ptr_2, operation);
2600            }
2601          }
2602    
2603    
2604        }
2605        else if (arg_0_Z.isExpanded()   && arg_1_Z.isTagged()) {
2606    
2607          // After finding a common function space above the two inputs have the same numSamples and num DPPS
2608          res = Data(0.0, shape1, arg_1_Z.getFunctionSpace(),true); // DataExpanded output
2609          DataExpanded* tmp_0=dynamic_cast<DataExpanded*>(arg_0_Z.borrowData());
2610          DataTagged*   tmp_1=dynamic_cast<DataTagged*>(arg_1_Z.borrowData());
2611          DataExpanded* tmp_2=dynamic_cast<DataExpanded*>(res.borrowData());
2612    
2613          int sampleNo_0,dataPointNo_0;
2614          int numSamples_0 = arg_0_Z.getNumSamples();
2615          int numDataPointsPerSample_0 = arg_0_Z.getNumDataPointsPerSample();
2616          res.requireWrite();
2617          #pragma omp parallel for private(sampleNo_0,dataPointNo_0) schedule(static)
2618          for (sampleNo_0 = 0; sampleNo_0 < numSamples_0; sampleNo_0++) {
2619            int offset_1 = tmp_1->getPointOffset(sampleNo_0,0);
2620            const double *ptr_1 = &(arg_1_Z.getDataAtOffsetRO(offset_1));
2621            for (dataPointNo_0 = 0; dataPointNo_0 < numDataPointsPerSample_0; dataPointNo_0++) {
2622              int offset_0 = tmp_0->getPointOffset(sampleNo_0,dataPointNo_0);
2623              int offset_2 = tmp_2->getPointOffset(sampleNo_0,dataPointNo_0);
2624              const double *ptr_0 = &(arg_0_Z.getDataAtOffsetRO(offset_0));
2625              double *ptr_2 = &(res.getDataAtOffsetRW(offset_2));
2626              tensor_binary_operation(size1, ptr_0[0], ptr_1, ptr_2, operation);
2627            }
2628          }
2629    
2630        }
2631        else if (arg_0_Z.isExpanded()   && arg_1_Z.isExpanded()) {
2632    
2633          // After finding a common function space above the two inputs have the same numSamples and num DPPS
2634          res = Data(0.0, shape1, arg_1_Z.getFunctionSpace(),true); // DataExpanded output
2635          DataExpanded* tmp_0=dynamic_cast<DataExpanded*>(arg_0_Z.borrowData());
2636          DataExpanded* tmp_1=dynamic_cast<DataExpanded*>(arg_1_Z.borrowData());
2637          DataExpanded* tmp_2=dynamic_cast<DataExpanded*>(res.borrowData());
2638    
2639          int sampleNo_0,dataPointNo_0;
2640          int numSamples_0 = arg_0_Z.getNumSamples();
2641          int numDataPointsPerSample_0 = arg_0_Z.getNumDataPointsPerSample();
2642          res.requireWrite();
2643          #pragma omp parallel for private(sampleNo_0,dataPointNo_0) schedule(static)
2644          for (sampleNo_0 = 0; sampleNo_0 < numSamples_0; sampleNo_0++) {
2645            for (dataPointNo_0 = 0; dataPointNo_0 < numDataPointsPerSample_0; dataPointNo_0++) {
2646              int offset_0 = tmp_0->getPointOffset(sampleNo_0,dataPointNo_0);
2647              int offset_1 = tmp_1->getPointOffset(sampleNo_0,dataPointNo_0);
2648              int offset_2 = tmp_2->getPointOffset(sampleNo_0,dataPointNo_0);
2649              const double *ptr_0 = &(arg_0_Z.getDataAtOffsetRO(offset_0));
2650              const double *ptr_1 = &(arg_1_Z.getDataAtOffsetRO(offset_1));
2651              double *ptr_2 = &(res.getDataAtOffsetRW(offset_2));
2652              tensor_binary_operation(size1, ptr_0[0], ptr_1, ptr_2, operation);
2653            }
2654          }
2655    
2656        }
2657        else {
2658          throw DataException("Error - C_TensorBinaryOperation: unknown combination of inputs");
2659        }
2660    
2661      } else if (0 == rank1) {
2662        if (arg_0_Z.isConstant()   && arg_1_Z.isConstant()) {
2663          res = Data(0.0, shape0, arg_1_Z.getFunctionSpace());      // DataConstant output
2664          const double *ptr_0 = &(arg_0_Z.getDataAtOffsetRO(0));
2665          const double *ptr_1 = &(arg_1_Z.getDataAtOffsetRO(0));
2666          double *ptr_2 = &(res.getDataAtOffsetRW(0));
2667          tensor_binary_operation(size0, ptr_0, ptr_1[0], ptr_2, operation);
2668        }
2669        else if (arg_0_Z.isConstant()   && arg_1_Z.isTagged()) {
2670    
2671          // Prepare the DataConstant input
2672          DataConstant* tmp_0=dynamic_cast<DataConstant*>(arg_0_Z.borrowData());
2673    
2674          // Borrow DataTagged input from Data object
2675          DataTagged* tmp_1=dynamic_cast<DataTagged*>(arg_1_Z.borrowData());
2676    
2677          // Prepare a DataTagged output 2
2678          res = Data(0.0, shape0, arg_1_Z.getFunctionSpace());      // DataTagged output
2679          res.tag();
2680          DataTagged* tmp_2=dynamic_cast<DataTagged*>(res.borrowData());
2681    
2682          // Prepare offset into DataConstant
2683          int offset_0 = tmp_0->getPointOffset(0,0);
2684          const double *ptr_0 = &(arg_0_Z.getDataAtOffsetRO(offset_0));
2685    
2686          //Get the pointers to the actual data
2687          const double *ptr_1 = &(tmp_1->getDefaultValueRO(0));
2688          double *ptr_2 = &(tmp_2->getDefaultValueRW(0));
2689    
2690          // Compute a result for the default
2691          tensor_binary_operation(size0, ptr_0, ptr_1[0], ptr_2, operation);
2692          // Compute a result for each tag
2693          const DataTagged::DataMapType& lookup_1=tmp_1->getTagLookup();
2694          DataTagged::DataMapType::const_iterator i; // i->first is a tag, i->second is an offset into memory
2695          for (i=lookup_1.begin();i!=lookup_1.end();i++) {
2696            tmp_2->addTag(i->first);
2697            const double *ptr_1 = &(tmp_1->getDataByTagRO(i->first,0));
2698            double *ptr_2 = &(tmp_2->getDataByTagRW(i->first,0));
2699            tensor_binary_operation(size0, ptr_0, ptr_1[0], ptr_2, operation);
2700          }
2701        }
2702        else if (arg_0_Z.isConstant()   && arg_1_Z.isExpanded()) {
2703    
2704          res = Data(0.0, shape0, arg_1_Z.getFunctionSpace(),true); // DataExpanded output
2705          DataConstant* tmp_0=dynamic_cast<DataConstant*>(arg_0_Z.borrowData());
2706          DataExpanded* tmp_1=dynamic_cast<DataExpanded*>(arg_1_Z.borrowData());
2707          DataExpanded* tmp_2=dynamic_cast<DataExpanded*>(res.borrowData());
2708    
2709          int sampleNo_1,dataPointNo_1;
2710          int numSamples_1 = arg_1_Z.getNumSamples();
2711          int numDataPointsPerSample_1 = arg_1_Z.getNumDataPointsPerSample();
2712          int offset_0 = tmp_0->getPointOffset(0,0);
2713          res.requireWrite();
2714          #pragma omp parallel for private(sampleNo_1,dataPointNo_1) schedule(static)
2715          for (sampleNo_1 = 0; sampleNo_1 < numSamples_1; sampleNo_1++) {
2716            for (dataPointNo_1 = 0; dataPointNo_1 < numDataPointsPerSample_1; dataPointNo_1++) {
2717              int offset_1 = tmp_1->getPointOffset(sampleNo_1,dataPointNo_1);
2718              int offset_2 = tmp_2->getPointOffset(sampleNo_1,dataPointNo_1);
2719              const double *ptr_0 = &(arg_0_Z.getDataAtOffsetRO(offset_0));
2720              const double *ptr_1 = &(arg_1_Z.getDataAtOffsetRO(offset_1));
2721              double *ptr_2 = &(res.getDataAtOffsetRW(offset_2));
2722              tensor_binary_operation(size0, ptr_0, ptr_1[0], ptr_2, operation);
2723            }
2724          }
2725    
2726        }
2727        else if (arg_0_Z.isTagged()     && arg_1_Z.isConstant()) {
2728    
2729          // Borrow DataTagged input from Data object
2730          DataTagged* tmp_0=dynamic_cast<DataTagged*>(arg_0_Z.borrowData());
2731    
2732          // Prepare the DataConstant input
2733          DataConstant* tmp_1=dynamic_cast<DataConstant*>(arg_1_Z.borrowData());
2734    
2735          // Prepare a DataTagged output 2
2736          res = Data(0.0, shape0, arg_0_Z.getFunctionSpace());      // DataTagged output
2737          res.tag();
2738          DataTagged* tmp_2=dynamic_cast<DataTagged*>(res.borrowData());
2739    
2740          // Prepare offset into DataConstant
2741          int offset_1 = tmp_1->getPointOffset(0,0);
2742          const double *ptr_1 = &(arg_1_Z.getDataAtOffsetRO(offset_1));
2743          // Get the pointers to the actual data
2744          const double *ptr_0 = &(tmp_0->getDefaultValueRO(0));
2745          double *ptr_2 = &(tmp_2->getDefaultValueRW(0));
2746          // Compute a result for the default
2747          tensor_binary_operation(size0, ptr_0, ptr_1[0], ptr_2, operation);
2748          // Compute a result for each tag
2749          const DataTagged::DataMapType& lookup_0=tmp_0->getTagLookup();
2750          DataTagged::DataMapType::const_iterator i; // i->first is a tag, i->second is an offset into memory
2751          for (i=lookup_0.begin();i!=lookup_0.end();i++) {
2752            tmp_2->addTag(i->first);
2753            const double *ptr_0 = &(tmp_0->getDataByTagRO(i->first,0));
2754            double *ptr_2 = &(tmp_2->getDataByTagRW(i->first,0));
2755            tensor_binary_operation(size0, ptr_0, ptr_1[0], ptr_2, operation);
2756          }
2757    
2758        }
2759        else if (arg_0_Z.isTagged()     && arg_1_Z.isTagged()) {
2760    
2761          // Borrow DataTagged input from Data object
2762          DataTagged* tmp_0=dynamic_cast<DataTagged*>(arg_0_Z.borrowData());
2763    
2764          // Borrow DataTagged input from Data object
2765          DataTagged* tmp_1=dynamic_cast<DataTagged*>(arg_1_Z.borrowData());
2766    
2767          // Prepare a DataTagged output 2
2768          res = Data(0.0, shape0, arg_1_Z.getFunctionSpace());
2769          res.tag();        // DataTagged output
2770          DataTagged* tmp_2=dynamic_cast<DataTagged*>(res.borrowData());
2771    
2772          // Get the pointers to the actual data
2773          const double *ptr_0 = &(tmp_0->getDefaultValueRO(0));
2774          const double *ptr_1 = &(tmp_1->getDefaultValueRO(0));
2775          double *ptr_2 = &(tmp_2->getDefaultValueRW(0));
2776    
2777          // Compute a result for the default
2778          tensor_binary_operation(size0, ptr_0, ptr_1[0], ptr_2, operation);
2779          // Merge the tags
2780          DataTagged::DataMapType::const_iterator i; // i->first is a tag, i->second is an offset into memory
2781          const DataTagged::DataMapType& lookup_0=tmp_0->getTagLookup();
2782          const DataTagged::DataMapType& lookup_1=tmp_1->getTagLookup();
2783          for (i=lookup_0.begin();i!=lookup_0.end();i++) {
2784            tmp_2->addTag(i->first); // use tmp_2 to get correct shape
2785          }
2786          for (i=lookup_1.begin();i!=lookup_1.end();i++) {
2787            tmp_2->addTag(i->first);
2788          }
2789          // Compute a result for each tag
2790          const DataTagged::DataMapType& lookup_2=tmp_2->getTagLookup();
2791          for (i=lookup_2.begin();i!=lookup_2.end();i++) {
2792            const double *ptr_0 = &(tmp_0->getDataByTagRO(i->first,0));
2793            const double *ptr_1 = &(tmp_1->getDataByTagRO(i->first,0));
2794            double *ptr_2 = &(tmp_2->getDataByTagRW(i->first,0));
2795            tensor_binary_operation(size0, ptr_0, ptr_1[0], ptr_2, operation);
2796          }
2797    
2798        }
2799        else if (arg_0_Z.isTagged()     && arg_1_Z.isExpanded()) {
2800    
2801          // After finding a common function space above the two inputs have the same numSamples and num DPPS
2802          res = Data(0.0, shape0, arg_1_Z.getFunctionSpace(),true); // DataExpanded output
2803          DataTagged*   tmp_0=dynamic_cast<DataTagged*>(arg_0_Z.borrowData());
2804          DataExpanded* tmp_1=dynamic_cast<DataExpanded*>(arg_1_Z.borrowData());
2805          DataExpanded* tmp_2=dynamic_cast<DataExpanded*>(res.borrowData());
2806    
2807          int sampleNo_0,dataPointNo_0;
2808          int numSamples_0 = arg_0_Z.getNumSamples();
2809          int numDataPointsPerSample_0 = arg_0_Z.getNumDataPointsPerSample();
2810          res.requireWrite();
2811          #pragma omp parallel for private(sampleNo_0,dataPointNo_0) schedule(static)
2812          for (sampleNo_0 = 0; sampleNo_0 < numSamples_0; sampleNo_0++) {
2813            int offset_0 = tmp_0->getPointOffset(sampleNo_0,0); // They're all the same, so just use #0
2814            const double *ptr_0 = &(arg_0_Z.getDataAtOffsetRO(offset_0));
2815            for (dataPointNo_0 = 0; dataPointNo_0 < numDataPointsPerSample_0; dataPointNo_0++) {
2816              int offset_1 = tmp_1->getPointOffset(sampleNo_0,dataPointNo_0);
2817              int offset_2 = tmp_2->getPointOffset(sampleNo_0,dataPointNo_0);
2818              const double *ptr_1 = &(arg_1_Z.getDataAtOffsetRO(offset_1));
2819              double *ptr_2 = &(res.getDataAtOffsetRW(offset_2));
2820              tensor_binary_operation(size0, ptr_0, ptr_1[0], ptr_2, operation);
2821            }
2822          }
2823    
2824        }
2825        else if (arg_0_Z.isExpanded()   && arg_1_Z.isConstant()) {
2826          res = Data(0.0, shape0, arg_1_Z.getFunctionSpace(),true); // DataExpanded output
2827          DataExpanded* tmp_0=dynamic_cast<DataExpanded*>(arg_0_Z.borrowData());
2828          DataConstant* tmp_1=dynamic_cast<DataConstant*>(arg_1_Z.borrowData());
2829          DataExpanded* tmp_2=dynamic_cast<DataExpanded*>(res.borrowData());
2830    
2831          int sampleNo_0,dataPointNo_0;
2832          int numSamples_0 = arg_0_Z.getNumSamples();
2833          int numDataPointsPerSample_0 = arg_0_Z.getNumDataPointsPerSample();
2834          int offset_1 = tmp_1->getPointOffset(0,0);
2835          res.requireWrite();
2836          #pragma omp parallel for private(sampleNo_0,dataPointNo_0) schedule(static)
2837          for (sampleNo_0 = 0; sampleNo_0 < numSamples_0; sampleNo_0++) {
2838            for (dataPointNo_0 = 0; dataPointNo_0 < numDataPointsPerSample_0; dataPointNo_0++) {
2839              int offset_0 = tmp_0->getPointOffset(sampleNo_0,dataPointNo_0);
2840              int offset_2 = tmp_2->getPointOffset(sampleNo_0,dataPointNo_0);
2841              const double *ptr_0 = &(arg_0_Z.getDataAtOffsetRO(offset_0));
2842              const double *ptr_1 = &(arg_1_Z.getDataAtOffsetRO(offset_1));
2843              double *ptr_2 = &(res.getDataAtOffsetRW(offset_2));
2844              tensor_binary_operation(size0, ptr_0, ptr_1[0], ptr_2, operation);
2845            }
2846          }
2847    
2848    
2849        }
2850        else if (arg_0_Z.isExpanded()   && arg_1_Z.isTagged()) {
2851    
2852          // After finding a common function space above the two inputs have the same numSamples and num DPPS
2853          res = Data(0.0, shape0, arg_1_Z.getFunctionSpace(),true); // DataExpanded output
2854          DataExpanded* tmp_0=dynamic_cast<DataExpanded*>(arg_0_Z.borrowData());
2855          DataTagged*   tmp_1=dynamic_cast<DataTagged*>(arg_1_Z.borrowData());
2856          DataExpanded* tmp_2=dynamic_cast<DataExpanded*>(res.borrowData());
2857    
2858          int sampleNo_0,dataPointNo_0;
2859          int numSamples_0 = arg_0_Z.getNumSamples();
2860          int numDataPointsPerSample_0 = arg_0_Z.getNumDataPointsPerSample();
2861          res.requireWrite();
2862          #pragma omp parallel for private(sampleNo_0,dataPointNo_0) schedule(static)
2863          for (sampleNo_0 = 0; sampleNo_0 < numSamples_0; sampleNo_0++) {
2864            int offset_1 = tmp_1->getPointOffset(sampleNo_0,0);
2865            const double *ptr_1 = &(arg_1_Z.getDataAtOffsetRO(offset_1));
2866            for (dataPointNo_0 = 0; dataPointNo_0 < numDataPointsPerSample_0; dataPointNo_0++) {
2867              int offset_0 = tmp_0->getPointOffset(sampleNo_0,dataPointNo_0);
2868              int offset_2 = tmp_2->getPointOffset(sampleNo_0,dataPointNo_0);
2869              const double *ptr_0 = &(arg_0_Z.getDataAtOffsetRO(offset_0));
2870              double *ptr_2 = &(res.getDataAtOffsetRW(offset_2));
2871              tensor_binary_operation(size0, ptr_0, ptr_1[0], ptr_2, operation);
2872            }
2873          }
2874    
2875        }
2876        else if (arg_0_Z.isExpanded()   && arg_1_Z.isExpanded()) {
2877    
2878          // After finding a common function space above the two inputs have the same numSamples and num DPPS
2879          res = Data(0.0, shape0, arg_1_Z.getFunctionSpace(),true); // DataExpanded output
2880          DataExpanded* tmp_0=dynamic_cast<DataExpanded*>(arg_0_Z.borrowData());
2881          DataExpanded* tmp_1=dynamic_cast<DataExpanded*>(arg_1_Z.borrowData());
2882          DataExpanded* tmp_2=dynamic_cast<DataExpanded*>(res.borrowData());
2883    
2884          int sampleNo_0,dataPointNo_0;
2885          int numSamples_0 = arg_0_Z.getNumSamples();
2886          int numDataPointsPerSample_0 = arg_0_Z.getNumDataPointsPerSample();
2887          res.requireWrite();
2888          #pragma omp parallel for private(sampleNo_0,dataPointNo_0) schedule(static)
2889          for (sampleNo_0 = 0; sampleNo_0 < numSamples_0; sampleNo_0++) {
2890            for (dataPointNo_0 = 0; dataPointNo_0 < numDataPointsPerSample_0; dataPointNo_0++) {
2891              int offset_0 = tmp_0->getPointOffset(sampleNo_0,dataPointNo_0);
2892              int offset_1 = tmp_1->getPointOffset(sampleNo_0,dataPointNo_0);
2893              int offset_2 = tmp_2->getPointOffset(sampleNo_0,dataPointNo_0);
2894              const double *ptr_0 = &(arg_0_Z.getDataAtOffsetRO(offset_0));
2895              const double *ptr_1 = &(arg_1_Z.getDataAtOffsetRO(offset_1));
2896              double *ptr_2 = &(res.getDataAtOffsetRW(offset_2));
2897              tensor_binary_operation(size0, ptr_0, ptr_1[0], ptr_2, operation);
2898            }
2899          }
2900    
2901        }
2902        else {
2903          throw DataException("Error - C_TensorBinaryOperation: unknown combination of inputs");
2904        }
2905    
2906      } else {
2907        throw DataException("Error - C_TensorBinaryOperation: arguments have incompatible shapes");
2908      }
2909    
2910      return res;
2911    }
2912    
2913    template <typename UnaryFunction>
2914    Data
2915    C_TensorUnaryOperation(Data const &arg_0,
2916                           UnaryFunction operation)
2917    {
2918      if (arg_0.isEmpty())  // do this before we attempt to interpolate
2919      {
2920         throw DataException("Error - Operations not permitted on instances of DataEmpty.");
2921      }
2922      if (arg_0.isLazy())
2923      {
2924         throw DataException("Error - Operations not permitted on lazy data.");
2925      }
2926      // Interpolate if necessary and find an appropriate function space
2927      Data arg_0_Z = Data(arg_0);
2928    
2929      // Get rank and shape of inputs
2930      const DataTypes::ShapeType& shape0 = arg_0_Z.getDataPointShape();
2931      int size0 = arg_0_Z.getDataPointSize();
2932    
2933      // Declare output Data object
2934      Data res;
2935    
2936      if (arg_0_Z.isConstant()) {
2937        res = Data(0.0, shape0, arg_0_Z.getFunctionSpace());      // DataConstant output
2938        const double *ptr_0 = &(arg_0_Z.getDataAtOffsetRO(0));
2939        double *ptr_2 = &(res.getDataAtOffsetRW(0));
2940        tensor_unary_operation(size0, ptr_0, ptr_2, operation);
2941      }
2942      else if (arg_0_Z.isTagged()) {
2943    
2944        // Borrow DataTagged input from Data object
2945        DataTagged* tmp_0=dynamic_cast<DataTagged*>(arg_0_Z.borrowData());
2946    
2947        // Prepare a DataTagged output 2
2948        res = Data(0.0, shape0, arg_0_Z.getFunctionSpace());   // DataTagged output
2949        res.tag();
2950        DataTagged* tmp_2=dynamic_cast<DataTagged*>(res.borrowData());
2951    
2952        // Get the pointers to the actual data
2953        const double *ptr_0 = &(tmp_0->getDefaultValueRO(0));
2954        double *ptr_2 = &(tmp_2->getDefaultValueRW(0));
2955        // Compute a result for the default
2956        tensor_unary_operation(size0, ptr_0, ptr_2, operation);
2957        // Compute a result for each tag
2958        const DataTagged::DataMapType& lookup_0=tmp_0->getTagLookup();
2959        DataTagged::DataMapType::const_iterator i; // i->first is a tag, i->second is an offset into memory
2960        for (i=lookup_0.begin();i!=lookup_0.end();i++) {
2961          tmp_2->addTag(i->first);
2962          const double *ptr_0 = &(tmp_0->getDataByTagRO(i->first,0));
2963          double *ptr_2 = &(tmp_2->getDataByTagRW(i->first,0));
2964          tensor_unary_operation(size0, ptr_0, ptr_2, operation);
2965        }
2966    
2967      }
2968      else if (arg_0_Z.isExpanded()) {
2969    
2970        res = Data(0.0, shape0, arg_0_Z.getFunctionSpace(),true); // DataExpanded output
2971        DataExpanded* tmp_0=dynamic_cast<DataExpanded*>(arg_0_Z.borrowData());
2972        DataExpanded* tmp_2=dynamic_cast<DataExpanded*>(res.borrowData());
2973    
2974        int sampleNo_0,dataPointNo_0;
2975        int numSamples_0 = arg_0_Z.getNumSamples();
2976        int numDataPointsPerSample_0 = arg_0_Z.getNumDataPointsPerSample();
2977        #pragma omp parallel for private(sampleNo_0,dataPointNo_0) schedule(static)
2978        for (sampleNo_0 = 0; sampleNo_0 < numSamples_0; sampleNo_0++) {
2979          for (dataPointNo_0 = 0; dataPointNo_0 < numDataPointsPerSample_0; dataPointNo_0++) {
2980            int offset_0 = tmp_0->getPointOffset(sampleNo_0,dataPointNo_0);
2981            int offset_2 = tmp_2->getPointOffset(sampleNo_0,dataPointNo_0);
2982            const double *ptr_0 = &(arg_0_Z.getDataAtOffsetRO(offset_0));
2983            double *ptr_2 = &(res.getDataAtOffsetRW(offset_2));
2984            tensor_unary_operation(size0, ptr_0, ptr_2, operation);
2985          }
2986        }
2987      }
2988      else {
2989        throw DataException("Error - C_TensorUnaryOperation: unknown combination of inputs");
2990      }
2991    
2992      return res;
2993  }  }
2994    
2995  }  }

Legend:
Removed from v.97  
changed lines
  Added in v.2644

  ViewVC Help
Powered by ViewVC 1.1.26