Detailed Description

A simple relative permeability function proposed by Kent S GeneralizedPower [39].

Definition:

\[ k_{\text{rel}} =\text{multiplier} \left(1-S^{\text{eff}}\right)^{\text{exponent}}\]

where \(S^{\text{eff}}\) is the effective saturation of the non-wetting phase.

This class handles the non-wetting (gas) phase portion of this relative permeability property for the relative permeability function.

This property must be a medium property, it computes the permeability reduction due to saturation as function of capillary pressure.

Definition at line 37 of file RelPermGeneralizedPowerNonwettingPhase.h.

#include <RelPermGeneralizedPowerNonwettingPhase.h>

Inheritance diagram for MaterialPropertyLib::RelPermGeneralizedPowerNonwettingPhase:

[legend]

Collaboration diagram for MaterialPropertyLib::RelPermGeneralizedPowerNonwettingPhase:

[legend]

Public Member Functions
	RelPermGeneralizedPowerNonwettingPhase (std::string name, const double residual_liquid_saturation, const double residual_gas_saturation, const double min_relative_permeability, const double a, const double lambda)

void	checkScale () const override

PropertyDataType	value (VariableArray const &variable_array, ParameterLib::SpatialPosition const &pos, double const t, double const dt) const override

PropertyDataType	dValue (VariableArray const &variable_array, Variable const variable, ParameterLib::SpatialPosition const &pos, double const t, double const dt) const override

Public Member Functions inherited from MaterialPropertyLib::Property
virtual	~Property ()

virtual PropertyDataType	initialValue (ParameterLib::SpatialPosition const &pos, double const t) const

virtual PropertyDataType	value () const

virtual PropertyDataType	value (VariableArray const &variable_array, VariableArray const &variable_array_prev, ParameterLib::SpatialPosition const &pos, double const t, double const dt) const

virtual PropertyDataType	dValue (VariableArray const &variable_array, VariableArray const &variable_array_prev, Variable const variable, ParameterLib::SpatialPosition const &pos, double const t, double const dt) const

virtual PropertyDataType	d2Value (VariableArray const &variable_array, Variable const variable1, Variable const variable2, ParameterLib::SpatialPosition const &pos, double const t, double const dt) const
	Default implementation: 2nd derivative of any constant property is zero.

virtual void	setProperties (std::vector< std::unique_ptr< Phase > > const &phases)
	Default implementation:

void	setScale (std::variant< Medium , Phase , Component * > scale)

template<typename T >
T	initialValue (ParameterLib::SpatialPosition const &pos, double const t) const

template<typename T >
T	value () const

template<typename T >
T	value (VariableArray const &variable_array, VariableArray const &variable_array_prev, ParameterLib::SpatialPosition const &pos, double const t, double const dt) const

template<typename T >
T	value (VariableArray const &variable_array, ParameterLib::SpatialPosition const &pos, double const t, double const dt) const

template<typename T >
T	dValue (VariableArray const &variable_array, VariableArray const &variable_array_prev, Variable const variable, ParameterLib::SpatialPosition const &pos, double const t, double const dt) const

template<typename T >
T	dValue (VariableArray const &variable_array, Variable const variable, ParameterLib::SpatialPosition const &pos, double const t, double const dt) const

template<typename T >
T	d2Value (VariableArray const &variable_array, Variable const &variable1, Variable const &variable2, ParameterLib::SpatialPosition const &pos, double const t, double const dt) const

Private Attributes
const double	residual_liquid_saturation_

const double	residual_gas_saturation_

const double	min_relative_permeability_

const double	a_

const double	lambda_

Additional Inherited Members
Protected Attributes inherited from MaterialPropertyLib::Property
std::string	name_

PropertyDataType	value_
	The single value of a property.

PropertyDataType	dvalue_

std::variant< Medium , Phase , Component * >	scale_

Constructor & Destructor Documentation

◆ RelPermGeneralizedPowerNonwettingPhase()

MaterialPropertyLib::RelPermGeneralizedPowerNonwettingPhase::RelPermGeneralizedPowerNonwettingPhase	(	std::string	name,
		const double	residual_liquid_saturation,
		const double	residual_gas_saturation,
		const double	min_relative_permeability,
		const double	a,
		const double	lambda )

