cvfe/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/common/typetraits/problem.hh>
#include <dumux/common/deprecated.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::BoundaryFaceQpIpData IpData>
    friend const InterpolationPointData& cache(const HybridCVFEElementVariables& elemVars,
                                               const IpData& ipData)
    { return elemVars.gridVariablesCache().boundaryFaceCache(elemVars.eIdx_, ipData.boundaryFaceIndex(), 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) &
    {
        const auto& gridDiscretization = Deprecated::gridGeometry(fvGeometry);
        eIdx_ = gridDiscretization.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 Problem = std::decay_t<decltype(std::declval<GVC>().problem())>;
    using GridGeometry = typename ProblemTraits<Problem>::GridGeometry;
    using GridView = typename GridGeometry::GridView;

    static constexpr std::size_t maxNumBoundaryFaces = 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
        const auto& gridDiscretization = Deprecated::gridGeometry(fvGeometry);
        auto elemSol = elementSolution(element, sol, gridDiscretization);
 
        // 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::BoundaryFaceQpIpData IpData>
    friend const InterpolationPointData& cache(const HybridCVFEElementVariables& elemVars,
                                               const IpData& ipData)
    { return elemVars.ipDataCache_->boundaryFaceCache(ipData.boundaryFaceIndex(), 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& boundaryFaceCache(std::size_t bfIdx, std::size_t qpIdx) const
        { return boundaryFaceCache_[bfIdx][qpIdx]; }
 
        // access operator
        InterpolationPointData& boundaryFaceCache(std::size_t bfIdx, std::size_t qpIdx)
        { return boundaryFaceCache_[bfIdx][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& boundaryFace : boundaryFaces(fvGeometry))
            {
                auto& bfCache = boundaryFaceCache_[boundaryFace.index()];
                const auto quadRule = Dumux::CVFE::quadratureRule(fvGeometry, boundaryFace);
                bfCache.resize(std::ranges::size(quadRule));
                for (const auto& qpData : quadRule)
                    bfCache[qpData.ipData().qpIndex()].update(problem,
                                                              element,
                                                              fvGeometry,
                                                              elemVars,
                                                              qpData.ipData());
            }
        }
 
        std::vector<std::vector<InterpolationPointData>> scvfCache_;
        std::vector<InterpolationPointData> elementCache_;
        std::array<std::vector<InterpolationPointData>, maxNumBoundaryFaces> boundaryFaceCache_;
    };
 
    const GridVariablesCache* gridVariablesCachePtr_;
    std::vector<Variables> variables_;
    std::shared_ptr<InterpolationPointDataCache> ipDataCache_;
};
 
} // end namespace Dumux::Experimental::CVFE
 
#endif