bruges.rockphysics.bounds module

Bounds on effective elastic modulus. :copyright: 2015 Agile Geoscience :license: Apache 2.0

bruges.rockphysics.bounds.hashin_shtrikman(f, k, mu, modulus='bulk')[source]

Hashin-Shtrikman bounds for a mixture of two constituents. The best bounds for an isotropic elastic mixture, which give the narrowest possible range of elastic modulus without specifying anything about the geometries of the constituents.

Parameters:
  • f – list or array of volume fractions (must sum to 1.00 or 100%).
  • k – bulk modulus of constituents (list or array).
  • mu – shear modulus of constituents (list or array).
  • modulus – A string specifying whether to return either the ‘bulk’ or ‘shear’ HS bound.
Returns:

The Hashin Shtrikman (lower, upper) bounds.

Return type:

namedtuple

Source:

Berryman, J.G., 1993, Mixture theories for rock properties Mavko, G., 1993, Rock Physics Formulas.

: Written originally by Xingzhou ‘Frank’ Liu, in MATLAB : modified by Isao Takahashi, 4/27/99, : Translated into Python by Evan Bianco

bruges.rockphysics.bounds.hill_average(f, m)[source]

The Hill average effective elastic modulus, mh of a mixture of N material phases. This is defined as the simple average of the Reuss (lower) and Voigt (upper) bounds.

Parameters:
  • f – list or array of N volume fractions (must sum to 1 or 100).
  • m

    elastic modulus of N constituents (list or array).

    Returns:
    mh: Hill average.
bruges.rockphysics.bounds.reuss_bound(f, m)[source]

The lower bound on the effective elastic modulus of a mixture of N material phases. This is defined at the harmonic average of the constituents. Same as Wood’s equation for homogeneous mixed fluids.

Parameters:
  • f – list or array of N volume fractions (must sum to 1 or 100).
  • m

    elastic modulus of N constituents (list or array).

    Returns:
    mr: Reuss lower bound.
bruges.rockphysics.bounds.voigt_bound(f, m)[source]

The upper bound on the effective elastic modulus, mv of a mixture of N material phases. This is defined at the arithmetic average of the constituents.

Parameters:
  • f – list or array of N volume fractions (must sum to 1 or 100).
  • m

    elastic modulus of N constituents (list or array).

    Returns:
    mv: Voigt upper bound.