hybrid/elementvariables.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-FileCopyrightText: Copyright © DuMux Project contributors, see AUTHORS.md in root folder
// SPDX-License-Identifier: GPL-3.0-or-later
//
#ifndef DUMUX_DISCRETIZATION_HYBRID_CVFE_ELEMENT_VARIABLES_HH
#define DUMUX_DISCRETIZATION_HYBRID_CVFE_ELEMENT_VARIABLES_HH
 
#include <array>
#include <optional>
#include <ranges>
#include <type_traits>
#include <utility>
#include <vector>
#include <memory>
 
#include <dumux/common/concepts/ipdata_.hh>
#include <dumux/common/concepts/localdofs_.hh>
#include <dumux/discretization/elementsolution.hh>
#include <dumux/discretization/cvfe/quadraturerules.hh>
 
#include <dumux/discretization/cvfe/variablesdeflectionpolicy.hh>
 
namespace Dumux::Experimental::CVFE {
 
template<class GVC, bool cachingEnabled>
class HybridCVFEElementVariables;
 
template<class GVC>
class HybridCVFEElementVariables<GVC, /*cachingEnabled*/true>
{
    class MutableVariablesView
    {
    public:
        MutableVariablesView(GVC& gridCache)
        : gridCache_(gridCache) {}
 
        using Variables = typename GVC::Variables;
 
        template<Dumux::Concept::LocalDof LocalDof>
        Variables& operator [](const LocalDof& localDof) const
        { return gridCache_.variables(localDof); }
    private:
        GVC& gridCache_;
    };
 
    class MutableVariablesViewWithIpCacheAccess
    {
    public:
        MutableVariablesViewWithIpCacheAccess(GVC& gridCache)
        : gridCache_(gridCache)
        {}
 
        using Variables = typename GVC::Variables;
 
        template<Dumux::Concept::LocalDof LocalDof>
        Variables& operator [](const LocalDof& localDof) const
        { return gridCache_.variables(localDof); }
 
        auto& cache(std::size_t eIdx) const
        { return gridCache_.cache(eIdx); }
 
    private:
        GVC& gridCache_;
    };
 
public:
    using GridVariablesCache = GVC;
 
    using InterpolationPointData = typename GridVariablesCache::InterpolationPointData;
 
    using MutableView = std::conditional_t<
        InterpolationPointData::isSolDependent,
        MutableVariablesViewWithIpCacheAccess,
        MutableVariablesView
    >;
 
    using Variables = typename GridVariablesCache::Variables;
 
    template<class FVElementGeometry>
    using DeflectionPolicy = std::conditional_t<
        InterpolationPointData::isSolDependent,
        Dumux::Detail::CVFE::VariablesDeflectionPolicyWithIpCacheUpdate<MutableView, FVElementGeometry>,
        Dumux::Detail::CVFE::VariablesDeflectionPolicy<MutableView, FVElementGeometry>
    >;
 
    HybridCVFEElementVariables(const GridVariablesCache& gridVariablesCache)
    : gridVariablesCachePtr_(&gridVariablesCache) {}
 
    const Variables& operator [](std::size_t localDofIdx) const
    { return gridVariablesCache().variables(eIdx_, localDofIdx); }
 
    template<Dumux::Concept::LocalDof LocalDof>
    const Variables& operator [](const LocalDof& localDof) const
    { return gridVariablesCache().variables(localDof); }
 
    template<class IpData>
    requires requires (const IpData& ipData) { ipData.localDofIndex(); }
    const Variables& operator [](const IpData& ipData) const
    { return gridVariablesCache().variables(eIdx_, ipData.localDofIndex()); }
 
    template<Concept::ScvfQpIpData IpData>
    friend const InterpolationPointData& cache(const HybridCVFEElementVariables& elemVars,
                                               const IpData& ipData)
    { return elemVars.gridVariablesCache().scvfCache(elemVars.eIdx_, ipData.scvfIndex(), ipData.qpIndex()); }
 
    template<Concept::IntersectionQpIpData IpData>
    friend const InterpolationPointData& cache(const HybridCVFEElementVariables& elemVars,
                                               const IpData& ipData)
    { return elemVars.gridVariablesCache().boundaryIntersectionCache(elemVars.eIdx_, ipData.intersectionIndex(), ipData.qpIndex()); }
 
