cellcentered/mpfa/elementvolumevariables.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_DISCRETIZATION_CCMPFA_ELEMENT_VOLUMEVARIABLES_HH
#define DUMUX_DISCRETIZATION_CCMPFA_ELEMENT_VOLUMEVARIABLES_HH
 
#include <algorithm>
#include <type_traits>
#include <utility>
#include <vector>
#include <utility>
 
#include <dumux/discretization/cellcentered/elementsolution.hh>
 
namespace Dumux {
namespace CCMpfa {
 
    template<class FVElementGeometry>
    std::size_t maxNumBoundaryVolVars(const FVElementGeometry& fvGeometry)
    {
        const auto& gridGeometry = fvGeometry.gridGeometry();
        const auto& gridIvIndexSets = gridGeometry.gridInteractionVolumeIndexSets();
 
        std::size_t numBoundaryVolVars = 0;
        for (const auto& scvf : scvfs(fvGeometry))
        {
            if (!gridGeometry.vertexUsesSecondaryInteractionVolume(scvf.vertexIndex()))
                numBoundaryVolVars += gridIvIndexSets.primaryIndexSet(scvf).nodalIndexSet().numBoundaryScvfs();
            else
                numBoundaryVolVars += gridIvIndexSets.secondaryIndexSet(scvf).nodalIndexSet().numBoundaryScvfs();
        }
 
        return numBoundaryVolVars;
    }
 
    template<class VolumeVariables, class IndexType, class Problem, class FVElemGeom, class NodalIndexSet>
    void addBoundaryVolVarsAtNode(std::vector<VolumeVariables>& volVars,
                                  std::vector<IndexType>& volVarIndices,
                                  const Problem& problem,
                                  const typename FVElemGeom::GridGeometry::GridView::template Codim<0>::Entity& element,
                                  const FVElemGeom& fvGeometry,
                                  const NodalIndexSet& nodalIndexSet)
    {
        if (nodalIndexSet.numBoundaryScvfs() == 0)
            return;
 
        // index of the element the fvGeometry was bound to
        const auto boundElemIdx = fvGeometry.gridGeometry().elementMapper().index(element);
 
        // check each scvf in the index set for boundary presence
        for (auto scvfIdx : nodalIndexSet.gridScvfIndices())
        {
            const auto& ivScvf = fvGeometry.scvf(scvfIdx);
 
            // only proceed for scvfs on the boundary and not in the bound element
            if (!ivScvf.boundary() || ivScvf.insideScvIdx() == boundElemIdx)
                continue;
 
            const auto insideScvIdx = ivScvf.insideScvIdx();
            const auto insideElement = fvGeometry.gridGeometry().element(insideScvIdx);
            const auto bcTypes = problem.boundaryTypes(insideElement, ivScvf);
 
            // Only proceed on dirichlet boundaries. On Neumann
            // boundaries the "outside" vol vars cannot be properly defined.
            if (bcTypes.hasOnlyDirichlet())
            {
                VolumeVariables dirichletVolVars;
                dirichletVolVars.update(elementSolution<FVElemGeom>(problem.dirichlet(insideElement, ivScvf)),
                                        problem,
                                        insideElement,
                                        fvGeometry.scv(insideScvIdx));
 
                volVars.emplace_back(std::move(dirichletVolVars));
                volVarIndices.push_back(ivScvf.outsideScvIdx());
            }
        }
    }
 
