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.
Files changed (381) hide show
  1. morphogen/__init__.py +60 -0
  2. morphogen/__main__.py +7 -0
  3. morphogen/_platform.py +55 -0
  4. morphogen/_public.py +153 -0
  5. morphogen/_utils.py +80 -0
  6. morphogen/_version.py +1 -0
  7. morphogen/analysis/__init__.py +174 -0
  8. morphogen/analysis/anisotropy.py +135 -0
  9. morphogen/analysis/basic.py +38 -0
  10. morphogen/analysis/cells.py +54 -0
  11. morphogen/analysis/connectivity.py +156 -0
  12. morphogen/analysis/correlation.py +195 -0
  13. morphogen/analysis/covariance.py +80 -0
  14. morphogen/analysis/fractal.py +54 -0
  15. morphogen/analysis/measures.py +188 -0
  16. morphogen/analysis/morphology.py +265 -0
  17. morphogen/analysis/particles.py +160 -0
  18. morphogen/analysis/percolation.py +2034 -0
  19. morphogen/analysis/power_laws.py +143 -0
  20. morphogen/analysis/random_sets.py +351 -0
  21. morphogen/analysis/stereology.py +289 -0
  22. morphogen/analysis/surface.py +107 -0
  23. morphogen/analysis/topology.py +92 -0
  24. morphogen/automata/__init__.py +74 -0
  25. morphogen/automata/engine.py +211 -0
  26. morphogen/automata/growth.py +686 -0
  27. morphogen/automata/lattice.py +143 -0
  28. morphogen/automata/reaction.py +255 -0
  29. morphogen/automata/rules.py +353 -0
  30. morphogen/automata/tilings.py +1715 -0
  31. morphogen/cli.py +3526 -0
  32. morphogen/config.py +2167 -0
  33. morphogen/contact/__init__.py +113 -0
  34. morphogen/contact/experiments.py +368 -0
  35. morphogen/contact/hertz.py +104 -0
  36. morphogen/contact/kernels.py +827 -0
  37. morphogen/contact/periodic.py +278 -0
  38. morphogen/contact/problem.py +578 -0
  39. morphogen/contact/surfaces.py +310 -0
  40. morphogen/coupling/__init__.py +43 -0
  41. morphogen/coupling/ageing.py +143 -0
  42. morphogen/coupling/diffusion.py +226 -0
  43. morphogen/coupling/fenicsx.py +484 -0
  44. morphogen/coupling/oxidation.py +447 -0
  45. morphogen/coupling/plates.py +247 -0
  46. morphogen/design/__init__.py +51 -0
  47. morphogen/design/csp.py +616 -0
  48. morphogen/design/frames.py +277 -0
  49. morphogen/design/search.py +287 -0
  50. morphogen/design/tiles.py +336 -0
  51. morphogen/distributions.py +312 -0
  52. morphogen/domain.py +203 -0
  53. morphogen/dynamics/__init__.py +179 -0
  54. morphogen/dynamics/model.py +638 -0
  55. morphogen/dynamics/openradioss.py +643 -0
  56. morphogen/dynamics/results.py +515 -0
  57. morphogen/fracture/__init__.py +170 -0
  58. morphogen/fracture/bulk.py +349 -0
  59. morphogen/fracture/cohesive.py +1614 -0
  60. morphogen/fracture/ductile.py +557 -0
  61. morphogen/fracture/lefm.py +1168 -0
  62. morphogen/fracture/mixed.py +1178 -0
  63. morphogen/fracture/periodic.py +733 -0
  64. morphogen/fracture/phasefield.py +714 -0
  65. morphogen/fracture/phasefield_finite.py +368 -0
  66. morphogen/fracture/surface.py +572 -0
  67. morphogen/fracture/toughness.py +566 -0
  68. morphogen/gpu.py +108 -0
  69. morphogen/gui/__init__.py +8 -0
  70. morphogen/gui/api.py +1927 -0
  71. morphogen/gui/desktop.py +387 -0
  72. morphogen/gui/icon.png +0 -0
  73. morphogen/gui/index.html +1909 -0
  74. morphogen/gui/server.py +229 -0
  75. morphogen/gui/tools/__init__.py +629 -0
  76. morphogen/gui/tools/compare.py +149 -0
  77. morphogen/gui/tools/contact.py +391 -0
  78. morphogen/gui/tools/couplings.py +1085 -0
  79. morphogen/gui/tools/crackfront.py +245 -0
  80. morphogen/gui/tools/design.py +224 -0
  81. morphogen/gui/tools/dynamics.py +824 -0
  82. morphogen/gui/tools/fracture.py +2586 -0
  83. morphogen/gui/tools/interop.py +1654 -0
  84. morphogen/gui/tools/learning.py +595 -0
  85. morphogen/gui/tools/mechanics.py +3881 -0
  86. morphogen/gui/tools/nonlocal_damage.py +1321 -0
  87. morphogen/gui/tools/phasefield.py +215 -0
  88. morphogen/gui/tools/physics.py +597 -0
  89. morphogen/gui/tools/stability.py +1756 -0
  90. morphogen/gui/tools/statistics.py +1408 -0
  91. morphogen/gui/viewer.js +1100 -0
  92. morphogen/homogenization/__init__.py +210 -0
  93. morphogen/homogenization/acoustics.py +566 -0
  94. morphogen/homogenization/amg.py +1005 -0
  95. morphogen/homogenization/apparent.py +1046 -0
  96. morphogen/homogenization/behaviours.cu +2285 -0
  97. morphogen/homogenization/behaviours.py +944 -0
  98. morphogen/homogenization/beremin.py +263 -0
  99. morphogen/homogenization/bifurcation.py +1085 -0
  100. morphogen/homogenization/bloch.py +507 -0
  101. morphogen/homogenization/bounds.py +226 -0
  102. morphogen/homogenization/core.py +458 -0
  103. morphogen/homogenization/coupled.py +1135 -0
  104. morphogen/homogenization/crystal.py +2967 -0
  105. morphogen/homogenization/dilatation.py +454 -0
  106. morphogen/homogenization/elements.py +157 -0
  107. morphogen/homogenization/fatigue.py +768 -0
  108. morphogen/homogenization/fe.py +1739 -0
  109. morphogen/homogenization/fenicsx.py +307 -0
  110. morphogen/homogenization/fft.py +499 -0
  111. morphogen/homogenization/fft_nonlinear.py +391 -0
  112. morphogen/homogenization/finite.py +613 -0
  113. morphogen/homogenization/flow.py +361 -0
  114. morphogen/homogenization/frames.py +1125 -0
  115. morphogen/homogenization/gpu.py +1241 -0
  116. morphogen/homogenization/harmonic.py +427 -0
  117. morphogen/homogenization/identification.py +579 -0
  118. morphogen/homogenization/kernels.py +760 -0
  119. morphogen/homogenization/laws.py +2061 -0
  120. morphogen/homogenization/materials.py +1080 -0
  121. morphogen/homogenization/mfront.py +589 -0
  122. morphogen/homogenization/networks.py +880 -0
  123. morphogen/homogenization/nonlinear.py +2612 -0
  124. morphogen/homogenization/ntfa.py +577 -0
  125. morphogen/homogenization/paths.py +476 -0
  126. morphogen/homogenization/photonic.py +467 -0
  127. morphogen/homogenization/poroelastic.py +212 -0
  128. morphogen/homogenization/porous.py +1120 -0
  129. morphogen/homogenization/postprocess.py +290 -0
  130. morphogen/homogenization/solvers.py +1140 -0
  131. morphogen/homogenization/tensors.py +240 -0
  132. morphogen/homogenization/voxel_fe.py +457 -0
  133. morphogen/homogenization/xfem.py +1016 -0
  134. morphogen/homogenization/zmat.py +1258 -0
  135. morphogen/iga/__init__.py +48 -0
  136. morphogen/iga/analysis.py +508 -0
  137. morphogen/iga/basis.py +214 -0
  138. morphogen/iga/geometry.py +501 -0
  139. morphogen/iga/homogenization.py +219 -0
  140. morphogen/iga/optimization.py +700 -0
  141. morphogen/iga/shapes.py +331 -0
  142. morphogen/image.py +128 -0
  143. morphogen/io/__init__.py +246 -0
  144. morphogen/io/amitex.py +741 -0
  145. morphogen/io/ebsd.py +881 -0
  146. morphogen/io/export.py +196 -0
  147. morphogen/io/geometry.py +158 -0
  148. morphogen/io/medit.py +147 -0
  149. morphogen/io/meshes.py +844 -0
  150. morphogen/io/metaimage.py +97 -0
  151. morphogen/io/mfront.py +1104 -0
  152. morphogen/io/native.py +57 -0
  153. morphogen/io/radioss.py +764 -0
  154. morphogen/io/solvers.py +371 -0
  155. morphogen/io/tables.py +278 -0
  156. morphogen/io/tiff.py +66 -0
  157. morphogen/io/vtk.py +701 -0
  158. morphogen/io/xdmf.py +200 -0
  159. morphogen/kernels/__init__.py +5 -0
  160. morphogen/kernels/annealing.py +192 -0
  161. morphogen/kernels/cells.py +69 -0
  162. morphogen/kernels/collective.py +87 -0
  163. morphogen/kernels/force_biased.py +595 -0
  164. morphogen/kernels/implicit.py +145 -0
  165. morphogen/kernels/leaves.py +132 -0
  166. morphogen/kernels/packing.py +304 -0
  167. morphogen/kernels/raster.py +279 -0
  168. morphogen/kernels/rsa.py +371 -0
  169. morphogen/kernels/union.py +135 -0
  170. morphogen/kernels/watershed.py +190 -0
  171. morphogen/laser/__init__.py +234 -0
  172. morphogen/laser/architectures.py +375 -0
  173. morphogen/laser/bending.py +216 -0
  174. morphogen/laser/cells.py +1694 -0
  175. morphogen/laser/design.py +940 -0
  176. morphogen/laser/figures.py +227 -0
  177. morphogen/laser/heat.py +804 -0
  178. morphogen/laser/materials.py +691 -0
  179. morphogen/laser/mechanics.py +1670 -0
  180. morphogen/laser/metallurgy.py +615 -0
  181. morphogen/laser/patterns.py +828 -0
  182. morphogen/laser/periodic.py +392 -0
  183. morphogen/laser/process.py +362 -0
  184. morphogen/laser/run.py +534 -0
  185. morphogen/laser/solid.py +216 -0
  186. morphogen/laser/specimen.py +200 -0
  187. morphogen/laser/structures.py +708 -0
  188. morphogen/learning/__init__.py +81 -0
  189. morphogen/learning/behaviour.py +398 -0
  190. morphogen/learning/data.py +328 -0
  191. morphogen/learning/learned.cpp +668 -0
  192. morphogen/learning/logarithmic.py +202 -0
  193. morphogen/learning/mfront.py +409 -0
  194. morphogen/learning/networks.py +767 -0
  195. morphogen/learning/run.py +212 -0
  196. morphogen/learning/standard.py +814 -0
  197. morphogen/learning/training.py +235 -0
  198. morphogen/mesh/__init__.py +29 -0
  199. morphogen/mesh/conforming.py +1423 -0
  200. morphogen/mesh/curved.py +600 -0
  201. morphogen/mesh/exact.py +1717 -0
  202. morphogen/mesh/octree.py +350 -0
  203. morphogen/mesh/polycrystal.py +1041 -0
  204. morphogen/mesh/polyhedra.py +677 -0
  205. morphogen/mesh/regularize.py +570 -0
  206. morphogen/mesh/surface.py +97 -0
  207. morphogen/mesh/tetra.py +512 -0
  208. morphogen/mesh/voxel.py +124 -0
  209. morphogen/micromorphic/__init__.py +31 -0
  210. morphogen/micromorphic/damage.py +359 -0
  211. morphogen/micromorphic/ductile.py +534 -0
  212. morphogen/micromorphic/finite.py +220 -0
  213. morphogen/micromorphic/microfoam.py +787 -0
  214. morphogen/micromorphic/space.py +341 -0
  215. morphogen/models/__init__.py +195 -0
  216. morphogen/models/affine.py +384 -0
  217. morphogen/models/automata.py +592 -0
  218. morphogen/models/base.py +500 -0
  219. morphogen/models/boolean.py +310 -0
  220. morphogen/models/bouligand.py +331 -0
  221. morphogen/models/branching.py +241 -0
  222. morphogen/models/combination.py +430 -0
  223. morphogen/models/deadleaves.py +766 -0
  224. morphogen/models/design.py +289 -0
  225. morphogen/models/ebsd.py +206 -0
  226. morphogen/models/fibers.py +1476 -0
  227. morphogen/models/foam.py +594 -0
  228. morphogen/models/gaussian.py +314 -0
  229. morphogen/models/growth.py +459 -0
  230. morphogen/models/hardcore.py +317 -0
  231. morphogen/models/hierarchical.py +269 -0
  232. morphogen/models/honeycomb.py +749 -0
  233. morphogen/models/implicit.py +177 -0
  234. morphogen/models/laminate.py +470 -0
  235. morphogen/models/lattice.py +351 -0
  236. morphogen/models/lattice_field.py +345 -0
  237. morphogen/models/levelset_foam.py +563 -0
  238. morphogen/models/nacre.py +411 -0
  239. morphogen/models/nested.py +924 -0
  240. morphogen/models/osteons.py +374 -0
  241. morphogen/models/pieces.py +167 -0
  242. morphogen/models/planar.py +126 -0
  243. morphogen/models/reconstruction.py +203 -0
  244. morphogen/models/scale_rich.py +1409 -0
  245. morphogen/models/scale_rich_3d.py +1616 -0
  246. morphogen/models/tessellation.py +735 -0
  247. morphogen/models/tiling_field.py +302 -0
  248. morphogen/models/tpms.py +197 -0
  249. morphogen/models/transparent.py +406 -0
  250. morphogen/models/union.py +141 -0
  251. morphogen/optimization/__init__.py +43 -0
  252. morphogen/optimization/cell.py +295 -0
  253. morphogen/optimization/filters.py +115 -0
  254. morphogen/optimization/mma.py +226 -0
  255. morphogen/optimization/run.py +219 -0
  256. morphogen/optimization/topology.py +632 -0
  257. morphogen/orientations.py +568 -0
  258. morphogen/parallel.py +599 -0
  259. morphogen/pipeline.py +978 -0
  260. morphogen/primitives.py +188 -0
  261. morphogen/results.py +564 -0
  262. morphogen/rve/__init__.py +73 -0
  263. morphogen/rve/report.py +627 -0
  264. morphogen/rve/scaling.py +363 -0
  265. morphogen/rve/study.py +1054 -0
  266. morphogen/rve/windows.py +345 -0
  267. morphogen/seeding.py +51 -0
  268. morphogen/settings.py +118 -0
  269. morphogen/stopping.py +48 -0
  270. morphogen/symmetry.py +384 -0
  271. morphogen/templates/activator_inhibitor.yaml +22 -0
  272. morphogen/templates/aggregation.yaml +23 -0
  273. morphogen/templates/boolean_cylinders.yaml +20 -0
  274. morphogen/templates/boolean_spheres.yaml +22 -0
  275. morphogen/templates/bouligand.yaml +28 -0
  276. morphogen/templates/cellular_automaton.yaml +25 -0
  277. morphogen/templates/coated_spheres.yaml +26 -0
  278. morphogen/templates/contact_fibers.yaml +27 -0
  279. morphogen/templates/cox_nanocomposite.yaml +22 -0
  280. morphogen/templates/cross_linked_fibers.yaml +26 -0
  281. morphogen/templates/curved_arcs.yaml +28 -0
  282. morphogen/templates/curved_fibers.yaml +24 -0
  283. morphogen/templates/dead_leaves.yaml +22 -0
  284. morphogen/templates/delaunay_network.yaml +22 -0
  285. morphogen/templates/dense_packing.yaml +22 -0
  286. morphogen/templates/diffusion.yaml +33 -0
  287. morphogen/templates/ebsd.yaml +34 -0
  288. morphogen/templates/ebsd_map.ctf +3087 -0
  289. morphogen/templates/fracture_composite.yaml +42 -0
  290. morphogen/templates/fracture_rubber.yaml +47 -0
  291. morphogen/templates/gaussian_excursion.yaml +17 -0
  292. morphogen/templates/graded_lattice.yaml +24 -0
  293. morphogen/templates/hardcore_fibers.yaml +22 -0
  294. morphogen/templates/hardcore_spheres.yaml +22 -0
  295. morphogen/templates/hierarchical_lattice.yaml +22 -0
  296. morphogen/templates/homogenization_acoustic_foam.yaml +36 -0
  297. morphogen/templates/homogenization_beremin.yaml +50 -0
  298. morphogen/templates/homogenization_cleavage.yaml +51 -0
  299. morphogen/templates/homogenization_cleavage_band.yaml +55 -0
  300. morphogen/templates/homogenization_contact.yaml +43 -0
  301. morphogen/templates/homogenization_crack_closure.yaml +49 -0
  302. morphogen/templates/homogenization_crystal_plasticity.yaml +50 -0
  303. morphogen/templates/homogenization_crystal_plasticity_fft.yaml +52 -0
  304. morphogen/templates/homogenization_crystallization.yaml +30 -0
  305. morphogen/templates/homogenization_debonding.yaml +43 -0
  306. morphogen/templates/homogenization_detwinning.yaml +58 -0
  307. morphogen/templates/homogenization_ductile_damage.yaml +47 -0
  308. morphogen/templates/homogenization_fatigue.yaml +40 -0
  309. morphogen/templates/homogenization_grain_fracture.yaml +56 -0
  310. morphogen/templates/homogenization_gyroid.yaml +30 -0
  311. morphogen/templates/homogenization_intergranular.yaml +43 -0
  312. morphogen/templates/homogenization_interphase.yaml +42 -0
  313. morphogen/templates/homogenization_mixed_loading.yaml +33 -0
  314. morphogen/templates/homogenization_ntfa.yaml +56 -0
  315. morphogen/templates/homogenization_piezoelectric.yaml +27 -0
  316. morphogen/templates/homogenization_polycrystal.yaml +30 -0
  317. morphogen/templates/homogenization_polycrystal_inclusions.yaml +30 -0
  318. morphogen/templates/homogenization_poroelastic.yaml +26 -0
  319. morphogen/templates/homogenization_rubber.yaml +40 -0
  320. morphogen/templates/homogenization_slip_cleavage.yaml +50 -0
  321. morphogen/templates/homogenization_spheres.yaml +31 -0
  322. morphogen/templates/homogenization_transport.yaml +29 -0
  323. morphogen/templates/homogenization_twinning.yaml +54 -0
  324. morphogen/templates/homogenization_viscoelastic.yaml +34 -0
  325. morphogen/templates/homogenization_viscoplastic.yaml +42 -0
  326. morphogen/templates/homogenization_voronoi.yaml +26 -0
  327. morphogen/templates/homogenization_xfem.yaml +23 -0
  328. morphogen/templates/hyperuniform_cells.yaml +24 -0
  329. morphogen/templates/laguerre.yaml +18 -0
  330. morphogen/templates/laser_bending.yaml +35 -0
  331. morphogen/templates/laser_cells.yaml +38 -0
  332. morphogen/templates/laser_corrugated.yaml +36 -0
  333. morphogen/templates/level_set_foam.yaml +29 -0
  334. morphogen/templates/menger_sponge.yaml +17 -0
  335. morphogen/templates/nacre.yaml +25 -0
  336. morphogen/templates/nucleation_growth.yaml +25 -0
  337. morphogen/templates/optimize_auxetic.yaml +29 -0
  338. morphogen/templates/optimize_auxetic_3d.yaml +27 -0
  339. morphogen/templates/optimize_bulk.yaml +23 -0
  340. morphogen/templates/optimize_conductivity.yaml +20 -0
  341. morphogen/templates/osteons.yaml +28 -0
  342. morphogen/templates/penetrable_spheres.yaml +21 -0
  343. morphogen/templates/poisson_fibers.yaml +21 -0
  344. morphogen/templates/random_laminate.yaml +26 -0
  345. morphogen/templates/random_lattice.yaml +27 -0
  346. morphogen/templates/random_walk_fibers.yaml +26 -0
  347. morphogen/templates/reaction_diffusion.yaml +22 -0
  348. morphogen/templates/reconstruction.yaml +22 -0
  349. morphogen/templates/rve_cellular_automaton.yaml +23 -0
  350. morphogen/templates/rve_crystal_plasticity_fft.yaml +51 -0
  351. morphogen/templates/rve_multiphysics.yaml +43 -0
  352. morphogen/templates/rve_poisson_fibers.yaml +22 -0
  353. morphogen/templates/rve_poisson_fibers_fe.yaml +33 -0
  354. morphogen/templates/rve_voronoi_windows.yaml +20 -0
  355. morphogen/templates/scale_rich_network.yaml +29 -0
  356. morphogen/templates/scale_rich_plates.yaml +30 -0
  357. morphogen/templates/sequential_dead_leaves.yaml +25 -0
  358. morphogen/templates/strut_lattice.yaml +21 -0
  359. morphogen/templates/tile_assembly.yaml +28 -0
  360. morphogen/templates/tpms.yaml +19 -0
  361. morphogen/templates/trabecular_bone.yaml +29 -0
  362. morphogen/templates/transparent_dead_leaves.yaml +23 -0
  363. morphogen/templates/vascular_tree.yaml +23 -0
  364. morphogen/templates/voronoi.yaml +20 -0
  365. morphogen/templates/wood.yaml +34 -0
  366. morphogen/templates/workflow.yaml +56 -0
  367. morphogen/texture.py +665 -0
  368. morphogen/theory.py +162 -0
  369. morphogen/viz/__init__.py +12 -0
  370. morphogen/viz/export.py +244 -0
  371. morphogen/viz/figures.py +707 -0
  372. morphogen/viz/png.py +148 -0
  373. morphogen/viz/sections.py +696 -0
  374. morphogen/viz/surfaces.py +1352 -0
  375. morphogen/viz/video.py +904 -0
  376. morphogen/viz/workflow.py +488 -0
  377. morphogen-1.0.0.dist-info/METADATA +2316 -0
  378. morphogen-1.0.0.dist-info/RECORD +381 -0
  379. morphogen-1.0.0.dist-info/WHEEL +4 -0
  380. morphogen-1.0.0.dist-info/entry_points.txt +5 -0
  381. 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}