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,359 @@
1
+ """A micromorphic damage model to crack with: cracks as localized bands of damage, whose
2
+ width a length sets independently of the elements, in small and finite strains (Forest
3
+ 2009, the micromorphic approach; the implicit gradient model of Peerlings, de Borst,
4
+ Brekelmans & de Vree 1996).
5
+
6
+ *Model.* A scalar micromorphic variable ``χ`` (a degree of freedom), the micromorphic
7
+ counterpart of a local equivalent strain ``ε_eq``, with the free energy ``ψ = (1 - d(κ))
8
+ w(ε) + H/2 (χ - ε_eq(ε))² + H ℓ²/2 |∇χ|²`` (``w`` the elastic energy) and the
9
+ generalized balance ``div b - a = 0`` of its stresses ``a = ∂ψ/∂χ = H (χ - ε_eq)`` and ``b =
10
+ ∂ψ/∂∇χ = H ℓ² ∇χ``: the Helmholtz equation ``χ - ℓ² Δχ = ε_eq`` of the implicit gradient
11
+ model (for any penalty ``H``), with ``∇χ · n = 0`` on the boundary. The damage follows
12
+ the largest value of ``χ``, ``κ = max χ``: ``d = 1 - (κ0/κ) (1 - α + α exp(-β (κ - κ0)))``
13
+ beyond the threshold ``κ0`` (Peerlings et al. 1998), at most ``d_max``. The stress is that
14
+ of Peerlings et al., ``σ = (1 - d) C : ε``; the derivative of the free energy, ``(1 - d) C
15
+ : ε - H (χ - ε_eq) ∂ε_eq/∂ε`` (``variational``), keeps in the band the stiffness of the
16
+ penalty, which does not degrade: a bar then damages throughout instead of localizing
17
+ (stress locking), unless ``H`` is small. The
18
+ equivalent strain is the modified von Mises one (de Vree et al. 1995), ``ε_eq = (k - 1)
19
+ I1 / (2k (1 - 2ν)) + sqrt(((k - 1) I1 / (1 - 2ν))² + 12 k J2 / (1 + ν)²) / (2k)``, the
20
+ uniaxial strain in tension and ``1/k`` of it in compression.
21
+
22
+ *Finite strains* (total Lagrangian): the compressible neo-Hookean energy ``w = μ/2 (I1 -
23
+ 3) - μ ln J + λ/2 (ln J)²`` and the equivalent strain of the Green-Lagrange strain ``E``,
24
+ so that ``P = (1 - d) P0(F) - H (χ - ε_eq) F ∂ε_eq/∂E``.
25
+
26
+ *Elements* (:mod:`morphogen.micromorphic.space`): quadratic displacements and a linear
27
+ ``χ``, one order lower, as Peerlings et al. recommend (equal orders make the stresses
28
+ oscillate); the tangent, with the derivative of the damage, is not symmetric.
29
+ """
30
+
31
+ from __future__ import annotations
32
+
33
+ import math
34
+ from dataclasses import dataclass
35
+
36
+ import numpy as np
37
+ from numba import njit, prange
38
+
39
+ from morphogen.homogenization.fe import _corner_gradients, _shape_gradients
40
+ from morphogen.mesh.tetra import TetMesh
41
+ from morphogen.micromorphic.microfoam import _MAP, _W
42
+ from morphogen.micromorphic.space import CHUNK, POINTS, WEIGHTS, MixedProblem, MixedSpace
43
+
44
+ #: The internal variables of a point: κ and d
45
+ N_STATE = 2
46
+ #: The generalized degree of freedom: the micromorphic equivalent strain
47
+ CHI = 3
48
+
49
+
50
+ @dataclass(frozen=True)
51
+ class MicromorphicDamage:
52
+ """A material of the micromorphic damage model (see the module): elasticity
53
+ ``young`` and ``poisson``; the damage ``threshold`` κ0, ``alpha`` and ``beta``, the
54
+ strength ratio ``ratio`` k of the equivalent strain and the largest damage
55
+ ``max_damage``; the ``length`` ℓ, the ``penalty`` H (by default ``young``, which scales
56
+ the equation of ``χ`` only) and ``variational`` (the coupling term of the stress: see
57
+ the module)."""
58
+
59
+ young: float
60
+ poisson: float
61
+ threshold: float
62
+ length: float
63
+ alpha: float = 0.99
64
+ beta: float = 300.0
65
+ ratio: float = 10.0
66
+ max_damage: float = 0.9999
67
+ penalty: float | None = None
68
+ variational: bool = False
69
+
70
+ def __post_init__(self) -> None:
71
+ if not (self.young > 0 and -1 < self.poisson < 0.5 and self.threshold > 0):
72
+ raise ValueError("MicromorphicDamage: positive young and threshold, -1 < poisson < 0.5")
73
+ if not (self.length > 0 and self.ratio >= 1 and 0 < self.max_damage < 1):
74
+ raise ValueError("MicromorphicDamage: positive length, ratio >= 1, 0 < max_damage < 1")
75
+
76
+ def parameters(self) -> np.ndarray:
77
+ h = self.young if self.penalty is None else float(self.penalty)
78
+ lam = self.young * self.poisson / ((1 + self.poisson) * (1 - 2 * self.poisson))
79
+ mu = self.young / (2 * (1 + self.poisson))
80
+ coupling = h if self.variational else 0.0
81
+ return np.array([lam, mu, self.poisson, self.threshold, self.alpha, self.beta, self.ratio,
82
+ self.max_damage, self.length**2, h, coupling]) # fmt: skip
83
+
84
+ def damage(self, kappa) -> np.ndarray:
85
+ """``d(κ)`` of the damage law."""
86
+ k = np.maximum(np.asarray(kappa, dtype=float), self.threshold)
87
+ d = 1 - self.threshold / k * (
88
+ 1 - self.alpha + self.alpha * np.exp(-self.beta * (k - self.threshold))
89
+ )
90
+ return np.minimum(d, self.max_damage)
91
+
92
+
93
+ @njit(cache=True)
94
+ def _damage_law(par, kappa):
95
+ """``d(κ)`` and ``d'(κ)``."""
96
+ k0, alpha, beta, dmax = par[3], par[4], par[5], par[7]
97
+ if kappa <= k0:
98
+ return 0.0, 0.0
99
+ ex = math.exp(-beta * (kappa - k0))
100
+ d = 1.0 - k0 / kappa * (1.0 - alpha + alpha * ex)
101
+ if d >= dmax:
102
+ return dmax, 0.0
103
+ dd = k0 / (kappa * kappa) * (1.0 - alpha + alpha * ex) + k0 / kappa * alpha * beta * ex
104
+ return d, dd
105
+
106
+
107
+ @njit(cache=True)
108
+ def _equivalent(par, eps, grad, hess):
109
+ """The modified von Mises equivalent strain of a strain (Mandel), its gradient and
110
+ its Hessian (Mandel)."""
111
+ nu, k = par[2], par[6]
112
+ a = (k - 1.0) / (2.0 * k * (1.0 - 2.0 * nu))
113
+ c = (k - 1.0) / (1.0 - 2.0 * nu)
114
+ g = 12.0 * k / (1.0 + nu) ** 2
115
+ i1 = eps[0] + eps[1] + eps[2]
116
+ dev = eps.copy()
117
+ for i in range(3):
118
+ dev[i] -= i1 / 3.0
119
+ j2 = 0.5 * (dev @ dev)
120
+ small = (1e-9 * par[3]) ** 2
121
+ r = math.sqrt(c * c * i1 * i1 + g * j2 + small)
122
+ q = np.empty(6)
123
+ for i in range(6):
124
+ q[i] = 0.5 * g * dev[i] + (c * c * i1 if i < 3 else 0.0)
125
+ for i in range(6):
126
+ grad[i] = (a if i < 3 else 0.0) + q[i] / (2.0 * k * r)
127
+ for i in range(6):
128
+ for j in range(6):
129
+ v = 0.0
130
+ if i < 3 and j < 3:
131
+ v += c * c - g / 6.0
132
+ if i == j:
133
+ v += 0.5 * g
134
+ hess[i, j] = v / (2.0 * k * r) - q[i] * q[j] / (2.0 * k * r**3)
135
+ return a * i1 + r / (2.0 * k)
136
+
137
+
138
+ @njit(parallel=True, cache=True)
139
+ def _damage_chunk(nodes, elements, first, mat, par, finite, values, offset, gp, gw, state_old,
140
+ state_new, fe, ke, tangent): # fmt: skip
141
+ """Element vectors and matrices of the elements ``first...`` (see the module)."""
142
+ for ee in prange(fe.shape[0]):
143
+ e = first + ee
144
+ el = elements[e]
145
+ pm = par[mat[e]]
146
+ lam, mu, l2, hs, hc = pm[0], pm[1], pm[8], pm[9], pm[10]
147
+ x = np.empty((4, 3))
148
+ for a in range(4):
149
+ x[a] = nodes[el[a]]
150
+ gl = np.empty((4, 3))
151
+ vol = abs(_corner_gradients(x, gl))
152
+ ul = np.empty((10, 3))
153
+ for a in range(10):
154
+ for i in range(3):
155
+ ul[a, i] = values[offset[el[a]] + i]
156
+ gv = np.empty(4)
157
+ for b in range(4):
158
+ gv[b] = values[offset[el[b]] + 3]
159
+ f = fe[ee]
160
+ f[:] = 0.0
161
+ if tangent:
162
+ ke[ee, :, :] = 0.0
163
+ grad = np.empty((10, 3))
164
+ hu = np.empty((3, 3))
165
+ strain = np.empty(6)
166
+ deq = np.empty(6)
167
+ heq = np.empty((6, 6))
168
+ p = np.empty((3, 3))
169
+ duu = np.zeros((3, 3, 3, 3))
170
+ duc = np.empty((3, 3))
171
+ dcu = np.empty((3, 3))
172
+ r2 = math.sqrt(2.0)
173
+ for g in range(gp.shape[0]):
174
+ bary = gp[g]
175
+ _shape_gradients(2, gl, bary, grad)
176
+ w = gw[g] * vol
177
+ for i in range(3):
178
+ for j in range(3):
179
+ v = 0.0
180
+ for a in range(10):
181
+ v += ul[a, i] * grad[a, j]
182
+ hu[i, j] = v
183
+ chi = 0.0
184
+ gchi = np.zeros(3)
185
+ for b in range(4):
186
+ chi += bary[b] * gv[b]
187
+ for k in range(3):
188
+ gchi[k] += gv[b] * gl[b, k]
189
+ if finite: # the Green-Lagrange strain
190
+ fm = np.eye(3) + hu
191
+ cg = fm.T @ fm
192
+ strain[0], strain[1], strain[2] = (
193
+ 0.5 * (cg[0, 0] - 1),
194
+ 0.5 * (cg[1, 1] - 1),
195
+ 0.5 * (cg[2, 2] - 1),
196
+ )
197
+ strain[3], strain[4], strain[5] = cg[1, 2] / r2, cg[2, 0] / r2, cg[0, 1] / r2
198
+ else:
199
+ strain[0], strain[1], strain[2] = hu[0, 0], hu[1, 1], hu[2, 2]
200
+ strain[3] = (hu[1, 2] + hu[2, 1]) / r2
201
+ strain[4] = (hu[2, 0] + hu[0, 2]) / r2
202
+ strain[5] = (hu[0, 1] + hu[1, 0]) / r2
203
+ eq = _equivalent(pm, strain, deq, heq)
204
+ kappa_old = state_old[e, g, 0]
205
+ loading = chi > kappa_old
206
+ kappa = chi if loading else kappa_old
207
+ d, dd = _damage_law(pm, kappa)
208
+ if not loading:
209
+ dd = 0.0
210
+ state_new[e, g, 0] = kappa
211
+ state_new[e, g, 1] = d
212
+ rel = chi - eq
213
+ # the derivative of eq (3 x 3 tensor) and its push forward in finite strains
214
+ gt = np.empty((3, 3))
215
+ for i in range(3):
216
+ for j in range(3):
217
+ k6 = _MAP[i, j]
218
+ gt[i, j] = deq[k6] / _W[k6]
219
+ if finite:
220
+ fm = np.eye(3) + hu
221
+ finv = np.linalg.inv(fm)
222
+ jac = np.linalg.det(fm)
223
+ lnj = math.log(jac) if jac > 0.0 else -30.0
224
+ p0 = mu * (fm - finv.T) + lam * lnj * finv.T
225
+ fg = fm @ gt
226
+ for i in range(3):
227
+ for j in range(3):
228
+ p[i, j] = (1.0 - d) * p0[i, j] - hc * rel * fg[i, j]
229
+ else:
230
+ tr = hu[0, 0] + hu[1, 1] + hu[2, 2]
231
+ p0 = np.empty((3, 3))
232
+ for i in range(3):
233
+ for j in range(3):
234
+ p0[i, j] = mu * (hu[i, j] + hu[j, i]) + (lam * tr if i == j else 0.0)
235
+ p[i, j] = (1.0 - d) * p0[i, j] - hc * rel * gt[i, j]
236
+ fg = gt
237
+ ach = hs * rel
238
+ for a in range(10):
239
+ for i in range(3):
240
+ v = 0.0
241
+ for j in range(3):
242
+ v += p[i, j] * grad[a, j]
243
+ f[3 * a + i] += w * v
244
+ for b in range(4):
245
+ f[30 + b] += w * (
246
+ ach * bary[b]
247
+ + hs * l2 * (gchi[0] * gl[b, 0] + gchi[1] * gl[b, 1] + gchi[2] * gl[b, 2])
248
+ )
249
+ if not tangent:
250
+ continue
251
+ # dP/dgrad u
252
+ for i in range(3):
253
+ for j in range(3):
254
+ for q in range(3):
255
+ for r in range(3):
256
+ a6 = _MAP[i, j]
257
+ b6 = _MAP[q, r]
258
+ v = -hc * rel * heq[a6, b6] / (_W[a6] * _W[b6])
259
+ if finite:
260
+ hv = 0.0
261
+ for bb in range(3):
262
+ for dd2 in range(3):
263
+ hv += (
264
+ fm[i, bb]
265
+ * fm[q, dd2]
266
+ * heq[_MAP[bb, j], _MAP[r, dd2]]
267
+ / (_W[_MAP[bb, j]] * _W[_MAP[r, dd2]])
268
+ )
269
+ v = -hc * rel * (hv + (gt[r, j] if i == q else 0.0))
270
+ c1 = mu - lam * lnj
271
+ v += (1.0 - d) * (
272
+ c1 * finv[r, i] * finv[j, q]
273
+ + lam * finv[j, i] * finv[r, q]
274
+ + (mu if i == q and j == r else 0.0)
275
+ )
276
+ else:
277
+ el6 = 0.0
278
+ if i == j and q == r:
279
+ el6 += lam
280
+ if i == q and j == r:
281
+ el6 += mu
282
+ if i == r and j == q:
283
+ el6 += mu
284
+ v += (1.0 - d) * el6
285
+ v += hc * fg[i, j] * fg[q, r]
286
+ duu[i, j, q, r] = v
287
+ duc[i, j] = -dd * p0[i, j] - hc * fg[i, j]
288
+ dcu[i, j] = -hs * fg[i, j]
289
+ kk = ke[ee]
290
+ for a in range(10):
291
+ for i in range(3):
292
+ for c in range(10):
293
+ for q in range(3):
294
+ v = 0.0
295
+ for j in range(3):
296
+ for r in range(3):
297
+ v += grad[a, j] * duu[i, j, q, r] * grad[c, r]
298
+ kk[3 * a + i, 3 * c + q] += w * v
299
+ v = 0.0
300
+ for j in range(3):
301
+ v += grad[a, j] * duc[i, j]
302
+ for b in range(4):
303
+ kk[3 * a + i, 30 + b] += w * v * bary[b]
304
+ for q in range(3):
305
+ v = 0.0
306
+ for r in range(3):
307
+ v += dcu[q, r] * grad[a, r]
308
+ for b in range(4):
309
+ kk[30 + b, 3 * a + q] += w * bary[b] * v
310
+ for b in range(4):
311
+ for c in range(4):
312
+ dot = gl[b, 0] * gl[c, 0] + gl[b, 1] * gl[c, 1] + gl[b, 2] * gl[c, 2]
313
+ kk[30 + b, 30 + c] += w * hs * (bary[b] * bary[c] + l2 * dot)
314
+
315
+
316
+ class DamageProblem(MixedProblem):
317
+ """A body of :class:`MicromorphicDamage` materials (one for every phase, or a dict of
318
+ the phases), in ``"small"`` or ``"finite"`` strains: its generalized degree of
319
+ freedom (component :data:`CHI` = 3 of the corner nodes) is ``χ``."""
320
+
321
+ def __init__(self, mesh: TetMesh, materials, *, kinematics: str = "small"):
322
+ if kinematics not in ("small", "finite"):
323
+ raise ValueError("kinematics: 'small' or 'finite'")
324
+ if isinstance(materials, MicromorphicDamage):
325
+ materials = {int(p): materials for p in np.unique(mesh.phase)}
326
+ self.space = MixedSpace(mesh, 1)
327
+ self.mesh = self.space.mesh
328
+ self.finite = kinematics == "finite"
329
+ phases = sorted(materials)
330
+ if not np.isin(self.mesh.phase, phases).all():
331
+ raise ValueError("DamageProblem: a material for every phase of the mesh")
332
+ index = {p: k for k, p in enumerate(phases)}
333
+ self.materials = materials
334
+ self._mat = np.array([index[int(p)] for p in self.mesh.phase], dtype=np.int64)
335
+ self._par = np.array([materials[p].parameters() for p in phases])
336
+
337
+ def _initial_state(self):
338
+ return np.zeros((self.mesh.n_elements, len(WEIGHTS), N_STATE))
339
+
340
+ def _assemble(self, values, state, tangent):
341
+ space = self.space
342
+ n_el = self.mesh.n_elements
343
+ rhs = np.zeros(space.n_dofs)
344
+ data = space.new_matrix_data() if tangent else np.zeros(0)
345
+ new_state = np.empty_like(state)
346
+ n_loc = space.n_local
347
+ for first in range(0, n_el, CHUNK):
348
+ count = min(CHUNK, n_el - first)
349
+ fe = np.empty((count, n_loc))
350
+ ke = np.empty((count, n_loc, n_loc)) if tangent else np.empty((count, 1, 1))
351
+ _damage_chunk(self.mesh.nodes, space.elements, first, self._mat, self._par, self.finite,
352
+ values, space.offset, POINTS, WEIGHTS, state, new_state, fe, ke,
353
+ tangent) # fmt: skip
354
+ space.add(first, ke, fe, data, rhs)
355
+ return rhs, (data if tangent else None), new_state
356
+
357
+ def damage(self, state) -> np.ndarray:
358
+ """The damage of the elements (the mean of their points)."""
359
+ return state[:, :, 1].mean(axis=1)