    template<Concept::QIpData IpData>
    friend const InterpolationPointData& cache(const HybridCVFEElementVariables& elemVars,
                                               const IpData& ipData)
    { return elemVars.gridVariablesCache().elementCache(elemVars.eIdx_, ipData.qpIndex()); }
 
    template<class FVElementGeometry, class SolutionVector>
    HybridCVFEElementVariables bind(const typename FVElementGeometry::GridGeometry::GridView::template Codim<0>::Entity& element,
                                    const FVElementGeometry& fvGeometry,
                                    const SolutionVector& sol) &&
    {
        this->bindElement(element, fvGeometry, sol);
        return std::move(*this);
    }
 
    // For compatibility reasons with the case of not storing the variables.
    // function to be called before assembling an element, preparing the variables within the stencil
    template<class FVElementGeometry, class SolutionVector>
    void bind(const typename FVElementGeometry::GridGeometry::GridView::template Codim<0>::Entity& element,
              const FVElementGeometry& fvGeometry,
              const SolutionVector& sol) &
    {
        bindElement(element, fvGeometry, sol);
    }
 
    template<class FVElementGeometry, class SolutionVector>
    HybridCVFEElementVariables bindElement(const typename FVElementGeometry::GridGeometry::GridView::template Codim<0>::Entity& element,
                                           const FVElementGeometry& fvGeometry,
                                           const SolutionVector& sol) &&
    {
        this->bindElement(element, fvGeometry, sol);
        return std::move(*this);
    }
 
    // function to prepare the variables within the element
    template<class FVElementGeometry, class SolutionVector>
    void bindElement(const typename FVElementGeometry::GridGeometry::GridView::template Codim<0>::Entity& element,
                     const FVElementGeometry& fvGeometry,
                     const SolutionVector& sol) &
    {
        eIdx_ = fvGeometry.gridGeometry().elementMapper().index(element);
    }
 
    const GridVariablesCache& gridVariablesCache() const
    { return *gridVariablesCachePtr_; }
 
    MutableView asMutableView(GridVariablesCache& gridVars)
    { return { gridVars }; }
 
private:
    const GridVariablesCache* gridVariablesCachePtr_;
    std::size_t eIdx_;
};
 
template<class GVC>
class HybridCVFEElementVariables<GVC, /*cachingEnabled*/false>
{
    using ThisType = HybridCVFEElementVariables<GVC, /*cachingEnabled*/false>;
    using GridGeometry = std::decay_t<decltype(std::declval<GVC>().problem().gridGeometry())>;
    using GridView = typename GridGeometry::GridView;
 
    static constexpr std::size_t maxNumIntersections = GridView::dimension << 1;
 
    class MutableVariablesView
    {
    public:
        MutableVariablesView(ThisType& view)
        : view_(view) {}
 
        using Variables = typename GVC::Variables;
 
        template<Dumux::Concept::LocalDof LocalDof>
        Variables& operator [](const LocalDof& localDof) const
        { return view_[localDof]; }
    private:
        ThisType& view_;
    };
 
    class MutableVariablesViewWithIpCacheAccess
    {
    public:
        MutableVariablesViewWithIpCacheAccess(ThisType& view)
        : view_(view)
        {}
 
        using Variables = typename GVC::Variables;
 
        template<Dumux::Concept::LocalDof LocalDof>
        Variables& operator [](const LocalDof& localDof) const
        { return view_[localDof]; }
 
        auto& cache(std::size_t) const
        { return *view_.ipDataCache_; }
 
    private:
        ThisType& view_;
    };
 
public:
    using GridVariablesCache = GVC;
 
    using InterpolationPointData = typename GridVariablesCache::InterpolationPointData;
 
    using MutableView = std::conditional_t<
        InterpolationPointData::isSolDependent,
        MutableVariablesViewWithIpCacheAccess,
        MutableVariablesView
    >;
 
    using Variables = typename GridVariablesCache::Variables;
 
    template<class FVElementGeometry>
    using DeflectionPolicy = std::conditional_t<
        InterpolationPointData::isSolDependent,
        Dumux::Detail::CVFE::VariablesDeflectionPolicyWithIpCacheUpdate<MutableView, FVElementGeometry>,
        Dumux::Detail::CVFE::VariablesDeflectionPolicy<MutableView, FVElementGeometry>
    >;
 
