/* This file is part of the OpenLB library * * Copyright (C) 2017 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_FLUX_MASS_3D_H #define SUPER_PLANE_INTEGRAL_FLUX_MASS_3D_H #include "superPlaneIntegralF3D.h" namespace olb { /// Mass flux plane integral /** * Calculates the flux integral of a 3-dimensional velocity functor multiplied * by a 1-dimensional density functor i.e. mass flux. * * Flux calculation is performed by SuperPlaneIntegralF3D. * This class adds a print method and mass flux specific constructor wrappers. * * See SuperPlaneIntegralF3D for further documentation. **/ template class SuperPlaneIntegralFluxMass3D final : public SuperPlaneIntegralF3D { private: /// Velocity functor FunctorPtr> _velocityF; /// Density functor FunctorPtr> _densityF; /// Mass conversation factor const T _conversationFactorMass; /// Mass conversation factor const T _conversationFactorTime; public: /// Primary constructor /** * \param velocityF * (non-)owning pointer or reference to velocity functor. * \param densityF * (non-)owning pointer or reference to density functor. * \param conversationFactorMass * Mass conversation factor * \param conversationFactorTime * Time conversation factor e.g. `converter.getConversionFactorTime()` * \param hyperplaneLattice * Parametrization of the hyperplane lattice to be interpolated. * \param integrationIndicator * (non-)owning pointer or reference to SuperIndicatorF3D. * 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. **/ SuperPlaneIntegralFluxMass3D(FunctorPtr>&& velocityF, FunctorPtr>&& densityF, SuperGeometry3D& geometry, T conversationFactorMass, T conversationFactorTime, const HyperplaneLattice3D& hyperplaneLattice, FunctorPtr>&& integrationIndicator, FunctorPtr>&& subplaneIndicator, BlockDataReductionMode mode=BlockDataReductionMode::Analytical); /// Constructor providing automatic lattice generation /** * \param velocityF * (non-)owning pointer or reference to velocity functor. * \param densityF * (non-)owning pointer or reference to density functor. * \param conversationFactorMass * Mass conversation factor * \param conversationFactorTime * Time conversation factor e.g. `converter.getConversionFactorTime()` * \param hyperplane * Parametrization of the hyperplane to be integrated. * The lattice resolution is set to CuboidGeometry3D::getMinDeltaR. * \param integrationIndicator * (non-)owning pointer or reference to SuperIndicatorF3D. * 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. **/ SuperPlaneIntegralFluxMass3D(FunctorPtr>&& velocityF, FunctorPtr>&& densityF, SuperGeometry3D& geometry, T conversationFactorMass, T conversationFactorTime, const Hyperplane3D& 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 velocityF * (non-)owning pointer or reference to velocity functor. * \param densityF * (non-)owning pointer or reference to density functor. * \param conversationFactorMass * Mass conversation factor * \param conversationFactorTime * Time conversation factor e.g. `converter.getConversionFactorTime()` * \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 SuperIndicatorF3D. * 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. **/ SuperPlaneIntegralFluxMass3D(FunctorPtr>&& velocityF, FunctorPtr>&& densityF, SuperGeometry3D& geometry, T conversationFactorMass, T conversationFactorTime, const Hyperplane3D& hyperplane, FunctorPtr>&& integrationIndicator, BlockDataReductionMode mode=BlockDataReductionMode::Analytical); /// Constructor providing automatic lattice and material indicator instantiation /** * \param velocityF (non-)owning pointer or reference to velocity functor. * \param densityF (non-)owning pointer or reference to density functor. * \param conversationFactorMass Mass conversation factor * \param conversationFactorTime Time conversation factor * \param origin hyperplane origin * \param u hyperplane span vector * \param v hyperplane span vector * \param materials material numbers relevant for hyperplane integration * \param mode defines how the values of the discrete hyperplane are determined **/ SuperPlaneIntegralFluxMass3D(FunctorPtr>&& velocityF, FunctorPtr>&& densityF, SuperGeometry3D& geometry, T conversationFactorMass, T conversationFactorTime, const Vector& origin, const Vector& u, const Vector& v, std::vector materials, BlockDataReductionMode mode=BlockDataReductionMode::Analytical); /// Constructor providing automatic lattice parametrization, only interpolating material 1 /** * \param velocityF (non-)owning pointer or reference to velocity functor. * \param densityF (non-)owning pointer or reference to density functor. * \param conversationFactorMass Mass conversation factor * \param conversationFactorTime Time conversation factor * \param origin hyperplane origin * \param u hyperplane span vector * \param v hyperplane span vector * \param mode defines how the values of the discrete hyperplane are determined **/ SuperPlaneIntegralFluxMass3D(FunctorPtr>&& velocityF, FunctorPtr>&& densityF, SuperGeometry3D& geometry, T conversationFactorMass, T conversationFactorTime, const Vector& origin, const Vector& u, const Vector& v, BlockDataReductionMode mode=BlockDataReductionMode::Analytical); /// Constructor providing automatic lattice parametrization to fit a given circle /** * \param velocityF (non-)owning pointer or reference to velocity functor. * \param densityF (non-)owning pointer or reference to density functor. * \param conversationFactorMass Mass conversation factor * \param conversationFactorTime Time conversation factor * \param circle circle indicator to be used for hyperplane subset parametrization * \param materials material numbers relevant for hyperplane interpolation * \param mode defines how the values of the discrete hyperplane are determined **/ SuperPlaneIntegralFluxMass3D(FunctorPtr>&& velocityF, FunctorPtr>&& densityF, SuperGeometry3D& geometry, T conversationFactorMass, T conversationFactorTime, IndicatorCircle3D& circle, std::vector materials, BlockDataReductionMode mode=BlockDataReductionMode::Analytical); /// Constructor providing automatic lattice parametrization to fit a given circle and only interpolating material 1 /** * \param velocityF (non-)owning pointer or reference to velocity functor. * \param densityF (non-)owning pointer or reference to density functor. * \param conversationFactorMass Mass conversation factor * \param conversationFactorTime Time conversation factor * \param circle circle indicator to be used for hyperplane subset parametrization * \param materials material numbers relevant for hyperplane interpolation * \param mode defines how the values of the discrete hyperplane are determined **/ SuperPlaneIntegralFluxMass3D(FunctorPtr>&& velocityF, FunctorPtr>&& densityF, SuperGeometry3D& geometry, T conversationFactorMass, T conversationFactorTime, IndicatorCircle3D& circle, BlockDataReductionMode mode=BlockDataReductionMode::Analytical); bool operator() (T output[], const int input[]) override; void print(std::string regionName, std::string massFluxSiScaleName); }; } #endif