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,484 @@
1
+ """Diffusion and swelling of tetrahedral meshes with FEniCSx (dolfinx): moisture or a
2
+ solvent enters a sample through its exposed faces, and the sample swells and bends as
3
+ it does (Mou, Dirrenberger & Le Duigou 2025 model pine cone scales and 4D-printed
4
+ hygromorphs this way with FEniCS).
5
+
6
+ The activity ``u`` of the species is continuous across interfaces, each phase holds
7
+ ``c = S u`` and lets it through with the permeability ``D S`` (as in
8
+ :mod:`morphogen.coupling.diffusion`): ``S du/dt = div(D S grad u)``, Lagrange elements of
9
+ the order of the mesh, the exposed faces held at the activity (a number or a function of
10
+ time), the other faces impermeable, implicit Euler steps. At each output time the
11
+ sample, free of tractions, deforms elastically under the swelling strains ``beta c I``
12
+ (small strains; isotropic phases), held only by 3-2-1 supports at three corners: its
13
+ displacement field, and the curvature of a strip fitted to the deflection of its
14
+ mid-plane (:func:`strip_curvature`). FEniCSx runs on Linux (or WSL).
15
+ """
16
+
17
+ from __future__ import annotations
18
+
19
+ import dataclasses
20
+ from collections.abc import Callable
21
+
22
+ import numpy as np
23
+ from scipy.spatial import cKDTree
24
+
25
+ from morphogen.homogenization.fenicsx import _modules
26
+ from morphogen.mesh.tetra import TetMesh
27
+
28
+ FACES = ("x-", "x+", "y-", "y+", "z-", "z+")
29
+
30
+
31
+ @dataclasses.dataclass
32
+ class SwellingResult:
33
+ """At the output ``times``: the mean concentration over the meshed volume
34
+ (``uptake``; ``saturation`` at the activity of the last time), the concentration of
35
+ the nodes (that of the phase of an element around each node, ``S u``) and their
36
+ displacement (morphoGen's order of the nodes)."""
37
+
38
+ times: np.ndarray
39
+ uptake: np.ndarray
40
+ saturation: float
41
+ concentration: list
42
+ displacement: list
43
+ mesh: TetMesh = dataclasses.field(repr=False)
44
+
45
+ @property
46
+ def relative_uptake(self) -> np.ndarray:
47
+ return self.uptake / self.saturation
48
+
49
+
50
+ def _dolfinx_mesh(mesh: TetMesh):
51
+ basix, dolfinx, _, ufl, MPI, _ = _modules()
52
+ corners = mesh.elements[:, :4]
53
+ used = np.unique(corners)
54
+ index = np.full(mesh.n_nodes, -1, dtype=np.int64)
55
+ index[used] = np.arange(len(used))
56
+ coord = basix.ufl.element("Lagrange", "tetrahedron", 1, shape=(3,))
57
+ msh = dolfinx.mesh.create_mesh(MPI.COMM_SELF, index[corners], ufl.Mesh(coord), mesh.nodes[used])
58
+ original = msh.topology.original_cell_index
59
+ if isinstance(original, list):
60
+ original = original[0]
61
+ return msh, np.asarray(original)
62
+
63
+
64
+ def _node_map(space, mesh: TetMesh) -> np.ndarray:
65
+ dist, block = cKDTree(space.tabulate_dof_coordinates()).query(mesh.nodes)
66
+ if dist.max() > 1e-9 * float(np.max(mesh.upper - mesh.lower)):
67
+ raise ValueError("the nodes of the mesh are not those of dolfinx's elements")
68
+ return block
69
+
70
+
71
+ def _cellwise(dolfinx, msh, values):
72
+ space = dolfinx.fem.functionspace(msh, ("DG", 0))
73
+ f = dolfinx.fem.Function(space)
74
+ f.x.array[space.dofmap.list[:, 0]] = values
75
+ return f
76
+
77
+
78
+ def swelling(
79
+ mesh: TetMesh,
80
+ phases: dict,
81
+ times,
82
+ *,
83
+ exposed=("z-",),
84
+ activity: float | Callable[[float], float] = 1.0,
85
+ initial: float = 0.0,
86
+ steps: int = 20,
87
+ kinematics: str = "small",
88
+ ) -> SwellingResult:
89
+ """Diffusion into ``mesh`` from its ``exposed`` faces and the free swelling of the
90
+ sample at the output ``times``. ``phases``: phase -> mapping with ``diffusivity``,
91
+ ``solubility`` (default 1), ``swelling`` (the strain per unit concentration,
92
+ default 0), ``young`` and ``poisson``. Each output interval takes ``steps`` implicit
93
+ Euler steps (the first one geometrically growing, for the sqrt(t) start).
94
+ ``kinematics``: ``"small"`` (linear elasticity under the swelling strains) or
95
+ ``"finite"`` (large rotations and strains: ``F = F_e F_s`` with the swelling stretch
96
+ ``F_s = (1 + beta c) I``, Saint Venant-Kirchhoff's law of ``F_e`` per unit volume of
97
+ the swollen state, so that ``P = (1 + beta c) F S_e``; Newton's method, each output
98
+ reached by continuation of the concentration field, halved when it fails)."""
99
+ if kinematics not in ("small", "finite"):
100
+ raise ValueError('kinematics: "small" or "finite"')
101
+ _, dolfinx, _, ufl, _, PETSc = _modules()
102
+
103
+ for face in exposed:
104
+ if face not in FACES:
105
+ raise ValueError(f"exposed: faces among {', '.join(FACES)}")
106
+ msh, original = _dolfinx_mesh(mesh)
107
+ phase = np.asarray(mesh.phase)[original]
108
+ missing = sorted(set(np.unique(phase).tolist()) - set(phases))
109
+ if missing:
110
+ raise ValueError(f"phases: no properties for {missing}")
111
+
112
+ def prop(name, default=None):
113
+ out = []
114
+ for p in phase:
115
+ v = phases[int(p)].get(name, default)
116
+ if v is None:
117
+ raise ValueError(f"phases: give '{name}' for phase {int(p)}")
118
+ out.append(float(v))
119
+ return _cellwise(dolfinx, msh, np.array(out))
120
+
121
+ sol = prop("solubility", 1.0)
122
+ perm = _cellwise(
123
+ dolfinx, msh, np.asarray(prop("diffusivity").x.array) * np.asarray(sol.x.array)
124
+ )
125
+ beta = prop("swelling", 0.0)
126
+ young, poisson = prop("young"), prop("poisson")
127
+ lam = young * poisson / ((1 + poisson) * (1 - 2 * poisson))
128
+ mu = young / (2 * (1 + poisson))
129
+ order = mesh.order
130
+ v_space = dolfinx.fem.functionspace(msh, ("Lagrange", order))
131
+ w_space = dolfinx.fem.functionspace(msh, ("Lagrange", order, (3,)))
132
+ node_s = _node_map(v_space, mesh)
133
+ node_w = _node_map(w_space, mesh)
134
+ # the exposed faces
135
+ lo, hi, tol = mesh.lower, mesh.upper, mesh.tolerance()
136
+
137
+ def on_faces(x):
138
+ out = np.zeros(x.shape[1], dtype=bool)
139
+ for face in exposed:
140
+ axis, side = "xyz".index(face[0]), face[1]
141
+ out |= np.abs(x[axis] - (lo[axis] if side == "-" else hi[axis])) <= tol
142
+ return out
143
+
144
+ facets = dolfinx.mesh.locate_entities_boundary(msh, 2, on_faces)
145
+ exposed_dofs = dolfinx.fem.locate_dofs_topological(v_space, 2, facets)
146
+ level = dolfinx.fem.Constant(msh, 0.0)
147
+ bc = dolfinx.fem.dirichletbc(level, exposed_dofs, v_space)
148
+ # diffusion: (S/dt) u + div(-D S grad u) = (S/dt) u_n
149
+ u, v = ufl.TrialFunction(v_space), ufl.TestFunction(v_space)
150
+ u_n = dolfinx.fem.Function(v_space)
151
+ u_n.x.array[:] = initial
152
+ inv_dt = dolfinx.fem.Constant(msh, 1.0)
153
+ a_d = dolfinx.fem.form(
154
+ (inv_dt * sol * u * v + perm * ufl.inner(ufl.grad(u), ufl.grad(v))) * ufl.dx
155
+ )
156
+ l_d = dolfinx.fem.form(inv_dt * sol * u_n * v * ufl.dx)
157
+ u_h = dolfinx.fem.Function(v_space)
158
+ # mechanics: free swelling, 3-2-1 supports
159
+ d, e = ufl.TrialFunction(w_space), ufl.TestFunction(w_space)
160
+
161
+ def eps(z):
162
+ return ufl.sym(ufl.grad(z))
163
+
164
+ def sigma(z):
165
+ return 2.0 * mu * eps(z) + lam * ufl.tr(eps(z)) * ufl.Identity(3)
166
+
167
+ a_m = dolfinx.fem.form(ufl.inner(sigma(d), eps(e)) * ufl.dx)
168
+ l_m = dolfinx.fem.form((3.0 * lam + 2.0 * mu) * beta * sol * u_h * ufl.div(e) * ufl.dx)
169
+ tree = cKDTree(mesh.nodes)
170
+ corners = [lo, np.array([hi[0], lo[1], lo[2]]), np.array([lo[0], hi[1], lo[2]])]
171
+ supports = [int(tree.query(c)[1]) for c in corners]
172
+ held = {0: [supports[0]], 1: [supports[0], supports[1]], 2: supports}
173
+ bcs_m = []
174
+ for c in range(3):
175
+ sub, parent = w_space.sub(c).collapse()
176
+ inverse = np.full(3 * len(node_w), -1, dtype=np.int64)
177
+ inverse[np.asarray(parent)] = np.arange(len(parent))
178
+ dofs = np.array(sorted({3 * int(node_w[n]) + c for n in held[c]}), dtype=np.int32)
179
+ bcs_m.append(
180
+ dolfinx.fem.dirichletbc(
181
+ dolfinx.fem.Function(sub), [dofs, inverse[dofs].astype(np.int32)], w_space.sub(c)
182
+ )
183
+ )
184
+ a_mech = dolfinx.fem.petsc.assemble_matrix(a_m, bcs=bcs_m)
185
+ a_mech.assemble()
186
+ ksp_m = PETSc.KSP().create(msh.comm)
187
+ ksp_m.setOperators(a_mech)
188
+ ksp_m.setType("preonly")
189
+ ksp_m.getPC().setType("lu")
190
+ ksp_m.getPC().setFactorSolverType("mumps")
191
+ disp = dolfinx.fem.Function(w_space)
192
+ if kinematics == "finite":
193
+ u_load = dolfinx.fem.Function(v_space) # the activity along the continuation
194
+ identity = ufl.Identity(3)
195
+ def_grad = identity + ufl.grad(disp)
196
+ stretch = 1.0 + beta * sol * u_load
197
+ fe = def_grad / stretch
198
+ ee = 0.5 * (fe.T * fe - identity)
199
+ se = lam * ufl.tr(ee) * identity + 2.0 * mu * ee
200
+ residual = ufl.inner(stretch * def_grad * se, ufl.grad(e)) * ufl.dx
201
+ newton = dolfinx.fem.petsc.NonlinearProblem(
202
+ residual,
203
+ disp,
204
+ petsc_options_prefix="morphogen_swelling_",
205
+ bcs=bcs_m,
206
+ petsc_options={
207
+ "snes_type": "newtonls",
208
+ "snes_linesearch_type": "bt",
209
+ "snes_rtol": 1e-10,
210
+ "snes_atol": 1e-12,
211
+ "snes_max_it": 15,
212
+ "ksp_type": "preonly",
213
+ "pc_type": "lu",
214
+ "pc_factor_mat_solver_type": "mumps",
215
+ },
216
+ )
217
+ u_prev = np.full(u_h.x.array.shape, float(initial))
218
+
219
+ def finite_solve():
220
+ target = np.asarray(u_h.x.array).copy()
221
+ done, step = 0.0, 0.25
222
+ saved = disp.x.array.copy()
223
+ while done < 1.0 - 1e-12:
224
+ s = min(1.0, done + step)
225
+ u_load.x.array[:] = u_prev + s * (target - u_prev)
226
+ newton.solve()
227
+ if newton.solver.getConvergedReason() > 0:
228
+ done, saved = s, disp.x.array.copy()
229
+ step = min(1.5 * step, 1.0 - done) if done < 1.0 else step
230
+ else:
231
+ disp.x.array[:] = saved
232
+ step *= 0.5
233
+ if step < 1e-4:
234
+ raise RuntimeError("swelling: Newton's method failed in finite strains")
235
+ u_prev[:] = target
236
+
237
+ value = activity if callable(activity) else (lambda t, a=float(activity): a)
238
+ volume = float(np.abs(mesh.volumes()).sum())
239
+ solvers: dict[float, object] = {}
240
+
241
+ def diffusion_step(dt, t):
242
+ key = float(dt)
243
+ if key not in solvers:
244
+ inv_dt.value = 1.0 / dt
245
+ mat = dolfinx.fem.petsc.assemble_matrix(a_d, bcs=[bc])
246
+ mat.assemble()
247
+ ksp = PETSc.KSP().create(msh.comm)
248
+ ksp.setOperators(mat)
249
+ ksp.setType("preonly")
250
+ ksp.getPC().setType("lu")
251
+ ksp.getPC().setFactorSolverType("mumps")
252
+ solvers.clear()
253
+ solvers[key] = ksp
254
+ inv_dt.value = 1.0 / dt
255
+ level.value = value(t)
256
+ b = dolfinx.fem.petsc.assemble_vector(l_d)
257
+ dolfinx.fem.petsc.apply_lifting(b, [a_d], bcs=[[bc]])
258
+ b.ghostUpdate(addv=PETSc.InsertMode.ADD, mode=PETSc.ScatterMode.REVERSE)
259
+ dolfinx.fem.petsc.set_bc(b, [bc])
260
+ solvers[key].solve(b, u_h.x.petsc_vec)
261
+ u_h.x.scatter_forward()
262
+ u_n.x.array[:] = u_h.x.array
263
+ b.destroy()
264
+
265
+ times = np.asarray(times, dtype=float)
266
+ if np.any(np.diff(times) <= 0) or times[0] <= 0:
267
+ raise ValueError("times: positive and increasing")
268
+ uptake, conc, displacement = [], [], []
269
+ mean_c = dolfinx.fem.form(sol * u_h * ufl.dx)
270
+ # the solubility of an element around each node, for the nodal concentrations
271
+ element_sol = np.array([float(phases[int(p)].get("solubility", 1.0)) for p in mesh.phase])
272
+ node_sol = np.zeros(mesh.n_nodes)
273
+ node_sol[mesh.elements.ravel()] = np.repeat(element_sol, mesh.elements.shape[1])
274
+ t = 0.0
275
+ u_h.x.array[:] = initial
276
+ for t_out in times:
277
+ span = t_out - t
278
+ if t == 0.0:
279
+ r = 1.25
280
+ first = span * (r - 1.0) / (r**steps - 1.0)
281
+ dts = first * r ** np.arange(steps)
282
+ else:
283
+ dts = np.full(steps, span / steps)
284
+ for dt in dts:
285
+ t += dt
286
+ diffusion_step(dt, t)
287
+ t = float(t_out)
288
+ uptake.append(float(dolfinx.fem.assemble_scalar(mean_c)) / volume)
289
+ conc.append(node_sol * np.asarray(u_h.x.array)[node_s])
290
+ if kinematics == "finite":
291
+ finite_solve()
292
+ else:
293
+ b = dolfinx.fem.petsc.assemble_vector(l_m)
294
+ dolfinx.fem.petsc.apply_lifting(b, [a_m], bcs=[bcs_m])
295
+ b.ghostUpdate(addv=PETSc.InsertMode.ADD, mode=PETSc.ScatterMode.REVERSE)
296
+ dolfinx.fem.petsc.set_bc(b, bcs_m)
297
+ ksp_m.solve(b, disp.x.petsc_vec)
298
+ disp.x.scatter_forward()
299
+ b.destroy()
300
+ displacement.append(np.asarray(disp.x.array).reshape(-1, 3)[node_w].copy())
301
+ s_mean = float(dolfinx.fem.assemble_scalar(dolfinx.fem.form(sol * ufl.dx))) / volume
302
+ return SwellingResult(
303
+ times, np.asarray(uptake), s_mean * float(value(times[-1])), conc, displacement, mesh
304
+ )
305
+
306
+
307
+ def strip_curvature(mesh: TetMesh, displacement, *, axis: int = 0, normal: int = 2) -> float:
308
+ """Curvature of a strip along ``axis`` bending in the plane of ``normal``: minus the
309
+ second derivative of the deflection of the nodes of its mid-plane (least squares,
310
+ ``w = -k x^2 / 2 + a x + b + c y``), so that it is positive when the strip bends
311
+ towards its lower face (``-normal``), as :func:`~morphogen.coupling.timoshenko_curvature`
312
+ and :class:`~morphogen.coupling.Multilayer`."""
313
+ d = np.asarray(displacement)
314
+ mid = 0.5 * (mesh.lower[normal] + mesh.upper[normal])
315
+ z = mesh.nodes[:, normal]
316
+ close = (
317
+ np.abs(z - mid)
318
+ <= 0.5 * np.min(np.abs(np.unique(z) - mid)[np.unique(z) != mid], initial=np.inf)
319
+ + mesh.tolerance()
320
+ )
321
+ if not close.any():
322
+ close = np.abs(z - mid) == np.abs(z - mid).min()
323
+ x = mesh.nodes[close, axis]
324
+ other = 3 - axis - normal
325
+ y = mesh.nodes[close, other]
326
+ w = d[close, normal]
327
+ basis = np.column_stack([0.5 * x**2, x, np.ones_like(x), y])
328
+ coef, *_ = np.linalg.lstsq(basis, w, rcond=None)
329
+ return -float(coef[0])
330
+
331
+
332
+ def arc_curvature(mesh: TetMesh, displacement, *, axis: int = 0, normal: int = 2) -> float:
333
+ """Curvature of a strip that bends into an arc (large rotations): the circle fitted
334
+ (least squares, Kasa) to the deformed nodes of its mid-plane in the plane of ``axis``
335
+ and ``normal``; positive when the strip bends towards its lower face."""
336
+ d = np.asarray(displacement)
337
+ mid = 0.5 * (mesh.lower[normal] + mesh.upper[normal])
338
+ z0 = mesh.nodes[:, normal]
339
+ close = np.abs(z0 - mid) == np.abs(z0 - mid).min()
340
+ x = mesh.nodes[close, axis] + d[close, axis]
341
+ z = z0[close] + d[close, normal]
342
+ basis = np.column_stack([x, z, np.ones_like(x)])
343
+ coef, *_ = np.linalg.lstsq(basis, -(x * x + z * z), rcond=None)
344
+ cx, cz = -0.5 * coef[0], -0.5 * coef[1]
345
+ radius = float(np.sqrt(cx * cx + cz * cz - coef[2]))
346
+ return (1.0 if cz < z.mean() else -1.0) / radius
347
+
348
+
349
+ @dataclasses.dataclass
350
+ class OxidationResult:
351
+ """At the ``times``: the oxidation tracer (amide concentration, mol/l) of each element,
352
+ their stresses (Voigt order 11 22 33 23 31 12) and the displacement of the nodes."""
353
+
354
+ times: np.ndarray
355
+ tracer: list
356
+ stress: list
357
+ displacement: list
358
+ mesh: TetMesh = dataclasses.field(repr=False)
359
+
360
+
361
+ def oxidation_stresses(
362
+ mesh: TetMesh,
363
+ law,
364
+ times,
365
+ *,
366
+ oxidation=None,
367
+ exposed=("z-", "z+"),
368
+ poisson: float = 0.37,
369
+ nodes: int = 81,
370
+ ) -> OxidationResult:
371
+ """Stresses of a sample oxidized through its ``exposed`` faces (Ernault et al. 2019):
372
+ the amide profile of the diffusion-limited oxidation
373
+ (:class:`~morphogen.coupling.ClosedLoopOxidation`, default: their DGEBA/IPDA at 110
374
+ °C) at the depth of each element below the nearest exposed face, Young's modulus and
375
+ the shrinkage (``expansion``, a strain) of ``law``
376
+ (:class:`~morphogen.coupling.PropertyLaw` of the amide concentration), and the
377
+ linear elastic response of the free sample (3-2-1 supports) to these eigenstrains
378
+ (Poisson's ratio ``poisson``, 0.37 as theirs)."""
379
+ from morphogen.coupling.oxidation import ClosedLoopOxidation
380
+
381
+ _, dolfinx, _, ufl, _, PETSc = _modules()
382
+ oxidation = oxidation or ClosedLoopOxidation()
383
+ for face in exposed:
384
+ if face not in FACES:
385
+ raise ValueError(f"exposed: faces among {', '.join(FACES)}")
386
+ times = np.asarray(times, dtype=float)
387
+ centroids = mesh.nodes[mesh.elements[:, :4]].mean(axis=1)
388
+ depth = np.full(len(centroids), np.inf)
389
+ for face in exposed:
390
+ axis = "xyz".index(face[0])
391
+ plane = mesh.lower[axis] if face[1] == "-" else mesh.upper[axis]
392
+ depth = np.minimum(depth, np.abs(centroids[:, axis] - plane))
393
+ profile = oxidation.profile(2.0 * float(depth.max()) * 1.02, times, nodes=nodes)
394
+ surface = oxidation.thin_film(times)["PO"]
395
+ msh, original = _dolfinx_mesh(mesh)
396
+ w_space = dolfinx.fem.functionspace(msh, ("Lagrange", mesh.order, (3,)))
397
+ node_w = _node_map(w_space, mesh)
398
+ young = _cellwise(dolfinx, msh, np.ones(len(original)))
399
+ shrink = _cellwise(dolfinx, msh, np.zeros(len(original)))
400
+ lam = young * poisson / ((1.0 + poisson) * (1.0 - 2.0 * poisson))
401
+ mu = young / (2.0 * (1.0 + poisson))
402
+ d, e = ufl.TrialFunction(w_space), ufl.TestFunction(w_space)
403
+
404
+ def eps(z):
405
+ return ufl.sym(ufl.grad(z))
406
+
407
+ identity = ufl.Identity(3)
408
+ a_form = dolfinx.fem.form(
409
+ ufl.inner(2.0 * mu * eps(d) + lam * ufl.tr(eps(d)) * identity, eps(e)) * ufl.dx
410
+ )
411
+ l_form = dolfinx.fem.form((3.0 * lam + 2.0 * mu) * shrink * ufl.div(e) * ufl.dx)
412
+ tree = cKDTree(mesh.nodes)
413
+ lo, hi = mesh.lower, mesh.upper
414
+ corners = [lo, np.array([hi[0], lo[1], lo[2]]), np.array([lo[0], hi[1], lo[2]])]
415
+ supports = [int(tree.query(c)[1]) for c in corners]
416
+ held = {0: [supports[0]], 1: [supports[0], supports[1]], 2: supports}
417
+ bcs = []
418
+ for c in range(3):
419
+ sub, parent = w_space.sub(c).collapse()
420
+ inverse = np.full(3 * len(node_w), -1, dtype=np.int64)
421
+ inverse[np.asarray(parent)] = np.arange(len(parent))
422
+ dofs = np.array(sorted({3 * int(node_w[n]) + c for n in held[c]}), dtype=np.int32)
423
+ bcs.append(
424
+ dolfinx.fem.dirichletbc(
425
+ dolfinx.fem.Function(sub), [dofs, inverse[dofs].astype(np.int32)], w_space.sub(c)
426
+ )
427
+ )
428
+ disp = dolfinx.fem.Function(w_space)
429
+ strain = eps(disp)
430
+ sigma = (
431
+ 2.0 * mu * (strain - shrink * identity)
432
+ + lam * ufl.tr(strain - shrink * identity) * identity
433
+ )
434
+ t_space = dolfinx.fem.functionspace(msh, ("DG", 0, (3, 3)))
435
+ points = t_space.element.interpolation_points
436
+ points = points() if callable(points) else points
437
+ sigma_expr = dolfinx.fem.Expression(sigma, points)
438
+ stress_fn = dolfinx.fem.Function(t_space)
439
+ cells = t_space.dofmap.list[:, 0]
440
+ order = np.empty(len(original), dtype=np.int64)
441
+ order[original] = np.arange(len(original)) # morphoGen element -> dolfinx cell
442
+ depths = np.concatenate([[0.0], profile["depth"]])
443
+ tracers, stresses, displacements = [], [], []
444
+ for k in range(len(times)):
445
+ amide = np.concatenate([[surface[k]], profile["PO"][k]])
446
+ tracer = np.interp(depth, depths, amide)
447
+ props = law(tracer)
448
+ young.x.array[young.function_space.dofmap.list[:, 0]] = props["young"][original]
449
+ shrink.x.array[shrink.function_space.dofmap.list[:, 0]] = props.get(
450
+ "expansion", np.zeros_like(tracer)
451
+ )[original]
452
+ mat = dolfinx.fem.petsc.assemble_matrix(a_form, bcs=bcs)
453
+ mat.assemble()
454
+ ksp = PETSc.KSP().create(msh.comm)
455
+ ksp.setOperators(mat)
456
+ ksp.setType("preonly")
457
+ ksp.getPC().setType("lu")
458
+ ksp.getPC().setFactorSolverType("mumps")
459
+ b = dolfinx.fem.petsc.assemble_vector(l_form)
460
+ dolfinx.fem.petsc.apply_lifting(b, [a_form], bcs=[bcs])
461
+ b.ghostUpdate(addv=PETSc.InsertMode.ADD, mode=PETSc.ScatterMode.REVERSE)
462
+ dolfinx.fem.petsc.set_bc(b, bcs)
463
+ ksp.solve(b, disp.x.petsc_vec)
464
+ disp.x.scatter_forward()
465
+ stress_fn.interpolate(sigma_expr)
466
+ tensors = np.asarray(stress_fn.x.array).reshape(-1, 9)[cells][order].reshape(-1, 3, 3)
467
+ voigt = np.stack(
468
+ [
469
+ tensors[:, 0, 0],
470
+ tensors[:, 1, 1],
471
+ tensors[:, 2, 2],
472
+ tensors[:, 1, 2],
473
+ tensors[:, 2, 0],
474
+ tensors[:, 0, 1],
475
+ ],
476
+ axis=1,
477
+ )
478
+ tracers.append(tracer)
479
+ stresses.append(voigt)
480
+ displacements.append(np.asarray(disp.x.array).reshape(-1, 3)[node_w].copy())
481
+ b.destroy()
482
+ ksp.destroy()
483
+ mat.destroy()
484
+ return OxidationResult(times, tracers, stresses, displacements, mesh)