    HybridCVFEElementVariables(const GridVariablesCache& gridVarsCache)
    : gridVariablesCachePtr_(&gridVarsCache)
    , ipDataCache_(std::make_shared<InterpolationPointDataCache>())
    {}
 
    template<class FVElementGeometry, class SolutionVector>
    HybridCVFEElementVariables bind(const typename FVElementGeometry::GridGeometry::GridView::template Codim<0>::Entity& element,
                              const FVElementGeometry& fvGeometry,
                              const SolutionVector& sol)  &&
    {
        this->bindElement(element, fvGeometry, sol);
        return std::move(*this);
    }
 
    // specialization for control-volume finite element, simply forwards to the bindElement method
    template<class FVElementGeometry, class SolutionVector>
    void bind(const typename FVElementGeometry::GridGeometry::GridView::template Codim<0>::Entity& element,
              const FVElementGeometry& fvGeometry,
              const SolutionVector& sol) &
    {
        bindElement(element, fvGeometry, sol);
    }
 
    template<class FVElementGeometry, class SolutionVector>
    HybridCVFEElementVariables bindElement(const typename FVElementGeometry::GridGeometry::GridView::template Codim<0>::Entity& element,
                                          const FVElementGeometry& fvGeometry,
                                          const SolutionVector& sol)  &&
    {
        this->bindElement(element, fvGeometry, sol);
        return std::move(*this);
    }
 
    // specialization for control-volume finite element
    template<class FVElementGeometry, class SolutionVector>
    void bindElement(const typename FVElementGeometry::GridGeometry::GridView::template Codim<0>::Entity& element,
                     const FVElementGeometry& fvGeometry,
                     const SolutionVector& sol) &
    {
        // get the solution at the dofs of the element
        auto elemSol = elementSolution(element, sol, fvGeometry.gridGeometry());
 
        // resize variables to the required size
        variables_.resize(Dumux::Detail::LocalDofs::numLocalDofs(fvGeometry));
 
        // update variables related to localDofs
        for (const auto& localDof : localDofs(fvGeometry))
            variables_[localDof.index()].update(elemSol, gridVariablesCache().problem(), fvGeometry, ipData(fvGeometry, localDof));
 
        if constexpr (InterpolationPointData::isSolDependent)
        {
            auto newIpDataCache = std::make_shared<InterpolationPointDataCache>(*ipDataCache_);
            newIpDataCache->update(gridVariablesCache().problem(), element, fvGeometry, variables_);
            ipDataCache_ = std::move(newIpDataCache);
        }
        else
            ipDataCache_->update(gridVariablesCache().problem(), element, fvGeometry, variables_);
    }
 
    const Variables& operator [](std::size_t localIdx) const
    { return variables_[localIdx]; }
 
    Variables& operator [](std::size_t localIdx)
    { return variables_[localIdx]; }
 
    template<Dumux::Concept::LocalDof LocalDof>
    const Variables& operator [](const LocalDof& localDof) const
    { return variables_[localDof.index()]; }
 
    template<Dumux::Concept::LocalDof LocalDof>
    Variables& operator [](const LocalDof& localDof)
    { return variables_[localDof.index()]; }
 
    template<class IpData>
    requires requires (const IpData& ipData) { ipData.localDofIndex(); }
    const Variables& operator [](const IpData& ipData) const
    { return variables_[ipData.localDofIndex()]; }
 
    template<class IpData>
    requires requires (const IpData& ipData) { ipData.localDofIndex(); }
    Variables& operator [](const IpData& ipData)
    { return variables_[ipData.localDofIndex()]; }
 
    template<Concept::ScvfQpIpData IpData>
    friend const InterpolationPointData& cache(const HybridCVFEElementVariables& elemVars,
                                               const IpData& ipData)
    { return elemVars.ipDataCache_->scvfCache(ipData.scvfIndex(), ipData.qpIndex()); }
 
    template<Concept::IntersectionQpIpData IpData>
    friend const InterpolationPointData& cache(const HybridCVFEElementVariables& elemVars,
                                               const IpData& ipData)
    { return elemVars.ipDataCache_->boundaryIntersectionCache(ipData.intersectionIndex(), ipData.qpIndex()); }
 
    template<Concept::QIpData IpData>
    friend const InterpolationPointData& cache(const HybridCVFEElementVariables& elemVars,
                                               const IpData& ipData)
    { return elemVars.ipDataCache_->elementCache(ipData.qpIndex()); }
 
