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,534 @@
1
+ """Micromorphic ductile damage: von Mises elasto-(visco)plasticity whose damage is driven by
2
+ a micromorphic counterpart of the cumulated plastic strain, which regularizes the
3
+ localization of ductile fracture, in small and finite strains (Forest 2009, the
4
+ micromorphic approach; the implicit gradient-enhanced ductile damage of Engelen, Geers &
5
+ Baaijens 2003 and Geers, Peerlings, Brekelmans & de Borst).
6
+
7
+ *Plasticity of the effective stress.* ``σ̃ = C : (ε - ε^p)`` (isotropic elasticity), the
8
+ yield function ``f = σ̃_eq - R(p)`` with ``R = σ0 + H p + Σ Q_i (1 - exp(-b_i p))``, the
9
+ normality ``ε̇^p = ṗ 3/2 s̃ / σ̃_eq``, rate-independent or with Norton's overstress ``σ̃_eq - R
10
+ = K ṗ^(1/N)``: the radial return, its consistent tangent ``C - (2μ)² θ n ⊗ n - (2μ)² Δp /
11
+ σ̃_eq^tr (3/2 I_dev - n ⊗ n)`` (``n = 3/2 s̃ / σ̃_eq``, ``θ = 1 / (3μ + R' + ∂V/∂Δp)``) and the
12
+ derivative of the cumulated plastic strain by the strain, ``∂p/∂ε = 2μ θ n``.
13
+
14
+ *Triaxiality.* The damage is driven by the equivalent plastic strain ``e``, ``ė = w(η)
15
+ ṗ``, weighted by a function of the triaxiality ``η = σ̃_m / σ̃_eq`` of the effective stress
16
+ (of the stress conjugate to the logarithmic strain in finite strains, nearly Kirchhoff's):
17
+ the ratio ``ε_f(1/3) / ε_f(η)`` of the strains to failure of uniaxial tension and of the
18
+ current state, so that ``e`` is the plastic strain of uniaxial tension that would damage
19
+ as much (``w(1/3) = 1``: the thresholds of the damage keep their meaning in tension).
20
+ ``"none"``: ``w = 1``, ``e = p``; ``"rice_tracey"``: ``w = exp(β (η - 1/3))``, the growth
21
+ rate of a void of Rice & Tracey (1969, ``β = 3/2``); ``"johnson_cook"``: ``ε_f = D1 + D2
22
+ exp(D3 η)`` (Johnson & Cook 1985); ``"lemaitre"``: ``w = R_ν = 2/3 (1 + ν) + 3 (1 - 2ν) η²``,
23
+ the triaxiality function of the elastic energy (Lemaitre 1985). Pure shear damages less
24
+ than tension, the triaxial stress ahead of a notch in plane strain more: the damage
25
+ concentrates there and the crack runs from the notch across the ligament (mode I). Its
26
+ increment ``Δe = w(η) Δp`` takes the triaxiality at the end of the step (backward Euler),
27
+ and ``∂e/∂ε = w ∂p/∂ε + Δp w'(η) ∂η/∂ε`` that of the consistent tangent, ``∂η/∂ε =
28
+ (∂σ̃_m/∂ε - η ∂σ̃_eq/∂ε) / σ̃_eq``.
29
+
30
+ *Micromorphic damage.* A scalar micromorphic variable ``χ`` (a degree of freedom), the
31
+ counterpart of ``e``, with the generalized balance ``H (χ - e) - div(H ℓ² ∇χ) = 0``: the
32
+ Helmholtz equation ``χ - ℓ² Δχ = e`` of the implicit gradient models, ``∇χ · n = 0`` on
33
+ the boundary (``H`` scales the equation only). The damage follows its largest value ``κ =
34
+ max χ``, ``d = d_max (1 - exp(-(κ - κ0) / κ_c))`` beyond the onset ``κ0``, and degrades the
35
+ stress, ``σ = (1 - d) σ̃``. The plasticity, that of the effective stress, hardens and stays
36
+ regular; the softening comes from the damage, nonlocal through ``χ``, so that the band of
37
+ damage has the width set by ``ℓ``, not by the elements, and a crack is the band where ``d``
38
+ reaches ``d_max``: a ligament fully damaged carries no load.
39
+
40
+ *Finite strains* (total Lagrangian; :mod:`morphogen.micromorphic.finite`): the plasticity
41
+ acts on the logarithmic strain and its conjugate stress, ``P = (1 - d) P̃`` with ``P̃`` the
42
+ first Piola-Kirchhoff stress pulled back from it, and ``∂p/∂F`` likewise.
43
+
44
+ *Elements* (:mod:`morphogen.micromorphic.space`): quadratic displacements and a linear
45
+ ``χ``; the tangent, with the derivatives of the damage by ``χ`` and of ``p`` by the strain,
46
+ is not symmetric. The time of a viscous step is its fraction of the ``duration`` of
47
+ :meth:`~morphogen.micromorphic.space.MixedProblem.run`, whose iterations start here from
48
+ the increment that the last tangent predicts (its ``predictor``): from the converged
49
+ values with only the prescribed ones moved, the points along a pulled boundary yield and
50
+ the iterations stall.
51
+ """
52
+
53
+ from __future__ import annotations
54
+
55
+ import math
56
+ from dataclasses import dataclass
57
+
58
+ import numpy as np
59
+ from numba import njit, prange
60
+
61
+ from morphogen.homogenization.fe import _corner_gradients, _shape_gradients
62
+ from morphogen.mesh.tetra import TetMesh
63
+ from morphogen.micromorphic.finite import MAP, W, hencky, pull_back
64
+ from morphogen.micromorphic.space import (
65
+ CHUNK,
66
+ POINTS,
67
+ WEIGHTS,
68
+ MixedProblem,
69
+ MixedSpace,
70
+ PathResult,
71
+ )
72
+
73
+ #: The internal variables of a point: the plastic strain (Mandel), p, κ, d, the equivalent
74
+ #: plastic strain of the damage e and the triaxiality of the last step
75
+ N_STATE = 11
76
+ #: The weights of the triaxiality
77
+ TRIAXIALITY = {"none": 0, "rice_tracey": 1, "johnson_cook": 2, "lemaitre": 3}
78
+ #: The generalized degree of freedom: the micromorphic cumulated plastic strain
79
+ CHI = 3
80
+
81
+
82
+ @dataclass(frozen=True)
83
+ class MicromorphicDuctile:
84
+ """A material of the micromorphic ductile damage model (see the module): elasticity
85
+ ``young`` and ``poisson``; plasticity ``yield_stress`` σ0, the linear ``hardening`` H,
86
+ ``voce`` ((Q1, b1), (Q2, b2)), Norton's ``viscosity`` K and ``exponent`` N (None:
87
+ rate-independent); the damage ``onset`` κ0, its scale ``critical`` κ_c and
88
+ ``max_damage``; the ``length`` ℓ and the ``penalty`` H of the equation of ``χ`` (by
89
+ default ``yield_stress``); the weight of the ``triaxiality`` (``"none"``,
90
+ ``"rice_tracey"`` with ``triaxiality_parameters`` (β,), default 1.5, ``"johnson_cook"``
91
+ with (D1, D2, D3), ``"lemaitre"``). The hardening must keep the plasticity of the
92
+ effective stress stable (``H + Σ Q_i b_i > 0``)."""
93
+
94
+ young: float
95
+ poisson: float
96
+ yield_stress: float
97
+ length: float
98
+ hardening: float = 0.0
99
+ voce: tuple = ()
100
+ viscosity: float | None = None
101
+ exponent: float | None = None
102
+ onset: float = 0.0
103
+ critical: float = 0.1
104
+ max_damage: float = 0.99
105
+ penalty: float | None = None
106
+ triaxiality: str = "none"
107
+ triaxiality_parameters: tuple = ()
108
+
109
+ def __post_init__(self) -> None:
110
+ name = "MicromorphicDuctile"
111
+ if not (self.young > 0 and -1 < self.poisson < 0.5 and self.yield_stress > 0):
112
+ raise ValueError(f"{name}: positive young and yield_stress, -1 < poisson < 0.5")
113
+ if not (self.length > 0 and self.critical > 0 and 0 < self.max_damage < 1):
114
+ raise ValueError(f"{name}: positive length and critical, 0 < max_damage < 1")
115
+ if len(self.voce) > 2 or self.hardening < 0 or self.onset < 0:
116
+ raise ValueError(f"{name}: at most two Voce terms, hardening and onset >= 0")
117
+ if (self.viscosity is None) != (self.exponent is None):
118
+ raise ValueError(f"{name}: Norton's viscosity and exponent together")
119
+ if self.triaxiality not in TRIAXIALITY:
120
+ raise ValueError(f"{name}: triaxiality among {sorted(TRIAXIALITY)}")
121
+ needed = {"none": 0, "rice_tracey": 1, "johnson_cook": 3, "lemaitre": 0}
122
+ given = len(self.triaxiality_parameters)
123
+ if given not in (
124
+ (0, 1) if self.triaxiality == "rice_tracey" else (needed[self.triaxiality],)
125
+ ):
126
+ raise ValueError(f"{name}: {needed[self.triaxiality]} triaxiality parameters")
127
+ if (
128
+ self.triaxiality == "johnson_cook"
129
+ and not min(self._failure(np.array([-1.0 / 3.0, 3.0]))) > 0
130
+ ):
131
+ raise ValueError(f"{name}: Johnson-Cook strains to failure must stay positive")
132
+
133
+ def _failure(self, eta) -> np.ndarray:
134
+ d1, d2, d3 = self.triaxiality_parameters
135
+ return d1 + d2 * np.exp(d3 * np.asarray(eta, dtype=float))
136
+
137
+ def weight(self, eta) -> np.ndarray:
138
+ """The weight ``w(η)`` of the triaxiality (see the module; 1 in uniaxial tension)."""
139
+ eta = np.asarray(eta, dtype=float)
140
+ kind = self.triaxiality
141
+ if kind == "rice_tracey":
142
+ beta = self.triaxiality_parameters[0] if self.triaxiality_parameters else 1.5
143
+ return np.exp(beta * (eta - 1.0 / 3.0))
144
+ if kind == "johnson_cook":
145
+ return self._failure(1.0 / 3.0) / self._failure(eta)
146
+ if kind == "lemaitre":
147
+ nu = self.poisson
148
+ return 2.0 / 3.0 * (1.0 + nu) + 3.0 * (1.0 - 2.0 * nu) * eta**2
149
+ return np.ones_like(eta)
150
+
151
+ def parameters(self) -> np.ndarray:
152
+ lam = self.young * self.poisson / ((1 + self.poisson) * (1 - 2 * self.poisson))
153
+ mu = self.young / (2 * (1 + self.poisson))
154
+ voce = list(self.voce) + [(0.0, 0.0)] * (2 - len(self.voce))
155
+ k, n = (0.0, 1.0)
156
+ if self.viscosity is not None:
157
+ k, n = float(self.viscosity), float(self.exponent)
158
+ h = self.yield_stress if self.penalty is None else float(self.penalty)
159
+ law = [0.0, 0.0, 0.0]
160
+ if self.triaxiality == "rice_tracey":
161
+ law[0] = self.triaxiality_parameters[0] if self.triaxiality_parameters else 1.5
162
+ elif self.triaxiality == "johnson_cook":
163
+ law = [float(v) for v in self.triaxiality_parameters]
164
+ elif self.triaxiality == "lemaitre":
165
+ law[0] = self.poisson
166
+ return np.array([lam, mu, self.yield_stress, self.hardening, voce[0][0], voce[0][1],
167
+ voce[1][0], voce[1][1], k, n, self.onset, self.critical,
168
+ self.max_damage, self.length**2, h, TRIAXIALITY[self.triaxiality],
169
+ *law]) # fmt: skip
170
+
171
+ def damage(self, kappa) -> np.ndarray:
172
+ """``d(κ)`` of the damage law."""
173
+ k = np.asarray(kappa, dtype=float)
174
+ d = self.max_damage * (1.0 - np.exp(-(k - self.onset) / self.critical))
175
+ return np.where(k > self.onset, d, 0.0)
176
+
177
+
178
+ @njit(cache=True)
179
+ def _hardening(par, p):
180
+ """``R(p)`` and ``R'(p)``."""
181
+ e1 = math.exp(-par[5] * p)
182
+ e2 = math.exp(-par[7] * p)
183
+ r = par[2] + par[3] * p + par[4] * (1.0 - e1) + par[6] * (1.0 - e2)
184
+ return r, par[3] + par[4] * par[5] * e1 + par[6] * par[7] * e2
185
+
186
+
187
+ @njit(cache=True)
188
+ def _damage_law(par, kappa):
189
+ """``d(κ)`` and ``d'(κ)``."""
190
+ if kappa <= par[10]:
191
+ return 0.0, 0.0
192
+ ex = math.exp(-(kappa - par[10]) / par[11])
193
+ return par[12] * (1.0 - ex), par[12] * ex / par[11]
194
+
195
+
196
+ @njit(cache=True)
197
+ def _weight(par, eta):
198
+ """``w(η)`` and ``w'(η)`` of the triaxiality (see the module)."""
199
+ kind = int(par[15])
200
+ if kind == 1: # Rice & Tracey
201
+ w = math.exp(par[16] * (eta - 1.0 / 3.0))
202
+ return w, par[16] * w
203
+ if kind == 2: # Johnson & Cook
204
+ d1, d2, d3 = par[16], par[17], par[18]
205
+ tension = d1 + d2 * math.exp(d3 / 3.0)
206
+ failure = max(d1 + d2 * math.exp(d3 * eta), 1e-12 * tension)
207
+ slope = d2 * d3 * math.exp(d3 * eta)
208
+ return tension / failure, -tension * slope / failure**2
209
+ if kind == 3: # Lemaitre
210
+ nu = par[16]
211
+ return 2.0 / 3.0 * (1.0 + nu) + 3.0 * (1.0 - 2.0 * nu) * eta * eta, 6.0 * (
212
+ 1.0 - 2.0 * nu
213
+ ) * eta
214
+ return 1.0, 0.0
215
+
216
+
217
+ @njit(cache=True)
218
+ def _driving(par, sig, tan, dp, dp_increment, de):
219
+ """The increment of the equivalent plastic strain of the damage, ``w(η) Δp``, and its
220
+ derivative by the strain into ``de`` (Mandel; see the module), from the effective stress
221
+ ``sig``, its tangent ``tan``, ``∂p/∂ε`` ``dp`` and ``Δp``; returns ``(Δe, η)``."""
222
+ mean = (sig[0] + sig[1] + sig[2]) / 3.0
223
+ s = sig.copy()
224
+ for r in range(3):
225
+ s[r] -= mean
226
+ q = math.sqrt(1.5 * (s @ s))
227
+ if int(par[15]) == 0 or not dp_increment > 0.0 or not q > 0.0:
228
+ de[:] = dp
229
+ return dp_increment, (mean / q if q > 0.0 else 0.0)
230
+ eta = mean / q
231
+ w, dw = _weight(par, eta)
232
+ for c in range(6):
233
+ dmean = (tan[0, c] + tan[1, c] + tan[2, c]) / 3.0
234
+ dq = 0.0
235
+ for r in range(6):
236
+ dq += 1.5 * s[r] / q * tan[r, c]
237
+ de[c] = w * dp[c] + dp_increment * dw * (dmean - eta * dq) / q
238
+ return w * dp_increment, eta
239
+
240
+
241
+ @njit(cache=True)
242
+ def _j2_point(par, eps, epsp_old, p_old, dt, sig, epsp, tan, dp):
243
+ """The radial return of a point (Mandel vectors; see the module): the effective
244
+ stress, the plastic strain, the consistent tangent and ``∂p/∂ε`` into ``sig``,
245
+ ``epsp``, ``tan``, ``dp``; returns ``p``."""
246
+ lam, mu = par[0], par[1]
247
+ ee = eps - epsp_old
248
+ tr = ee[0] + ee[1] + ee[2]
249
+ for r in range(6):
250
+ sig[r] = 2.0 * mu * ee[r] + (lam * tr if r < 3 else 0.0)
251
+ for c in range(6):
252
+ tan[r, c] = (2.0 * mu if r == c else 0.0) + (lam if r < 3 and c < 3 else 0.0)
253
+ mean = (sig[0] + sig[1] + sig[2]) / 3.0
254
+ s = sig.copy()
255
+ for r in range(3):
256
+ s[r] -= mean
257
+ q_tr = math.sqrt(1.5 * (s @ s))
258
+ r0, dr0 = _hardening(par, p_old)
259
+ epsp[:] = epsp_old
260
+ dp[:] = 0.0
261
+ if not math.isfinite(q_tr):
262
+ sig[:] = np.nan
263
+ return p_old
264
+ if not q_tr > r0 * (1.0 + 1e-12):
265
+ return p_old
266
+ k, n_exp = par[8], par[9]
267
+ lo, hi = 0.0, q_tr / (3.0 * mu)
268
+ x = min(max((q_tr - r0) / (3.0 * mu + max(dr0, 0.0)), 1e-12 * hi), 0.999 * hi)
269
+ slope = 3.0 * mu
270
+ for _ in range(100):
271
+ rr, dr = _hardening(par, p_old + x)
272
+ g = q_tr - 3.0 * mu * x - rr
273
+ slope = 3.0 * mu + dr
274
+ if k > 0.0:
275
+ rate = x / dt
276
+ g -= k * rate ** (1.0 / n_exp)
277
+ slope += k / (n_exp * dt) * rate ** (1.0 / n_exp - 1.0)
278
+ if abs(g) <= 1e-13 * q_tr:
279
+ break
280
+ if g > 0.0:
281
+ lo = x
282
+ else:
283
+ hi = x
284
+ new = x + g / slope
285
+ if not lo < new < hi:
286
+ new = 0.5 * (lo + hi)
287
+ if abs(new - x) <= 1e-15 * hi:
288
+ x = new
289
+ break
290
+ x = new
291
+ theta = 1.0 / slope
292
+ for r in range(6):
293
+ nr = 1.5 * s[r] / q_tr
294
+ sig[r] -= 2.0 * mu * x * nr
295
+ epsp[r] = epsp_old[r] + x * nr
296
+ dp[r] = 2.0 * mu * theta * nr
297
+ a = (2.0 * mu) ** 2 * theta
298
+ b = (2.0 * mu) ** 2 * x / q_tr
299
+ for r in range(6):
300
+ nr = 1.5 * s[r] / q_tr
301
+ for c in range(6):
302
+ nc = 1.5 * s[c] / q_tr
303
+ dev = (1.0 if r == c else 0.0) - (1.0 / 3.0 if r < 3 and c < 3 else 0.0)
304
+ tan[r, c] -= a * nr * nc + b * (1.5 * dev - nr * nc)
305
+ return p_old + x
306
+
307
+
308
+ @njit(cache=True)
309
+ def point_update(par, eps, epsp_old, p_old, dt):
310
+ """A point (Mandel vectors): returns the effective stress, the plastic strain, ``p``,
311
+ the consistent tangent and ``∂p/∂ε`` (for checks)."""
312
+ sig = np.empty(6)
313
+ epsp = np.empty(6)
314
+ tan = np.empty((6, 6))
315
+ dp = np.empty(6)
316
+ p = _j2_point(par, eps, epsp_old, p_old, dt, sig, epsp, tan, dp)
317
+ return sig, epsp, p, tan, dp
318
+
319
+
320
+ @njit(cache=True)
321
+ def driving_update(par, eps, epsp_old, p_old, e_old, dt):
322
+ """A point with the equivalent plastic strain of the damage (Mandel vectors): returns
323
+ ``e``, the triaxiality ``η`` and ``∂e/∂ε`` (for checks)."""
324
+ sig = np.empty(6)
325
+ epsp = np.empty(6)
326
+ tan = np.empty((6, 6))
327
+ dp = np.empty(6)
328
+ de = np.empty(6)
329
+ p = _j2_point(par, eps, epsp_old, p_old, dt, sig, epsp, tan, dp)
330
+ increment, eta = _driving(par, sig, tan, dp, p - p_old, de)
331
+ return e_old + increment, eta, de
332
+
333
+
334
+ @njit(parallel=True, cache=True)
335
+ def _ductile_chunk(nodes, elements, first, mat, par, finite, values, offset, gp, gw, dt,
336
+ state_old, state_new, fe, ke, tangent): # fmt: skip
337
+ """Element vectors and matrices of the elements ``first...`` (see the module)."""
338
+ r2 = math.sqrt(2.0)
339
+ for ee in prange(fe.shape[0]):
340
+ e = first + ee
341
+ el = elements[e]
342
+ pm = par[mat[e]]
343
+ l2, hs = pm[13], pm[14]
344
+ x = np.empty((4, 3))
345
+ for a in range(4):
346
+ x[a] = nodes[el[a]]
347
+ gl = np.empty((4, 3))
348
+ vol = abs(_corner_gradients(x, gl))
349
+ ul = np.empty((10, 3))
350
+ for a in range(10):
351
+ for i in range(3):
352
+ ul[a, i] = values[offset[el[a]] + i]
353
+ gv = np.empty(4)
354
+ for b in range(4):
355
+ gv[b] = values[offset[el[b]] + 3]
356
+ f = fe[ee]
357
+ f[:] = 0.0
358
+ if tangent:
359
+ ke[ee, :, :] = 0.0
360
+ grad = np.empty((10, 3))
361
+ hu = np.empty((3, 3))
362
+ mu3 = np.empty(3)
363
+ q = np.empty((3, 3))
364
+ eps = np.empty(6)
365
+ sig = np.empty(6)
366
+ epsp = np.empty(6)
367
+ tan = np.empty((6, 6))
368
+ dp6 = np.empty(6)
369
+ de6 = np.empty(6)
370
+ ptil = np.empty((3, 3))
371
+ dpdf = np.empty((9, 9))
372
+ dp9 = np.empty(9)
373
+ for g in range(gp.shape[0]):
374
+ bary = gp[g]
375
+ _shape_gradients(2, gl, bary, grad)
376
+ w = gw[g] * vol
377
+ for i in range(3):
378
+ for j in range(3):
379
+ v = 0.0
380
+ for a in range(10):
381
+ v += ul[a, i] * grad[a, j]
382
+ hu[i, j] = v
383
+ chi = 0.0
384
+ gchi = np.zeros(3)
385
+ for b in range(4):
386
+ chi += bary[b] * gv[b]
387
+ for k in range(3):
388
+ gchi[k] += gv[b] * gl[b, k]
389
+ so = state_old[e, g]
390
+ sn = state_new[e, g]
391
+ if finite:
392
+ if hencky(hu, mu3, q, eps) != 0: # an inverted point: the step is divided
393
+ f[:] = np.nan
394
+ sn[:] = so
395
+ continue
396
+ else:
397
+ eps[0], eps[1], eps[2] = hu[0, 0], hu[1, 1], hu[2, 2]
398
+ eps[3] = (hu[1, 2] + hu[2, 1]) / r2
399
+ eps[4] = (hu[2, 0] + hu[0, 2]) / r2
400
+ eps[5] = (hu[0, 1] + hu[1, 0]) / r2
401
+ p = _j2_point(pm, eps, so[:6], so[6], dt, sig, epsp, tan, dp6)
402
+ increment, eta = _driving(pm, sig, tan, dp6, p - so[6], de6)
403
+ e_drive = so[9] + increment
404
+ if finite:
405
+ pull_back(hu, mu3, q, sig, tan, de6, ptil, dpdf, dp9)
406
+ else:
407
+ for i in range(3):
408
+ for j in range(3):
409
+ a6 = MAP[i, j]
410
+ ptil[i, j] = sig[a6] / W[a6]
411
+ dp9[3 * i + j] = de6[a6] / W[a6]
412
+ for qq in range(3):
413
+ for rr in range(3):
414
+ b6 = MAP[qq, rr]
415
+ dpdf[3 * i + j, 3 * qq + rr] = tan[a6, b6] / (W[a6] * W[b6])
416
+ kappa_old = so[7]
417
+ loading = chi > kappa_old
418
+ kappa = chi if loading else kappa_old
419
+ d, dd = _damage_law(pm, kappa)
420
+ if not loading:
421
+ dd = 0.0
422
+ sn[:6] = epsp
423
+ sn[6] = p
424
+ sn[7] = kappa
425
+ sn[8] = d
426
+ sn[9] = e_drive
427
+ sn[10] = eta
428
+ for a in range(10):
429
+ for i in range(3):
430
+ v = 0.0
431
+ for j in range(3):
432
+ v += ptil[i, j] * grad[a, j]
433
+ f[3 * a + i] += w * (1.0 - d) * v
434
+ for b in range(4):
435
+ dot = gchi[0] * gl[b, 0] + gchi[1] * gl[b, 1] + gchi[2] * gl[b, 2]
436
+ f[30 + b] += w * hs * ((chi - e_drive) * bary[b] + l2 * dot)
437
+ if not tangent:
438
+ continue
439
+ kk = ke[ee]
440
+ for a in range(10):
441
+ for i in range(3):
442
+ for c in range(10):
443
+ for qq in range(3):
444
+ v = 0.0
445
+ for j in range(3):
446
+ for rr in range(3):
447
+ v += grad[a, j] * dpdf[3 * i + j, 3 * qq + rr] * grad[c, rr]
448
+ kk[3 * a + i, 3 * c + qq] += w * (1.0 - d) * v
449
+ v = 0.0
450
+ for j in range(3):
451
+ v += grad[a, j] * ptil[i, j]
452
+ for b in range(4):
453
+ kk[3 * a + i, 30 + b] -= w * dd * v * bary[b]
454
+ for qq in range(3):
455
+ v = 0.0
456
+ for rr in range(3):
457
+ v += dp9[3 * qq + rr] * grad[a, rr]
458
+ for b in range(4):
459
+ kk[30 + b, 3 * a + qq] -= w * hs * bary[b] * v
460
+ for b in range(4):
461
+ for c in range(4):
462
+ dot = gl[b, 0] * gl[c, 0] + gl[b, 1] * gl[c, 1] + gl[b, 2] * gl[c, 2]
463
+ kk[30 + b, 30 + c] += w * hs * (bary[b] * bary[c] + l2 * dot)
464
+
465
+
466
+ class DuctileProblem(MixedProblem):
467
+ """A body of :class:`MicromorphicDuctile` materials (one for every phase, or a dict of
468
+ the phases), in ``"small"`` or ``"finite"`` strains: its generalized degree of freedom
469
+ (component :data:`CHI` = 3 of the corner nodes) is ``χ``, the micromorphic cumulated
470
+ plastic strain of the damage (the counterpart of ``e``, the plastic strain weighted by
471
+ the triaxiality)."""
472
+
473
+ def __init__(self, mesh: TetMesh, materials, *, kinematics: str = "small"):
474
+ if kinematics not in ("small", "finite"):
475
+ raise ValueError("kinematics: 'small' or 'finite'")
476
+ if isinstance(materials, MicromorphicDuctile):
477
+ materials = {int(p): materials for p in np.unique(mesh.phase)}
478
+ self.space = MixedSpace(mesh, 1)
479
+ self.mesh = self.space.mesh
480
+ self.finite = kinematics == "finite"
481
+ phases = sorted(materials)
482
+ if not np.isin(self.mesh.phase, phases).all():
483
+ raise ValueError("DuctileProblem: a material for every phase of the mesh")
484
+ index = {p: k for k, p in enumerate(phases)}
485
+ self.materials = materials
486
+ self._mat = np.array([index[int(p)] for p in self.mesh.phase], dtype=np.int64)
487
+ self._par = np.array([materials[p].parameters() for p in phases])
488
+
489
+ def run(
490
+ self, prescribed, load: float = 1.0, *, predictor: bool = True, **options
491
+ ) -> PathResult:
492
+ """:meth:`~morphogen.micromorphic.space.MixedProblem.run`, by default with its
493
+ ``predictor`` (the iterations of a step from the increment that the last tangent
494
+ predicts: points yielding along the loaded boundary would stall them)."""
495
+ return super().run(prescribed, load, predictor=predictor, **options)
496
+
497
+ def _initial_state(self):
498
+ return np.zeros((self.mesh.n_elements, len(WEIGHTS), N_STATE))
499
+
500
+ def _assemble(self, values, state, tangent):
501
+ space = self.space
502
+ n_el = self.mesh.n_elements
503
+ rhs = np.zeros(space.n_dofs)
504
+ data = space.new_matrix_data() if tangent else np.zeros(0)
505
+ new_state = np.empty_like(state)
506
+ n_loc = space.n_local
507
+ dt = float(getattr(self, "_dt", 1.0))
508
+ for first in range(0, n_el, CHUNK):
509
+ count = min(CHUNK, n_el - first)
510
+ fe = np.empty((count, n_loc))
511
+ ke = np.empty((count, n_loc, n_loc)) if tangent else np.empty((count, 1, 1))
512
+ _ductile_chunk(self.mesh.nodes, space.elements, first, self._mat, self._par,
513
+ self.finite, values, space.offset, POINTS, WEIGHTS, dt, state,
514
+ new_state, fe, ke, tangent) # fmt: skip
515
+ space.add(first, ke, fe, data, rhs)
516
+ return rhs, (data if tangent else None), new_state
517
+
518
+ def damage(self, state) -> np.ndarray:
519
+ """The damage of the elements (the mean of their points)."""
520
+ return state[:, :, 8].mean(axis=1)
521
+
522
+ def plastic_strain(self, state) -> np.ndarray:
523
+ """The cumulated plastic strain of the elements (the mean of their points)."""
524
+ return state[:, :, 6].mean(axis=1)
525
+
526
+ def driving(self, state) -> np.ndarray:
527
+ """The equivalent plastic strain of the damage ``e`` of the elements (the mean of
528
+ their points)."""
529
+ return state[:, :, 9].mean(axis=1)
530
+
531
+ def triaxiality(self, state) -> np.ndarray:
532
+ """The triaxiality of the effective stress of the elements at their last plastic
533
+ step (the mean of their points)."""
534
+ return state[:, :, 10].mean(axis=1)