OGS
MaterialPropertyLib::StrainDependentPermeability< DisplacementDim > Class Template Referencefinal

Detailed Description

template<int DisplacementDim>
class MaterialPropertyLib::StrainDependentPermeability< DisplacementDim >

A strain dependent intrinsic permeability model.

The model was proposed in [34] and it was further investigated in [35] .

The model takes the form of

\[ \mathbf{k} =f(\epsilon_v) e^{b_1 {\bar\epsilon}^p}\mathbf{k}_0 \]

with

\[ f(\epsilon_v)= \begin{cases} 10^{b_2 \epsilon_v}, & \epsilon_v <=0\\ 10^{b_3 \epsilon_v}, & \epsilon_v >0 \end{cases} \]

where

\( \epsilon_v \) the volumetric strain,
\( {\bar\epsilon}^p\) the equivalent plastic strain,
\(\mathbf{k}_0\) the initial intrinsic permeability,
\(b_1,\,b_2,\,b_3\) the three parameters.
  • Note: In [34] and [35] , from the point of view of experiment of permeability change, the symbols of \( \Delta \epsilon_v \) and \(\Delta {\bar\epsilon}^p\) are used for \( \epsilon_v \) and \( {\bar\epsilon}^p\), respectively. That means that the symbols of \( \Delta \epsilon_v \) and \(\Delta {\bar\epsilon}^p\) refer to the increment of the volumetric strain and the increment of the equivalent plastic strain, respectively, from the beginning of the experiment.

Definition at line 63 of file StrainDependentPermeability.h.

#include <StrainDependentPermeability.h>

Inheritance diagram for MaterialPropertyLib::StrainDependentPermeability< DisplacementDim >:
[legend]
Collaboration diagram for MaterialPropertyLib::StrainDependentPermeability< DisplacementDim >:
[legend]

Public Member Functions

 StrainDependentPermeability (std::string name, ParameterLib::Parameter< double > const &k0, double const b1, double const b2, double const b3, double const minimum_permeability, double const maximum_permeability, ParameterLib::CoordinateSystem const *const local_coordinate_system)
 
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. More...
 
void setScale (std::variant< Medium *, Phase *, Component * > scale)
 
template<typename T >
initialValue (ParameterLib::SpatialPosition const &pos, double const t) const
 
template<typename T >
value () const
 
template<typename 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 >
value (VariableArray const &variable_array, ParameterLib::SpatialPosition const &pos, double const t, double const dt) const
 
template<typename 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 >
dValue (VariableArray const &variable_array, Variable const variable, ParameterLib::SpatialPosition const &pos, double const t, double const dt) const
 
template<typename 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

ParameterLib::Parameter< double > const & k0_
 Initial intrinsic permeability. More...
 
double const b1_
 
double const b2_
 
double const b3_
 
double const minimum_permeability_
 
double const maximum_permeability_
 
ParameterLib::CoordinateSystem const *const local_coordinate_system_
 

Additional Inherited Members

- Protected Attributes inherited from MaterialPropertyLib::Property
std::string name_
 
PropertyDataType value_
 The single value of a property. More...
 
PropertyDataType dvalue_
 
std::variant< Medium *, Phase *, Component * > scale_
 

Constructor & Destructor Documentation

◆ StrainDependentPermeability()

template<int DisplacementDim>
MaterialPropertyLib::StrainDependentPermeability< DisplacementDim >::StrainDependentPermeability ( std::string  name,
ParameterLib::Parameter< double > const &  k0,
double const  b1,
double const  b2,
double const  b3,
double const  minimum_permeability,
double const  maximum_permeability,
ParameterLib::CoordinateSystem const *const  local_coordinate_system 
)

Definition at line 26 of file StrainDependentPermeability.cpp.

31  : k0_(k0),
32  b1_(b1),
33  b2_(b2),
34  b3_(b3),
35  minimum_permeability_(minimum_permeability),
36  maximum_permeability_(maximum_permeability),
37  local_coordinate_system_(local_coordinate_system)
38 {
39  name_ = std::move(name);
40 }
ParameterLib::Parameter< double > const & k0_
Initial intrinsic permeability.
ParameterLib::CoordinateSystem const *const local_coordinate_system_

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

Member Function Documentation

◆ checkScale()

template<int DisplacementDim>
void MaterialPropertyLib::StrainDependentPermeability< DisplacementDim >::checkScale
overridevirtual

Reimplemented from MaterialPropertyLib::Property.

Definition at line 43 of file StrainDependentPermeability.cpp.