    template<class VolumeVariables, class IndexType, class Problem, class FVElemGeom>
    void addBoundaryVolVars(std::vector<VolumeVariables>& volVars,
                            std::vector<IndexType>& volVarIndices,
                            const Problem& problem,
                            const typename FVElemGeom::GridGeometry::GridView::template Codim<0>::Entity& element,
                            const FVElemGeom& fvGeometry)
    {
        const auto& gridGeometry = fvGeometry.gridGeometry();
 
        // treat the BCs inside the element
        if (fvGeometry.hasBoundaryScvf())
        {
            const auto boundElemIdx = gridGeometry.elementMapper().index(element);
            const auto& scvI = fvGeometry.scv(boundElemIdx);
 
            for (const auto& scvf : scvfs(fvGeometry))
            {
                if (!scvf.boundary())
                    continue;
 
                // Only proceed on dirichlet boundaries. On Neumann
                // boundaries the "outside" vol vars cannot be properly defined.
                if (problem.boundaryTypes(element, scvf).hasOnlyDirichlet())
                {
                    VolumeVariables dirichletVolVars;
                    dirichletVolVars.update(elementSolution<FVElemGeom>(problem.dirichlet(element, scvf)),
                                            problem,
                                            element,
                                            scvI);
 
                    volVars.emplace_back(std::move(dirichletVolVars));
                    volVarIndices.push_back(scvf.outsideScvIdx());
                }
            }
        }
 
        // Update boundary volume variables in the neighbors
        const auto& gridIvIndexSets = gridGeometry.gridInteractionVolumeIndexSets();
        for (const auto& scvf : scvfs(fvGeometry))
        {
            if (!gridGeometry.vertexUsesSecondaryInteractionVolume(scvf.vertexIndex()))
                addBoundaryVolVarsAtNode( volVars, volVarIndices, problem, element, fvGeometry,
                                          gridIvIndexSets.primaryIndexSet(scvf).nodalIndexSet() );
            else
                addBoundaryVolVarsAtNode( volVars, volVarIndices, problem, element, fvGeometry,
                                          gridIvIndexSets.secondaryIndexSet(scvf).nodalIndexSet() );
        }
    }
} // end namespace CCMpfa
 
template<class GVV, bool cachingEnabled>
class CCMpfaElementVolumeVariables;
 
template<class GVV>
class CCMpfaElementVolumeVariables<GVV, /*cachingEnabled*/true>
{
public:
    using GridVolumeVariables = GVV;
 
    using VolumeVariables = typename GridVolumeVariables::VolumeVariables;
 
    CCMpfaElementVolumeVariables(const GridVolumeVariables& gridVolVars)
    : gridVolVarsPtr_(&gridVolVars)
    , numScv_(gridVolVars.problem().gridGeometry().numScv())
    {}
 
    template<class SubControlVolume, typename std::enable_if_t<!std::is_integral<SubControlVolume>::value, int> = 0>
    const VolumeVariables& operator [](const SubControlVolume& scv) const
    {
        return scv.dofIndex() < numScv_ ? gridVolVars().volVars(scv.dofIndex())
                                        : boundaryVolVars_[getLocalIdx_(scv.dofIndex())];
    }
 
    const VolumeVariables& operator [](const std::size_t scvIdx) const
    {
        return scvIdx < numScv_ ? gridVolVars().volVars(scvIdx)
                                : boundaryVolVars_[getLocalIdx_(scvIdx)];
    }
 
    template<class FVElementGeometry, class SolutionVector>
    CCMpfaElementVolumeVariables bind(const typename FVElementGeometry::GridGeometry::GridView::template Codim<0>::Entity& element,
                                      const FVElementGeometry& fvGeometry,
                                      const SolutionVector& sol) &&
    {
        this->bind_(element, fvGeometry, sol);
        return std::move(*this);
    }
 
    template<class FVElementGeometry, class SolutionVector>
    void bind(const typename FVElementGeometry::GridGeometry::GridView::template Codim<0>::Entity& element,
              const FVElementGeometry& fvGeometry,
              const SolutionVector& sol) &
    { this->bind_(element, fvGeometry, sol); }
 
    template<class FVElementGeometry, class SolutionVector>
    CCMpfaElementVolumeVariables 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);
    }
 
    template<class FVElementGeometry, class SolutionVector>
    void bindElement(const typename FVElementGeometry::GridGeometry::GridView::template Codim<0>::Entity& element,
                     const FVElementGeometry& fvGeometry,
                     const SolutionVector& sol) &
    { this->bindElement_(element, fvGeometry, sol); }
 
    void clear()
    {
        boundaryVolVarIndices_.clear();
        boundaryVolVars_.clear();
    }
 
    const GridVolumeVariables& gridVolVars() const
    { return *gridVolVarsPtr_; }
 
