pointsource.hh

Go to the documentation of this file.

// -*- mode: C++; tab-width: 4; indent-tabs-mode: nil; c-basic-offset: 4 -*-
// vi: set et ts=4 sw=4 sts=4:
//
// SPDX-FileCopyrightInfo: Copyright © DuMux Project contributors, see AUTHORS.md in root folder
// SPDX-License-Identifier: GPL-3.0-or-later
//
#ifndef DUMUX_POINTSOURCE_HH
#define DUMUX_POINTSOURCE_HH
 
#include <functional>
 
#include <dune/common/reservedvector.hh>
#include <dumux/common/properties.hh>
#include <dumux/common/parameters.hh>
#include <dumux/common/numeqvector.hh>
#include <dumux/geometry/boundingboxtree.hh>
#include <dumux/geometry/intersectspointgeometry.hh>
#include <dumux/geometry/intersectingentities.hh>
 
#include <dumux/discretization/method.hh>
 
namespace Dumux {
 
template<class PositionType, class ValueType>
class PointSource
{
public:
    using Scalar = std::decay_t<decltype(std::declval<ValueType>()[0])>;
    using GlobalPosition = PositionType;
    using Values = ValueType;
 
    PointSource(GlobalPosition pos, Values values)
      : values_(values), pos_(pos), embeddings_(1) {}
 
    // value known at the time of initialization
    PointSource(GlobalPosition pos)
      : values_(0.0), pos_(pos), embeddings_(1) {}
 
    PointSource& operator+= (Scalar s)
    {
        values_ += s;
        return *this;
    }
 
    PointSource& operator-= (Scalar s)
    {
        values_ -= s;
        return *this;
    }
 
    PointSource& operator*= (Scalar s)
    {
        values_ *= s;
        return *this;
    }
 
    PointSource& operator/= (Scalar s)
    {
        values_ /= s;
        return *this;
    }
 
    PointSource& operator= (const Values& values)
    {
        values_ = values;
        return *this;
    }
 
    PointSource& operator= (Scalar s)
    {
        values_ = s;
        return *this;
    }
 
    Values values() const
    { return values_; }
 
    const GlobalPosition& position() const
    { return pos_; }
 
    // to the local residual in the problem in scvPointSources
    // to be overloaded by derived classes
    template<class Problem, class FVElementGeometry, class ElementVolumeVariables>
    void update(const Problem &problem,
                const typename FVElementGeometry::GridGeometry::GridView::template Codim<0>::Entity &element,
                const FVElementGeometry &fvGeometry,
                const ElementVolumeVariables &elemVolVars,
                const typename FVElementGeometry::SubControlVolume &scv)
    {}
 
    void setEmbeddings(std::size_t embeddings)
    {
        embeddings_ = embeddings;
    }
 
    std::size_t embeddings() const
    {
        return embeddings_;
    }
 
protected:
    Values values_; 
private:
    GlobalPosition pos_; 
    std::size_t embeddings_; 
};
 
template<class GlobalPosition, class SourceValues, class I>
class IdPointSource : public PointSource<GlobalPosition, SourceValues>
{
    using ParentType = PointSource<GlobalPosition, SourceValues>;
    using Scalar = typename ParentType::Scalar;
 
public:
    using IdType = I;
 
    IdPointSource(GlobalPosition pos, SourceValues values, IdType id)
      :  ParentType(pos, values), id_(id) {}
 
    // value known at the time of initialization
    IdPointSource(GlobalPosition pos, IdType id)
      : ParentType(pos, SourceValues(0.0)), id_(id) {}
 
    IdType id() const
    { return id_; }
 
    IdPointSource& operator= (const SourceValues& values)
    {
        ParentType::operator=(values);
        return *this;
    }
 
