morphogen.models

Morphological models (see list_models()).

boolean_spheres

Boolean model of spheres (Poisson germs, random radii)

boolean_cylinders

Boolean model of finite fibres (cylinders / spherocylinders)

poisson_fibers

Infinite fibres on isotropic Poisson lines (non-periodic)

hardcore_spheres

Non-overlapping spheres: random sequential addition, or dense packings grown by the Lubachevsky-Stillinger algorithm

penetrable_spheres

Spheres with impenetrable cores (Torquato’s cherry-pit model)

hardcore_fibers

Non-overlapping straight fibres by random sequential addition

curved_fibers

Boolean model of curved fibres (worm-like chains of segments)

random_walk_fibers

Bending fibres packed without overlap by forces (Altendorf & Jeulin’s random walks), drawn into contact (Keilmann et al.)

cross_linked_fibers

Straight fibres bonded by cross-links at their contacts (entangled cross-linked fibres, Chatti et al.)

voronoi

Poisson-Voronoi tessellation (multiphase mosaic, polycrystal)

laguerre

Laguerre (power) tessellation with random weights

gaussian_excursion

Excursion set of a Gaussian random field

tpms

Gyroid, Schwarz P/D, Neovius sheet or network lattices

strut_lattice

Cubic, BCC, FCC and octet strut lattices

cellular_automaton

Two-phase structure grown by a cellular automaton from noise

activator_inhibitor

Turing-like patterns of Young’s activator-inhibitor automaton

reaction_diffusion

Turing patterns of the Gray-Scott reaction-diffusion system

nucleation_growth

Nucleation and growth (JMAK): Voronoi / Johnson-Mehl grains

aggregation

Diffusion-limited, Eden or ballistic clusters and deposits

tile_assembly

Compatible assemblies of building blocks (combinatorial design)

random_lattice

Strut lattices with missing struts and displaced nodes

random_laminate

Layers of random thicknesses with holes (nanolayered films)

dead_leaves

Dead leaves of spheres or spheroids, of families of their own sizes, over a background (finite coverage)

transparent_dead_leaves

Excursion of the random function of transparent leaves

reconstruction

Annealed to the two-point probability and lineal path of a Debye medium, a model or an image (Yeong-Torquato)

combination

Union, intersection, difference or complement of models, inclusions in a matrix (a polycrystal…), or nested models

cox_spheres

Spheres clustered in the phase 1 of another model (aggregates)

coating

A coating around the phase 1 of a model, or hollow members

hierarchical_lattice

Frames of generation G of (hollow) tubes on an fcc lattice

fractal_sponge

Menger sponge, Vicsek fractal, Cantor dust (iterated functions)

nacre

Brick-and-mortar stacks of mineral tablets (bio-inspired)

bouligand

Twisted plywood of fibres: arthropod cuticles, fish scales

honeycomb

Prismatic cells: hexagonal, square or random honeycombs, wood

osteons

Haversian bone: osteons remodelled one after another

open_foam

Open-cell foams and trabecular bone (struts on Voronoi edges)

delaunay_network

Fibre networks on the edges of Delaunay triangulations (Ban et al.), in space or in a plane

level_set_foam

Foams as level sets of distance fields: Plateau borders, nodes

branching

Vascular trees grown by space colonization (Murray’s law)

ebsd

Polycrystal of a measured orientation map (EBSD): its grains and their orientations, in windows of the map

scale_rich_network

Ligaments of power-law thicknesses grown until they meet: scale- rich networks (Both et al. 2026), extruded prisms, or plates (closed cells) or beams (struts) in 3D

The point processes, tessellations, fields, leaves, growths and lattices take an anisotropy, the same field everywhere: their realizations are mapped by a stretch along principal axes preserving volumes (morphogen.models.affine).

