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,341 @@
1
+ """The mixed finite elements of micromorphic media and their Newton solver.
2
+
3
+ The displacement ``u`` is interpolated on the ten nodes of quadratic tetrahedra and the
4
+ ``n_g`` generalized degrees of freedom (the components of the microdeformation, a scalar
5
+ micromorphic variable...) on their four corners: one order lower, so that the relative
6
+ deformation ``∇u - χ`` can vanish (a penalty on it with equal orders locks). The degrees
7
+ of freedom are numbered node by node (three components of ``u``, then ``n_g`` on a
8
+ corner); the sparse pattern of the matrix follows from the node graph of the mesh, and
9
+ the element matrices, computed by chunks of elements in parallel, are added into it in
10
+ place (one pass, no list of triplets: an element of the full micromorphic medium has 66
11
+ degrees of freedom, 4356 entries).
12
+
13
+ Elements are integrated at the four points of the degree-two rule of the tetrahedron
14
+ (exact for the products of the gradients of quadratic functions and of linear
15
+ functions), where the behaviours keep their internal variables.
16
+
17
+ The solver (:meth:`MixedProblem.run`) grows prescribed degrees of freedom with a load
18
+ factor; Newton's method with a line search, the steps divided when it fails.
19
+ """
20
+
21
+ from __future__ import annotations
22
+
23
+ import time
24
+ from dataclasses import dataclass, field
25
+
26
+ import numpy as np
27
+ import scipy.sparse as sp
28
+ import scipy.sparse.linalg as spla
29
+ from numba import njit
30
+
31
+ from morphogen.homogenization.fe import GAUSS, node_pattern
32
+ from morphogen.mesh.tetra import TET_EDGES, TetMesh
33
+
34
+ #: Gauss points (barycentric coordinates) and weights of the elements
35
+ POINTS, WEIGHTS = GAUSS[2]
36
+ #: Elements whose matrices are computed together (memory: 8 x 66² bytes each)
37
+ CHUNK = 2048
38
+
39
+
40
+ @njit(cache=True)
41
+ def _dof_pattern(ptr, idx, nd, offset):
42
+ """The CSR pattern of the degrees of freedom from the node graph (``ptr``, ``idx``):
43
+ the position of each neighbour's block in the rows of a node, the start and length
44
+ of the rows of each node, the row pointers and the column indices."""
45
+ n = len(nd)
46
+ cum = np.empty(len(idx), dtype=np.int64)
47
+ length = np.empty(n, dtype=np.int64)
48
+ for v in range(n):
49
+ c = 0
50
+ for q in range(ptr[v], ptr[v + 1]):
51
+ cum[q] = c
52
+ c += nd[idx[q]]
53
+ length[v] = c
54
+ base = np.empty(n + 1, dtype=np.int64)
55
+ base[0] = 0
56
+ for v in range(n):
57
+ base[v + 1] = base[v] + nd[v] * length[v]
58
+ n_dofs = offset[n]
59
+ indptr = np.empty(n_dofs + 1, dtype=np.int64)
60
+ indices = np.empty(base[n], dtype=np.int64)
61
+ for v in range(n):
62
+ for i in range(nd[v]):
63
+ start = base[v] + i * length[v]
64
+ indptr[offset[v] + i] = start
65
+ pos = start
66
+ for q in range(ptr[v], ptr[v + 1]):
67
+ w = idx[q]
68
+ for j in range(nd[w]):
69
+ indices[pos] = offset[w] + j
70
+ pos += 1
71
+ indptr[n_dofs] = base[n]
72
+ return cum, base, length, indptr, indices
73
+
74
+
75
+ @njit(cache=True)
76
+ def _scatter(elements, first, ke, fe, lnode, comp, offset, base, length, ptr, idx, cum, data, rhs):
77
+ """Add element vectors (and matrices, if ``data`` is not empty) of the elements
78
+ ``first, first + 1...`` into the global vector (matrix data)."""
79
+ n_loc = len(lnode)
80
+ qpos = np.empty((10, 10), dtype=np.int64)
81
+ with_matrix = len(data) > 0
82
+ for e in range(fe.shape[0]):
83
+ el = elements[first + e]
84
+ if with_matrix:
85
+ for a in range(10):
86
+ v = el[a]
87
+ for c in range(10):
88
+ w = el[c]
89
+ lo = ptr[v]
90
+ hi = ptr[v + 1] - 1
91
+ while lo < hi:
92
+ mid = (lo + hi) // 2
93
+ if idx[mid] < w:
94
+ lo = mid + 1
95
+ else:
96
+ hi = mid
97
+ qpos[a, c] = lo
98
+ for al in range(n_loc):
99
+ a = lnode[al]
100
+ v = el[a]
101
+ rhs[offset[v] + comp[al]] += fe[e, al]
102
+ if with_matrix:
103
+ row = base[v] + comp[al] * length[v]
104
+ for be in range(n_loc):
105
+ data[row + cum[qpos[a, lnode[be]]] + comp[be]] += ke[e, al, be]
106
+
107
+
108
+ class MixedSpace:
109
+ """The degrees of freedom of a mesh (made quadratic if it is linear, with straight
110
+ edges): three displacements per node, ``n_g`` generalized ones per corner node (see
111
+ the module)."""
112
+
113
+ def __init__(self, mesh: TetMesh, n_g: int):
114
+ mesh = mesh.quadratic().straight()
115
+ self.mesh = mesh
116
+ self.n_g = int(n_g)
117
+ n = mesh.n_nodes
118
+ self.corner = np.zeros(n, dtype=bool)
119
+ self.corner[np.unique(mesh.elements[:, :4])] = True
120
+ self.nd = 3 + self.n_g * self.corner.astype(np.int64)
121
+ self.offset = np.concatenate([[0], np.cumsum(self.nd)]).astype(np.int64)
122
+ self.n_dofs = int(self.offset[-1])
123
+ self._ptr, self._idx = node_pattern(mesh.elements, n)
124
+ self._cum, self._base, self._length, indptr, indices = _dof_pattern(
125
+ self._ptr, self._idx, self.nd, self.offset
126
+ )
127
+ small = indptr[-1] < 2**31 - 1
128
+ self._indptr = indptr.astype(np.int32) if small else indptr
129
+ self._indices = indices.astype(np.int32) if small else indices
130
+ n_loc = 30 + 4 * self.n_g
131
+ self.lnode = np.array(
132
+ [a // 3 if a < 30 else (a - 30) // max(self.n_g, 1) for a in range(n_loc)]
133
+ )
134
+ self.comp = np.array(
135
+ [a % 3 if a < 30 else 3 + (a - 30) % max(self.n_g, 1) for a in range(n_loc)]
136
+ )
137
+ self.elements = np.ascontiguousarray(mesh.elements, dtype=np.int64)
138
+
139
+ @property
140
+ def n_local(self) -> int:
141
+ return 30 + 4 * self.n_g
142
+
143
+ def dofs(self, nodes, components) -> np.ndarray:
144
+ """The degrees of freedom (nodes x components) of components (0-2: ``u``, 3...:
145
+ the generalized ones, on corner nodes only) of nodes."""
146
+ nodes = np.atleast_1d(np.asarray(nodes, dtype=np.int64))
147
+ comps = np.atleast_1d(np.asarray(components, dtype=np.int64))
148
+ if np.any(comps >= self.nd[nodes][:, None]):
149
+ raise ValueError("a generalized degree of freedom on a node that is not a corner")
150
+ return self.offset[nodes][:, None] + comps[None, :]
151
+
152
+ def new_matrix_data(self) -> np.ndarray:
153
+ return np.zeros(len(self._indices))
154
+
155
+ def matrix(self, data) -> sp.csr_matrix:
156
+ return sp.csr_matrix((data, self._indices, self._indptr), shape=(self.n_dofs, self.n_dofs))
157
+
158
+ def add(self, first, ke, fe, data, rhs) -> None:
159
+ """Add the matrices ``ke`` and vectors ``fe`` of the elements ``first...``."""
160
+ _scatter(self.elements, first, ke, fe, self.lnode, self.comp, self.offset, self._base,
161
+ self._length, self._ptr, self._idx, self._cum, data, rhs) # fmt: skip
162
+
163
+ def displacement(self, values) -> np.ndarray:
164
+ """The displacement (nodes x 3) of a vector of degrees of freedom."""
165
+ return np.asarray(values)[self.offset[:-1, None] + np.arange(3)]
166
+
167
+ def generalized(self, values) -> np.ndarray:
168
+ """The generalized degrees of freedom at every node (nodes x n_g): those of the
169
+ corners, interpolated linearly at the mid-edge nodes."""
170
+ values = np.asarray(values)
171
+ out = np.full((self.mesh.n_nodes, self.n_g), np.nan)
172
+ corners = np.flatnonzero(self.corner)
173
+ out[corners] = values[self.offset[corners][:, None] + 3 + np.arange(self.n_g)]
174
+ el = self.elements
175
+ for k, (i, j) in enumerate(TET_EDGES):
176
+ out[el[:, 4 + k]] = 0.5 * (out[el[:, i]] + out[el[:, j]])
177
+ return out
178
+
179
+
180
+ @dataclass
181
+ class PathResult:
182
+ """The steps of a problem: load factors, reactions (steps x prescribed sets x
183
+ components of each set, summed over its nodes), Newton iterations, the final degrees
184
+ of freedom and internal variables and, with ``fields``, the degrees of freedom and the
185
+ internal variables of the steps."""
186
+
187
+ loads: np.ndarray
188
+ reactions: list
189
+ iterations: np.ndarray
190
+ values: np.ndarray
191
+ state: np.ndarray
192
+ fields: list = field(default_factory=list, repr=False)
193
+ states: list = field(default_factory=list, repr=False)
194
+ time_s: float = 0.0
195
+
196
+
197
+ class MixedProblem:
198
+ """A boundary value problem on a :class:`MixedSpace`; subclasses give
199
+ ``_assemble(values, state, tangent) -> (residual, matrix data or None, new state)``
200
+ (the residual: the internal forces, no external ones) and ``_initial_state()``."""
201
+
202
+ space: MixedSpace
203
+
204
+ def _assemble(self, values, state, tangent): # pragma: no cover - abstract
205
+ raise NotImplementedError
206
+
207
+ def _initial_state(self): # pragma: no cover - abstract
208
+ raise NotImplementedError
209
+
210
+ def run(
211
+ self,
212
+ prescribed,
213
+ load: float = 1.0,
214
+ *,
215
+ steps: int = 10,
216
+ tol: float = 1e-6,
217
+ max_newton: int = 25,
218
+ max_cuts: int = 12,
219
+ fields: bool = False,
220
+ refactor: float = 0.0,
221
+ ordering: str = "COLAMD",
222
+ duration: float = 1.0,
223
+ predictor: bool = False,
224
+ ) -> PathResult:
225
+ """Grow the prescribed degrees of freedom to ``load`` times their values in
226
+ ``steps`` steps (divided when Newton's method fails): entries ``(nodes,
227
+ components, value)``, components 0-2 for the displacement and 3... for the
228
+ generalized ones (corner nodes only), the value a number or an array of the
229
+ nodes x components (0: held). The factors of the tangent (SuperLU, column
230
+ ``ordering``) are kept from an iteration to the next while each divides the
231
+ residual by more than ``1 / refactor`` (a modified Newton method for large problems,
232
+ whose cost the factorization dominates; by default 0, Newton's method: stale
233
+ tangents may miss the bifurcation of a softening body). ``duration``: the time of
234
+ the whole load, for viscous behaviours (a step lasts its fraction of it: the
235
+ attribute ``_dt`` of the problem during its iterations). ``predictor``: the
236
+ iterations of a step start from the free degrees of freedom that the last
237
+ converged tangent predicts for the prescribed increment (``K_ff Δu_f = -K_fd
238
+ Δu_d``), instead of the converged ones, which strain the elements along the
239
+ loaded boundary alone: there they may yield, and the iterations of a plastic body
240
+ stall on that first guess; when they fail, the same step from the converged ones
241
+ (near a bifurcation, the tangent may predict another branch)."""
242
+ t0 = time.perf_counter()
243
+ space = self.space
244
+ dofs, values, sets = [], [], []
245
+ for nodes, comps, value in prescribed:
246
+ d = space.dofs(nodes, comps)
247
+ dofs.append(d.ravel())
248
+ values.append(np.broadcast_to(np.asarray(value, dtype=float), d.shape).ravel())
249
+ sets.append(d)
250
+ dofs = np.concatenate(dofs)
251
+ values = np.concatenate(values)
252
+ if len(np.unique(dofs)) != len(dofs):
253
+ raise ValueError("prescribed: a degree of freedom is given twice")
254
+ free = np.setdiff1d(np.arange(space.n_dofs), dofs)
255
+ u = np.zeros(space.n_dofs)
256
+ state = self._initial_state()
257
+ loads, reactions, its, snaps = [0.0], [[np.zeros(s.shape[1]) for s in sets]], [0], []
258
+ kept = []
259
+ if fields:
260
+ snaps.append(u.copy())
261
+ kept.append(state.copy())
262
+ lam, step, cuts = 0.0, load / steps, 0
263
+ last = None # with the predictor: the factors of K_ff and K_fd of the last tangent
264
+ plain = False # the predictor failed: plain guesses until the next convergence
265
+ while lam < load * (1 - 1e-12):
266
+ step = min(step, load - lam)
267
+ target = lam + step
268
+ trial = u.copy()
269
+ trial[dofs] = target * values
270
+ self._dt = step / load * float(duration)
271
+ if predictor and last is None: # the tangent of the initial state
272
+ rows = space.matrix(self._assemble(u, state, True)[1])[free]
273
+ try:
274
+ last = (spla.splu(rows[:, free].tocsc(), permc_spec=ordering), rows[:, dofs])
275
+ except RuntimeError: # singular: no predictor
276
+ last = ()
277
+ # a tangent nearly singular (a bifurcation) may predict a wrong branch: after a
278
+ # failure from the predictor, the same step from the converged values
279
+ guessed = bool(predictor and last) and not plain
280
+ if guessed:
281
+ guess = last[0].solve(-(last[1] @ ((target - lam) * values)))
282
+ if np.all(np.isfinite(guess)):
283
+ trial[free] += guess
284
+ ok, scale, lu, previous = False, None, None, None
285
+ for iterations in range(1, max_newton + 1):
286
+ fresh = lu is None or previous is None
287
+ r, data, new_state = self._assemble(trial, state, True)
288
+ norm = float(np.linalg.norm(r[free]))
289
+ if not np.isfinite(norm):
290
+ break
291
+ if scale is None:
292
+ scale = max(float(np.linalg.norm(r[dofs])), norm, 1e-30)
293
+ if norm <= tol * scale and iterations > 1:
294
+ ok = True
295
+ break
296
+ if fresh or norm > refactor * previous:
297
+ try:
298
+ rows = space.matrix(data)[free]
299
+ lu = spla.splu(rows[:, free].tocsc(), permc_spec=ordering)
300
+ except RuntimeError: # singular
301
+ break
302
+ coupling = rows[:, dofs] if predictor else None
303
+ du = lu.solve(-r[free])
304
+ if not np.all(np.isfinite(du)):
305
+ break
306
+ alpha = 1.0
307
+ for _ in range(4): # a backtracking line search on the residual
308
+ probe = trial.copy()
309
+ probe[free] += alpha * du
310
+ r_probe, _, _ = self._assemble(probe, state, False)
311
+ probe_norm = float(np.linalg.norm(r_probe[free]))
312
+ if probe_norm < norm or alpha < 0.2:
313
+ break
314
+ alpha *= 0.5
315
+ if not np.isfinite(probe_norm):
316
+ break
317
+ trial[free] += alpha * du
318
+ scale = max(scale, float(np.linalg.norm(r_probe[dofs])))
319
+ previous = norm
320
+ if not ok:
321
+ if guessed:
322
+ plain = True
323
+ continue
324
+ cuts += 1
325
+ if cuts > max_cuts:
326
+ raise RuntimeError(f"micromorphic problem: no convergence at load {target:g}")
327
+ step *= 0.5
328
+ continue
329
+ u, state, lam, cuts = trial, new_state, target, 0
330
+ if predictor:
331
+ last, plain = (lu, coupling), False
332
+ loads.append(lam)
333
+ reactions.append([r[s].sum(axis=0) for s in sets])
334
+ its.append(iterations)
335
+ if fields:
336
+ snaps.append(u.copy())
337
+ kept.append(state.copy())
338
+ if iterations <= 4:
339
+ step = min(step * 1.5, load / steps)
340
+ return PathResult(np.array(loads), reactions, np.array(its), u, state, snaps, kept,
341
+ time.perf_counter() - t0) # fmt: skip
@@ -0,0 +1,195 @@
1
+ """Morphological models (see :func:`list_models`).
2
+
3
+ =========================== ===============================================================
4
+ ``boolean_spheres`` Boolean model of spheres (Poisson germs, random radii)
5
+ ``boolean_cylinders`` Boolean model of finite fibres (cylinders / spherocylinders)
6
+ ``poisson_fibers`` Infinite fibres on isotropic Poisson lines (non-periodic)
7
+ ``hardcore_spheres`` Non-overlapping spheres: random sequential addition, or dense
8
+ packings grown by the Lubachevsky-Stillinger algorithm
9
+ ``penetrable_spheres`` Spheres with impenetrable cores (Torquato's cherry-pit model)
10
+ ``hardcore_fibers`` Non-overlapping straight fibres by random sequential addition
11
+ ``curved_fibers`` Boolean model of curved fibres (worm-like chains of segments)
12
+ ``random_walk_fibers`` Bending fibres packed without overlap by forces (Altendorf &
13
+ Jeulin's random walks), drawn into contact (Keilmann et al.)
14
+ ``cross_linked_fibers`` Straight fibres bonded by cross-links at their contacts
15
+ (entangled cross-linked fibres, Chatti et al.)
16
+ ``voronoi`` Poisson-Voronoi tessellation (multiphase mosaic, polycrystal)
17
+ ``laguerre`` Laguerre (power) tessellation with random weights
18
+ ``gaussian_excursion`` Excursion set of a Gaussian random field
19
+ ``tpms`` Gyroid, Schwarz P/D, Neovius sheet or network lattices
20
+ ``strut_lattice`` Cubic, BCC, FCC and octet strut lattices
21
+ ``cellular_automaton`` Two-phase structure grown by a cellular automaton from noise
22
+ ``activator_inhibitor`` Turing-like patterns of Young's activator-inhibitor automaton
23
+ ``reaction_diffusion`` Turing patterns of the Gray-Scott reaction-diffusion system
24
+ ``nucleation_growth`` Nucleation and growth (JMAK): Voronoi / Johnson-Mehl grains
25
+ ``aggregation`` Diffusion-limited, Eden or ballistic clusters and deposits
26
+ ``tile_assembly`` Compatible assemblies of building blocks (combinatorial design)
27
+ ``random_lattice`` Strut lattices with missing struts and displaced nodes
28
+ ``random_laminate`` Layers of random thicknesses with holes (nanolayered films)
29
+ ``dead_leaves`` Dead leaves of spheres or spheroids, of families of their own
30
+ sizes, over a background (finite coverage)
31
+ ``transparent_dead_leaves`` Excursion of the random function of transparent leaves
32
+ ``reconstruction`` Annealed to the two-point probability and lineal path of a
33
+ Debye medium, a model or an image (Yeong-Torquato)
34
+ ``combination`` Union, intersection, difference or complement of models,
35
+ inclusions in a matrix (a polycrystal...), or nested models
36
+ ``cox_spheres`` Spheres clustered in the phase 1 of another model (aggregates)
37
+ ``coating`` A coating around the phase 1 of a model, or hollow members
38
+ ``hierarchical_lattice`` Frames of generation G of (hollow) tubes on an fcc lattice
39
+ ``fractal_sponge`` Menger sponge, Vicsek fractal, Cantor dust (iterated functions)
40
+ ``nacre`` Brick-and-mortar stacks of mineral tablets (bio-inspired)
41
+ ``bouligand`` Twisted plywood of fibres: arthropod cuticles, fish scales
42
+ ``honeycomb`` Prismatic cells: hexagonal, square or random honeycombs, wood
43
+ ``osteons`` Haversian bone: osteons remodelled one after another
44
+ ``open_foam`` Open-cell foams and trabecular bone (struts on Voronoi edges)
45
+ ``delaunay_network`` Fibre networks on the edges of Delaunay triangulations (Ban et
46
+ al.), in space or in a plane
47
+ ``level_set_foam`` Foams as level sets of distance fields: Plateau borders, nodes
48
+ ``branching`` Vascular trees grown by space colonization (Murray's law)
49
+ ``ebsd`` Polycrystal of a measured orientation map (EBSD): its grains
50
+ and their orientations, in windows of the map
51
+ ``scale_rich_network`` Ligaments of power-law thicknesses grown until they meet: scale-
52
+ rich networks (Both et al. 2026), extruded prisms, or plates
53
+ (closed cells) or beams (struts) in 3D
54
+ =========================== ===============================================================
55
+
56
+ The point processes, tessellations, fields, leaves, growths and lattices take an
57
+ ``anisotropy``, the same field everywhere: their realizations are mapped by a stretch
58
+ along principal axes preserving volumes (:mod:`morphogen.models.affine`).
59
+ """
60
+
61
+ from morphogen.models.affine import AffineStructure, Anisotropy
62
+ from morphogen.models.automata import (
63
+ ActivatorInhibitorModel,
64
+ CellularAutomatonModel,
65
+ ReactionDiffusionModel,
66
+ )
67
+ from morphogen.models.base import (
68
+ Microstructure,
69
+ Model,
70
+ get_model,
71
+ list_models,
72
+ model_from_config,
73
+ register,
74
+ )
75
+ from morphogen.models.boolean import BooleanCylinders, BooleanSpheres
76
+ from morphogen.models.bouligand import Bouligand, BouligandStructure
77
+ from morphogen.models.branching import BranchingNetwork
78
+ from morphogen.models.combination import Combination, Combined
79
+ from morphogen.models.deadleaves import DeadLeaves, DeadLeavesModel
80
+ from morphogen.models.design import RandomLattice, TileAssembly
81
+ from morphogen.models.ebsd import EBSD
82
+ from morphogen.models.fibers import (
83
+ CrossLinkedFibers,
84
+ CurvedFibers,
85
+ HardcoreFibers,
86
+ PoissonFibers,
87
+ RandomWalkFibers,
88
+ )
89
+ from morphogen.models.foam import DelaunayNetwork, OpenFoam
90
+ from morphogen.models.gaussian import GaussianExcursion, GaussianField
91
+ from morphogen.models.growth import AggregationModel, NucleationGrowthModel
92
+ from morphogen.models.hardcore import HardcoreSpheres, PenetrableSpheres
93
+ from morphogen.models.hierarchical import HierarchicalLattice
94
+ from morphogen.models.honeycomb import Honeycomb, PrismaticCells
95
+ from morphogen.models.laminate import Laminate, RandomLaminate
96
+ from morphogen.models.lattice import StrutLattice
97
+ from morphogen.models.lattice_field import LatticeField
98
+ from morphogen.models.levelset_foam import (
99
+ DistanceFieldFoam,
100
+ LevelSetFoam,
101
+ SeedCalibration,
102
+ calibrate_seeds,
103
+ )
104
+ from morphogen.models.nacre import Nacre, NacreStructure
105
+ from morphogen.models.nested import (
106
+ ClusteredSpheres,
107
+ CoatedStructure,
108
+ Coating,
109
+ CoxSpheres,
110
+ FractalSponge,
111
+ FractalStructure,
112
+ )
113
+ from morphogen.models.osteons import Osteons, OsteonStructure
114
+ from morphogen.models.reconstruction import Reconstruction
115
+ from morphogen.models.scale_rich import ScaleRichNetwork, ScaleRichStructure
116
+ from morphogen.models.scale_rich_3d import ScaleRichBeams, ScaleRichPlates
117
+ from morphogen.models.tessellation import Laguerre, Tessellation, Voronoi
118
+ from morphogen.models.tiling_field import TilingField
119
+ from morphogen.models.tpms import TPMS, TPMSStructure
120
+ from morphogen.models.transparent import TransparentDeadLeaves, TransparentDeadLeavesModel
121
+ from morphogen.models.union import PrimitiveUnion
122
+
123
+ __all__ = [
124
+ "EBSD",
125
+ "TPMS",
126
+ "ActivatorInhibitorModel",
127
+ "AffineStructure",
128
+ "AggregationModel",
129
+ "Anisotropy",
130
+ "BooleanCylinders",
131
+ "BooleanSpheres",
132
+ "Bouligand",
133
+ "BouligandStructure",
134
+ "BranchingNetwork",
135
+ "CellularAutomatonModel",
136
+ "ClusteredSpheres",
137
+ "CoatedStructure",
138
+ "Coating",
139
+ "Combination",
140
+ "Combined",
141
+ "CoxSpheres",
142
+ "CrossLinkedFibers",
143
+ "CurvedFibers",
144
+ "DeadLeaves",
145
+ "DeadLeavesModel",
146
+ "DelaunayNetwork",
147
+ "DistanceFieldFoam",
148
+ "FractalSponge",
149
+ "FractalStructure",
150
+ "GaussianExcursion",
151
+ "GaussianField",
152
+ "HardcoreFibers",
153
+ "HardcoreSpheres",
154
+ "HierarchicalLattice",
155
+ "Honeycomb",
156
+ "Laguerre",
157
+ "Laminate",
158
+ "LatticeField",
159
+ "LevelSetFoam",
160
+ "Microstructure",
161
+ "Model",
162
+ "Nacre",
163
+ "NacreStructure",
164
+ "NucleationGrowthModel",
165
+ "OpenFoam",
166
+ "OsteonStructure",
167
+ "Osteons",
168
+ "PenetrableSpheres",
169
+ "PoissonFibers",
170
+ "PrimitiveUnion",
171
+ "PrismaticCells",
172
+ "RandomLaminate",
173
+ "RandomLattice",
174
+ "RandomWalkFibers",
175
+ "ReactionDiffusionModel",
176
+ "Reconstruction",
177
+ "ScaleRichBeams",
178
+ "ScaleRichNetwork",
179
+ "ScaleRichPlates",
180
+ "ScaleRichStructure",
181
+ "SeedCalibration",
182
+ "StrutLattice",
183
+ "TPMSStructure",
184
+ "Tessellation",
185
+ "TileAssembly",
186
+ "TilingField",
187
+ "TransparentDeadLeaves",
188
+ "TransparentDeadLeavesModel",
189
+ "Voronoi",
190
+ "calibrate_seeds",
191
+ "get_model",
192
+ "list_models",
193
+ "model_from_config",
194
+ "register",
195
+ ]