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,351 @@
|
|
|
1
|
+
"""Strut (beam) lattices: periodic arrangements of cylindrical struts."""
|
|
2
|
+
|
|
3
|
+
from __future__ import annotations
|
|
4
|
+
|
|
5
|
+
import itertools
|
|
6
|
+
import math
|
|
7
|
+
from dataclasses import dataclass
|
|
8
|
+
from functools import lru_cache
|
|
9
|
+
from typing import ClassVar
|
|
10
|
+
|
|
11
|
+
import numpy as np
|
|
12
|
+
from scipy import optimize
|
|
13
|
+
|
|
14
|
+
from morphogen._utils import check_fraction, check_positive
|
|
15
|
+
from morphogen.domain import Domain
|
|
16
|
+
from morphogen.kernels.union import UnionAccelerator
|
|
17
|
+
from morphogen.models.affine import ANISOTROPY, Anisotropy, anisotropic
|
|
18
|
+
from morphogen.models.base import Model, param, register
|
|
19
|
+
from morphogen.models.union import PrimitiveUnion
|
|
20
|
+
from morphogen.primitives import Segments, with_periodic_images
|
|
21
|
+
from morphogen.seeding import SeedLike, make_rng
|
|
22
|
+
|
|
23
|
+
_CORNERS = np.array(list(itertools.product((0.0, 1.0), repeat=3)))
|
|
24
|
+
_FACE_CENTERS = np.array(
|
|
25
|
+
[
|
|
26
|
+
[0.5, 0.5, 0.0],
|
|
27
|
+
[0.5, 0.5, 1.0],
|
|
28
|
+
[0.5, 0.0, 0.5],
|
|
29
|
+
[0.5, 1.0, 0.5],
|
|
30
|
+
[0.0, 0.5, 0.5],
|
|
31
|
+
[1.0, 0.5, 0.5],
|
|
32
|
+
]
|
|
33
|
+
)
|
|
34
|
+
_BODY_CENTER = np.array([[0.5, 0.5, 0.5]])
|
|
35
|
+
|
|
36
|
+
|
|
37
|
+
def _pairs_at(nodes_a, nodes_b, distance, same: bool):
|
|
38
|
+
"""Pairs of nodes (one from each set) at the given distance, in the unit cell."""
|
|
39
|
+
out = []
|
|
40
|
+
for i, p in enumerate(nodes_a):
|
|
41
|
+
for j, q in enumerate(nodes_b):
|
|
42
|
+
if same and j <= i:
|
|
43
|
+
continue
|
|
44
|
+
if abs(np.linalg.norm(p - q) - distance) < 1e-9:
|
|
45
|
+
out.append((p, q))
|
|
46
|
+
return out
|
|
47
|
+
|
|
48
|
+
|
|
49
|
+
def unit_cell_struts(cell: str) -> np.ndarray:
|
|
50
|
+
"""Struts of a unit cell in fractional coordinates, shape (n, 2, 3)."""
|
|
51
|
+
h = math.sqrt(0.5)
|
|
52
|
+
if cell == "cubic":
|
|
53
|
+
pairs = _pairs_at(_CORNERS, _CORNERS, 1.0, True)
|
|
54
|
+
elif cell == "bcc":
|
|
55
|
+
pairs = _pairs_at(_BODY_CENTER, _CORNERS, math.sqrt(3.0) / 2.0, False)
|
|
56
|
+
elif cell == "fcc":
|
|
57
|
+
pairs = _pairs_at(_CORNERS, _FACE_CENTERS, h, False)
|
|
58
|
+
elif cell == "octet":
|
|
59
|
+
pairs = _pairs_at(_CORNERS, _FACE_CENTERS, h, False)
|
|
60
|
+
pairs += _pairs_at(_FACE_CENTERS, _FACE_CENTERS, h, True)
|
|
61
|
+
elif cell == "kelvin":
|
|
62
|
+
# edges of the truncated octahedron around the body centre (Voronoi cell of the
|
|
63
|
+
# bcc lattice): its vertices are the permutations of (0, +-1/4, +-1/2), its
|
|
64
|
+
# square faces lie on the faces of the cell
|
|
65
|
+
signs = itertools.product((-1.0, 1.0), repeat=2)
|
|
66
|
+
base = {p for a, b in signs for p in itertools.permutations((0.0, 0.25 * a, 0.5 * b))}
|
|
67
|
+
vertices = 0.5 + np.array(sorted(base))
|
|
68
|
+
pairs = _pairs_at(vertices, vertices, 0.25 * math.sqrt(2.0), True)
|
|
69
|
+
elif cell == "diamond":
|
|
70
|
+
# two face-centred lattices a quarter of the diagonal apart: each node of one
|
|
71
|
+
# joined to its four neighbours of the other, at the corners of a tetrahedron
|
|
72
|
+
# (coordination 4, bending-dominated: the honeycomb of space)
|
|
73
|
+
sites = np.vstack([_CORNERS, _FACE_CENTERS])
|
|
74
|
+
inner = np.array([[0.25, 0.25, 0.25], [0.75, 0.75, 0.25], [0.75, 0.25, 0.75],
|
|
75
|
+
[0.25, 0.75, 0.75]]) # fmt: skip
|
|
76
|
+
pairs = _pairs_at(inner, sites, 0.25 * math.sqrt(3.0), False)
|
|
77
|
+
elif cell == "pyrochlore":
|
|
78
|
+
# tetrahedra joined by their corners (the middles of the bonds of the diamond
|
|
79
|
+
# lattice): six struts per node along three straight lines, coordination 6,
|
|
80
|
+
# stretching-dominated with half the struts of the octet truss: the kagome of
|
|
81
|
+
# space. The origin is at an eighth of the diagonal: every tetrahedron in the cell
|
|
82
|
+
pairs = []
|
|
83
|
+
centres = np.array([[0.0, 0.0, 0.0], [0.5, 0.5, 0.0], [0.5, 0.0, 0.5], [0.0, 0.5, 0.5]])
|
|
84
|
+
even = np.array([[1, 1, 1], [1, -1, -1], [-1, 1, -1], [-1, -1, 1]]) / 8.0
|
|
85
|
+
for centre in centres:
|
|
86
|
+
for origin, corners in ((0.125, even), (0.375, -even)):
|
|
87
|
+
vertices = centre + origin + corners
|
|
88
|
+
pairs += _pairs_at(vertices, vertices, 0.25 * math.sqrt(2.0), True)
|
|
89
|
+
else:
|
|
90
|
+
raise ValueError(f"cell: expected one of {sorted(CELLS)}, got {cell!r}")
|
|
91
|
+
return np.array([[p, q] for p, q in pairs], dtype=float)
|
|
92
|
+
|
|
93
|
+
|
|
94
|
+
CELLS = ("cubic", "bcc", "fcc", "octet", "kelvin", "diamond", "pyrochlore")
|
|
95
|
+
|
|
96
|
+
|
|
97
|
+
def _unique_segments(start: np.ndarray, end: np.ndarray, scale: float):
|
|
98
|
+
"""Remove duplicated struts (shared by neighbouring cells)."""
|
|
99
|
+
a = np.round(start / scale, 9)
|
|
100
|
+
b = np.round(end / scale, 9)
|
|
101
|
+
# orient each strut so that its first endpoint is the lexicographically smaller one
|
|
102
|
+
diff = b - a
|
|
103
|
+
first = np.argmax(diff != 0, axis=1)
|
|
104
|
+
swap = diff[np.arange(len(diff)), first] < 0
|
|
105
|
+
lo = np.where(swap[:, None], b, a)
|
|
106
|
+
hi = np.where(swap[:, None], a, b)
|
|
107
|
+
_, idx = np.unique(np.hstack([lo, hi]), axis=0, return_index=True)
|
|
108
|
+
idx.sort()
|
|
109
|
+
return start[idx], end[idx]
|
|
110
|
+
|
|
111
|
+
|
|
112
|
+
def lattice_struts(cell: str, cell_size: float, lower, upper) -> tuple[np.ndarray, np.ndarray]:
|
|
113
|
+
"""All struts of the lattice anchored at the origin whose cells meet [lower, upper]."""
|
|
114
|
+
unit = unit_cell_struts(cell) * cell_size
|
|
115
|
+
lo_idx = np.floor(np.asarray(lower) / cell_size).astype(int)
|
|
116
|
+
hi_idx = np.ceil(np.asarray(upper) / cell_size).astype(int) - 1
|
|
117
|
+
ranges = [range(lo_idx[a], max(hi_idx[a], lo_idx[a]) + 1) for a in range(3)]
|
|
118
|
+
shifts = np.array(list(itertools.product(*ranges)), dtype=float) * cell_size
|
|
119
|
+
start = (shifts[:, None, :] + unit[None, :, 0, :]).reshape(-1, 3)
|
|
120
|
+
end = (shifts[:, None, :] + unit[None, :, 1, :]).reshape(-1, 3)
|
|
121
|
+
return _unique_segments(start, end, cell_size)
|
|
122
|
+
|
|
123
|
+
|
|
124
|
+
#: Offset of the lattice from the voxels of the fraction estimates, in voxels: off the
|
|
125
|
+
#: symmetries of the cells, so that the voxels sample the struts as if at random.
|
|
126
|
+
_JITTER = np.array([math.sqrt(2.0) - 1.0, math.sqrt(3.0) - 1.0, math.sqrt(5.0) - 2.0]) / 2.0
|
|
127
|
+
|
|
128
|
+
|
|
129
|
+
def lattice_fraction(cell: str, radius: float, n: int | None = None) -> float:
|
|
130
|
+
"""Solid volume fraction of a lattice of unit cell size 1 (voxel estimate)."""
|
|
131
|
+
if n is None:
|
|
132
|
+
n = int(np.clip(math.ceil(10.0 / radius), 48, 256))
|
|
133
|
+
unit = Domain.cube(1.0, periodic=True)
|
|
134
|
+
start, end = lattice_struts(cell, 1.0, unit.lower, unit.upper)
|
|
135
|
+
shift = _JITTER / n # voxels aligned with the struts would count them in batches
|
|
136
|
+
seg = Segments(start - shift, end - shift, np.full(len(start), radius), round_caps=True)
|
|
137
|
+
seg = with_periodic_images(seg, unit)
|
|
138
|
+
acc = UnionAccelerator(None, seg, unit.lower, unit.upper, min_cell=2.0 / n)
|
|
139
|
+
counts = acc.count(unit.lower, np.full(3, 1.0 / n), (n, n, n), 1)
|
|
140
|
+
return float(counts.mean())
|
|
141
|
+
|
|
142
|
+
|
|
143
|
+
@lru_cache(maxsize=512)
|
|
144
|
+
def strut_fraction(cell: str, r: float, t: float = 0.0, n: int | None = None) -> float:
|
|
145
|
+
"""Solid fraction of a lattice of unit cell size 1, struts of radius ``r`` hollow
|
|
146
|
+
with walls ``t`` (0: solid): the union of the struts minus that of their bores.
|
|
147
|
+
Exact for the cubic cell, a voxel estimate on ``n^3`` voxels otherwise (default: 8
|
|
148
|
+
voxels across the walls of hollow struts, 10 across the radius of solid ones)."""
|
|
149
|
+
hollow = 0 < t < r
|
|
150
|
+
if cell == "cubic": # three orthogonal cylinders per node, minus their overlaps
|
|
151
|
+
|
|
152
|
+
def union(x):
|
|
153
|
+
return 3.0 * math.pi * x * x - 8.0 * math.sqrt(2.0) * x**3
|
|
154
|
+
|
|
155
|
+
else:
|
|
156
|
+
if n is None:
|
|
157
|
+
n = int(np.clip(math.ceil(8.0 / t if hollow else 10.0 / r), 48, 256))
|
|
158
|
+
|
|
159
|
+
def union(x):
|
|
160
|
+
return lattice_fraction(cell, x, n)
|
|
161
|
+
|
|
162
|
+
return union(r) - (union(r - t) if hollow else 0.0)
|
|
163
|
+
|
|
164
|
+
|
|
165
|
+
@lru_cache(maxsize=128)
|
|
166
|
+
def strut_radius(cell: str, target: float, t: float = 0.0) -> float:
|
|
167
|
+
"""Radius of the struts (unit cell size) of a lattice of solid fraction ``target``,
|
|
168
|
+
hollow with walls ``t``. The fraction of solid struts grows with their radius; that
|
|
169
|
+
of hollow struts peaks once their bores start to fill the cell: the radius is taken
|
|
170
|
+
below the peak."""
|
|
171
|
+
lo, hi = max(1e-4, 1.0001 * t), 0.499
|
|
172
|
+
if t > 0:
|
|
173
|
+
radii = np.linspace(lo, hi, 25)
|
|
174
|
+
k = int(np.argmax([strut_fraction(cell, r, t, 64) for r in radii]))
|
|
175
|
+
hi = float(radii[max(k, 1)])
|
|
176
|
+
top = strut_fraction(cell, hi, t)
|
|
177
|
+
if top <= target:
|
|
178
|
+
reach = f"hollow struts with walls of {t:.3g} cell" if t > 0 else "this lattice"
|
|
179
|
+
raise ValueError(f"volume_fraction: at most {top:.3g} for {reach}")
|
|
180
|
+
return float(optimize.brentq(lambda r: strut_fraction(cell, r, t) - target, lo, hi, xtol=1e-5))
|
|
181
|
+
|
|
182
|
+
|
|
183
|
+
@register
|
|
184
|
+
@anisotropic
|
|
185
|
+
@dataclass(frozen=True)
|
|
186
|
+
class StrutLattice(Model):
|
|
187
|
+
"""Lattice of cylindrical struts with spherical nodes (spherocylinders).
|
|
188
|
+
|
|
189
|
+
Cells: ``cubic`` (cube edges), ``bcc`` (body diagonals), ``fcc`` (face diagonals),
|
|
190
|
+
``octet`` (face diagonals and inner octahedron), ``kelvin`` (edges of the Kelvin
|
|
191
|
+
foam: truncated octahedra on a bcc lattice, 24 struts per cell). Give the strut
|
|
192
|
+
radius or the target relative density (solid volume fraction). With
|
|
193
|
+
``wall_thickness``, the struts are hollow tubes: their union minus the union of their
|
|
194
|
+
bores (which join at the nodes).
|
|
195
|
+
|
|
196
|
+
In non-periodic domains, the lattice may be turned (``rotation``: Bunge angles of its
|
|
197
|
+
axes in those of the sample; it is then anchored at the centre of the domain) and
|
|
198
|
+
graded: with ``radius_gradient`` (the radii at the lower and upper faces of the
|
|
199
|
+
domain along ``gradient_axis``), each strut takes the radius interpolated linearly at
|
|
200
|
+
its midpoint, a functionally graded lattice.
|
|
201
|
+
"""
|
|
202
|
+
|
|
203
|
+
name = "strut_lattice"
|
|
204
|
+
phases: ClassVar[dict[int, str]] = {0: "void", 1: "struts"}
|
|
205
|
+
count_label = "unit cells"
|
|
206
|
+
|
|
207
|
+
cell: str = param(
|
|
208
|
+
"octet",
|
|
209
|
+
doc="Unit cell: cubic, bcc, fcc, octet, kelvin, diamond or pyrochlore",
|
|
210
|
+
kind="str",
|
|
211
|
+
)
|
|
212
|
+
cell_size: float = param(1.0, doc="Edge of the cubic unit cell", unit="length")
|
|
213
|
+
strut_radius: float | None = param(None, doc="Strut radius", unit="length")
|
|
214
|
+
volume_fraction: float | None = param(None, doc="Target relative density", kind="fraction")
|
|
215
|
+
wall_thickness: float | None = param(
|
|
216
|
+
None, doc="Wall thickness of hollow struts (default: solid)", unit="length"
|
|
217
|
+
)
|
|
218
|
+
rotation: tuple[float, ...] | None = param(
|
|
219
|
+
None,
|
|
220
|
+
doc="Bunge angles (degrees) of the axes of the lattice in those of the sample "
|
|
221
|
+
"(non-periodic domains)",
|
|
222
|
+
kind="floats",
|
|
223
|
+
)
|
|
224
|
+
radius_gradient: tuple[float, ...] | None = param(
|
|
225
|
+
None,
|
|
226
|
+
doc="Strut radii at the lower and upper faces of the domain along gradient_axis: a "
|
|
227
|
+
"graded lattice (non-periodic domains)",
|
|
228
|
+
kind="floats",
|
|
229
|
+
unit="length",
|
|
230
|
+
)
|
|
231
|
+
gradient_axis: int = param(
|
|
232
|
+
0, doc="Axis of the gradient of the strut radius: 0, 1 or 2", kind="int"
|
|
233
|
+
)
|
|
234
|
+
anisotropy: Anisotropy | None = param(None, doc=ANISOTROPY, kind="anisotropy", kw_only=True)
|
|
235
|
+
|
|
236
|
+
def _validate(self) -> None:
|
|
237
|
+
if self.cell not in CELLS:
|
|
238
|
+
raise ValueError(f"cell: expected one of {list(CELLS)}, got {self.cell!r}")
|
|
239
|
+
check_positive(self.cell_size, "cell_size")
|
|
240
|
+
if self.rotation is not None and len(self.rotation) != 3:
|
|
241
|
+
raise ValueError("rotation: three Bunge angles (degrees)")
|
|
242
|
+
if self.gradient_axis not in (0, 1, 2):
|
|
243
|
+
raise ValueError("gradient_axis: 0, 1 or 2")
|
|
244
|
+
if self.radius_gradient is not None:
|
|
245
|
+
if len(self.radius_gradient) != 2:
|
|
246
|
+
raise ValueError("radius_gradient: the radii at the lower and upper faces")
|
|
247
|
+
if self.strut_radius is not None or self.volume_fraction is not None:
|
|
248
|
+
raise ValueError("give the radius_gradient, or the strut_radius or volume_fraction")
|
|
249
|
+
if self.wall_thickness is not None:
|
|
250
|
+
raise ValueError("radius_gradient: solid struts only (no wall_thickness)")
|
|
251
|
+
for r in self.radius_gradient:
|
|
252
|
+
check_positive(r, "radius_gradient")
|
|
253
|
+
if r >= 0.5 * self.cell_size:
|
|
254
|
+
raise ValueError("radius_gradient: radii smaller than half the cell size")
|
|
255
|
+
return
|
|
256
|
+
if (self.strut_radius is None) == (self.volume_fraction is None):
|
|
257
|
+
raise ValueError("give exactly one of 'strut_radius' and 'volume_fraction'")
|
|
258
|
+
if self.strut_radius is not None:
|
|
259
|
+
check_positive(self.strut_radius, "strut_radius")
|
|
260
|
+
if self.strut_radius >= 0.5 * self.cell_size:
|
|
261
|
+
raise ValueError("strut_radius: must be smaller than half the cell size")
|
|
262
|
+
else:
|
|
263
|
+
check_fraction(self.volume_fraction, "volume_fraction")
|
|
264
|
+
if self.wall_thickness is not None:
|
|
265
|
+
check_positive(self.wall_thickness, "wall_thickness")
|
|
266
|
+
if self.strut_radius is not None and self.wall_thickness >= self.strut_radius:
|
|
267
|
+
raise ValueError("wall_thickness: smaller than the strut radius")
|
|
268
|
+
|
|
269
|
+
@property
|
|
270
|
+
def radius(self) -> float:
|
|
271
|
+
"""Strut radius (solved numerically from the volume fraction if needed; the mean
|
|
272
|
+
of the gradient of a graded lattice)."""
|
|
273
|
+
if self.radius_gradient is not None:
|
|
274
|
+
return 0.5 * (self.radius_gradient[0] + self.radius_gradient[1])
|
|
275
|
+
if self.strut_radius is not None:
|
|
276
|
+
return self.strut_radius
|
|
277
|
+
t = 0.0 if self.wall_thickness is None else self.wall_thickness / self.cell_size
|
|
278
|
+
return strut_radius(self.cell, float(self.volume_fraction), t) * self.cell_size
|
|
279
|
+
|
|
280
|
+
def _struts(self, domain: Domain) -> tuple[np.ndarray, np.ndarray]:
|
|
281
|
+
"""Ends of the struts that may meet the domain (turned by ``rotation``)."""
|
|
282
|
+
a = self.cell_size
|
|
283
|
+
margin = 0.0 if domain.periodic else a
|
|
284
|
+
if self.rotation is None:
|
|
285
|
+
return lattice_struts(self.cell, a, domain.lower - margin, domain.upper + margin)
|
|
286
|
+
from morphogen.orientations import euler_to_matrix
|
|
287
|
+
|
|
288
|
+
g = euler_to_matrix(np.asarray(self.rotation, dtype=float))[0] # lattice = g sample
|
|
289
|
+
box = domain.dilated(margin)
|
|
290
|
+
corners = np.array([[box.lower[i] if c[i] == 0 else box.upper[i] for i in range(3)]
|
|
291
|
+
for c in itertools.product((0, 1), repeat=3)]) # fmt: skip
|
|
292
|
+
local = (corners - domain.center) @ g.T
|
|
293
|
+
start, end = lattice_struts(self.cell, a, local.min(axis=0), local.max(axis=0))
|
|
294
|
+
return domain.center + start @ g, domain.center + end @ g
|
|
295
|
+
|
|
296
|
+
def _radii(self, domain: Domain, start, end) -> np.ndarray:
|
|
297
|
+
if self.radius_gradient is None:
|
|
298
|
+
return np.full(len(start), self.radius)
|
|
299
|
+
axis = self.gradient_axis
|
|
300
|
+
s = (0.5 * (start + end)[:, axis] - domain.lower[axis]) / domain.lengths[axis]
|
|
301
|
+
r0, r1 = self.radius_gradient
|
|
302
|
+
return r0 + (r1 - r0) * np.clip(s, 0.0, 1.0)
|
|
303
|
+
|
|
304
|
+
def generate(self, domain: Domain, seed: SeedLike = None) -> PrimitiveUnion:
|
|
305
|
+
_, seed_info = make_rng(seed)
|
|
306
|
+
a = self.cell_size
|
|
307
|
+
if domain.periodic:
|
|
308
|
+
if self.rotation is not None or self.radius_gradient is not None:
|
|
309
|
+
raise ValueError(
|
|
310
|
+
"strut_lattice: rotated and graded lattices need a non-periodic domain"
|
|
311
|
+
)
|
|
312
|
+
ratio = domain.lengths / a
|
|
313
|
+
if np.any(np.abs(ratio - np.rint(ratio)) > 1e-6 * np.maximum(ratio, 1.0)):
|
|
314
|
+
raise ValueError(
|
|
315
|
+
"strut_lattice: a periodic domain must contain a whole number of cells"
|
|
316
|
+
)
|
|
317
|
+
start, end = self._struts(domain)
|
|
318
|
+
segments = Segments(start, end, self._radii(domain, start, end), round_caps=True)
|
|
319
|
+
if not domain.periodic:
|
|
320
|
+
lo, hi = segments.bounds()
|
|
321
|
+
keep = np.all((hi >= domain.lower) & (lo <= domain.upper), axis=1)
|
|
322
|
+
segments = segments.subset(keep)
|
|
323
|
+
struts = PrimitiveUnion(domain, segments=segments, model=self, seed=seed_info)
|
|
324
|
+
if self.wall_thickness is None:
|
|
325
|
+
return struts
|
|
326
|
+
from morphogen.models.combination import Combined
|
|
327
|
+
from morphogen.models.nested import bores_of
|
|
328
|
+
|
|
329
|
+
bores = bores_of(struts, self.wall_thickness)
|
|
330
|
+
return Combined(domain, "difference", [struts, bores], model=self, seed=seed_info)
|
|
331
|
+
|
|
332
|
+
def expected_count(self, domain: Domain) -> float:
|
|
333
|
+
"""Number of unit cells in the domain."""
|
|
334
|
+
return domain.volume / self.cell_size**3
|
|
335
|
+
|
|
336
|
+
def theory(self, domain: Domain | None = None) -> dict[str, float]:
|
|
337
|
+
if self.radius_gradient is not None:
|
|
338
|
+
# the local density along the gradient, averaged (Gauss-Legendre)
|
|
339
|
+
x, w = np.polynomial.legendre.leggauss(6)
|
|
340
|
+
r0, r1 = (r / self.cell_size for r in self.radius_gradient)
|
|
341
|
+
local = [strut_fraction(self.cell, float(r0 + (r1 - r0) * (1 + xi) / 2)) for xi in x]
|
|
342
|
+
return {
|
|
343
|
+
"volume_fraction": float(np.dot(w, local) / 2.0),
|
|
344
|
+
"volume_fraction_lower": strut_fraction(self.cell, float(r0)),
|
|
345
|
+
"volume_fraction_upper": strut_fraction(self.cell, float(r1)),
|
|
346
|
+
}
|
|
347
|
+
r = self.radius / self.cell_size
|
|
348
|
+
t = 0.0 if self.wall_thickness is None else self.wall_thickness / self.cell_size
|
|
349
|
+
# solid struts on fine voxels, hollow ones on the voxels of the radius solve
|
|
350
|
+
fraction = strut_fraction(self.cell, r, t, None if t else 256)
|
|
351
|
+
return {"strut_radius": self.radius, "volume_fraction": fraction}
|