private:
    int getLocalIdx_(const int volVarIdx) const
    {
        auto it = std::find(boundaryVolVarIndices_.begin(), boundaryVolVarIndices_.end(), volVarIdx);
        assert(it != boundaryVolVarIndices_.end() && "Could not find the current volume variables for volVarIdx!");
        return std::distance(boundaryVolVarIndices_.begin(), it);
    }
 
    template<class FVElementGeometry, class SolutionVector>
    void bind_(const typename FVElementGeometry::GridGeometry::GridView::template Codim<0>::Entity& element,
               const FVElementGeometry& fvGeometry,
               const SolutionVector& sol)
    {
        clear();
 
        // maybe prepare boundary volume variables
        const auto maxNumBoundaryVolVars = CCMpfa::maxNumBoundaryVolVars(fvGeometry);
        if (maxNumBoundaryVolVars > 0)
        {
            boundaryVolVars_.reserve(maxNumBoundaryVolVars);
            boundaryVolVarIndices_.reserve(maxNumBoundaryVolVars);
            CCMpfa::addBoundaryVolVars(boundaryVolVars_, boundaryVolVarIndices_, gridVolVars().problem(), element, fvGeometry);
        }
    }
 
    template<class FVElementGeometry, class SolutionVector>
    void bindElement_(const typename FVElementGeometry::GridGeometry::GridView::template Codim<0>::Entity& element,
                      const FVElementGeometry& fvGeometry,
                      const SolutionVector& sol)
    {}
 
    const GridVolumeVariables* gridVolVarsPtr_;
 
    std::size_t numScv_;
    std::vector<std::size_t> boundaryVolVarIndices_;
    std::vector<VolumeVariables> boundaryVolVars_;
};
 
 
template<class GVV>
class CCMpfaElementVolumeVariables<GVV, /*cachingEnabled*/false>
{
public:
    using GridVolumeVariables = GVV;
 
    using VolumeVariables = typename GridVolumeVariables::VolumeVariables;
 
    CCMpfaElementVolumeVariables(const GridVolumeVariables& gridVolVars)
    : gridVolVarsPtr_(&gridVolVars) {}
 
    template<class SubControlVolume, typename std::enable_if_t<!std::is_integral<SubControlVolume>::value, int> = 0>
    const VolumeVariables& operator [](const SubControlVolume& scv) const
    { return volumeVariables_[getLocalIdx_(scv.dofIndex())]; }
 
    template<class SubControlVolume, typename std::enable_if_t<!std::is_integral<SubControlVolume>::value, int> = 0>
    VolumeVariables& operator [](const SubControlVolume& scv)
    { return volumeVariables_[getLocalIdx_(scv.dofIndex())]; }
 
    const VolumeVariables& operator [](std::size_t scvIdx) const
    { return volumeVariables_[getLocalIdx_(scvIdx)]; }
 
    VolumeVariables& operator [](std::size_t scvIdx)
    { return volumeVariables_[getLocalIdx_(scvIdx)]; }
 
    template<class FVElementGeometry, class SolutionVector>
    CCMpfaElementVolumeVariables bind(const typename FVElementGeometry::GridGeometry::GridView::template Codim<0>::Entity& element,
                                      const FVElementGeometry& fvGeometry,
                                      const SolutionVector& sol) &&
    {
        this->bind_(element, fvGeometry, sol);
        return std::move(*this);
    }
 
    template<class FVElementGeometry, class SolutionVector>
    void bind(const typename FVElementGeometry::GridGeometry::GridView::template Codim<0>::Entity& element,
              const FVElementGeometry& fvGeometry,
              const SolutionVector& sol) &
    { this->bind_(element, fvGeometry, sol); }
 
    template<class FVElementGeometry, class SolutionVector>
    CCMpfaElementVolumeVariables 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);
    }
 
    template<class FVElementGeometry, class SolutionVector>
    void bindElement(const typename FVElementGeometry::GridGeometry::GridView::template Codim<0>::Entity& element,
                     const FVElementGeometry& fvGeometry,
                     const SolutionVector& sol) &
    { this->bindElement_(element, fvGeometry, sol); }
 
    const GridVolumeVariables& gridVolVars() const
    { return *gridVolVarsPtr_; }
 
    void clear()
    {
        volVarIndices_.clear();
        volumeVariables_.clear();
    }
 
