morphogen.homogenization.poroelastic¶
Weak couplings of elasticity with a scalar field that loads the phases: the pressure of the fluid of the pores (the poroelasticity of Biot) and the content of a species that the phases absorb (hygroscopic and chemical swelling).
Both are eigenstrain problems of the elastic solvers (FFT on voxel images, finite elements on conforming meshes, extended finite elements on level sets), as the thermal expansion is.
Swelling. A phase that absorbs a species (moisture in a polymer or in wood, a solvent
in a gel, lithium in an electrode) strains by beta c for a content c:
sigma = C : (eps - beta c). With the swelling of the materials, the strain of
each phase for a unit of the quantity that drives the sorption (a content, a relative
humidity, an activity: the coefficient of a phase is then its strain at equilibrium with a
unit of that quantity, the product of its coefficient of expansion and of its
solubility), swelling_tensor() gives the macroscopic strain of the stress-free
volume element, E = S : Sigma + B c; Levin’s relation holds, B = <beta : C : A> :
C*^-1.
Poroelasticity. In a porous solid whose pores hold a fluid at the pressure p,
Sigma = C_d : E - b p,phi - phi_0 = b : E + p / N
with the drained stiffness C_d (that of the solid with empty pores), the tensor of
Biot b and the modulus of Biot N of the solid (Biot 1941; Coussy 2004). The
pressure on the walls of the pores is, in the solid, the uniform stress -p 1 and the
eigenstrain -p S_s : 1 of each solid phase: one more solution of the elastic
problem, at zero macroscopic strain, gives b = 1 - Sigma' (Sigma': the mean stress
of that problem for a unit pressure) and 1 / N = -(1 - phi_0) <tr eps>_s, the volume
the pores gain. A homogeneous solid recovers b = 1 - C_d : S_s : 1 and 1 / N = (b -
phi_0 1) : S_s : 1 (b = 1 - K_d / K_s, 1 / N = (b - phi_0) / K_s when isotropic);
the solid may as well be heterogeneous (several phases, crystals), where these formulae do
not hold. A fluid of bulk modulus K_f that cannot drain stiffens the medium (Gassmann
1951): 1 / M = 1 / N + phi_0 / K_f, C_u = C_d + M b (x) b, and a stress raises its
pressure by p = -B : Sigma / 3 with the tensor of Skempton B = 3 M S_u : b.
References: M. A. Biot, J. Appl. Phys. 12 (1941) 155; F. Gassmann, Vierteljahrsschr. Naturforsch. Ges. Zürich 96 (1951) 1; O. Coussy, Poromechanics, Wiley (2004); L. Dormieux, D. Kondo, F.-J. Ulm, Microporomechanics, Wiley (2006); V. M. Levin, Mekh. Tverd. Tela 2 (1967) 88.
- morphogen.homogenization.poroelastic.POROELASTIC_ENTRIES = ('porosity', 'biot_coefficient', 'biot_modulus', 'bulk_modulus', 'b11', 'b22', 'b33', 'b23', 'b31', 'b12')¶
The scalar results of
poroelastic_tensors()(columns of the tables of results and quantities of the statistics of RVE studies)
- morphogen.homogenization.poroelastic.UNDRAINED_ENTRIES = ('storage_modulus', 'undrained_bulk_modulus', 'skempton_coefficient', 'B11', 'B22', 'B33', 'B23', 'B31', 'B12')¶
Those of a fluid that cannot drain (with its bulk modulus)
- morphogen.homogenization.poroelastic.pressure_materials(materials: dict[int, Material]) dict[int, Material][source]¶
The materials of the problem of a unit pressure in the pores: each solid phase with the eigenstrain
-S : 1(as a thermal expansion: the temperature of the elastic problems is then the pressure), the voids as they are.
- morphogen.homogenization.poroelastic.swelling_materials(materials: dict[int, Material]) dict[int, Material][source]¶
The materials of the problem of a unit content of the absorbed species: each phase with its
swellingas a thermal expansion (none: a phase that does not swell).
- morphogen.homogenization.poroelastic.swelling_tensor(sample, materials: dict[int, Material], bc: str = 'periodic', **options)[source]¶
Apparent swelling tensor (3 x 3) of a sample and the solution that gives it: the macroscopic strain of a unit content of the absorbed species under zero macroscopic stress, with the
swellingof the materials (E = S : Sigma + B c).options: those ofmake_problem()(solver,tol,maxiter,grains,orientations,device).
- morphogen.homogenization.poroelastic.undrained(stiffness, biot, biot_modulus: float, porosity: float, fluid_bulk: float) dict[source]¶
The response of a saturated porous medium whose fluid, of bulk modulus
fluid_bulk, cannot drain (Gassmann):storage_modulusM(1 / M = 1 / N + phi_0 / K_f),undrained_stiffnessC_u = C_d + M b (x) b(Voigt),undrained_bulk_modulus(1 / (1 : S_u : 1)),skempton(the 3 x 3 tensorB = 3 M S_u : b: a macroscopic stress raises the pressure by-B : Sigma / 3) andskempton_coefficient(its mean), from the drainedstiffness(6 x 6), the tensor (3 x 3) and the modulus of Biot and the porosity.
- morphogen.homogenization.poroelastic.poroelastic_tensors(sample, materials: dict[int, Material], bc: str = 'periodic', *, fluid_bulk: float | None = None, **options) dict[source]¶
The poroelastic law of a porous sample (voxel image, conforming mesh or level set; its pores: the void phases), under periodic or kinematic uniform (
kubc) conditions.Returns the drained stiffness (
"tensor", Voigt 6 x 6, with its"compliance"), the tensor of Biot ("biot", 3 x 3; its entriesb11…b12and its mean"biot_coefficient"), the modulus of Biot of the solid ("biot_modulus"; infinite for a rigid solid), the"porosity"and the drained"bulk_modulus"(1 / (1 : S_d : 1)); with the bulk modulus of the fluidfluid_bulk, also the undrained response ofundrained(). The solid may hold several phases and crystals (grains,orientations).options: those ofmake_problem()(solver,tol,maxiter,grains,orientations,device).