morphogen 1.0.0__py3-none-any.whl
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- morphogen/__init__.py +60 -0
- morphogen/__main__.py +7 -0
- morphogen/_platform.py +55 -0
- morphogen/_public.py +153 -0
- morphogen/_utils.py +80 -0
- morphogen/_version.py +1 -0
- morphogen/analysis/__init__.py +174 -0
- morphogen/analysis/anisotropy.py +135 -0
- morphogen/analysis/basic.py +38 -0
- morphogen/analysis/cells.py +54 -0
- morphogen/analysis/connectivity.py +156 -0
- morphogen/analysis/correlation.py +195 -0
- morphogen/analysis/covariance.py +80 -0
- morphogen/analysis/fractal.py +54 -0
- morphogen/analysis/measures.py +188 -0
- morphogen/analysis/morphology.py +265 -0
- morphogen/analysis/particles.py +160 -0
- morphogen/analysis/percolation.py +2034 -0
- morphogen/analysis/power_laws.py +143 -0
- morphogen/analysis/random_sets.py +351 -0
- morphogen/analysis/stereology.py +289 -0
- morphogen/analysis/surface.py +107 -0
- morphogen/analysis/topology.py +92 -0
- morphogen/automata/__init__.py +74 -0
- morphogen/automata/engine.py +211 -0
- morphogen/automata/growth.py +686 -0
- morphogen/automata/lattice.py +143 -0
- morphogen/automata/reaction.py +255 -0
- morphogen/automata/rules.py +353 -0
- morphogen/automata/tilings.py +1715 -0
- morphogen/cli.py +3526 -0
- morphogen/config.py +2167 -0
- morphogen/contact/__init__.py +113 -0
- morphogen/contact/experiments.py +368 -0
- morphogen/contact/hertz.py +104 -0
- morphogen/contact/kernels.py +827 -0
- morphogen/contact/periodic.py +278 -0
- morphogen/contact/problem.py +578 -0
- morphogen/contact/surfaces.py +310 -0
- morphogen/coupling/__init__.py +43 -0
- morphogen/coupling/ageing.py +143 -0
- morphogen/coupling/diffusion.py +226 -0
- morphogen/coupling/fenicsx.py +484 -0
- morphogen/coupling/oxidation.py +447 -0
- morphogen/coupling/plates.py +247 -0
- morphogen/design/__init__.py +51 -0
- morphogen/design/csp.py +616 -0
- morphogen/design/frames.py +277 -0
- morphogen/design/search.py +287 -0
- morphogen/design/tiles.py +336 -0
- morphogen/distributions.py +312 -0
- morphogen/domain.py +203 -0
- morphogen/dynamics/__init__.py +179 -0
- morphogen/dynamics/model.py +638 -0
- morphogen/dynamics/openradioss.py +643 -0
- morphogen/dynamics/results.py +515 -0
- morphogen/fracture/__init__.py +170 -0
- morphogen/fracture/bulk.py +349 -0
- morphogen/fracture/cohesive.py +1614 -0
- morphogen/fracture/ductile.py +557 -0
- morphogen/fracture/lefm.py +1168 -0
- morphogen/fracture/mixed.py +1178 -0
- morphogen/fracture/periodic.py +733 -0
- morphogen/fracture/phasefield.py +714 -0
- morphogen/fracture/phasefield_finite.py +368 -0
- morphogen/fracture/surface.py +572 -0
- morphogen/fracture/toughness.py +566 -0
- morphogen/gpu.py +108 -0
- morphogen/gui/__init__.py +8 -0
- morphogen/gui/api.py +1927 -0
- morphogen/gui/desktop.py +387 -0
- morphogen/gui/icon.png +0 -0
- morphogen/gui/index.html +1909 -0
- morphogen/gui/server.py +229 -0
- morphogen/gui/tools/__init__.py +629 -0
- morphogen/gui/tools/compare.py +149 -0
- morphogen/gui/tools/contact.py +391 -0
- morphogen/gui/tools/couplings.py +1085 -0
- morphogen/gui/tools/crackfront.py +245 -0
- morphogen/gui/tools/design.py +224 -0
- morphogen/gui/tools/dynamics.py +824 -0
- morphogen/gui/tools/fracture.py +2586 -0
- morphogen/gui/tools/interop.py +1654 -0
- morphogen/gui/tools/learning.py +595 -0
- morphogen/gui/tools/mechanics.py +3881 -0
- morphogen/gui/tools/nonlocal_damage.py +1321 -0
- morphogen/gui/tools/phasefield.py +215 -0
- morphogen/gui/tools/physics.py +597 -0
- morphogen/gui/tools/stability.py +1756 -0
- morphogen/gui/tools/statistics.py +1408 -0
- morphogen/gui/viewer.js +1100 -0
- morphogen/homogenization/__init__.py +210 -0
- morphogen/homogenization/acoustics.py +566 -0
- morphogen/homogenization/amg.py +1005 -0
- morphogen/homogenization/apparent.py +1046 -0
- morphogen/homogenization/behaviours.cu +2285 -0
- morphogen/homogenization/behaviours.py +944 -0
- morphogen/homogenization/beremin.py +263 -0
- morphogen/homogenization/bifurcation.py +1085 -0
- morphogen/homogenization/bloch.py +507 -0
- morphogen/homogenization/bounds.py +226 -0
- morphogen/homogenization/core.py +458 -0
- morphogen/homogenization/coupled.py +1135 -0
- morphogen/homogenization/crystal.py +2967 -0
- morphogen/homogenization/dilatation.py +454 -0
- morphogen/homogenization/elements.py +157 -0
- morphogen/homogenization/fatigue.py +768 -0
- morphogen/homogenization/fe.py +1739 -0
- morphogen/homogenization/fenicsx.py +307 -0
- morphogen/homogenization/fft.py +499 -0
- morphogen/homogenization/fft_nonlinear.py +391 -0
- morphogen/homogenization/finite.py +613 -0
- morphogen/homogenization/flow.py +361 -0
- morphogen/homogenization/frames.py +1125 -0
- morphogen/homogenization/gpu.py +1241 -0
- morphogen/homogenization/harmonic.py +427 -0
- morphogen/homogenization/identification.py +579 -0
- morphogen/homogenization/kernels.py +760 -0
- morphogen/homogenization/laws.py +2061 -0
- morphogen/homogenization/materials.py +1080 -0
- morphogen/homogenization/mfront.py +589 -0
- morphogen/homogenization/networks.py +880 -0
- morphogen/homogenization/nonlinear.py +2612 -0
- morphogen/homogenization/ntfa.py +577 -0
- morphogen/homogenization/paths.py +476 -0
- morphogen/homogenization/photonic.py +467 -0
- morphogen/homogenization/poroelastic.py +212 -0
- morphogen/homogenization/porous.py +1120 -0
- morphogen/homogenization/postprocess.py +290 -0
- morphogen/homogenization/solvers.py +1140 -0
- morphogen/homogenization/tensors.py +240 -0
- morphogen/homogenization/voxel_fe.py +457 -0
- morphogen/homogenization/xfem.py +1016 -0
- morphogen/homogenization/zmat.py +1258 -0
- morphogen/iga/__init__.py +48 -0
- morphogen/iga/analysis.py +508 -0
- morphogen/iga/basis.py +214 -0
- morphogen/iga/geometry.py +501 -0
- morphogen/iga/homogenization.py +219 -0
- morphogen/iga/optimization.py +700 -0
- morphogen/iga/shapes.py +331 -0
- morphogen/image.py +128 -0
- morphogen/io/__init__.py +246 -0
- morphogen/io/amitex.py +741 -0
- morphogen/io/ebsd.py +881 -0
- morphogen/io/export.py +196 -0
- morphogen/io/geometry.py +158 -0
- morphogen/io/medit.py +147 -0
- morphogen/io/meshes.py +844 -0
- morphogen/io/metaimage.py +97 -0
- morphogen/io/mfront.py +1104 -0
- morphogen/io/native.py +57 -0
- morphogen/io/radioss.py +764 -0
- morphogen/io/solvers.py +371 -0
- morphogen/io/tables.py +278 -0
- morphogen/io/tiff.py +66 -0
- morphogen/io/vtk.py +701 -0
- morphogen/io/xdmf.py +200 -0
- morphogen/kernels/__init__.py +5 -0
- morphogen/kernels/annealing.py +192 -0
- morphogen/kernels/cells.py +69 -0
- morphogen/kernels/collective.py +87 -0
- morphogen/kernels/force_biased.py +595 -0
- morphogen/kernels/implicit.py +145 -0
- morphogen/kernels/leaves.py +132 -0
- morphogen/kernels/packing.py +304 -0
- morphogen/kernels/raster.py +279 -0
- morphogen/kernels/rsa.py +371 -0
- morphogen/kernels/union.py +135 -0
- morphogen/kernels/watershed.py +190 -0
- morphogen/laser/__init__.py +234 -0
- morphogen/laser/architectures.py +375 -0
- morphogen/laser/bending.py +216 -0
- morphogen/laser/cells.py +1694 -0
- morphogen/laser/design.py +940 -0
- morphogen/laser/figures.py +227 -0
- morphogen/laser/heat.py +804 -0
- morphogen/laser/materials.py +691 -0
- morphogen/laser/mechanics.py +1670 -0
- morphogen/laser/metallurgy.py +615 -0
- morphogen/laser/patterns.py +828 -0
- morphogen/laser/periodic.py +392 -0
- morphogen/laser/process.py +362 -0
- morphogen/laser/run.py +534 -0
- morphogen/laser/solid.py +216 -0
- morphogen/laser/specimen.py +200 -0
- morphogen/laser/structures.py +708 -0
- morphogen/learning/__init__.py +81 -0
- morphogen/learning/behaviour.py +398 -0
- morphogen/learning/data.py +328 -0
- morphogen/learning/learned.cpp +668 -0
- morphogen/learning/logarithmic.py +202 -0
- morphogen/learning/mfront.py +409 -0
- morphogen/learning/networks.py +767 -0
- morphogen/learning/run.py +212 -0
- morphogen/learning/standard.py +814 -0
- morphogen/learning/training.py +235 -0
- morphogen/mesh/__init__.py +29 -0
- morphogen/mesh/conforming.py +1423 -0
- morphogen/mesh/curved.py +600 -0
- morphogen/mesh/exact.py +1717 -0
- morphogen/mesh/octree.py +350 -0
- morphogen/mesh/polycrystal.py +1041 -0
- morphogen/mesh/polyhedra.py +677 -0
- morphogen/mesh/regularize.py +570 -0
- morphogen/mesh/surface.py +97 -0
- morphogen/mesh/tetra.py +512 -0
- morphogen/mesh/voxel.py +124 -0
- morphogen/micromorphic/__init__.py +31 -0
- morphogen/micromorphic/damage.py +359 -0
- morphogen/micromorphic/ductile.py +534 -0
- morphogen/micromorphic/finite.py +220 -0
- morphogen/micromorphic/microfoam.py +787 -0
- morphogen/micromorphic/space.py +341 -0
- morphogen/models/__init__.py +195 -0
- morphogen/models/affine.py +384 -0
- morphogen/models/automata.py +592 -0
- morphogen/models/base.py +500 -0
- morphogen/models/boolean.py +310 -0
- morphogen/models/bouligand.py +331 -0
- morphogen/models/branching.py +241 -0
- morphogen/models/combination.py +430 -0
- morphogen/models/deadleaves.py +766 -0
- morphogen/models/design.py +289 -0
- morphogen/models/ebsd.py +206 -0
- morphogen/models/fibers.py +1476 -0
- morphogen/models/foam.py +594 -0
- morphogen/models/gaussian.py +314 -0
- morphogen/models/growth.py +459 -0
- morphogen/models/hardcore.py +317 -0
- morphogen/models/hierarchical.py +269 -0
- morphogen/models/honeycomb.py +749 -0
- morphogen/models/implicit.py +177 -0
- morphogen/models/laminate.py +470 -0
- morphogen/models/lattice.py +351 -0
- morphogen/models/lattice_field.py +345 -0
- morphogen/models/levelset_foam.py +563 -0
- morphogen/models/nacre.py +411 -0
- morphogen/models/nested.py +924 -0
- morphogen/models/osteons.py +374 -0
- morphogen/models/pieces.py +167 -0
- morphogen/models/planar.py +126 -0
- morphogen/models/reconstruction.py +203 -0
- morphogen/models/scale_rich.py +1409 -0
- morphogen/models/scale_rich_3d.py +1616 -0
- morphogen/models/tessellation.py +735 -0
- morphogen/models/tiling_field.py +302 -0
- morphogen/models/tpms.py +197 -0
- morphogen/models/transparent.py +406 -0
- morphogen/models/union.py +141 -0
- morphogen/optimization/__init__.py +43 -0
- morphogen/optimization/cell.py +295 -0
- morphogen/optimization/filters.py +115 -0
- morphogen/optimization/mma.py +226 -0
- morphogen/optimization/run.py +219 -0
- morphogen/optimization/topology.py +632 -0
- morphogen/orientations.py +568 -0
- morphogen/parallel.py +599 -0
- morphogen/pipeline.py +978 -0
- morphogen/primitives.py +188 -0
- morphogen/results.py +564 -0
- morphogen/rve/__init__.py +73 -0
- morphogen/rve/report.py +627 -0
- morphogen/rve/scaling.py +363 -0
- morphogen/rve/study.py +1054 -0
- morphogen/rve/windows.py +345 -0
- morphogen/seeding.py +51 -0
- morphogen/settings.py +118 -0
- morphogen/stopping.py +48 -0
- morphogen/symmetry.py +384 -0
- morphogen/templates/activator_inhibitor.yaml +22 -0
- morphogen/templates/aggregation.yaml +23 -0
- morphogen/templates/boolean_cylinders.yaml +20 -0
- morphogen/templates/boolean_spheres.yaml +22 -0
- morphogen/templates/bouligand.yaml +28 -0
- morphogen/templates/cellular_automaton.yaml +25 -0
- morphogen/templates/coated_spheres.yaml +26 -0
- morphogen/templates/contact_fibers.yaml +27 -0
- morphogen/templates/cox_nanocomposite.yaml +22 -0
- morphogen/templates/cross_linked_fibers.yaml +26 -0
- morphogen/templates/curved_arcs.yaml +28 -0
- morphogen/templates/curved_fibers.yaml +24 -0
- morphogen/templates/dead_leaves.yaml +22 -0
- morphogen/templates/delaunay_network.yaml +22 -0
- morphogen/templates/dense_packing.yaml +22 -0
- morphogen/templates/diffusion.yaml +33 -0
- morphogen/templates/ebsd.yaml +34 -0
- morphogen/templates/ebsd_map.ctf +3087 -0
- morphogen/templates/fracture_composite.yaml +42 -0
- morphogen/templates/fracture_rubber.yaml +47 -0
- morphogen/templates/gaussian_excursion.yaml +17 -0
- morphogen/templates/graded_lattice.yaml +24 -0
- morphogen/templates/hardcore_fibers.yaml +22 -0
- morphogen/templates/hardcore_spheres.yaml +22 -0
- morphogen/templates/hierarchical_lattice.yaml +22 -0
- morphogen/templates/homogenization_acoustic_foam.yaml +36 -0
- morphogen/templates/homogenization_beremin.yaml +50 -0
- morphogen/templates/homogenization_cleavage.yaml +51 -0
- morphogen/templates/homogenization_cleavage_band.yaml +55 -0
- morphogen/templates/homogenization_contact.yaml +43 -0
- morphogen/templates/homogenization_crack_closure.yaml +49 -0
- morphogen/templates/homogenization_crystal_plasticity.yaml +50 -0
- morphogen/templates/homogenization_crystal_plasticity_fft.yaml +52 -0
- morphogen/templates/homogenization_crystallization.yaml +30 -0
- morphogen/templates/homogenization_debonding.yaml +43 -0
- morphogen/templates/homogenization_detwinning.yaml +58 -0
- morphogen/templates/homogenization_ductile_damage.yaml +47 -0
- morphogen/templates/homogenization_fatigue.yaml +40 -0
- morphogen/templates/homogenization_grain_fracture.yaml +56 -0
- morphogen/templates/homogenization_gyroid.yaml +30 -0
- morphogen/templates/homogenization_intergranular.yaml +43 -0
- morphogen/templates/homogenization_interphase.yaml +42 -0
- morphogen/templates/homogenization_mixed_loading.yaml +33 -0
- morphogen/templates/homogenization_ntfa.yaml +56 -0
- morphogen/templates/homogenization_piezoelectric.yaml +27 -0
- morphogen/templates/homogenization_polycrystal.yaml +30 -0
- morphogen/templates/homogenization_polycrystal_inclusions.yaml +30 -0
- morphogen/templates/homogenization_poroelastic.yaml +26 -0
- morphogen/templates/homogenization_rubber.yaml +40 -0
- morphogen/templates/homogenization_slip_cleavage.yaml +50 -0
- morphogen/templates/homogenization_spheres.yaml +31 -0
- morphogen/templates/homogenization_transport.yaml +29 -0
- morphogen/templates/homogenization_twinning.yaml +54 -0
- morphogen/templates/homogenization_viscoelastic.yaml +34 -0
- morphogen/templates/homogenization_viscoplastic.yaml +42 -0
- morphogen/templates/homogenization_voronoi.yaml +26 -0
- morphogen/templates/homogenization_xfem.yaml +23 -0
- morphogen/templates/hyperuniform_cells.yaml +24 -0
- morphogen/templates/laguerre.yaml +18 -0
- morphogen/templates/laser_bending.yaml +35 -0
- morphogen/templates/laser_cells.yaml +38 -0
- morphogen/templates/laser_corrugated.yaml +36 -0
- morphogen/templates/level_set_foam.yaml +29 -0
- morphogen/templates/menger_sponge.yaml +17 -0
- morphogen/templates/nacre.yaml +25 -0
- morphogen/templates/nucleation_growth.yaml +25 -0
- morphogen/templates/optimize_auxetic.yaml +29 -0
- morphogen/templates/optimize_auxetic_3d.yaml +27 -0
- morphogen/templates/optimize_bulk.yaml +23 -0
- morphogen/templates/optimize_conductivity.yaml +20 -0
- morphogen/templates/osteons.yaml +28 -0
- morphogen/templates/penetrable_spheres.yaml +21 -0
- morphogen/templates/poisson_fibers.yaml +21 -0
- morphogen/templates/random_laminate.yaml +26 -0
- morphogen/templates/random_lattice.yaml +27 -0
- morphogen/templates/random_walk_fibers.yaml +26 -0
- morphogen/templates/reaction_diffusion.yaml +22 -0
- morphogen/templates/reconstruction.yaml +22 -0
- morphogen/templates/rve_cellular_automaton.yaml +23 -0
- morphogen/templates/rve_crystal_plasticity_fft.yaml +51 -0
- morphogen/templates/rve_multiphysics.yaml +43 -0
- morphogen/templates/rve_poisson_fibers.yaml +22 -0
- morphogen/templates/rve_poisson_fibers_fe.yaml +33 -0
- morphogen/templates/rve_voronoi_windows.yaml +20 -0
- morphogen/templates/scale_rich_network.yaml +29 -0
- morphogen/templates/scale_rich_plates.yaml +30 -0
- morphogen/templates/sequential_dead_leaves.yaml +25 -0
- morphogen/templates/strut_lattice.yaml +21 -0
- morphogen/templates/tile_assembly.yaml +28 -0
- morphogen/templates/tpms.yaml +19 -0
- morphogen/templates/trabecular_bone.yaml +29 -0
- morphogen/templates/transparent_dead_leaves.yaml +23 -0
- morphogen/templates/vascular_tree.yaml +23 -0
- morphogen/templates/voronoi.yaml +20 -0
- morphogen/templates/wood.yaml +34 -0
- morphogen/templates/workflow.yaml +56 -0
- morphogen/texture.py +665 -0
- morphogen/theory.py +162 -0
- morphogen/viz/__init__.py +12 -0
- morphogen/viz/export.py +244 -0
- morphogen/viz/figures.py +707 -0
- morphogen/viz/png.py +148 -0
- morphogen/viz/sections.py +696 -0
- morphogen/viz/surfaces.py +1352 -0
- morphogen/viz/video.py +904 -0
- morphogen/viz/workflow.py +488 -0
- morphogen-1.0.0.dist-info/METADATA +2316 -0
- morphogen-1.0.0.dist-info/RECORD +381 -0
- morphogen-1.0.0.dist-info/WHEEL +4 -0
- morphogen-1.0.0.dist-info/entry_points.txt +5 -0
- morphogen-1.0.0.dist-info/licenses/LICENSE +674 -0
|
@@ -0,0 +1,203 @@
|
|
|
1
|
+
"""Stochastic reconstruction of two-phase microstructures from their statistical
|
|
2
|
+
descriptors (Yeong & Torquato 1998).
|
|
3
|
+
|
|
4
|
+
A realization is a periodic lattice of cells of edge ``cell_size`` covering the domain
|
|
5
|
+
(a :class:`~morphogen.models.lattice_field.LatticeField`), annealed from random cells of
|
|
6
|
+
the volume fraction (:mod:`morphogen.kernels.annealing`): the two-point probability
|
|
7
|
+
``S_2`` of phase 1 along the axes of the lattice, and its lineal-path function ``L``
|
|
8
|
+
with the weight ``lineal_path``, approach their targets, those of
|
|
9
|
+
|
|
10
|
+
* a Debye random medium (``correlation_length`` ``a``, Debye, Anderson & Brumberger
|
|
11
|
+
1957): ``S_2(r) = p^2 + p (1 - p) e^{-r/a}``, specific surface ``4 p (1 - p) / a``;
|
|
12
|
+
* a realization of another model (``reference``) on the same lattice, periodic;
|
|
13
|
+
* a phase image (``image``: a file), its descriptors measured at its own voxels and
|
|
14
|
+
interpolated at the lags of the lattice (``p^2`` and 0 beyond its half size).
|
|
15
|
+
|
|
16
|
+
``S_2`` alone does not determine a microstructure: two microstructures with the same
|
|
17
|
+
``S_2`` can differ in their connectivity, which ``L`` (and the chords) retains in part.
|
|
18
|
+
"""
|
|
19
|
+
|
|
20
|
+
from __future__ import annotations
|
|
21
|
+
|
|
22
|
+
import dataclasses
|
|
23
|
+
import math
|
|
24
|
+
from dataclasses import dataclass
|
|
25
|
+
from typing import ClassVar
|
|
26
|
+
|
|
27
|
+
import numpy as np
|
|
28
|
+
|
|
29
|
+
from morphogen._utils import check_fraction, check_positive
|
|
30
|
+
from morphogen.domain import Domain, Grid
|
|
31
|
+
from morphogen.kernels.annealing import anneal
|
|
32
|
+
from morphogen.models.base import Model, param, register
|
|
33
|
+
from morphogen.models.lattice_field import LatticeField, lattice_shape
|
|
34
|
+
from morphogen.seeding import SeedLike, make_rng
|
|
35
|
+
|
|
36
|
+
|
|
37
|
+
def _measured(image, rmax: int, lags: np.ndarray, n_axes: int):
|
|
38
|
+
"""``S_2`` and ``L`` of phase 1 of an image at the physical ``lags`` of each axis (rows),
|
|
39
|
+
interpolated from its own lags, and its volume fraction."""
|
|
40
|
+
from morphogen.analysis.correlation import lineal_path
|
|
41
|
+
from morphogen.analysis.covariance import covariance
|
|
42
|
+
|
|
43
|
+
cov = covariance(image, 1)
|
|
44
|
+
lp = lineal_path(image, 1)
|
|
45
|
+
p = cov.volume_fraction
|
|
46
|
+
s = np.full((3, rmax + 1), p * p)
|
|
47
|
+
line = np.zeros((3, rmax + 1))
|
|
48
|
+
for a, name in enumerate("xyz"[:n_axes]):
|
|
49
|
+
s[a] = np.interp(lags[a], cov.lags[name], cov.values[name], right=p * p)
|
|
50
|
+
line[a] = np.interp(lags[a], lp.lags[name], lp.values[name], right=0.0)
|
|
51
|
+
return s, line, p
|
|
52
|
+
|
|
53
|
+
|
|
54
|
+
@register
|
|
55
|
+
@dataclass(frozen=True)
|
|
56
|
+
class Reconstruction(Model):
|
|
57
|
+
"""Two-phase microstructure annealed to the two-point probability (and the lineal-path
|
|
58
|
+
function) of a Debye medium, of a model or of an image (Yeong & Torquato 1998)."""
|
|
59
|
+
|
|
60
|
+
name = "reconstruction"
|
|
61
|
+
phases: ClassVar[dict[int, str]] = {0: "phase 0", 1: "phase 1"}
|
|
62
|
+
|
|
63
|
+
reference: Model | None = param(
|
|
64
|
+
None, doc="A model whose realization on the lattice gives the targets", kind="model"
|
|
65
|
+
)
|
|
66
|
+
image: str | None = param(
|
|
67
|
+
None, doc="A phase image (file) whose phase 1 gives the targets", kind="str"
|
|
68
|
+
)
|
|
69
|
+
correlation_length: float | None = param(
|
|
70
|
+
None,
|
|
71
|
+
doc="Debye random medium: S2(r) = p^2 + p (1 - p) exp(-r / a)",
|
|
72
|
+
unit="length",
|
|
73
|
+
)
|
|
74
|
+
volume_fraction: float | None = param(
|
|
75
|
+
None, doc="Fraction of phase 1 of the Debye medium", kind="fraction"
|
|
76
|
+
)
|
|
77
|
+
lineal_path: float = param(
|
|
78
|
+
0.0, doc="Weight of the lineal-path function in the energy (0: S2 alone)"
|
|
79
|
+
)
|
|
80
|
+
max_lag: int | None = param(
|
|
81
|
+
None,
|
|
82
|
+
doc="Largest lag of the descriptors, in cells (default: a quarter of the lattice, "
|
|
83
|
+
"at most 32)",
|
|
84
|
+
kind="int",
|
|
85
|
+
)
|
|
86
|
+
sweeps: int = param(100, doc="Trial swaps per cell", kind="int")
|
|
87
|
+
cooling: float = param(
|
|
88
|
+
0.98, doc="Factor of the temperature after every tenth of a sweep", kind="fraction"
|
|
89
|
+
)
|
|
90
|
+
tolerance: float = param(1e-10, doc="Energy at which the annealing stops")
|
|
91
|
+
cell_size: float = param(1.0, doc="Edge of the cells of the lattice", unit="length")
|
|
92
|
+
dimension: int = param(
|
|
93
|
+
3, doc="3, or 2 for planar structures (one cell through the thickness)", kind="int"
|
|
94
|
+
)
|
|
95
|
+
smoothing: float = param(
|
|
96
|
+
0.0,
|
|
97
|
+
doc="Gaussian smoothing (in cells) of the interface for other resolutions and "
|
|
98
|
+
"conforming meshes (0: trilinear interpolation of the cells)",
|
|
99
|
+
unit="cells",
|
|
100
|
+
)
|
|
101
|
+
|
|
102
|
+
def _validate(self) -> None:
|
|
103
|
+
given = [k for k in ("reference", "image", "correlation_length")
|
|
104
|
+
if getattr(self, k) is not None] # fmt: skip
|
|
105
|
+
if len(given) != 1:
|
|
106
|
+
raise ValueError(
|
|
107
|
+
"give one target: reference (a model), image (a file) or correlation_length "
|
|
108
|
+
"(a Debye medium)"
|
|
109
|
+
)
|
|
110
|
+
if self.correlation_length is not None:
|
|
111
|
+
check_positive(self.correlation_length, "correlation_length")
|
|
112
|
+
if self.volume_fraction is None:
|
|
113
|
+
raise ValueError("volume_fraction: the fraction of phase 1 of the Debye medium")
|
|
114
|
+
check_fraction(self.volume_fraction, "volume_fraction")
|
|
115
|
+
if self.lineal_path:
|
|
116
|
+
raise ValueError("lineal_path: unknown for a Debye medium (give a reference)")
|
|
117
|
+
elif self.volume_fraction is not None:
|
|
118
|
+
raise ValueError("volume_fraction: that of the reference or of the image")
|
|
119
|
+
check_positive(self.lineal_path, "lineal_path", allow_zero=True)
|
|
120
|
+
if self.max_lag is not None and self.max_lag < 1:
|
|
121
|
+
raise ValueError("max_lag: a positive number of cells")
|
|
122
|
+
if self.sweeps < 1:
|
|
123
|
+
raise ValueError("sweeps: a positive number of swaps per cell")
|
|
124
|
+
if not 0.0 < self.cooling <= 1.0:
|
|
125
|
+
raise ValueError("cooling: a factor in (0, 1]")
|
|
126
|
+
check_positive(self.tolerance, "tolerance", allow_zero=True)
|
|
127
|
+
check_positive(self.cell_size, "cell_size")
|
|
128
|
+
if self.dimension not in (2, 3):
|
|
129
|
+
raise ValueError("dimension: 2 or 3")
|
|
130
|
+
check_positive(self.smoothing, "smoothing", allow_zero=True)
|
|
131
|
+
|
|
132
|
+
def _lattice(self, domain: Domain) -> tuple[Grid, int, int]:
|
|
133
|
+
"""The periodic lattice of the domain, its axes and the largest lag."""
|
|
134
|
+
shape = lattice_shape(domain, self.cell_size, self.dimension)
|
|
135
|
+
n_axes = 3 if self.dimension == 3 else 2
|
|
136
|
+
if self.max_lag is not None:
|
|
137
|
+
rmax = int(self.max_lag)
|
|
138
|
+
else:
|
|
139
|
+
rmax = min(32, max(1, min(shape[:n_axes]) // 4))
|
|
140
|
+
if rmax > min(shape[:n_axes]) // 2:
|
|
141
|
+
raise ValueError(f"max_lag: at most half the lattice ({min(shape[:n_axes]) // 2})")
|
|
142
|
+
return Grid(dataclasses.replace(domain, periodic=True), shape), n_axes, rmax
|
|
143
|
+
|
|
144
|
+
def targets(self, domain: Domain, seed: SeedLike = None):
|
|
145
|
+
"""The target ``S_2`` and ``L`` along the axes (rows, lags 0..max_lag) and the
|
|
146
|
+
volume fraction, on the lattice of the domain."""
|
|
147
|
+
rng, _ = make_rng(seed)
|
|
148
|
+
return self._targets(domain, rng)
|
|
149
|
+
|
|
150
|
+
def _targets(self, domain: Domain, rng):
|
|
151
|
+
lattice, n_axes, rmax = self._lattice(domain)
|
|
152
|
+
lags = np.arange(rmax + 1)[None, :] * np.asarray(lattice.spacing, dtype=float)[:, None]
|
|
153
|
+
if self.correlation_length is not None:
|
|
154
|
+
p = float(self.volume_fraction)
|
|
155
|
+
s = p * p + p * (1.0 - p) * np.exp(-lags / self.correlation_length)
|
|
156
|
+
return s, np.zeros_like(s), p
|
|
157
|
+
if self.reference is not None:
|
|
158
|
+
ref = self.reference.generate(lattice.domain, seed=rng)
|
|
159
|
+
image = ref.voxelize(grid=lattice)
|
|
160
|
+
else:
|
|
161
|
+
from morphogen import io
|
|
162
|
+
|
|
163
|
+
image = io.load_image(self.image)
|
|
164
|
+
s, line, p = _measured(image, rmax, lags, n_axes)
|
|
165
|
+
return s, line, p
|
|
166
|
+
|
|
167
|
+
def generate(self, domain: Domain, seed: SeedLike = None) -> LatticeField:
|
|
168
|
+
rng, seed_info = make_rng(seed)
|
|
169
|
+
lattice, n_axes, rmax = self._lattice(domain)
|
|
170
|
+
target_s, target_l, p = self._targets(domain, rng)
|
|
171
|
+
cells = int(np.prod(lattice.shape))
|
|
172
|
+
img = np.zeros(cells, dtype=np.uint8)
|
|
173
|
+
img[rng.permutation(cells)[: round(p * cells)]] = 1
|
|
174
|
+
img = img.reshape(lattice.shape)
|
|
175
|
+
stage = max(1, cells // 10)
|
|
176
|
+
initial, energy, trials, accepted = anneal(
|
|
177
|
+
img,
|
|
178
|
+
np.ascontiguousarray(target_s),
|
|
179
|
+
np.ascontiguousarray(target_l),
|
|
180
|
+
float(self.lineal_path),
|
|
181
|
+
n_axes,
|
|
182
|
+
rmax,
|
|
183
|
+
int(self.sweeps) * cells,
|
|
184
|
+
float(self.cooling),
|
|
185
|
+
stage,
|
|
186
|
+
float(self.tolerance),
|
|
187
|
+
int(rng.integers(2**31 - 1)),
|
|
188
|
+
)
|
|
189
|
+
attributes = {"initial_energy": float(initial), "energy": float(energy),
|
|
190
|
+
"trials": int(trials), "accepted": int(accepted),
|
|
191
|
+
"max_lag": rmax} # fmt: skip
|
|
192
|
+
return LatticeField(domain, img, smoothing=self.smoothing, attributes=attributes,
|
|
193
|
+
model=self, seed=seed_info) # fmt: skip
|
|
194
|
+
|
|
195
|
+
def theory(self, domain: Domain | None = None) -> dict[str, float]:
|
|
196
|
+
if self.correlation_length is not None:
|
|
197
|
+
p, a = float(self.volume_fraction), float(self.correlation_length)
|
|
198
|
+
return {"volume_fraction": p, "specific_surface": 4.0 * p * (1.0 - p) / a,
|
|
199
|
+
"integral_range": 8.0 * math.pi * a**3} # fmt: skip
|
|
200
|
+
if self.reference is not None:
|
|
201
|
+
ref = self.reference.theory(domain)
|
|
202
|
+
return {k: ref[k] for k in ("volume_fraction",) if k in ref}
|
|
203
|
+
return {}
|