smoothedlinearlaw.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_MATERIAL_FLUIDMATRIX_TWOP_SMOOTHED_LINEAR_LAW_HH
#define DUMUX_MATERIAL_FLUIDMATRIX_TWOP_SMOOTHED_LINEAR_LAW_HH
 
 
#include <cmath>
#include <algorithm>
 
#include <dumux/common/parameters.hh>
#include <dumux/common/spline.hh>
#include <dumux/material/fluidmatrixinteractions/2p/efftoabsdefaultpolicy.hh>
#include <dumux/material/fluidmatrixinteractions/fluidmatrixinteraction.hh>
 
namespace Dumux::FluidMatrix {
 
template<class ScalarType, class EffToAbsPolicy = TwoPEffToAbsDefaultPolicy>
class SmoothedLinearLaw : public Adapter<SmoothedLinearLaw<ScalarType, EffToAbsPolicy>, PcKrSw>
{
 
public:
    using Scalar = ScalarType;
    using EffToAbsParams = typename EffToAbsPolicy::template Params<Scalar>;
    using EffToAbs = EffToAbsPolicy;
 
    static constexpr bool isRegularized()
    { return false; }
 
    static constexpr int numFluidPhases()
    { return 2; }
 
    struct Params
    {
        Params(Scalar pe, Scalar pcMax, Scalar krLowS, Scalar krHighS)
        : pe_(pe), pcMax_(pcMax), krLowS_(krLowS), krHighS_(krHighS)
        {}
 
        Scalar pe() const { return pe_; }
        void setPe(Scalar pe) { pe_ = pe; }
 
        Scalar pcMax() const { return pcMax_; }
        void setPcMax(Scalar pcMax) { pcMax_ = pcMax; }
 
        Scalar krLowS() const { return krLowS_; }
        void setKrLowS(Scalar krLowS) { krLowS_ = krLowS; }
 
        Scalar krHighS() const { return krHighS_; }
        void setKrHighS(Scalar krHighS) { krHighS_ = krHighS; }
 
        bool operator== (const Params& p) const
        {
            return Dune::FloatCmp::eq(pe(), p.pe(), 1e-6)
                   && Dune::FloatCmp::eq(pcMax(), p.pcMax(), 1e-6)
                   && Dune::FloatCmp::eq(krLowS(), p.krLowS(), 1e-6)
                   && Dune::FloatCmp::eq(krHighS(), p.krHighS(), 1e-6);
        }
 
    private:
        Scalar pe_, pcMax_, krLowS_, krHighS_;
    };
 
    SmoothedLinearLaw() = delete;
 
    explicit SmoothedLinearLaw(const std::string& paramGroup)
    : SmoothedLinearLaw(makeParams(paramGroup), EffToAbs::template makeParams<Scalar>(paramGroup))
    {}
 
    SmoothedLinearLaw(const Params& params,
                      const EffToAbsParams& effToAbsParams = {})
    : params_(params)
    , effToAbsParams_(effToAbsParams)
    , splineM_((1.0 - ((1.0 - params_.krHighS()) + params_.krLowS())/2.0 )
               / (1.0 - (1.0 - params_.krHighS()) - params_.krLowS()))
    , splineLowS_(0.0, params_.krLowS(), // x1, x2
                  0.0, params_.krLowS()/2.0, // y1, y2
                  0.0, splineM_) // m1, m2
    , splineHighS_(params_.krHighS(), 1.0, // x1, x2
                   1.0 - (1.0 - params_.krHighS())/2.0, 1.0, // y1, y2
                   splineM_, 0.0) // m1, m2
    {}
 
    static Params makeParams(const std::string& paramGroup)
    {
        const auto pe = getParamFromGroup<Scalar>(paramGroup, "SmoothedLinearLawPe");
        const auto pcMax = getParamFromGroup<Scalar>(paramGroup, "SmoothedLinearLawPcMax");
        const auto krLowS = getParamFromGroup<Scalar>(paramGroup, "SmoothedLinearLawKrLowS");
        const auto krHighS = getParamFromGroup<Scalar>(paramGroup, "SmoothedLinearLawKrHighS");
        return {pe, pcMax, krLowS, krHighS};
    }
 
    Scalar pc(Scalar swe) const
    {
        return (1.0 - swe)*(params_.pcMax() - params_.pe()) + params_.pe();
    }
 
    Scalar swe(Scalar pc) const
    {
        return 1.0 - (pc - params_.pe())/(params_.pcMax() - params_.pe());
    }
 
    Scalar endPointPc() const
    { return params_.pe(); }
 
    Scalar dpc_dswe(Scalar swe) const
    {
        return params_.pe() - params_.pcMax();
    }
 
    Scalar dswe_dpc(Scalar pc) const
    {
        return 1.0/(params_.pe() - params_.pcMax());
    }
 
    Scalar krw(Scalar swe) const
    {
        return relperm_(swe);
    }
 
    Scalar krn(Scalar swe) const
    {
        Scalar sne = 1.0 - swe;
        return relperm_(sne);
    }
 
    bool operator== (const SmoothedLinearLaw<Scalar, EffToAbs>& o) const
    {
        return params_ == o.params_
               && effToAbsParams_ == o.effToAbsParams_;
    }
 
    const EffToAbsParams& effToAbsParams() const
    { return effToAbsParams_; }
 
private:
 
    Scalar relperm_(Scalar S) const
    {
        const Scalar lowS = params_.krLowS();
        const Scalar highS = params_.krHighS();
 
        // check whether the saturation is unpyhsical
        if (S >= 1.0)
            return 1.0;
        else if (S <= 0.0)
            return 0;
        // check whether the permeability needs to be regularized
        else if (S < lowS)
            return splineLowS_.eval(S);
        else if (S > highS)
            return splineHighS_.eval(S);
 
        // straight line for S \in [lowS, highS]
        return lowS/2.0 + splineM_*(S - lowS);
    }
 
    Params params_;
    EffToAbsParams effToAbsParams_;
    Scalar splineM_;
    Dumux::Spline<Scalar> splineLowS_;
    Dumux::Spline<Scalar> splineHighS_;
};
} // end namespace Dumux::FluidMatrix
 
#endif