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— Concentrationsc = S uat the requestedtimesand 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(kin 1/s attemperature, Arrhenius withactivation_energyJ/mol). Vibert et al. (2024) found that the mechanical properties of aged papers fall faster below a critical degree of polymerizationcritical_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-planestiffness: the 3 x 3 plane-stress matrix of the componentsxx,yy,xy, engineering shear, of an orthotropic or anisotropic layer), swelling strains per unit concentration along x and y (and the engineering shearbeta_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 fromz = 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 thetimes(s), and the number ofstepsof the integration.OxidationResult— At thetimes: 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]attracer[i](increasing), constant beyond the table.SwellingResult— At the outputtimes: the mean concentration over the meshed volume (uptake;saturationat 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 ofaxisandnormal; 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 inlawsare binned by theirtracervalue intolevelsclasses 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 andmaterials. 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 attimes(s).oxidation_stresses— Stresses of a sample oxidized through itsexposedfaces (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) oflaw(PropertyLawof the amide concentration), and the linear elastic response of the free sample (3-2-1 supports) to these eigenstrains (Poisson’s ratiopoisson, 0.37 as theirs).slab_profile—c / c_sat the distancezfrom the middle of the slab (Crank 1975, eq. 4.17).slab_uptake—M(t) / M_infof 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 alongaxisbending in the plane ofnormal: 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), astimoshenko_curvature()andMultilayer.swelling— Diffusion intomeshfrom itsexposedfaces and the free swelling of the sample at the outputtimes.phases: phase -> mapping withdiffusivity,solubility(default 1),swelling(the strain per unit concentration, default 0),youngandpoisson. Each output interval takesstepsimplicit 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_swith the swelling stretchF_s = (1 + beta c) I, Saint Venant-Kirchhoff’s law ofF_eper unit volume of the swollen state, so thatP = (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 bystrainrelative 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 ofimagefrom itsexposedfaces, held at the activityboundary(a number or a function of time), from a uniform initial activityinitial.