Public names

  • EBSD — Polycrystal of a measured orientation map (EBSD): the grains of the map, with their orientations, in a window of the size of the domain.

  • TPMS — TPMS lattice: gyroid, Schwarz P (primitive), Schwarz D (diamond) or Neovius.

  • ActivatorInhibitorModel — Turing patterns of Young’s (1984) activator-inhibitor cellular automaton.

  • AffineStructure — The image by x = A y (Anisotropy) of a realization inner of the isotropic model, generated in the preimage of domain.

  • AggregationModel — Aggregates of particles: diffusion-limited, Eden or ballistic growth.

  • Anisotropy — Stretches stretch along the principal axes turned by the Bunge angles euler (degrees); elongation: the number it was given as (an elongation along z).

  • BooleanCylinders — Boolean model of finite fibres: cylinders (flat caps) or spherocylinders.

  • BooleanSpheres — Boolean model of spheres: union of balls centred on a Poisson point process.

  • Bouligand — Bouligand (twisted plywood) structure: layers of parallel fibres, each turned by pitch_angle from the one below, stacked along axis.

  • BouligandStructure — Layers of parallel fibres along axis: layer k spans [z0 + k h, z0 + (k + 1) h), its fibres the cylinders of radius r around the lines of its mid-plane in the direction angles[k] (degrees from the first axis of the plane), at the spacing spacings[k], one of them through offsets[k] along their normal.

  • BranchingNetwork — Branching network grown toward n_attractors random points by space colonization (segments of step), with Murray’s law for the radii.

  • CellularAutomatonModel — Two-phase structure grown by a cellular automaton from random noise.

  • ClusteredSpheres — Spheres (phase 1) clustered in aggregates, a realization of another model; the aggregates outside the spheres may form a phase of their own.

  • CoatedStructure — A structure with a layer around its phase 1 (outside) or a shell inside it.

  • Coating — A layer of constant thickness on the phase 1 of a model.

  • Combination — Union, intersection, difference or complement of models, or inclusions in a matrix.

  • Combined — Realization of a combination: its components and how they combine.

  • CoxSpheres — Spheres clustered in the phase 1 of another model: a Cox Boolean model.

  • CrossLinkedFibers — Entangled cross-linked fibres: straight fibres bonded by cross-links at a fraction of their contacts (Mezeix et al. 2009, 2016; Chatti et al. 2018, 2020).

  • CurvedFibers — Curved fibres: chains of segments straight spherocylinders along curved axes, a Boolean model or non-overlapping fibres.

  • DeadLeaves — Leaves in the order they cover the space (the first one is on top), and the background that they leave uncovered (finite coverage; the last cell).

  • DeadLeavesModel — Dead leaves of spheres or spheroids, of one or several families: each point belongs to the last leaf covering it (or to a background, with a finite coverage).

  • DelaunayNetwork — Fibre networks along the edges of the Delaunay triangulation of random points (Ban, Barocas, Shephard & Picu 2016), in space or in a plane.

  • DistanceFieldFoam — A foam, the region Phi <= 0 of the level-set function of its seeds (see the module); the same realization can be evaluated at any resolution and point.

  • FractalSponge — Iterated function system on a cubic grid: the Menger sponge and its kin.

  • FractalStructure — Periodic tiling of the cube kept by an iterated function system.

  • GaussianExcursion — Excursion set {Y > threshold} of a Gaussian field with covariance exp(-h^2 / 2 l^2).

  • GaussianField — Phase 1 = {Y > threshold} for a unit-variance Gaussian field Y.

  • HardcoreFibers — Non-overlapping straight fibres (spherocylinders) placed by random sequential addition (RSA).

  • HardcoreSpheres — Non-overlapping spheres, by random sequential addition (RSA) or grown into dense packings by the Lubachevsky–Stillinger algorithm.

  • HierarchicalLattice — Hierarchical lattice: frames of generation G of (hollow) tubes on an fcc lattice.

  • Honeycomb — Prismatic cells along axis with walls of wall_thickness: hexagonal or square honeycombs, random cells, or the radial files, growth rings and rays of wood.

  • Laguerre — Laguerre (power) tessellation of germ spheres, the weights being their r^2.

  • Laminate — Layers of phase 1 (intervals along axis) in phase 0, with holes.

  • LatticeField — A phase (and optionally a label) per cell of a regular lattice of the domain.

  • LevelSetFoam — Open- or closed-cell foams as level sets of the distance fields of a packing of aligned ellipsoids (Sonon et al. 2012; Kilingar et al. 2019; Degdeg & Dirrenberger 2026): struts with Plateau-border cross-sections of controlled curvature, thickening towards the nodes, cells elongated by the shape of the seeds (see the module).

  • Microstructure — One realization of a model in a domain.

  • Model — Morphological model (random set or deterministic architecture).

  • Nacre — Nacre: staggered layers of mineral tablets bonded by an organic mortar.

  • NacreStructure — Layers of tablets along axis: layer k spans [z0 + k p, z0 + (k + 1) p) (p: the period), its tablet the slab of thickness t in its middle; in the plane, the tablets are the cells of the germs of the layer, shrunk by half the gap. Periodic domains hold a whole number of layers, which wrap around.

  • NucleationGrowthModel — Nucleation and growth of grains until impingement (JMAK kinetics).

  • OpenFoam — Open-cell foam or trabecular bone: struts along the edges of the periodic Voronoi tessellation of (regularized) germs, cells elongated by anisotropy along axis, with a strut radius or a relative density. The framework of the struts is kept in the metadata (periodic_framework()), and with frame_stiffness the stiffness of its frame of beams in the summary.

  • OsteonStructure — Osteons along axis: discs of the cross-section (centres, radii) in the order of their arrival, the last on top, with a canal of canal_ratio times their radius and a cement line of cement thickness.

  • Osteons — Haversian bone: aligned osteons with canals and cement lines, remodelled one after another over a fraction coverage of the cross-section (a dead-leaves model of cylinders along axis).

  • PenetrableSpheres — Penetrable spheres with impenetrable cores: the cherry-pit model of Torquato (1984), or penetrable-concentric-shell model.

  • PoissonFibers — Infinite cylinders of radius R around Poisson lines, isotropic or of directions drawn from orientation.

  • PrimitiveUnion — Phase 1 is the union of the spheres and segments, phase 0 its complement.

  • PrismaticCells — Prisms along axis over cells of the plane: the walls (phase 1) are the points closer to the sides of their cell than half its wall thickness walls[i], the lumens of the cells phase 0. The cells are those of germs (Voronoi), or rectangles in radial files (wood; the germs are then their centres), between which rays may run (files["rays"], WoodRays): the structure is then three-dimensional.

  • RandomLaminate — Layers of random thicknesses stacked along an axis, with holes through the layers of phase 1 (nanolayered films, Bironeau et al. 2016).

  • RandomLattice — Strut lattices with defects: missing struts and displaced nodes.

  • RandomWalkFibers — Bending fibres packed without overlap by forces (Altendorf & Jeulin 2011).

  • ReactionDiffusionModel — Turing patterns of the Gray-Scott reaction-diffusion system.

  • Reconstruction — Two-phase microstructure annealed to the two-point probability (and the lineal-path function) of a Debye medium, of a model or of an image (Yeong & Torquato 1998).

  • ScaleRichBeams — A scale-rich network of beams: cylinders with round ends (phase 1) grown until they meet (grow_beams()), in one open void (phase 0); or, with a frame, within a frame of that thickness (phase 1 too), on which they end.

  • ScaleRichNetwork — Scale-rich network (Both et al. 2026): ligaments lambda_0 t^-alpha thick grown one after another from points of the voids until they meet: by default (dimension: 2) in the plane of the axes other than axis and extruded along it (see morphogen.models.scale_rich); with dimension: 3, plates or beams in the box (see morphogen.models.scale_rich_3d). The initial thickness is given, or solved on each realization for a relative density (volume_fraction). Orientations uniform, among angles (2D) or drawn from a law (3D), or polarized by a pole; a gradient of the nucleation density. Non-periodic: the ligaments end on the boundary of the box (or on a frame).

  • ScaleRichPlates — A scale-rich network of plates: its plates (phase 1, convex polyhedra that never overlap) and its voids (phase 0, closed convex cells), which partition the box exactly (grow_plates()); or, with a frame, the box within a frame of that thickness (phase 1 too), on which the plates end.

  • ScaleRichStructure — A scale-rich network extruded along axis: its ligaments (phase 1, convex polygons of the plane of the two other axes, which never overlap) and its voids (phase 0, convex cells), which partition the face of the box exactly (grow()); or, with a frame, the face within a frame of that thickness (phase 1 too), on which the ligaments end.

  • SeedCalibration — The result of calibrate_seeds(): the calibrated model, the scale of its seeds relative to the initial model and their aspect, the target and achieved mean section radii (axis -> radius), the history of (scale, aspect, achieved) over the iterations and the sections of the last foam.

  • StrutLattice — Lattice of cylindrical struts with spherical nodes (spherocylinders).

  • TPMSStructure — Solid {phi <= level} (network) or {|phi| <= level} (sheet).

  • Tessellation — Cells of germs g_i with weights w_i: x belongs to the cell minimizing the power distance |x - g_i|^2 - w_i (Voronoi when all weights vanish).

  • TileAssembly — Compatible assemblies of building blocks with matching faces.

  • TilingField — A phase per cell of a tiling covering the domain.

  • TransparentDeadLeaves — Transparent leaves in their order of fall backwards (the first on top), the random function Z they make, and its excursion Z > threshold (phase 1).

  • TransparentDeadLeavesModel — Transparent dead leaves of spheres (Jeulin 1997): the excursion of the random function of leaves letting 1 - α of what they cover show through.

  • Voronoi — Voronoi tessellation (mosaic): each point belongs to its nearest germ. The germs are Poisson points, or a stealthy hyperuniform pattern (germs: stealthy: the collective coordinates of Torquato and coworkers, morphogen.kernels.collective), a fixed number of them in the box, whose cells are disordered but far more regular.

  • calibrate_seeds — Scale the seeds of a foam, and with fit_shape change their shape factors, until the mean radii of the sections of its phase (the pores) by the planes normal to the axes of target (a mapping axis -> mean radius, or the measured Sections) match them within tol. Gauss–Newton steps in the logarithms of the scale and of the shape factors with the Jacobian of ellipsoids, log r_D = log s + log kappa_D(b/a, c/a) (fit_shape needs the three axes; otherwise the step is the mean logarithmic deviation, and the iterations stop when it falls below tol / 2, a shape that does not fit the sections leaving its misfit in SeedCalibration.residual); each foam is generated with the same seed (drawn once if None) on the grid shape or voxel_size and measured as the target should have been (separate, prominence, min_radius: see section_sizes()).

  • get_model — The class of a registered model, by its name (list_models()).

  • list_models — The names of the registered models, sorted.

  • model_from_config — Build a model from a mapping {"type": name, **parameters}.

  • register — Class decorator adding a model to the registry under cls.name.

Modules