From 94d3e79a8617f88dc0219cfdeedfa3147833719d Mon Sep 17 00:00:00 2001 From: Adrian Kummerlaender Date: Mon, 24 Jun 2019 14:43:36 +0200 Subject: Initialize at openlb-1-3 --- .../lattice/integral/superPlaneIntegralF2D.h | 203 +++++++++++++++++++++ 1 file changed, 203 insertions(+) create mode 100644 src/functors/lattice/integral/superPlaneIntegralF2D.h (limited to 'src/functors/lattice/integral/superPlaneIntegralF2D.h') diff --git a/src/functors/lattice/integral/superPlaneIntegralF2D.h b/src/functors/lattice/integral/superPlaneIntegralF2D.h new file mode 100644 index 0000000..0ef8c9a --- /dev/null +++ b/src/functors/lattice/integral/superPlaneIntegralF2D.h @@ -0,0 +1,203 @@ +/* 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 + * + * + * 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_PLANE_INTEGRAL_F_2D_H +#define SUPER_PLANE_INTEGRAL_F_2D_H + +#include "core/vector.h" +#include "io/ostreamManager.h" +#include "geometry/superGeometry2D.h" +#include "functors/lattice/superBaseF2D.h" +#include "functors/analytical/indicator/indicatorBaseF2D.h" +#include "functors/lattice/indicator/superIndicatorF2D.h" +#include "functors/lattice/indicator/superIndicatorBaseF2D.h" +#include "functors/lattice/blockReduction2D1D.h" +#include "utilities/functorPtr.h" +#include "utilities/hyperplane2D.h" +#include "utilities/hyperplaneLattice2D.h" + +namespace olb { + + +/// Surface integral of a subset of a interpolated hyperplane +template +class SuperPlaneIntegralF2D : public SuperF2D { +protected: + SuperGeometry2D& _geometry; + + /// Functor to be integrated on the line + FunctorPtr> _f; + /// Indicator describing relevant discrete integration points + FunctorPtr> _integrationIndicatorF; + /// Indicator describing the relevant subset of the interpolated hyperplane + FunctorPtr> _subplaneIndicatorF; + /// Functor describing line to be interpolated and integrated + BlockReduction2D1D _reductionF; + + /// Origin vector as given by hyperplane definition, (0,0) in respect to the + /// subplane indicator _subplaneIndicatorF + /** + * Note: The reduced plane _reductionF calculates its own origin based on _origin + * as its spans the maximum size possible given the direction vector, origin and + * geometry size. + **/ + Vector _origin; + /// Direction vector u as given by hyperplane definition, normalized to h + Vector _u; + /// Orthogonal vector to _u + Vector _normal; + + /// Subset of the discrete line points given by _reductionF as indicated + /// by _integrationIndicatorF. i.e. the points used to interpolate the hyperplane + std::vector _rankLocalSubplane; + + /// \returns true iff the given physical position is to be integrated + /** + * This is determined using the _integrationIndicatorF indicated subset of the 2d + * hyperplane reduced by _reductionF. + **/ + bool isToBeIntegrated(const Vector& physR, int iC); + +public: + /// Primary constructor + /** + * All other constructors defer the actual construction to this constructor. + * + * \param f + * (non-)owning pointer or reference to SuperF2D. + * \param hyperplaneLattice + * Parametrization of the hyperplane lattice to be interpolated. + * \param integrationIndicator + * (non-)owning pointer or reference to SuperIndicatorF2D. + * Describes the set of lattice points relevant for integration. + * \param subplaneIndicator + * (non-)owning pointer or reference to IndicatorF2D. + * Describes the relevant subplane of the interpolated hyperplane. + * \param mode + * Defines how the values of the discrete hyperplane are determined. + * i.e. if they are interpolated or read directly from lattice points. + * Note: BlockDataReductionMode::Analytical imposes restrictions on + * hyperplane definition and discretization. If you are not sure + * consider providing only a hyperplane defintion instead of both a + * definition and a discretization. + **/ + SuperPlaneIntegralF2D(FunctorPtr>&& f, + SuperGeometry2D& geometry, + const HyperplaneLattice2D& hyperplaneLattice, + FunctorPtr>&& integrationIndicator, + FunctorPtr>&& subplaneIndicator, + BlockDataReductionMode mode=BlockDataReductionMode::Analytical); + /// Constructor providing automatic lattice generation + /** + * \param f + * (non-)owning pointer or reference to SuperF2D. + * \param hyperplane + * Parametrization of the hyperplane to be integrated. + * The lattice resolution is set to CuboidGeometry2D::getMinDeltaR. + * \param integrationIndicator + * (non-)owning pointer or reference to SuperIndicatorF2D. + * Describes the set of lattice points relevant for integration. + * \param subplaneIndicator + * (non-)owning pointer or reference to IndicatorF2D. + * Describes the relevant subplane of the interpolated hyperplane. + * \param mode + * Defines how the values of the discrete hyperplane are determined. + * i.e. if they are interpolated or read directly from lattice points. + **/ + SuperPlaneIntegralF2D(FunctorPtr>&& f, + SuperGeometry2D& geometry, + const Hyperplane2D& hyperplane, + FunctorPtr>&& integrationIndicator, + FunctorPtr>&& subplaneIndicator, + BlockDataReductionMode mode=BlockDataReductionMode::Analytical); + + /// Constructor providing automatic lattice generation and omitting subplane restriction + /** + * i.e. the intersection between geometry and hyperplane is integrated wherever _integrationIndicatorF allows. + * + * \param f + * (non-)owning pointer or reference to SuperF2D. + * \param hyperplane + * Parametrization of the hyperplane to be integrated. + * The lattice resolution is set to the cuboid geometry's minDeltaR. + * \param integrationIndicator + * (non-)owning pointer or reference to SuperIndicatorF2D. + * Describes the set of lattice points relevant for integration. + * \param mode + * Defines how the values of the discrete hyperplane are determined. + * i.e. if they are interpolated or read directly from lattice points. + **/ + SuperPlaneIntegralF2D(FunctorPtr>&& f, + SuperGeometry2D& geometry, + const Hyperplane2D& hyperplane, + FunctorPtr>&& integrationIndicator, + BlockDataReductionMode mode=BlockDataReductionMode::Analytical); + + /// Constructor providing automatic lattice and material indicator instantiation + /** + * \param f (non-)owning pointer or reference to SuperF2D. + * \param origin hyperplane origin origin + * \param u hyperplane direction vector + * \param materials material numbers relevant for hyperplane integration + * \param mode defines how the values of the discrete hyperplane are determined + **/ + SuperPlaneIntegralF2D(FunctorPtr>&& f, + SuperGeometry2D& geometry, + const Vector& origin, + const Vector& u, + std::vector materials, + BlockDataReductionMode mode=BlockDataReductionMode::Analytical); + /// Constructor providing automatic lattice parametrization, only interpolating material 1 + /** + * \param f (non-)owning pointer or reference to SuperF2D. + * \param origin hyperplane origin + * \param u hyperplane direction vector + * \param mode defines how the values of the discrete hyperplane are determined + **/ + SuperPlaneIntegralF2D(FunctorPtr>&& f, + SuperGeometry2D& geometry, + const Vector& origin, + const Vector& u, + BlockDataReductionMode mode=BlockDataReductionMode::Analytical); + + /** + * Returns the line integral in the following structure: + * + * \code + * output[0] = integral, e.g. flow[0] * h for 1-dimensional target sizes + * output[1] = #voxels * h i.e. length of line + * output[2..2+f.getTargetSize()] = flow + * \endcode + * + * Note: output[0] contains the flux value if applicable + * + * \param input irrelevant + **/ + bool operator() (T output[], const int input[]) override; + +}; + + +} + +#endif -- cgit v1.2.3