staticinteractionvolume.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_CC_MPFA_O_STATIC_INTERACTIONVOLUME_HH
#define DUMUX_DISCRETIZATION_CC_MPFA_O_STATIC_INTERACTIONVOLUME_HH
 
#include <dune/common/fmatrix.hh>
#include <dune/common/fvector.hh>
#include <dune/common/exceptions.hh>
 
#include <dumux/common/math.hh>
 
#include <dumux/discretization/cellcentered/mpfa/interactionvolumebase.hh>
#include <dumux/discretization/cellcentered/mpfa/dualgridindexset.hh>
#include <dumux/discretization/cellcentered/mpfa/localfacedata.hh>
#include <dumux/discretization/cellcentered/mpfa/methods.hh>
 
#include "localassembler.hh"
#include "localsubcontrolentities.hh"
#include "interactionvolumeindexset.hh"
#include "interactionvolume.hh"
#include "scvgeometryhelper.hh"
 
namespace Dumux {
 
template< class Traits > class CCMpfaOStaticInteractionVolume;
 
template< class NI, class S, int C, int F >
struct CCMpfaODefaultStaticInteractionVolumeTraits
{
private:
    using GridIndexType = typename NI::GridIndexType;
    using LocalIndexType = typename NI::LocalIndexType;
 
    static constexpr int dim = NI::Traits::GridView::dimension;
    static constexpr int dimWorld = NI::Traits::GridView::dimensionworld;
 
    using DimVector = Dune::FieldVector<S, dim>;
    using FaceOmegas = Dune::ReservedVector<DimVector, 2>;
 
    struct MVTraits
    {
        using OmegaStorage = std::array< FaceOmegas, F >;
 
        using AMatrix = Dune::FieldMatrix< S, F, F >;
        using BMatrix = Dune::FieldMatrix< S, F, C >;
        using CMatrix = Dune::FieldMatrix< S, F, F >;
        using DMatrix = Dune::FieldMatrix< S, F, C >;
        using TMatrix = Dune::FieldMatrix< S, F, C >;
        using CellVector = Dune::FieldVector< S, C >;
        using FaceVector = Dune::FieldVector< S, F >;
    };
 
public:
    using GridView = typename NI::Traits::GridView;
    using IndexSet = CCMpfaOInteractionVolumeIndexSet< NI >;
    using LocalScvType = CCMpfaOInteractionVolumeLocalScv< IndexSet, S, dim, dimWorld >;
    using LocalScvfType = CCMpfaOInteractionVolumeLocalScvf< IndexSet >;
    using LocalFaceData = InteractionVolumeLocalFaceData<GridIndexType, LocalIndexType>;
    using MatVecTraits = MVTraits;
    static constexpr int numScvs = C;
    static constexpr int numScvfs = F;
 