    const GridVariablesCache& gridVariablesCache() const
    { return *gridVariablesCachePtr_; }
 
    MutableView asMutableView(GridVariablesCache&)
    { return { *this }; }
 
private:
    class InterpolationPointDataCache
    {
    public:
        InterpolationPointDataCache()
        {}
 
        template<class Problem, class FVElementGeometry, class ElementVariables>
        void update(const Problem& problem,
                    const typename FVElementGeometry::Element& element,
                    const FVElementGeometry& fvGeometry,
                    const ElementVariables& elemVars)
        {
            updateElementCache_(problem, element, fvGeometry, elemVars);
        }
 
        // access operator
        const InterpolationPointData& scvfCache(std::size_t scvfIdx, std::size_t qpIdx) const
        { return scvfCache_[scvfIdx][qpIdx]; }
 
        // access operator
        InterpolationPointData& scvfCache(std::size_t scvfIdx, std::size_t qpIdx)
        { return scvfCache_[scvfIdx][qpIdx]; }
 
        // access operator
        const InterpolationPointData& elementCache(std::size_t qpIdx) const
        { return elementCache_[qpIdx]; }
 
        // access operator
        InterpolationPointData& elementCache(std::size_t qpIdx)
        { return elementCache_[qpIdx]; }
 
        // access operator
        const InterpolationPointData& boundaryIntersectionCache(std::size_t intersectionIdx, std::size_t qpIdx) const
        { return (*boundaryIntersectionCache_[intersectionIdx])[qpIdx]; }
 
        // access operator
        InterpolationPointData& boundaryIntersectionCache(std::size_t intersectionIdx, std::size_t qpIdx)
        { return (*boundaryIntersectionCache_[intersectionIdx])[qpIdx]; }
 
    private:
        template<class Problem, class FVElementGeometry, class ElementVariables>
        void updateElementCache_(const Problem& problem,
                                 const typename FVElementGeometry::Element& element,
                                 const FVElementGeometry& fvGeometry,
                                 const ElementVariables& elemVars)
        {
            scvfCache_.resize(fvGeometry.numScvf());
            for (const auto& scvf : scvfs(fvGeometry))
            {
                const auto quadRule = Dumux::CVFE::quadratureRule(fvGeometry, scvf);
                scvfCache_[scvf.index()].resize(std::ranges::size(quadRule));
                for (const auto& qpData : quadRule)
                    scvfCache_[scvf.index()][qpData.ipData().qpIndex()].update(
                        problem, element, fvGeometry, elemVars, qpData.ipData()
                    );
            }
 
            const auto elemQuadRule = Dumux::CVFE::quadratureRule(fvGeometry, element);
            elementCache_.resize(std::ranges::size(elemQuadRule));
            for (const auto& qpData : elemQuadRule)
                elementCache_[qpData.ipData().qpIndex()].update(problem, element, fvGeometry, elemVars, qpData.ipData());
 
            for (const auto& intersection : intersections(fvGeometry.gridGeometry().gridView(), element))
            {
                const auto intersectionIndex = intersection.indexInInside();
                if (intersection.boundary())
                {
                    auto& boundaryCache = boundaryIntersectionCache_[intersectionIndex];
                    boundaryCache.emplace();
                    const auto quadRule = Dumux::CVFE::quadratureRule(fvGeometry, intersection);
                    boundaryCache->resize(std::ranges::size(quadRule));
                    for (const auto& qpData : quadRule)
                        (*boundaryCache)[qpData.ipData().qpIndex()].update(problem,
                                                                           element,
                                                                           fvGeometry,
                                                                           elemVars,
                                                                           qpData.ipData());
                }
                else
                    boundaryIntersectionCache_[intersectionIndex].reset();
            }
        }
 
        std::vector<std::vector<InterpolationPointData>> scvfCache_;
        std::vector<InterpolationPointData> elementCache_;
        std::array<std::optional<std::vector<InterpolationPointData>>, maxNumIntersections> boundaryIntersectionCache_;
    };
 
    const GridVariablesCache* gridVariablesCachePtr_;
    std::vector<Variables> variables_;
    std::shared_ptr<InterpolationPointDataCache> ipDataCache_;
};
 
} // end namespace Dumux::Experimental::CVFE
 
#endif