porepy.params.rock module

Hard coded typical parameters that may be of use in simulations.

Contains standard values (e.g. found in Wikipedia) for permeability, elastic moduli etc.

Note that thermal expansion coefficients are linear (m/mK) for rocks, but volumetric (m^3/m^3) for fluids.

class Granite(theta_ref=None)[source]

Bases: UnitRock

Generic values for granite. Data partially from:

And: https://www.jsg.utexas.edu/tyzhu/files/Some-Useful-Numbers.pdf

Parameters

theta_ref (Optional[float]) –

specific_heat_capacity(theta=None)[source]

Determines specific heat capacity of granite.

Parameters

theta (float, optional) – temperature

Returns

specific heat capacity

Return type

float

thermal_conductivity(theta=None)[source]

Return themal conductivity of granite.

Parameters

theta (float, optional) – temperature in Celsius (not used)

Returns

thermal conductivity

Return type

float

class SandStone(theta_ref=None)[source]

Bases: UnitRock

Generic values for Sandstone.

Data partially from:

http://civilblog.org/2015/02/13/what-are-the-values-of-modulus-of-elasticity-poissons-ratio-for-different-rocks/

Parameters

theta_ref (Optional[float]) –

specific_heat_capacity(theta=None)[source]

Determines specific heat capacity of sandstone.

Parameters

theta (float, optional) – temperature

Returns

specific heat capacity

Return type

float

class Shale(theta_ref=None)[source]

Bases: UnitRock

Generic values for shale.

Data partially from:

http://civilblog.org/2015/02/13/what-are-the-values-of-modulus-of-elasticity-poissons-ratio-for-different-rocks/

Parameters

theta_ref (Optional[float]) –

specific_heat_capacity(theta=None)[source]

Determines specific heat capacity of shale.

Parameters

theta (float, optional) – temperature

Returns

specific heat capacity

Return type

float

class UnitRock(theta_ref=None)[source]

Bases: object

Mother of all rocks, all values are unity.

PERMEABILITY

Permeability

POROSITY

Porosity

LAMBDA

First Lamé parameter

MU

Shear modulus / Second Lamé parameter

YOUNG_MODULUS

Young’s modulus

POISSON_RATIO

Poisson’s ratio

specific_heat_capacity(theta=None)[source]

Determines specific heat capacity.

Parameters

theta (float, optional) – temperature

Returns

specific heat capacity

Return type

float

thermal_conductivity(_)[source]

Return themal conductivity.

May depend on temperature, but currently is fixed.

Returns

thermal conductivity

Return type

float

bulk_from_lame(lmbda, mu)[source]

Compute bulk modulus from Lamé parameters.

Parameters
  • lmbda (float) – First Lamé parameter

  • mu (float) – Shear modulus (second Lamé parameter)

Returns

bulk modulus

Return type

float

lame_from_young_poisson(e, nu)[source]

Compute Lamé parameters from Young’s modulus and Poisson’s ratio.

Parameters
  • e (float) – Young’s modulus

  • nu (float) – Poisson’s ratio

Returns

pair of first Lamé parameter and shear modulus

Return type

tuple(float, float)

poisson_from_lame(mu, lmbda)[source]

Compute Poisson’s ratio from Lamé parameters.

Parameters
  • mu (float) – shear modulus (second Lamé parameter)

  • lmbda (float) – first Lamé parameter

Returns

Poisson’s ratio

Return type

float

young_from_lame(lmbda, mu)[source]

Compute Young’s modulus from Lamé parameters.

Parameters
  • lmbda (float) – First Lamé parameter

  • mu (float) – Shear modulus (second Lamé parameter)

Returns

Young’s modulus

Return type

float