    template<class Problem, class FVElementGeometry, class ElemVolVars>
    using LocalAssembler = MpfaOInteractionVolumeAssembler<Problem, FVElementGeometry, ElemVolVars>;
};
 
template< class Traits >
class CCMpfaOStaticInteractionVolume
: public CCMpfaInteractionVolumeBase< Traits >
{
    using GridView = typename Traits::GridView;
    using Element = typename GridView::template Codim<0>::Entity;
 
    using IndexSet = typename Traits::IndexSet;
    using GridIndexType = typename IndexSet::GridIndexType;
    using LocalIndexType = typename IndexSet::LocalIndexType;
    using Stencil = typename IndexSet::NodalGridStencilType;
 
    using LocalScvType = typename Traits::LocalScvType;
    using LocalScvfType = typename Traits::LocalScvfType;
    using LocalFaceData = typename Traits::LocalFaceData;
 
    static constexpr int numScvf = Traits::numScvfs;
    static constexpr int numScv = Traits::numScvs;
 
public:
    static_assert(int(GridView::dimension)==int(GridView::dimensionworld), "static iv does not work on surface grids");
 
    struct DirichletData
    {
        GridIndexType volVarIndex() const
        { DUNE_THROW(Dune::InvalidStateException, "Static interaction volume cannot be used on boundaries!"); }
    };
 
    static constexpr MpfaMethods MpfaMethod = MpfaMethods::oMethod;
 
    template< class Problem, class FVElementGeometry >
    void bind(const IndexSet& indexSet,
              const Problem& problem,
              const FVElementGeometry& fvGeometry)
    {
        // for the o-scheme, the stencil is equal to the scv
        // index set of the dual grid's nodal index set
        assert(indexSet.numScvs() == numScv);
        stencil_ = &indexSet.nodalIndexSet().gridScvIndices();
 
        // set up stuff related to sub-control volumes
        for (LocalIndexType scvIdxLocal = 0; scvIdxLocal < numScv; scvIdxLocal++)
        {
            elements_[scvIdxLocal] = fvGeometry.gridGeometry().element( stencil()[scvIdxLocal] );
            scvs_[scvIdxLocal] = LocalScvType(fvGeometry.gridGeometry().mpfaHelper(),
                                              fvGeometry,
                                              fvGeometry.scv( stencil()[scvIdxLocal] ),
                                              scvIdxLocal,
                                              indexSet);
        }
 
        // set up quantities related to sub-control volume faces
        for (LocalIndexType faceIdxLocal = 0; faceIdxLocal < numScvf; ++faceIdxLocal)
        {
            const auto& scvf = fvGeometry.scvf(indexSet.gridScvfIndex(faceIdxLocal));
            assert(!scvf.boundary());
 
            // the neighboring scvs in local indices (order: 0 - inside scv, 1..n - outside scvs)
            const auto& neighborScvIndicesLocal = indexSet.neighboringLocalScvIndices(faceIdxLocal);
 
            // create iv-local scvf objects
            scvfs_[faceIdxLocal] = LocalScvfType(scvf, neighborScvIndicesLocal, faceIdxLocal, /*isDirichlet*/false);
            localFaceData_[faceIdxLocal*2] = LocalFaceData(faceIdxLocal, neighborScvIndicesLocal[0], scvf.index());
 
            // add local face data objects for the outside face
            const auto outsideLocalScvIdx = neighborScvIndicesLocal[1];
            for (int coord = 0; coord < GridView::dimension; ++coord)
            {
                if (indexSet.localScvfIndex(outsideLocalScvIdx, coord) == faceIdxLocal)
                {
                    const auto globalScvfIdx = indexSet.nodalIndexSet().gridScvfIndex(outsideLocalScvIdx, coord);
                    const auto& flipScvf = fvGeometry.scvf(globalScvfIdx);
                    localFaceData_[faceIdxLocal*2+1] = LocalFaceData(faceIdxLocal,       // iv-local scvf idx
                                                                     outsideLocalScvIdx, // iv-local scv index
                                                                     0,                  // scvf-local index in outside faces
                                                                     flipScvf.index());  // global scvf index
                    break; // go to next outside face
                }
            }
 
            // make sure we found it
            assert(localFaceData_[faceIdxLocal*2+1].ivLocalInsideScvIndex() == outsideLocalScvIdx);
        }
    }
 
    static constexpr std::size_t numFaces()
    { return numScvf; }
 
    static constexpr std::size_t numUnknowns()
    { return numScvf; }
 
    static constexpr std::size_t numKnowns()
    { return numScv; }
 
    static constexpr std::size_t numScvs()
    { return numScv; }
 
    const Stencil& stencil() const
    { return *stencil_; }
 
    const Element& element(LocalIndexType ivLocalScvIdx) const
    { return elements_[ivLocalScvIdx]; }
 
    const LocalScvfType& localScvf(LocalIndexType ivLocalScvfIdx) const
    { return scvfs_[ivLocalScvfIdx]; }
 
    const LocalScvType& localScv(LocalIndexType ivLocalScvIdx) const
    { return scvs_[ivLocalScvIdx]; }
 
    const std::array<LocalFaceData, numScvf*2>& localFaceData() const
    { return localFaceData_; }
 
    const std::array<DirichletData, 0>& dirichletData() const
    { return dirichletData_; }
 
    template< class FVElementGeometry >
    auto getScvGeometry(LocalIndexType ivLocalScvIdx, const FVElementGeometry& fvGeometry) const
    { return CCMpfaOScvGeometryHelper<LocalScvType>::computeScvGeometry(ivLocalScvIdx, *this, fvGeometry); }
 
    template< class NI >
    static constexpr std::size_t numIVAtVertex(const NI& nodalIndexSet)
    { return 1; }
 
    template< class IvIndexSetContainer,
              class ScvfIndexMap,
              class NodalIndexSet,
              class FlipScvfIndexSet >
    static void addIVIndexSets(IvIndexSetContainer& ivIndexSetContainer,
                               ScvfIndexMap& scvfIndexMap,
                               const NodalIndexSet& nodalIndexSet,
                               const FlipScvfIndexSet& flipScvfIndexSet)
    {
        // reuse the standard o-method's implementation of this
        CCMpfaOInteractionVolume<Traits>::addIVIndexSets(ivIndexSetContainer,
                                                         scvfIndexMap,
                                                         nodalIndexSet,
                                                         flipScvfIndexSet);
    }
 
private:
    // pointer to cell stencil (in iv index set)
    const Stencil * stencil_ = nullptr;
 
    // Variables defining the local scope
    std::array<Element, numScv> elements_;
    std::array<LocalScvType, numScv> scvs_;
    std::array<LocalScvfType, numScvf> scvfs_;
    std::array<LocalFaceData, numScvf*2> localFaceData_;
 
    // Dummy dirichlet data container (compatibility with dynamic o-iv)
    std::array<DirichletData, 0> dirichletData_;
};
 
} // end namespace Dumux
 
#endif