44 {
45  if (!std::holds_alternative<Medium*>(scale_))
46  {
47  OGS_FATAL(
48  "The property 'StrainDependentPermeability' is "
49  "implemented on the 'medium' scale only.");
50  }
51 }
#define OGS_FATAL(...)
Definition: Error.h:26
std::variant< Medium *, Phase *, Component * > scale_
Definition: Property.h:287

References OGS_FATAL.

◆ dValue()

template<int DisplacementDim>
PropertyDataType MaterialPropertyLib::StrainDependentPermeability< DisplacementDim >::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 99 of file StrainDependentPermeability.cpp.

103 {
104  if (variable == Variable::mechanical_strain)
105  {
106  return 0.;
107  }
108 
109  OGS_FATAL(
110  "The derivative of the intrinsic permeability of "
111  "StrainDependentPermeabilityis not implemented.");
112 }

References MaterialPropertyLib::mechanical_strain, and OGS_FATAL.

◆ value()

template<int DisplacementDim>
PropertyDataType MaterialPropertyLib::StrainDependentPermeability< DisplacementDim >::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 54 of file StrainDependentPermeability.cpp.

58 {
59  double const e_vol = std::get<double>(
60  variable_array[static_cast<int>(Variable::volumetric_strain)]);
61  double const e_vol_pls = std::get<double>(
62  variable_array[static_cast<int>(Variable::equivalent_plastic_strain)]);
63 
64  auto k_data = k0_(t, pos);
65 
66  double const ten_base_exponent = e_vol > 0.0 ? b3_ * e_vol : b2_ * e_vol;
67  double const factor =
68  std::pow(10.0, ten_base_exponent) * std::exp(b1_ * e_vol_pls);
69 
70  for (auto& k_i : k_data)
71  {
72  k_i = std::clamp(k_i * factor, minimum_permeability_,
74  }
75 
76  // Local coordinate transformation is only applied for the case that the
77  // initial intrinsic permeability is given with orthotropic assumption.
78  if (local_coordinate_system_ && (k_data.size() == DisplacementDim))
79  {
80  Eigen::Matrix<double, DisplacementDim, DisplacementDim> const e =
81  local_coordinate_system_->transformation<DisplacementDim>(pos);
82  Eigen::Matrix<double, DisplacementDim, DisplacementDim> k =
83  Eigen::Matrix<double, DisplacementDim, DisplacementDim>::Zero();
84 
85  for (int i = 0; i < DisplacementDim; ++i)
86  {
87  Eigen::Matrix<double, DisplacementDim, DisplacementDim> const
88  ei_otimes_ei = e.col(i) * e.col(i).transpose();
89 
90  k += k_data[i] * ei_otimes_ei;
91  }
92  return k;
93  }
94 
95  return fromVector(k_data);
96 }
PropertyDataType fromVector(std::vector< double > const &values)
Definition: Property.cpp:23
Eigen::Matrix< double, Dimension, Dimension > transformation(SpatialPosition const &pos) const

References MaterialPropertyLib::equivalent_plastic_strain, MaterialPropertyLib::fromVector(), and MaterialPropertyLib::volumetric_strain.

Member Data Documentation

◆ b1_

template<int DisplacementDim>
double const MaterialPropertyLib::StrainDependentPermeability< DisplacementDim >::b1_
private

Definition at line 85 of file StrainDependentPermeability.h.

◆ b2_

template<int DisplacementDim>
double const MaterialPropertyLib::StrainDependentPermeability< DisplacementDim >::b2_
private

Definition at line 86 of file StrainDependentPermeability.h.

◆ b3_

template<int DisplacementDim>
double const MaterialPropertyLib::StrainDependentPermeability< DisplacementDim >::b3_
private

Definition at line 87 of file StrainDependentPermeability.h.

◆ k0_

template<int DisplacementDim>
ParameterLib::Parameter<double> const& MaterialPropertyLib::StrainDependentPermeability< DisplacementDim >::k0_
private

Initial intrinsic permeability.

Definition at line 84 of file StrainDependentPermeability.h.

◆ local_coordinate_system_

template<int DisplacementDim>
ParameterLib::CoordinateSystem const* const MaterialPropertyLib::StrainDependentPermeability< DisplacementDim >::local_coordinate_system_
private

Definition at line 90 of file StrainDependentPermeability.h.

◆ maximum_permeability_

template<int DisplacementDim>
double const MaterialPropertyLib::StrainDependentPermeability< DisplacementDim >::maximum_permeability_
private

Definition at line 89 of file StrainDependentPermeability.h.

◆ minimum_permeability_

template<int DisplacementDim>
double const MaterialPropertyLib::StrainDependentPermeability< DisplacementDim >::minimum_permeability_
private

Definition at line 88 of file StrainDependentPermeability.h.


The documentation for this class was generated from the following files: