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,349 @@
1
+ """The bulk of the crack problems by the behaviours of morphoGen's points: von Mises
2
+ elasto-(visco)plasticity (logarithmic strains in finite strains), porous plasticity (GTN,
3
+ Rousselier, elliptic: :mod:`morphogen.homogenization.porous`, the ductile damage of metals
4
+ by the growth of their voids), crystal plasticity (multiplicative in finite strains, each
5
+ grain turned by its orientation) and MFront laws through MGIS, in small and finite
6
+ strains, with their internal variables.
7
+
8
+ The points are those of the nonlinear finite elements of the homogenization
9
+ (:mod:`morphogen.homogenization.nonlinear`, :mod:`morphogen.homogenization.finite`): one
10
+ per linear tetrahedron, integrated implicitly over each step from the internal variables
11
+ committed at the end of the previous converged step, with their consistent tangents,
12
+ assembled into the nodal forces ``∫ Bᵀ σ dV`` (``∫ P · ∇N dV_0`` in finite strains) and the
13
+ tangent stiffness of the Newton solver of :class:`~morphogen.fracture.cohesive.
14
+ CohesiveProblem`.
15
+
16
+ Energies (per unit reference volume, at the committed state):
17
+
18
+ * the *work* density ``w = ∫ P : dF`` (``∫ σ : dε``), accumulated over the converged steps
19
+ by the trapezoidal rule: the stored and dissipated energies together, the energy
20
+ density of the deformation theory of plasticity; summed over the body it is the work
21
+ of the loads;
22
+ * the *free* energy ``ψ``: elastic, ``1/2 σ : C⁻¹ : σ`` in small strains, ``1/2 T : (ε - εᵖ)``
23
+ with the stress ``T`` conjugate to the logarithmic strain ``ε`` for von Mises points in
24
+ finite strains, ``1/2 Sₑ : Eₑ`` of the elastic Green-Lagrange strain of ``Fₑ = F Fₚ⁻¹`` for
25
+ crystals; and the energy stored by hardening: ``1/2 H p² + Σ Q (p - (1 - e^(-b p)) / b)``
26
+ and ``Σ 3/(4 C) X : X`` for von Mises points (``∂ψ/∂p = R(p)``, ``∂ψ/∂X = 3 X / 2C``),
27
+ ``Σ C α²/2`` of the kinematic hardening of the slip systems of crystals (their isotropic
28
+ hardening is counted as dissipated, and so is the hardening of the matrix of porous
29
+ points, isotropic and kinematic, whose plastic strain enters the elastic energy as that
30
+ of von Mises points).
31
+ MFront laws have none (NaN).
32
+
33
+ The configurational forces of the internal variables (:meth:`PointBulk.configurational`):
34
+ ``Div (ψ I - Hᵀ P) = ∂ψ/∂α · ∇α`` in a homogeneous body (``P = ∂ψ/∂F`` at fixed internal
35
+ variables ``α``), with ``∂ψ/∂εᵖ = -σ`` (``-T``), ``∂ψ/∂Fₚ⁻¹ = Fᵀ Fₑ Sₑ`` for crystals, and the
36
+ derivatives of the stored energies above; the gradients of the internal variables (one
37
+ value per element) come from their projection on the nodes (volume-weighted means of
38
+ the elements around each node, the two lips of a crack apart, and on the crack meshes of a
39
+ morphology its materials apart: a node of their interfaces has a value for each).
40
+ """
41
+
42
+ from __future__ import annotations
43
+
44
+ import math
45
+
46
+ import numpy as np
47
+ import scipy.sparse as sp
48
+
49
+ from morphogen.homogenization import finite as fin
50
+ from morphogen.homogenization.behaviours import (
51
+ _KIN,
52
+ CRYSTAL,
53
+ HILL,
54
+ MAX_ISOTROPIC,
55
+ MAX_KINEMATIC,
56
+ MFRONT,
57
+ PLASTIC,
58
+ STATE_P,
59
+ STATE_X,
60
+ )
61
+ from morphogen.homogenization.crystal import CP_ALPHA
62
+ from morphogen.homogenization.fe import GAUSS, _expand_columns, element_colours, node_pattern
63
+ from morphogen.homogenization.materials import material_table
64
+ from morphogen.homogenization.nonlinear import (
65
+ _fill_tangent,
66
+ _internal_forces,
67
+ _point_strains,
68
+ _update,
69
+ behaviour_table,
70
+ external_points,
71
+ )
72
+ from morphogen.mesh.tetra import TetMesh
73
+
74
+ #: Weights of the Voigt components (tensor shears) in the double contraction of symmetric
75
+ #: tensors
76
+ _TWICE = np.array([1.0, 1.0, 1.0, 2.0, 2.0, 2.0])
77
+
78
+
79
+ def nonlinear_materials(materials, phases) -> bool:
80
+ """Whether a phase among ``phases`` has an inelastic behaviour (von Mises, porous or
81
+ crystal plasticity, MFront, a learned law)."""
82
+ for p in np.unique(phases):
83
+ m = materials.get(int(p))
84
+ if m is None or m.void:
85
+ continue
86
+ if m.nonlinear:
87
+ return True
88
+ return False
89
+
90
+
91
+ def _tensor(voigt) -> np.ndarray:
92
+ """Symmetric 3 x 3 tensors (..., 3, 3) of Voigt components with tensor shears."""
93
+ v = np.asarray(voigt, dtype=float)
94
+ out = np.empty((*v.shape[:-1], 3, 3))
95
+ for k, (a, b) in enumerate(((0, 0), (1, 1), (2, 2), (1, 2), (2, 0), (0, 1))):
96
+ out[..., a, b] = v[..., k]
97
+ out[..., b, a] = v[..., k]
98
+ return out
99
+
100
+
101
+ def _tet_gradients(nodes, elements):
102
+ """Gradients of the shape functions (elements x 4 x 3) and volumes of linear
103
+ tetrahedra."""
104
+ x = nodes[elements]
105
+ dm = np.stack([x[:, 1] - x[:, 0], x[:, 2] - x[:, 0], x[:, 3] - x[:, 0]], axis=2)
106
+ inv = np.linalg.inv(dm)
107
+ grads = np.concatenate([-inv.sum(axis=1, keepdims=True), inv], axis=1)
108
+ return grads, np.abs(np.linalg.det(dm)) / 6.0
109
+
110
+
111
+ class PointBulk:
112
+ """The bulk of a crack problem (see the module): a mesh of linear tetrahedra, the
113
+ materials of its phases (an orientation per grain of ``mesh.cell`` from
114
+ ``mesh.orientations``) and the kinematics; :meth:`evaluate` integrates the points for a
115
+ displacement, :meth:`commit` keeps their state at the end of a converged step."""
116
+
117
+ def __init__(self, mesh: TetMesh, materials, finite: bool):
118
+ if mesh.order != 1:
119
+ raise ValueError("PointBulk: linear tetrahedra")
120
+ self.mesh, self.finite = mesh, bool(finite)
121
+ self.materials = materials
122
+ self.table = material_table(mesh.phase, materials, "elastic", grains=mesh.cell,
123
+ orientations=mesh.orientations) # fmt: skip
124
+ if np.any(self.table.mat < 0):
125
+ raise ValueError("PointBulk: void phases (remove their elements from the mesh)")
126
+ beh = behaviour_table(mesh.phase, materials, self.table, finite=self.finite)
127
+ self.behaviours = beh
128
+ self.gp, self.gw = GAUSS[1] # one point per element
129
+ self.kind = np.ascontiguousarray(beh.kind)
130
+ self.pmat = np.ascontiguousarray(beh.pmat)
131
+ self.mat = np.ascontiguousarray(self.table.mat)
132
+ n, nc = mesh.n_elements, 9 if self.finite else 6
133
+ self.grads = np.zeros((n, nc))
134
+ self.wts = np.zeros(n)
135
+ self.stress = np.zeros((n, nc))
136
+ self.tangent = np.zeros((n, nc, nc))
137
+ self.old = np.zeros((n, beh.width))
138
+ self.new = np.zeros((n, beh.width))
139
+ self.work = np.zeros(n)
140
+ self.committed_stress = np.zeros((n, nc))
141
+ self.committed_grads = np.zeros((n, nc))
142
+ self.indptr_n, self.indices_n = node_pattern(mesh.elements, mesh.n_nodes)
143
+ self.by_colour, self.colours = element_colours(mesh.elements, mesh.n_nodes)
144
+ self.data = np.zeros(9 * int(self.indptr_n[-1]))
145
+ self.indices = _expand_columns(self.indptr_n, self.indices_n, 3)
146
+ lengths = np.repeat(np.diff(self.indptr_n) * 3, 3)
147
+ self.indptr = np.zeros(3 * mesh.n_nodes + 1, dtype=np.int64)
148
+ np.cumsum(lengths, out=self.indptr[1:])
149
+ self.nodal = np.zeros(3 * mesh.n_nodes)
150
+ # MFront behaviours (MGIS) and learned laws (their models)
151
+ self._mfront = external_points(beh.mfront, self.kind, self.pmat, self.mat,
152
+ self.table.rotations, self.finite) # fmt: skip
153
+
154
+ @property
155
+ def n_dofs(self) -> int:
156
+ return 3 * self.mesh.n_nodes
157
+
158
+ def reset(self) -> None:
159
+ """The natural state: no strain, no internal variable, no work."""
160
+ for a in (self.old, self.new, self.work, self.committed_stress, self.committed_grads):
161
+ a[...] = 0.0
162
+
163
+ def evaluate(self, u, dt: float, tangent: bool):
164
+ """Nodal forces (all dofs) and, with ``tangent``, the tangent stiffness (CSR) of
165
+ the bulk for the displacement ``u`` (flat) at the end of a step ``dt`` from the
166
+ committed state; None if the integration of a point fails."""
167
+ m = self.mesh
168
+ kernel = fin.point_gradients if self.finite else _point_strains
169
+ kernel(m.nodes, m.elements, 1, np.ascontiguousarray(u, dtype=float), self.gp, self.gw,
170
+ self.grads, self.wts) # fmt: skip
171
+ failed = _update(self.finite, self.kind, self.mat, self.pmat, self.behaviours.data,
172
+ self.grads, 0.0, float(dt), self.old, self.new, self.stress,
173
+ self.tangent, 0, 1.0) # fmt: skip
174
+ if self._mfront is not None:
175
+ failed += self._mfront.integrate(self.grads, 0.0, float(dt), self.old, self.new,
176
+ self.stress, self.tangent) # fmt: skip
177
+ if failed:
178
+ return None
179
+ forces = fin.internal_forces if self.finite else _internal_forces
180
+ forces(m.nodes, m.elements, 1, self.gp, self.stress, self.wts, self.by_colour,
181
+ self.colours, self.nodal) # fmt: skip
182
+ k = None
183
+ if tangent:
184
+ fill = fin.fill_tangent if self.finite else _fill_tangent
185
+ fill(m.nodes, m.elements, 1, self.gp, self.tangent, self.wts, self.indptr_n,
186
+ self.indices_n, self.by_colour, self.colours, self.data) # fmt: skip
187
+ n = self.n_dofs
188
+ k = sp.csr_matrix((self.data.copy(), self.indices, self.indptr), shape=(n, n))
189
+ return self.nodal.copy(), k
190
+
191
+ def commit(self) -> None:
192
+ """Keep the state of the last evaluation (the end of a converged step) and add the
193
+ work of the step (trapezoidal rule)."""
194
+ increment = self.grads - self.committed_grads
195
+ self.work += 0.5 * np.einsum("ij,ij->i", self.committed_stress + self.stress, increment)
196
+ self.committed_stress[...] = self.stress
197
+ self.committed_grads[...] = self.grads
198
+ self.old, self.new = self.new, self.old
199
+
200
+ # -- energies ------------------------------------------------------------------------
201
+
202
+ def stress_tensors(self) -> np.ndarray:
203
+ """The committed stresses as 3 x 3 tensors (first Piola-Kirchhoff in finite
204
+ strains, Cauchy in small strains)."""
205
+ if self.finite:
206
+ return self.committed_stress.reshape(-1, 3, 3).copy()
207
+ return _tensor(self.committed_stress)
208
+
209
+ def _elastic(self):
210
+ """The elastic free energy of every point, and the conjugate of the plastic strain
211
+ (``-σ`` or ``-T``, tensor components) or of ``Fₚ⁻¹`` (9) of the crystals."""
212
+ matrices = self.behaviours.data[0]
213
+ state = self.old
214
+ n = self.mesh.n_elements
215
+ psi = np.zeros(n)
216
+ conjugate = np.zeros((n, 9))
217
+ crystal = self.kind == CRYSTAL
218
+ if not self.finite:
219
+ compliance = np.linalg.inv(matrices)
220
+ sig = self.committed_stress
221
+ strain = np.einsum("eij,ej->ei", compliance[self.mat], sig) # engineering
222
+ psi = 0.5 * np.einsum("ei,ei->e", sig, strain)
223
+ conjugate[:, :6] = -sig
224
+ return psi, conjugate
225
+ others = ~crystal
226
+ if np.any(others):
227
+ log = fin.log_strain(self.committed_grads[others]) # engineering
228
+ plastic = state[others, :6] * _TWICE
229
+ elastic = log - plastic
230
+ t = np.einsum("eij,ej->ei", matrices[self.mat[others]], elastic)
231
+ psi[others] = 0.5 * np.einsum("ei,ei->e", t, elastic)
232
+ conjugate[others, :6] = -t
233
+ if np.any(crystal):
234
+ ns = self.behaviours.data[7][self.pmat[crystal]]
235
+ off = CP_ALPHA + 2 * ns
236
+ rows = np.flatnonzero(crystal)
237
+ g = np.stack([state[i, o : o + 9] for i, o in zip(rows, off, strict=True)])
238
+ g = g.reshape(-1, 3, 3) + np.eye(3)
239
+ f = self.committed_grads[crystal].reshape(-1, 3, 3) + np.eye(3)
240
+ fe = f @ g
241
+ ee = 0.5 * (np.swapaxes(fe, 1, 2) @ fe - np.eye(3))
242
+ e6 = fin._voigt(ee) * _TWICE # engineering
243
+ s6 = np.einsum("eij,ej->ei", matrices[self.mat[crystal]], e6)
244
+ psi[crystal] = 0.5 * np.einsum("ei,ei->e", s6, e6)
245
+ conjugate[crystal] = (np.swapaxes(f, 1, 2) @ fe @ _tensor(s6)).reshape(-1, 9)
246
+ return psi, conjugate
247
+
248
+ def _hardening(self):
249
+ """The energy stored by hardening of every point and the list of the hardening
250
+ variables with their conjugates (``∂ψ/∂α``): (values, conjugates) per point."""
251
+ data = self.behaviours.data
252
+ params, nk, cp_par, cp_n = data[2], data[3], data[5], data[7]
253
+ state = self.old
254
+ n = self.mesh.n_elements
255
+ psi = np.zeros(n)
256
+ variables = []
257
+ plastic = (self.kind == PLASTIC) | (self.kind == HILL) # the same hardenings
258
+ if np.any(plastic):
259
+ par = params[self.pmat[plastic]]
260
+ p = state[plastic, STATE_P]
261
+ h = par[:, 3]
262
+ stored = 0.5 * h * p * p
263
+ force = h * p
264
+ for i in range(MAX_ISOTROPIC):
265
+ q, b = par[:, 6 + 2 * i], par[:, 7 + 2 * i]
266
+ safe = np.where(b > 0, b, 1.0)
267
+ decay = np.exp(-safe * p)
268
+ stored += np.where(q != 0, q * (p - (1.0 - decay) / safe), 0.0)
269
+ force += np.where(q != 0, q * (1.0 - decay), 0.0)
270
+ values = np.zeros((n, 1 + 6 * MAX_KINEMATIC))
271
+ forces = np.zeros_like(values)
272
+ values[plastic, 0] = p
273
+ forces[plastic, 0] = force
274
+ for k in range(min(nk, MAX_KINEMATIC)):
275
+ c = par[:, _KIN + 2 * k]
276
+ x = state[plastic, STATE_X + 6 * k : STATE_X + 6 * k + 6]
277
+ inverse = np.where(c > 0, 1.0 / np.where(c > 0, c, 1.0), 0.0)
278
+ stored += 0.75 * inverse * np.einsum("ei,ei->e", x * _TWICE, x)
279
+ values[plastic, 1 + 6 * k : 7 + 6 * k] = x
280
+ forces[plastic, 1 + 6 * k : 7 + 6 * k] = 1.5 * inverse[:, None] * x * _TWICE
281
+ psi[plastic] = stored
282
+ variables.append((values, forces))
283
+ crystal = self.kind == CRYSTAL
284
+ if np.any(crystal):
285
+ n_max = cp_par.shape[1]
286
+ values = np.zeros((n, n_max))
287
+ forces = np.zeros_like(values)
288
+ for i in np.flatnonzero(crystal):
289
+ c = self.pmat[i]
290
+ ns = int(cp_n[c])
291
+ alpha = state[i, CP_ALPHA : CP_ALPHA + ns]
292
+ stiff = cp_par[c, :ns, 3]
293
+ psi[i] = 0.5 * float(stiff @ (alpha * alpha))
294
+ values[i, :ns] = alpha
295
+ forces[i, :ns] = stiff * alpha
296
+ variables.append((values, forces))
297
+ return psi, variables
298
+
299
+ def free_energy(self) -> np.ndarray:
300
+ """The free energy density of every point (see the module; NaN for MFront)."""
301
+ elastic, _ = self._elastic()
302
+ stored, _ = self._hardening()
303
+ psi = elastic + stored
304
+ psi[self.kind == MFRONT] = math.nan
305
+ return psi
306
+
307
+ def configurational(self) -> np.ndarray:
308
+ """``Div (ψ I - Hᵀ P) = ∂ψ/∂α · ∇α`` of every element (elements x 3; see the
309
+ module)."""
310
+ if np.any(self.kind == MFRONT):
311
+ raise ValueError("configurational forces: no free energy of MFront laws")
312
+ m = self.mesh
313
+ grads, volumes = _tet_gradients(m.nodes, m.elements)
314
+ _, conjugate = self._elastic()
315
+ state = self.old
316
+ plastic_strain = np.zeros((m.n_elements, 9))
317
+ crystal = self.kind == CRYSTAL
318
+ if self.finite and np.any(crystal):
319
+ ns = self.behaviours.data[7][self.pmat[crystal]]
320
+ off = CP_ALPHA + 2 * ns
321
+ rows = np.flatnonzero(crystal)
322
+ plastic_strain[crystal] = np.stack(
323
+ [state[i, o : o + 9] for i, o in zip(rows, off, strict=True)]
324
+ )
325
+ others = ~crystal if self.finite else np.ones(m.n_elements, dtype=bool)
326
+ plastic_strain[others, :6] = state[others, :6] * _TWICE # tensor contraction weights
327
+ pairs = [(plastic_strain, conjugate)]
328
+ _, variables = self._hardening()
329
+ pairs += variables
330
+ out = np.zeros((m.n_elements, 3))
331
+ if m.side is None:
332
+ groups = np.zeros(m.n_elements, dtype=np.int64)
333
+ else: # a crack mesh of a morphology: the materials apart
334
+ from morphogen.fracture.mixed import material_groups
335
+
336
+ groups = material_groups(m.phase, self.materials)
337
+ for g in np.unique(groups):
338
+ sel = np.flatnonzero(groups == g)
339
+ corners = m.elements[sel]
340
+ weight = np.bincount(corners.ravel(), np.repeat(volumes[sel], 4), minlength=m.n_nodes)
341
+ weight = np.where(weight > 0, weight, 1.0)
342
+ for values, forces in pairs:
343
+ nodal = np.zeros((m.n_nodes, values.shape[1]))
344
+ for a in range(4):
345
+ np.add.at(nodal, corners[:, a], volumes[sel, None] * values[sel])
346
+ nodal /= weight[:, None]
347
+ gradient = np.einsum("eac,eak->eck", nodal[corners], grads[sel])
348
+ out[sel] += np.einsum("ec,eck->ek", forces[sel], gradient)
349
+ return out