morphogen.models¶
Morphological models (see list_models()).
|
Boolean model of spheres (Poisson germs, random radii) |
|
Boolean model of finite fibres (cylinders / spherocylinders) |
|
Infinite fibres on isotropic Poisson lines (non-periodic) |
|
Non-overlapping spheres: random sequential addition, or dense packings grown by the Lubachevsky-Stillinger algorithm |
|
Spheres with impenetrable cores (Torquato’s cherry-pit model) |
|
Non-overlapping straight fibres by random sequential addition |
|
Boolean model of curved fibres (worm-like chains of segments) |
|
Bending fibres packed without overlap by forces (Altendorf & Jeulin’s random walks), drawn into contact (Keilmann et al.) |
|
Straight fibres bonded by cross-links at their contacts (entangled cross-linked fibres, Chatti et al.) |
|
Poisson-Voronoi tessellation (multiphase mosaic, polycrystal) |
|
Laguerre (power) tessellation with random weights |
|
Excursion set of a Gaussian random field |
|
Gyroid, Schwarz P/D, Neovius sheet or network lattices |
|
Cubic, BCC, FCC and octet strut lattices |
|
Two-phase structure grown by a cellular automaton from noise |
|
Turing-like patterns of Young’s activator-inhibitor automaton |
|
Turing patterns of the Gray-Scott reaction-diffusion system |
|
Nucleation and growth (JMAK): Voronoi / Johnson-Mehl grains |
|
Diffusion-limited, Eden or ballistic clusters and deposits |
|
Compatible assemblies of building blocks (combinatorial design) |
|
Strut lattices with missing struts and displaced nodes |
|
Layers of random thicknesses with holes (nanolayered films) |
|
Dead leaves of spheres or spheroids, of families of their own sizes, over a background (finite coverage) |
|
Excursion of the random function of transparent leaves |
|
Annealed to the two-point probability and lineal path of a Debye medium, a model or an image (Yeong-Torquato) |
|
Union, intersection, difference or complement of models, inclusions in a matrix (a polycrystal…), or nested models |
|
Spheres clustered in the phase 1 of another model (aggregates) |
|
A coating around the phase 1 of a model, or hollow members |
|
Frames of generation G of (hollow) tubes on an fcc lattice |
|
Menger sponge, Vicsek fractal, Cantor dust (iterated functions) |
|
Brick-and-mortar stacks of mineral tablets (bio-inspired) |
|
Twisted plywood of fibres: arthropod cuticles, fish scales |
|
Prismatic cells: hexagonal, square or random honeycombs, wood |
|
Haversian bone: osteons remodelled one after another |
|
Open-cell foams and trabecular bone (struts on Voronoi edges) |
|
Fibre networks on the edges of Delaunay triangulations (Ban et al.), in space or in a plane |
|
Foams as level sets of distance fields: Plateau borders, nodes |
|
Vascular trees grown by space colonization (Murray’s law) |
|
Polycrystal of a measured orientation map (EBSD): its grains and their orientations, in windows of the map |
|
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 byx = A y(Anisotropy) of a realizationinnerof the isotropic model, generated in the preimage ofdomain.AggregationModel— Aggregates of particles: diffusion-limited, Eden or ballistic growth.Anisotropy— Stretchesstretchalong the principal axes turned by the Bunge angleseuler(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 bypitch_anglefrom the one below, stacked alongaxis.BouligandStructure— Layers of parallel fibres alongaxis: layerkspans[z0 + k h, z0 + (k + 1) h), its fibres the cylinders of radiusraround the lines of its mid-plane in the directionangles[k](degrees from the first axis of the plane), at the spacingspacings[k], one of them throughoffsets[k]along their normal.BranchingNetwork— Branching network grown towardn_attractorsrandom points by space colonization (segments ofstep), 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 ofsegmentsstraight 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 regionPhi <= 0of 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 alongaxiswith walls ofwall_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 theirr^2.Laminate— Layers of phase 1 (intervals alongaxis) 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 alongaxis: layerkspans[z0 + k p, z0 + (k + 1) p)(p: the period), its tablet the slab of thicknesstin its middle; in the plane, the tablets are the cells of the germs of the layer, shrunk by half thegap. 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 byanisotropyalongaxis, with a strut radius or a relative density. The framework of the struts is kept in the metadata (periodic_framework()), and withframe_stiffnessthe stiffness of its frame of beams in the summary.OsteonStructure— Osteons alongaxis: discs of the cross-section (centres, radii) in the order of their arrival, the last on top, with a canal ofcanal_ratiotimes their radius and a cement line ofcementthickness.Osteons— Haversian bone: aligned osteons with canals and cement lines, remodelled one after another over a fractioncoverageof the cross-section (a dead-leaves model of cylinders alongaxis).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 fromorientation.PrimitiveUnion— Phase 1 is the union of the spheres and segments, phase 0 its complement.PrismaticCells— Prisms alongaxisover cells of the plane: the walls (phase 1) are the points closer to the sides of their cell than half its wall thicknesswalls[i], the lumens of the cells phase 0. The cells are those of germs (Voronoi), or rectangles in radialfiles(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 aframe, within a frame of that thickness (phase 1 too), on which they end.ScaleRichNetwork— Scale-rich network (Both et al. 2026): ligamentslambda_0 t^-alphathick grown one after another from points of the voids until they meet: by default (dimension: 2) in the plane of the axes other thanaxisand extruded along it (seemorphogen.models.scale_rich); withdimension: 3, plates or beams in the box (seemorphogen.models.scale_rich_3d). The initial thickness is given, or solved on each realization for a relative density (volume_fraction). Orientations uniform, amongangles(2D) or drawn from a law (3D), or polarized by apole; 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 aframe, the box within a frame of that thickness (phase 1 too), on which the plates end.ScaleRichStructure— A scale-rich network extruded alongaxis: 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 aframe, the face within a frame of that thickness (phase 1 too), on which the ligaments end.SeedCalibration— The result ofcalibrate_seeds(): the calibratedmodel, thescaleof its seeds relative to the initial model and theiraspect, thetargetandachievedmean section radii (axis -> radius), thehistoryof (scale, aspect, achieved) over the iterations and thesectionsof the last foam.StrutLattice— Lattice of cylindrical struts with spherical nodes (spherocylinders).TPMSStructure— Solid{phi <= level}(network) or{|phi| <= level}(sheet).Tessellation— Cells of germsg_iwith weightsw_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 functionZthey make, and its excursionZ > threshold(phase 1).TransparentDeadLeavesModel— Transparent dead leaves of spheres (Jeulin 1997): the excursion of the random function of leaves letting1 - α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 withfit_shapechange their shape factors, until the mean radii of the sections of itsphase(the pores) by the planes normal to the axes oftarget(a mapping axis -> mean radius, or the measuredSections) match them withintol. 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_shapeneeds the three axes; otherwise the step is the mean logarithmic deviation, and the iterations stop when it falls belowtol / 2, a shape that does not fit the sections leaving its misfit inSeedCalibration.residual); each foam is generated with the sameseed(drawn once if None) on the gridshapeorvoxel_sizeand measured as the target should have been (separate,prominence,min_radius: seesection_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 undercls.name.
Modules¶
- morphogen.models.affine
- morphogen.models.automata
- morphogen.models.base
- morphogen.models.boolean
- morphogen.models.bouligand
- morphogen.models.branching
- morphogen.models.combination
- morphogen.models.deadleaves
- morphogen.models.design
- morphogen.models.ebsd
- morphogen.models.fibers
- morphogen.models.foam
- morphogen.models.gaussian
- morphogen.models.growth
- morphogen.models.hardcore
- morphogen.models.hierarchical
- morphogen.models.honeycomb
- morphogen.models.implicit
- morphogen.models.laminate
- morphogen.models.lattice
- morphogen.models.lattice_field
- morphogen.models.levelset_foam
- morphogen.models.nacre
- morphogen.models.nested
- morphogen.models.osteons
- morphogen.models.pieces
- morphogen.models.planar
- morphogen.models.reconstruction
- morphogen.models.scale_rich
- morphogen.models.scale_rich_3d
- morphogen.models.tessellation
- morphogen.models.tiling_field
- morphogen.models.tpms
- morphogen.models.transparent
- morphogen.models.union