morphogen.coupling

Couplings of transport, chemistry and mechanics: transient diffusion in voxel images, the thermal oxidation of polymers, properties that evolve with ageing, and hygromorph plates.

Public names

  • ClosedLoopOxidation — Rate constants (s^-1, l mol^-1 s^-1), initial concentrations (mol/l) and oxygen transport (solubility mol l^-1 Pa^-1, diffusivity m^2/s, partial pressure Pa) of the closed-loop scheme; the defaults are those of Ernault et al. (2019) for DGEBA/IPDA at 110 °C in air.

  • DiffusionResult — Concentrations c = S u at the requested times and the uptake: the mean concentration over the image at each time, and at equilibrium (saturation).

  • Hydrolysis — Chain scissions of cellulose by acid hydrolysis, Ekenstam’s law: 1/DP(t) - 1/DP(0) = k t (k in 1/s at temperature, Arrhenius with activation_energy J/mol). Vibert et al. (2024) found that the mechanical properties of aged papers fall faster below a critical degree of polymerization critical_dp (about 750), whatever the ageing (hydrolysis or oxidation): the fibres embrittle, more than their bonds.

  • Layer — A layer of a hygromorph: thickness, Young’s modulus and Poisson’s ratio (or the in-plane stiffness: the 3 x 3 plane-stress matrix of the components xx, yy, xy, engineering shear, of an orthotropic or anisotropic layer), swelling strains per unit concentration along x and y (and the engineering shear beta_xy), the diffusivity through the thickness and the solubility (the concentration at equilibrium with the outside activity 1).

  • Multilayer — A free plate of layers stacked from z = 0 (the bottom face) upwards.

  • OxidationField — The oxidation of an image: the concentrations of the species (fields: name -> array (times,) + shape, mol/l; zero in the phases that hold none) at the times (s), and the number of steps of the integration.

  • OxidationResult — At the times: the oxidation tracer (amide concentration, mol/l) of each element, their stresses (Voigt order 11 22 33 23 31 12) and the displacement of the nodes.

  • PropertyLaw — Material parameters (young, poisson, conductivity, expansion…) as piecewise linear functions of a tracer: values[name][i] at tracer[i] (increasing), constant beyond the table.

  • SwellingResult — At the output times: the mean concentration over the meshed volume (uptake; saturation at the activity of the last time), the concentration of the nodes (that of the phase of an element around each node, S u) and their displacement (morphoGen’s order of the nodes).

  • arc_curvature — Curvature of a strip that bends into an arc (large rotations): the circle fitted (least squares, Kasa) to the deformed nodes of its mid-plane in the plane of axis and normal; positive when the strip bends towards its lower face.

  • graded_materials — Graded phases of an ageing microstructure: the voxels of each phase with a law in laws are binned by their tracer value into levels classes of equal width, each a new phase whose material is the law at the middle of its class (fixed: parameters common to all, e.g. poisson=0.37); the other phases keep their labels and materials. Returns the label image and the materials of all its labels.

  • oxidation_field — The thermal oxidation of the phases of an image (see the module): the concentrations of the species in its voxels at times (s).

  • oxidation_stresses — Stresses of a sample oxidized through its exposed faces (Ernault et al. 2019): the amide profile of the diffusion-limited oxidation (ClosedLoopOxidation, default: their DGEBA/IPDA at 110 °C) at the depth of each element below the nearest exposed face, Young’s modulus and the shrinkage (expansion, a strain) of law (PropertyLaw of the amide concentration), and the linear elastic response of the free sample (3-2-1 supports) to these eigenstrains (Poisson’s ratio poisson, 0.37 as theirs).

  • slab_profile — c / c_s at the distance z from the middle of the slab (Crank 1975, eq. 4.17).

  • slab_uptake — M(t) / M_inf of a slab exposed on both faces (Crank 1975, eq. 4.18): 1 - sum 8 / ((2n + 1)^2 pi^2) exp(-D (2n + 1)^2 pi^2 t / L^2).

  • strip_curvature — Curvature of a strip along axis bending in the plane of normal: minus the second derivative of the deflection of the nodes of its mid-plane (least squares, w = -k x^2 / 2 + a x + b + c y), so that it is positive when the strip bends towards its lower face (-normal), as timoshenko_curvature() and Multilayer.

  • swelling — Diffusion into mesh from its exposed faces and the free swelling of the sample at the output times. phases: phase -> mapping with diffusivity, solubility (default 1), swelling (the strain per unit concentration, default 0), young and poisson. Each output interval takes steps implicit Euler steps (the first one geometrically growing, for the sqrt(t) start). kinematics: "small" (linear elasticity under the swelling strains) or "finite" (large rotations and strains: F = F_e F_s with the swelling stretch F_s = (1 + beta c) I, Saint Venant-Kirchhoff’s law of F_e per unit volume of the swollen state, so that P = (1 + beta c) F S_e; Newton’s method, each output reached by continuation of the concentration field, halved when it fails).

  • timoshenko_curvature — Curvature of a free bilayer whose upper layer (2) swells by strain relative to the lower one (Timoshenko 1925): 6 de (1 + m)^2 / (h (3 (1 + m)^2 + (1 + m n) (m^2 + 1/(m n)))), m = h1/h2, n = E1/E2; positive: the plate bends towards its lower face (centre of curvature below).

  • transient_diffusion — Diffusion of a species into the phases of image from its exposed faces, held at the activity boundary (a number or a function of time), from a uniform initial activity initial.

Modules