morphogen.coupling.plates

Hygromorph plates: multilayers that bend as moisture diffuses through them.

Pine cone scales and 4D-printed hygromorphs bend because their layers swell differently and because the moisture profile through the thickness evolves (Mou, Dirrenberger & Le Duigou 2025). Here a free multilayer plate, each layer isotropic in elasticity (plane stress) with orthotropic swelling beta_x, beta_y (strain per unit concentration), a diffusivity and a solubility: moisture enters by Fick’s law through the thickness (finite volumes, continuity of the activity between layers, implicit Euler), the swelling strains beta c(z, t) are eigenstrains, and the classical laminate theory gives the mid-plane strains and curvatures of the free plate ([A B; B D] [eps0; kappa] = [N*; M*]) at every time: the sequence of bendings along x and y. The geometric nonlinearity of large deflections (Föppl–von Kármán, which selects cylindrical shapes beyond a critical curvature) is left to finite element models.

class morphogen.coupling.plates.Layer(thickness: float, young: float, poisson: float = 0.3, beta_x: float = 0.0, beta_y: float = 0.0, diffusivity: float = 0.0, solubility: float = 1.0, stiffness: tuple | None = None, beta_xy: float = 0.0)[source]

Bases: object

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).

plane_stiffness() → ndarray[source]

The plane-stress stiffness Q (3 x 3: xx, yy, xy).

classmethod from_microstructure(thickness: float, sample, materials, *, solubility=None, normal: int = 2, **options) → Layer[source]

A layer whose properties are the apparent ones of a microstructure (a voxel image or a conforming mesh, periodic homogenization by homogenize()): the plane-stress stiffness of the apparent stiffness tensor in the plane normal to normal, the swelling of its apparent expansion tensor (give each material its swelling strain per unit concentration as expansion), the diffusivity through the thickness, the apparent conductivity across it (give each material its permeability, diffusivity times solubility, as conductivity) over the mean solubility of the phases (a mapping phase -> solubility, default 1).

class morphogen.coupling.plates.Multilayer(layers, nodes_per_layer: int = 40)[source]

Bases: object

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

stiffness() → tuple[ndarray, ndarray, ndarray][source]

A, B and D (3 x 3: xx, yy, xy) about z = 0.

deformation(concentration, *, full: bool = False) → tuple[ndarray, ndarray][source]

Mid-plane strains (about z = 0) and curvatures (kappa_x, kappa_y) of the free plate under the swelling of the concentrations of the cells (a profile, or an array of profiles: times x cells); full: also the shear strain and the twist (kappa_xy) of anisotropic layers.

moisture(times, *, exposed: str = 'bottom', activity: float | Callable[[float], float] = 1.0, initial: float = 0.0, steps: int = 200) → ndarray[source]

Concentration profiles (times x cells) as moisture enters through the exposed face (bottom, top or both) held at activity (a number or a function of time); the activity is continuous between layers, the concentration is the solubility times it.

curvature_history(times, **moisture) → dict[str, ndarray][source]

Moisture profiles, mid-plane strains and curvatures of the free plate at times (keywords: those of moisture()).

morphogen.coupling.plates.timoshenko_curvature(strain: float, h1: float, h2: float, e1: float, e2: float) → float[source]

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).