Definition at line 19 of file RelPermGeneralizedPowerNonwettingPhase.cpp.

    : residual_liquid_saturation_(residual_liquid_saturation),
      residual_gas_saturation_(residual_gas_saturation),
      min_relative_permeability_(min_relative_permeability),
      a_(a),
      lambda_(lambda)
{
    name_ = std::move(name);
}

References MaterialPropertyLib::name, and MaterialPropertyLib::Property::name_.

Member Function Documentation

◆ checkScale()

void MaterialPropertyLib::RelPermGeneralizedPowerNonwettingPhase::checkScale ( ) const

inlineoverridevirtual

Reimplemented from MaterialPropertyLib::Property.

Definition at line 55 of file RelPermGeneralizedPowerNonwettingPhase.h.

    {
        if (!std::holds_alternative<Medium*>(scale_))
        {
            OGS_FATAL(
                "The property "
                "'RelativePermeabilityGeneralizedPowerNonwettingPhase' is "
                "implemented on the 'media' scale only.");
        }
    }

References OGS_FATAL, and MaterialPropertyLib::Property::scale_.

◆ dValue()

PropertyDataType MaterialPropertyLib::RelPermGeneralizedPowerNonwettingPhase::dValue	(	VariableArray const &	variable_array,
		Variable const	variable,
		ParameterLib::SpatialPosition const &	pos,
		double const	t,
		double const	dt ) const

overridevirtual

This virtual method will compute the property derivative value based on the variables that are passed as arguments with the default implementation using empty variables array for the previous time step.

The default implementation of this method only returns the property value derivative without altering it.

Reimplemented from MaterialPropertyLib::Property.

Definition at line 70 of file RelPermGeneralizedPowerNonwettingPhase.cpp.

{
    if (variable != Variable::liquid_saturation)
    {
        OGS_FATAL(
            "RelPermGeneralizedPowerNonwettingPhase::dValue is implemented for "
            "derivatives with respect to liquid saturation only.");
    }
 
    const double S_L = variable_array.liquid_saturation;
 
    auto const S_L_res = residual_liquid_saturation_;
    auto const S_L_max = 1. - residual_gas_saturation_;
    auto const S_e = (S_L - S_L_res) / (S_L_max - S_L_res);
 
    if ((S_e < 0.) || (S_e > 1.))
    {
        return 0.;
    }
 
    auto const dS_e_dS_L = 1. / (S_L_max - S_L_res);
 
    auto const dk_rel_GR_dS_e = -lambda_ * a_ * std::pow(1. - S_e, lambda_ - 1);
    return dk_rel_GR_dS_e * dS_e_dS_L;
}

References a_, lambda_, MaterialPropertyLib::liquid_saturation, MaterialPropertyLib::VariableArray::liquid_saturation, OGS_FATAL, residual_gas_saturation_, and residual_liquid_saturation_.

◆ value()

PropertyDataType MaterialPropertyLib::RelPermGeneralizedPowerNonwettingPhase::value	(	VariableArray const &	variable_array,
		ParameterLib::SpatialPosition const &	pos,
		double const	t,
		double const	dt ) const

overridevirtual

This virtual method will compute the property value based on the variables that are passed as arguments with the default implementation using empty variables array for the previous time step.

Reimplemented from MaterialPropertyLib::Property.

Definition at line 35 of file RelPermGeneralizedPowerNonwettingPhase.cpp.

{
    const double S_L = variable_array.liquid_saturation;
 
    if (std::isnan(S_L))
    {
        OGS_FATAL(
            "In RelPermGeneralizedPowerNonwettingPhase::value, the liquid "
            "saturation is "
            "NaN.");
    }
 
    auto const S_L_res = residual_liquid_saturation_;
    auto const S_L_max = 1. - residual_gas_saturation_;
 
    auto const S_e = (S_L - S_L_res) / (S_L_max - S_L_res);
 
    if (S_e >= 1.0)
    {
        // fully saturated medium
        return min_relative_permeability_;
    }
    if (S_e <= 0.0)
    {
        // dry medium
        return a_;
    }
 
    auto const S_e_g = (1. - S_e);
 
    return a_ * std::pow(S_e_g, lambda_);
}