summaryrefslogtreecommitdiff
path: root/src/functors/lattice/superAverage3D.h
blob: 7112fc33003234767d5483e69da3696d54537dee (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
/*  This file is part of the OpenLB library
 *
 *  Copyright (C) 2018 Adrian Kummerlaender
 *  E-mail contact: info@openlb.net
 *  The most recent release of OpenLB can be downloaded at
 *  <http://www.openlb.net/>
 *
 *  This program is free software; you can redistribute it and/or
 *  modify it under the terms of the GNU General Public License
 *  as published by the Free Software Foundation; either version 2
 *  of the License, or (at your option) any later version.
 *
 *  This program is distributed in the hope that it will be useful,
 *  but WITHOUT ANY WARRANTY; without even the implied warranty of
 *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 *  GNU General Public License for more details.
 *
 *  You should have received a copy of the GNU General Public
 *  License along with this program; if not, write to the Free
 *  Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
 *  Boston, MA  02110-1301, USA.
*/

#ifndef SUPER_AVERAGE_3D_H
#define SUPER_AVERAGE_3D_H

#include "superBaseF3D.h"
#include "blockAverage3D.h"
#include "indicator/superIndicatorBaseF3D.h"
#include "utilities/functorPtr.h"

namespace olb {


/// SuperAverage3D returns the average in each component of f on a indicated subset
template <typename T, typename W = T>
class SuperAverage3D final : public SuperF3D<T,W> {
private:
  FunctorPtr<SuperF3D<T,W>>        _f;
  FunctorPtr<SuperIndicatorF3D<T>> _indicatorF;
public:
  /// Constructor for determining the average of f on a indicated subset
  /**
   * \param f          functor of which the average is to be determined
   * \param indicatorF indicator describing the subset on which to evaluate f
   **/
  SuperAverage3D(FunctorPtr<SuperF3D<T,W>>&&        f,
                 FunctorPtr<SuperIndicatorF3D<T>>&& indicatorF);
  /// Constructor for determining the average of f on a given material
  /**
   * \param f             functor of which the average is to be determined
   * \param superGeometry super geometry for constructing material indicator
   * \param material      number of the relevant material
   **/
  SuperAverage3D(FunctorPtr<SuperF3D<T,W>>&& f,
                 SuperGeometry3D<T>& superGeometry,
                 const int material);

  /// Global average operator
  /**
   * Note: While this functor exposes BlockAverage3D functors if possible, a call to
   * this function will not use them but calculate the global average by summing all
   * components and voxel counts.
   * Calling BlockAverage3D in this situation would unnecessarily complicate this as
   * we would have to weight the aggregated averages according to their share in the
   * global average.
   **/
  bool operator() (W output[], const int input[]) override;
};


}

#endif