    IdPointSource& operator= (Scalar s)
    {
        ParentType::operator=(s);
        return *this;
    }
 
private:
    IdType id_;
};
 
template<class TypeTag>
class SolDependentPointSource : public PointSource<Dune::FieldVector<typename GetPropType<TypeTag, Properties::GridGeometry>::GridView::ctype,
                                                   GetPropType<TypeTag, Properties::GridGeometry>::GridView::dimensionworld>,
                                                   Dumux::NumEqVector<GetPropType<TypeTag, Properties::PrimaryVariables>>>
{
    using GridView = typename GetPropType<TypeTag, Properties::GridGeometry>::GridView;
    using SourceValues = Dumux::NumEqVector<GetPropType<TypeTag, Properties::PrimaryVariables>>;
    using Problem = GetPropType<TypeTag, Properties::Problem>;
    using ElementVolumeVariables = typename GetPropType<TypeTag, Properties::GridVolumeVariables>::LocalView;
    using FVElementGeometry = typename GetPropType<TypeTag, Properties::GridGeometry>::LocalView;
    using SubControlVolume = typename FVElementGeometry::SubControlVolume;
    using Element = typename GridView::template Codim<0>::Entity;
 
    static const int dimworld = GridView::dimensionworld;
    using GlobalPosition = typename Dune::FieldVector<typename GridView::ctype, dimworld>;
    // returns the PointSource values as PrimaryVariables
    using ValueFunction = typename std::function<SourceValues(const Problem &problem,
                                                              const Element &element,
                                                              const FVElementGeometry &fvGeometry,
                                                              const ElementVolumeVariables &elemVolVars,
                                                              const SubControlVolume &scv)>;
 
    using ParentType = PointSource<GlobalPosition, SourceValues>;
    using Scalar = typename ParentType::Scalar;
 
public:
    // value known at the time of initialization
    SolDependentPointSource(GlobalPosition pos,
                            ValueFunction valueFunction)
      : ParentType(pos, SourceValues(0.0)), valueFunction_(valueFunction) {}
 
    // to the local residual in the problem in scvPointSources
    // to be overloaded by derived classes
    void update(const Problem &problem,
                const Element &element,
                const FVElementGeometry &fvGeometry,
                const ElementVolumeVariables &elemVolVars,
                const SubControlVolume &scv)
    { this->values_ = valueFunction_(problem, element, fvGeometry, elemVolVars, scv); }
 
    SolDependentPointSource& operator= (const SourceValues& values)
    {
        ParentType::operator=(values);
        return *this;
    }
 
    SolDependentPointSource& operator= (Scalar s)
    {
        ParentType::operator=(s);
        return *this;
    }
 
private:
    ValueFunction valueFunction_;
};
 
class BoundingBoxTreePointSourceHelper
{
public:
    template<class GridGeometry, class PointSource, class PointSourceMap>
    static void computePointSourceMap(const GridGeometry& gridGeometry,
                                      const std::vector<PointSource>& sources,
                                      PointSourceMap& pointSourceMap,
                                      const std::string& paramGroup = "")
    {
        const auto& boundingBoxTree = gridGeometry.boundingBoxTree();
 
        for (const auto& s : sources)
        {
            // compute in which elements the point source falls
            const auto entities = intersectingEntities(s.position(), boundingBoxTree);
 
            // continue with next point source if no intersection with the grid are found
            if (entities.empty())
                continue;
 
            // make local copy of point source for the map
            auto source = s;
 
            // split the source values equally among all concerned entities
            source.setEmbeddings(entities.size()*source.embeddings());
 
            if constexpr (GridGeometry::discMethod == DiscretizationMethods::box
                || GridGeometry::discMethod == DiscretizationMethods::fcdiamond)
            {
                // loop over all concerned elements
                auto fvGeometry = localView(gridGeometry);
                for (const auto eIdx : entities)
                {
                    // check in which subcontrolvolume(s) we are
                    const auto element = boundingBoxTree.entitySet().entity(eIdx);
                    fvGeometry.bindElement(element);
 
                    const auto globalPos = source.position();
                    // loop over all sub control volumes and check if the point source is inside
                    constexpr int dim = GridGeometry::GridView::dimension;
                    Dune::ReservedVector<std::size_t, 1<<dim> scvIndices;
                    for (const auto& scv : scvs(fvGeometry))
                        if (intersectsPointGeometry(globalPos, fvGeometry.geometry(scv)))
                            scvIndices.push_back(scv.indexInElement());
 
                    // for all scvs that tested positive add the point sources
                    // to the element/scv to point source map
                    for (const auto scvIdx : scvIndices)
                    {
                        const auto key = std::make_pair(eIdx, scvIdx);
                        if (pointSourceMap.count(key))
                            pointSourceMap.at(key).push_back(source);
                        else
                            pointSourceMap.insert({key, {source}});
                        // split equally on the number of matched scvs
                        auto& s = pointSourceMap.at(key).back();
                        s.setEmbeddings(scvIndices.size()*s.embeddings());
                    }
                }
            }
            else
            {
                for (const auto eIdx : entities)
                {
                    // add the pointsource to the DOF map
                    const auto key = std::make_pair(eIdx, /*scvIdx=*/ 0);
                    if (pointSourceMap.count(key))
                        pointSourceMap.at(key).push_back(source);
                    else
                        pointSourceMap.insert({key, {source}});
                }
            }
        }
    }
};
 
} // end namespace Dumux
 
#endif