private:
 
    template<class FVElementGeometry, class SolutionVector>
    void bind_(const typename FVElementGeometry::GridGeometry::GridView::template Codim<0>::Entity& element,
               const FVElementGeometry& fvGeometry,
               const SolutionVector& sol)
    {
        clear();
 
        const auto& problem = gridVolVars().problem();
        const auto& gridGeometry = fvGeometry.gridGeometry();
 
        // stencil information
        const auto globalI = gridGeometry.elementMapper().index(element);
        const auto& assemblyMapI = gridGeometry.connectivityMap()[globalI];
        const auto numVolVars = assemblyMapI.size() + 1;
 
        // resize local containers to the required size (for internal elements)
        const auto maxNumBoundaryVolVars = CCMpfa::maxNumBoundaryVolVars(fvGeometry);
        volumeVariables_.reserve(numVolVars+maxNumBoundaryVolVars);
        volVarIndices_.reserve(numVolVars+maxNumBoundaryVolVars);
 
        VolumeVariables volVars;
        const auto& scvI = fvGeometry.scv(globalI);
        volVars.update(elementSolution(element, sol, gridGeometry),
                       problem,
                       element,
                       scvI);
 
        volVarIndices_.push_back(scvI.dofIndex());
        volumeVariables_.emplace_back(std::move(volVars));
 
        // Update the volume variables of the neighboring elements
        for (auto&& dataJ : assemblyMapI)
        {
            const auto& elementJ = gridGeometry.element(dataJ.globalJ);
            const auto& scvJ = fvGeometry.scv(dataJ.globalJ);
            VolumeVariables volVarsJ;
            volVarsJ.update(elementSolution(elementJ, sol, gridGeometry),
                            problem,
                            elementJ,
                            scvJ);
 
            volVarIndices_.push_back(scvJ.dofIndex());
            volumeVariables_.emplace_back(std::move(volVarsJ));
        }
 
        // maybe prepare boundary volume variables
        if (maxNumBoundaryVolVars > 0)
            CCMpfa::addBoundaryVolVars(volumeVariables_, volVarIndices_, problem, element, fvGeometry);
 
        // //! TODO Check if user added additional DOF dependencies, i.e. the residual of DOF globalI depends
        // //! on additional DOFs not included in the discretization schemes' occupation pattern
        // const auto& additionalDofDependencies = problem.getAdditionalDofDependencies(globalI);
        // if (!additionalDofDependencies.empty())
        // {
        //     volumeVariables_.reserve(volumeVariables_.size() + additionalDofDependencies.size());
        //     volVarIndices_.reserve(volVarIndices_.size() + additionalDofDependencies.size());
        //     for (auto globalJ : additionalDofDependencies)
        //     {
        //         const auto& elementJ = gridGeometry.element(globalJ);
        //         const auto& scvJ = fvGeometry.scv(globalJ);
 
        //         VolumeVariables additionalVolVars;
        //         additionalVolVars.update(elementSolution(elementJ, sol, gridGeometry),
        //                                  problem,
        //                                  elementJ,
        //                                  scvJ);
 
        //         volumeVariables_.emplace_back(std::move(additionalVolVars));
        //         volVarIndices_.push_back(globalJ);
        //     }
        // }
    }
 
    template<class FVElementGeometry, class SolutionVector>
    void bindElement_(const typename FVElementGeometry::GridGeometry::GridView::template Codim<0>::Entity& element,
                      const FVElementGeometry& fvGeometry,
                      const SolutionVector& sol)
    {
        clear();
 
        const auto& gridGeometry = fvGeometry.gridGeometry();
        auto eIdx = gridGeometry.elementMapper().index(element);
        volumeVariables_.resize(1);
        volVarIndices_.resize(1);
 
        // update the volume variables of the element
        const auto& scv = fvGeometry.scv(eIdx);
        volumeVariables_[0].update(elementSolution(element, sol, gridGeometry),
                                   gridVolVars().problem(),
                                   element,
                                   scv);
        volVarIndices_[0] = scv.dofIndex();
    }
 
    const GridVolumeVariables* gridVolVarsPtr_;
 
    int getLocalIdx_(const int volVarIdx) const
    {
        auto it = std::find(volVarIndices_.begin(), volVarIndices_.end(), volVarIdx);
        assert(it != volVarIndices_.end() && "Could not find the current volume variables for volVarIdx!");
        return std::distance(volVarIndices_.begin(), it);
    }
 
    std::vector<std::size_t> volVarIndices_;
    std::vector<VolumeVariables> volumeVariables_;
};
 
} // end namespace Dumux
 
#endif