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,368 @@
1
+ """Brittle fracture of voxel images by the phase-field method in finite strains: the cell
2
+ of :mod:`morphogen.fracture.phasefield` whose phases stretch much before they break
3
+ (rubbers, foams, soft tissues).
4
+
5
+ The phases are hyperelastic (the strain energies of :mod:`morphogen.homogenization.laws`)
6
+ or elastic (the energy of Hencky of the logarithmic strain, the elasticity of every
7
+ finite-strain solver of the package), and the energy of the cell is that of the small
8
+ strains with the energy of the deformation gradient, over the reference configuration,
9
+
10
+ E(u, d) = int g(d) psi(F) dV0 + int G_c gamma(d, grad0 d) dV0, g(d) = (1 - d)^2 + k:
11
+
12
+ the damage and its gradient are Lagrangian fields, and the toughness is an energy per unit
13
+ area of the reference configuration (Miehe & Schänzel 2014). The crack densities
14
+ (``AT2``, ``AT1``), the regularization length and the irreversibility are those of the
15
+ small strains (:class:`~morphogen.fracture.phasefield.PhaseField`).
16
+
17
+ A step of a loading path is solved by alternate minimization, as in small strains: until
18
+ the damage no longer moves,
19
+
20
+ 1. the displacement at fixed damage: the periodic problem of the voxels of the nonlinear
21
+ FFT solver (:class:`~morphogen.homogenization.fft_nonlinear.NonlinearFFTProblem`: total
22
+ Lagrangian, F-bar voxels, Newton's method, the macroscopic components prescribed as
23
+ stresses among its unknowns), the nominal stress and the tangent of each point times the
24
+ degradation of its voxel (the stress is degraded as a whole, as in small strains: the
25
+ hybrid formulation), the Fourier preconditioner of its Krylov solves scaled by the
26
+ degradation of the nodes;
27
+ 2. the damage of the driving energy ``psi+`` of the state reached: the problem of the
28
+ small strains (the same equation, its bound or its history field).
29
+
30
+ The solver of the paths divides a step where Newton's method fails (a cell that breaks at
31
+ once): the damage then starts again from that of the last converged step. Where a crack
32
+ runs at a fixed load, the F-bar voxels of its band, sheared far, may turn inside out under
33
+ Newton's corrections from an equilibrium where none is near it, and dividing the step only
34
+ replays the run of the crack: the compressible solids, which do not lock, are better solved
35
+ on fully integrated voxels (``integration="full"``).
36
+
37
+ The energy that drives the damage (``split``) is all the energy (``"none"``); or its
38
+ isochoric part and its volumetric part in expansion, ``J > 1`` (``"volumetric"``: the split
39
+ of Amor et al. between the two terms of the strain energies, so that a hydrostatic
40
+ compression does not break); or, for the elastic phases only, the tensile part of the
41
+ energy of Hencky in the principal logarithmic strains (``"spectral"``, as in small
42
+ strains: ``lambda <tr e>+^2 / 2 + mu sum <e_i>+^2``). The compressible energies that are
43
+ not split (Blatz-Ko, hyperfoam) drive the damage as a whole.
44
+ """
45
+
46
+ from __future__ import annotations
47
+
48
+ import logging
49
+
50
+ import numpy as np
51
+
52
+ from morphogen.fracture.phasefield import (
53
+ PhaseField,
54
+ PhaseFieldProblem,
55
+ PhaseFieldResult,
56
+ _to_nodes,
57
+ _to_voxels,
58
+ )
59
+ from morphogen.homogenization import finite as fin
60
+ from morphogen.homogenization.fft_nonlinear import NonlinearFFTProblem, _VoxelPaths
61
+ from morphogen.homogenization.materials import Material
62
+ from morphogen.homogenization.paths import LoadingPath
63
+ from morphogen.image import VoxelImage
64
+
65
+ log = logging.getLogger("morphogen")
66
+
67
+ __all__ = ["FinitePhaseFieldProblem", "green_lagrange"]
68
+
69
+
70
+ def green_lagrange(grads: np.ndarray) -> tuple[np.ndarray, np.ndarray]:
71
+ """The Green-Lagrange strains (n, 6; engineering shears) and the Jacobians ``det F``
72
+ of displacement gradients (n, 9; row by row)."""
73
+ h = np.asarray(grads, dtype=float).reshape(-1, 3, 3)
74
+ e = 0.5 * (h + np.swapaxes(h, 1, 2) + np.swapaxes(h, 1, 2) @ h)
75
+ out = fin._voigt(e)
76
+ out[:, 3:] *= 2.0
77
+ return out, np.linalg.det(np.eye(3) + h)
78
+
79
+
80
+ class _DegradedVoxels(_VoxelPaths):
81
+ """The voxels of a cell whose points are degraded: their stresses and tangents times
82
+ the degradation of their voxel, and the preconditioner of the Krylov solves scaled by
83
+ that of the nodes (the stiffness of a damaged cell is that of the sound one times
84
+ ``g``, which the Fourier inverse of the sound reference medium ignores)."""
85
+
86
+ def _buffers(self, n_pts: int, nc: int) -> None:
87
+ super()._buffers(n_pts, nc)
88
+ reference, problem = self.precondition, self.problem
89
+
90
+ def scaled(r):
91
+ w = problem.node_weight
92
+ return w * reference(w * r)
93
+
94
+ self.precondition = scaled
95
+
96
+ def integrate(self, grads, dtemp, dt, old, new, stress, tangent, guess, ratio) -> int:
97
+ failed = super().integrate(grads, dtemp, dt, old, new, stress, tangent, guess, ratio)
98
+ g = self.problem.point_scale
99
+ stress *= g[:, None]
100
+ tangent *= g[:, None, None]
101
+ return failed
102
+
103
+
104
+ class _DegradedFFTProblem(NonlinearFFTProblem):
105
+ """The loading paths of a voxel image whose voxels are degraded by ``point_scale``
106
+ (one value per integration point) and ``node_weight`` (one per nodal unknown), the
107
+ damage of its ``owner`` settled on each state reached (the hooks of
108
+ :meth:`~morphogen.homogenization.nonlinear._PathSolver.run`)."""
109
+
110
+ def __init__(self, image, materials, owner, **options):
111
+ super().__init__(image, materials, "periodic", kinematics="finite", **options)
112
+ self.owner = owner
113
+ self.point_scale = np.ones(0 if self.empty else self.kind.size)
114
+ self.node_weight = np.ones(3 * int(np.prod(self.shape)))
115
+
116
+ def _discretization(self) -> _VoxelPaths:
117
+ return _DegradedVoxels(self)
118
+
119
+ def _settle(self, state) -> bool:
120
+ return self.owner._settle(state)
121
+
122
+ def _rollback(self) -> None:
123
+ self.owner._rollback()
124
+
125
+
126
+ class FinitePhaseFieldProblem:
127
+ """The brittle fracture of a periodic voxel image in finite strains (see the module):
128
+ ``materials`` of its phases, those that break hyperelastic or elastic (isotropic);
129
+ ``fracture`` (:class:`~morphogen.fracture.phasefield.PhaseField`, or a mapping of its
130
+ parameters); ``initial``: the voxels broken from the start. ``tol``: the relative
131
+ residual of the linear solves; ``staggered_tol``: the largest change of the damage
132
+ that ends the alternate minimization of a step, of at most ``max_staggered``
133
+ iterations; ``nonlinear``: the other options of
134
+ :class:`~morphogen.homogenization.fft_nonlinear.NonlinearFFTProblem` (``newton_tol``,
135
+ ``max_newton``, ``max_cuts``, ``integration``, ``tangent``)."""
136
+
137
+ def __init__(self, image: VoxelImage, materials: dict[int, Material], fracture, *,
138
+ initial=None, tol: float = 1e-7, staggered_tol: float = 1e-3,
139
+ max_staggered: int = 200, **nonlinear): # fmt: skip
140
+ fracture = PhaseField.from_config(fracture)
141
+ self.staggered_tol, self.max_staggered = float(staggered_tol), int(max_staggered)
142
+ for name in ("kinematics", "device", "grains", "orientations"):
143
+ if name in nonlinear:
144
+ raise ValueError(
145
+ f"phase field in finite strains: no option {name!r} (isotropic phases, "
146
+ "on the CPU)"
147
+ )
148
+ #: the damage problem (that of the small strains) and the state of the damage
149
+ self.damage = PhaseFieldProblem(image, materials, fracture, initial=initial, tol=tol)
150
+ self.fracture = fracture
151
+ self.image, self.shape = image, image.shape
152
+ self.paths = _DegradedFFTProblem(image, materials, self, tol=tol, **nonlinear)
153
+ self.materials = materials
154
+ self._energies = self._energy_laws()
155
+ #: the damage and the history of the last converged step, the alternate
156
+ #: minimizations of the step under way and what the last of them found
157
+ self._committed = (self.damage.d, self.damage.history)
158
+ self._staggered, self._trial = 0, (self.damage.history, 0.0, 0.0)
159
+ self._degrade()
160
+
161
+ # -- the energies of the points ------------------------------------------------------
162
+
163
+ def _energy_laws(self) -> list:
164
+ """For each phase whose energy is known (elastic or hyperelastic), its points and
165
+ the function of their displacement gradients that gives the driving energy and
166
+ the whole energy; the phases that break must be among them."""
167
+ from morphogen.homogenization.laws import analytic_model
168
+
169
+ paths, split = self.paths, self.fracture.split
170
+ phase = np.asarray(self.image.data).ravel()[paths.elem]
171
+ out = []
172
+ for ph in np.unique(phase):
173
+ m = self.materials[int(ph)]
174
+ breaks = self.fracture.of(int(ph)) is not None
175
+ points = np.flatnonzero(np.repeat(phase == ph, paths.ng))
176
+ if m.hyperelasticity is not None and m.viscoelasticity is None:
177
+ if breaks and split == "spectral":
178
+ raise ValueError(
179
+ f"phase {int(ph)}: the spectral split is that of the logarithmic "
180
+ "strain of elastic phases; a hyperelastic phase takes split "
181
+ "'volumetric' (its isochoric energy, and the volumetric one in "
182
+ "expansion) or 'none'"
183
+ )
184
+ out.append((points, _hyperelastic_energy(analytic_model(m, finite=True), split)))
185
+ elif not m.nonlinear and m.isotropic and m.stiffness is None:
186
+ out.append((points, _hencky_energy(*m.lame, split)))
187
+ elif breaks:
188
+ raise ValueError(
189
+ f"phase {int(ph)}: in finite strains the phases that break are elastic "
190
+ "(isotropic) or hyperelastic"
191
+ )
192
+ return out
193
+
194
+ def _energy(self, grads: np.ndarray) -> tuple[np.ndarray, np.ndarray]:
195
+ """The driving energy ``psi+`` and the whole energy of the voxels (the means of
196
+ their points; zero in the voids and in the phases whose energy is not known)."""
197
+ paths = self.paths
198
+ plus, whole = np.zeros(paths.kind.size), np.zeros(paths.kind.size)
199
+ for points, law in self._energies:
200
+ plus[points], whole[points] = law(grads[points])
201
+ out = []
202
+ for values in (plus, whole):
203
+ voxels = np.zeros(int(np.prod(self.shape)))
204
+ voxels[paths.elem] = values.reshape(-1, paths.ng).mean(axis=1)
205
+ out.append(voxels.reshape(self.shape))
206
+ return out[0], out[1]
207
+
208
+ def _degrade(self) -> np.ndarray:
209
+ """The degradation of the voxels for the damage reached, given to the points of
210
+ the mechanical problem and to its preconditioner."""
211
+ g = self.damage.degradation()
212
+ paths = self.paths
213
+ paths.point_scale = np.ascontiguousarray(np.repeat(g.ravel()[paths.elem], paths.ng))
214
+ nodal = _to_nodes(g) / 8.0
215
+ paths.node_weight = np.repeat(1.0 / np.sqrt(nodal.ravel()), 3)
216
+ return g
217
+
218
+ # -- the damage of a state: the hooks of the solver of the paths ----------------------
219
+
220
+ def _settle(self, state) -> bool:
221
+ """The damage of the driving energy of the state reached, from that of the last
222
+ converged step (its bound); true while it moves: the step is solved again."""
223
+ dmg = self.damage
224
+ plus, whole = self._energy(state.grads)
225
+ history = plus
226
+ if self.fracture.irreversibility == "history":
227
+ history = np.maximum(self._committed[1], plus)
228
+ g = dmg.degradation() # of the damage the state was solved with
229
+ elastic = float(np.sum(g * whole)) * dmg.voxel / dmg.volume
230
+ new = dmg._damage(history, self._committed[0])
231
+ change = float(np.abs(new - dmg.d).max())
232
+ dmg.d = new
233
+ self._trial = (history, elastic, change)
234
+ self._degrade()
235
+ self._staggered += 1
236
+ return change >= self.staggered_tol and self._staggered < self.max_staggered
237
+
238
+ def _rollback(self) -> None:
239
+ """A step divided: the damage of the last converged step again."""
240
+ self.damage.d = self._committed[0]
241
+ self._staggered = 0
242
+ self._degrade()
243
+
244
+ # -- loading paths -------------------------------------------------------------------
245
+
246
+ def run(self, path, *, name: str = "path", fields=False, monitor=None) -> PhaseFieldResult:
247
+ """Follow a loading path (:class:`~morphogen.homogenization.paths.LoadingPath`, or
248
+ a mapping for it; nominal strains and stresses, as for the loading paths in finite
249
+ strains): :class:`~morphogen.fracture.phasefield.PhaseFieldResult` with the nominal
250
+ and true measures of the path. ``fields``: true for the damage, strain and stress
251
+ of the voxels at the end of each segment of the path, ``"steps"`` at the end of
252
+ each step, or a list of times of its steps. ``monitor(time, records so far)``
253
+ after each step; a true value ends the path there."""
254
+ path = LoadingPath.from_spec(path)
255
+ if np.any(np.asarray(path.temperature) != 0):
256
+ raise ValueError("phase field in finite strains: no change of temperature")
257
+ dmg, paths = self.damage, self.paths
258
+ wanted = paths._field_times(path, fields)
259
+ volume = dmg.volume
260
+ rec = {k: [] for k in ("t", "d", "gamma", "elastic", "fracture", "its", "phases")}
261
+ kept: dict = {}
262
+
263
+ def record(t: float, elastic: float) -> None:
264
+ rec["t"].append(float(t))
265
+ rec["d"].append(dmg._mean_damage())
266
+ rec["gamma"].append(dmg.crack_surface() / volume)
267
+ rec["elastic"].append(elastic)
268
+ rec["fracture"].append(dmg.crack_surface(weight=dmg.gc) / volume)
269
+ means = dmg._phase_means(None, None)
270
+ rec["phases"].append({ph: v["plastic"] for ph, v in means.items()})
271
+
272
+ record(float(path.times[0]), 0.0)
273
+
274
+ def after(state) -> bool:
275
+ """A converged step: its damage and its history kept."""
276
+ history, elastic, change = self._trial
277
+ if change >= self.staggered_tol:
278
+ log.warning(
279
+ "phase field: the alternate minimization of the step to t = %g stopped at "
280
+ "a change of the damage of %.2e", state.time, change
281
+ ) # fmt: skip
282
+ dmg.history = history
283
+ self._committed = (dmg.d, history)
284
+ rec["its"].append(self._staggered)
285
+ self._staggered = 0
286
+ record(state.time, elastic)
287
+ if wanted.size and np.any(np.isclose(state.time, wanted, rtol=1e-12, atol=0.0)):
288
+ kept[float(state.time)] = np.clip(_to_voxels(dmg.d), 0.0, 1.0)
289
+ return bool(monitor is not None and monitor(float(state.time), rec))
290
+
291
+ res = paths.run(path, name=name, fields=fields, monitor=after)
292
+ for t, values in res.fields.items(): # the damage with the fields of the voxels
293
+ values["damage"] = values["p"] = kept[float(t)]
294
+ phases = {}
295
+ for ph, means in res.phases.items():
296
+ phases[ph] = dict(means)
297
+ if ph in rec["phases"][0]:
298
+ phases[ph]["plastic"] = np.array([step[ph] for step in rec["phases"]])
299
+ info = dict(res.info)
300
+ info["newton_iterations"] = int(np.sum(res.iterations))
301
+ return PhaseFieldResult(
302
+ name=res.name,
303
+ bc=res.bc,
304
+ path=res.path,
305
+ times=res.times,
306
+ strain=res.strain,
307
+ stress=res.stress,
308
+ temperature=res.temperature,
309
+ plastic=np.array(rec["d"]),
310
+ phases=phases,
311
+ iterations=np.array(rec["its"], dtype=int),
312
+ info=info,
313
+ fields=res.fields,
314
+ support=res.support,
315
+ kinematics="finite",
316
+ cauchy=res.cauchy,
317
+ log_strain=res.log_strain,
318
+ damage=np.array(rec["d"]),
319
+ crack_surface=np.array(rec["gamma"]),
320
+ elastic_energy=np.array(rec["elastic"]),
321
+ fracture_energy=np.array(rec["fracture"]),
322
+ )
323
+
324
+
325
+ def _hyperelastic_energy(law, split: str):
326
+ """The driving and whole energies of the points of a hyperelastic law (its isochoric
327
+ and volumetric parts) from their displacement gradients."""
328
+
329
+ def energy(grads):
330
+ e, j = green_lagrange(grads)
331
+ with np.errstate(invalid="ignore", divide="ignore", over="ignore"):
332
+ iso, vol = law._parts(e)[4]
333
+ iso, vol = np.nan_to_num(iso), np.nan_to_num(vol)
334
+ whole = iso + vol
335
+ if split == "none":
336
+ return whole, whole
337
+ return iso + np.where(j >= 1.0, vol, 0.0), whole
338
+
339
+ return energy
340
+
341
+
342
+ def _hencky_energy(lam: float, mu: float, split: str):
343
+ """The driving and whole energies of the points of an elastic phase in finite strains:
344
+ the energy of Hencky ``lambda (tr e)^2 / 2 + mu e : e`` of the logarithmic strain."""
345
+ bulk = lam + 2.0 * mu / 3.0
346
+
347
+ def energy(grads):
348
+ e = fin.log_strain(grads)
349
+ e[:, 3:] *= 0.5 # tensor shears
350
+ tr = e[:, :3].sum(axis=1)
351
+ dev2 = np.sum((e[:, :3] - tr[:, None] / 3.0) ** 2, axis=1) + 2.0 * np.sum(
352
+ e[:, 3:] ** 2, axis=1
353
+ )
354
+ whole = 0.5 * bulk * tr**2 + mu * dev2
355
+ if split == "none":
356
+ return whole, whole
357
+ if split == "volumetric":
358
+ return 0.5 * bulk * np.maximum(tr, 0.0) ** 2 + mu * dev2, whole
359
+ t = np.empty((len(e), 3, 3))
360
+ for k, (a, b) in enumerate(((0, 0), (1, 1), (2, 2), (1, 2), (2, 0), (0, 1))):
361
+ t[:, a, b] = t[:, b, a] = e[:, k]
362
+ principal = np.linalg.eigvalsh(t)
363
+ plus = 0.5 * lam * np.maximum(tr, 0.0) ** 2 + mu * np.sum(
364
+ np.maximum(principal, 0.0) ** 2, axis=1
365
+ )
366
+ return plus, whole
367
+
368
+ return energy