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,263 @@
1
+ """Cleavage by the local approach: the Weibull stress of Beremin (1983) on the fields of a
2
+ loading path (:func:`path_beremin`).
3
+
4
+ Cleavage starts at microcracks that the plastic strain nucleates, the weakest of which
5
+ gives way: the probability that a volume ``V`` under a stress ``sigma`` breaks is that of
6
+ its weakest link, and for a field of stresses::
7
+
8
+ P_f = 1 - exp(-(sigma_w / sigma_u)^m), sigma_w^m = sum_i <sigma_i>^m V_i / V_0,
9
+
10
+ with ``sigma_w`` the Weibull stress, the sum over the points of the plastic zone (their
11
+ volumes ``V_i``), ``m`` the modulus of Weibull, ``sigma_u`` the scale of the cleavage
12
+ stresses of the reference volume ``V_0``. The stress ``sigma_i`` that drives the cleavage
13
+ of a point is its largest principal stress (the original criterion, for polycrystals
14
+ whose grains are smaller than the points), or, where the points are those of the grains
15
+ of a polycrystal, the largest normal stress of the cleavage planes of their crystal
16
+ (:data:`~morphogen.homogenization.crystal.CLEAVAGE`): {100} in ferrite, the basal plane
17
+ in zinc — the planes of the lattice as it is at each time, where the fields of the path
18
+ have its orientation (a lattice that its twins turned, or that turned with the finite
19
+ strains of its crystal). A point counts from the time its cumulated plastic strain
20
+ passes ``plastic`` (it then belongs to the plastic zone, whatever happens later), and a
21
+ cell that has survived a Weibull stress has survived the smaller ones: the probability
22
+ at a time is that of the largest Weibull stress reached. A cell stands for a point of a
23
+ part: for ``N`` cells under the same loading (the gauge of a specimen), ``V_0 / N`` in
24
+ place of ``V_0``.
25
+ """
26
+
27
+ from __future__ import annotations
28
+
29
+ from dataclasses import dataclass, field
30
+
31
+ import numpy as np
32
+
33
+ from morphogen.homogenization.crystal import CLEAVAGE, OPENING, cleavage_systems
34
+ from morphogen.orientations import euler_to_matrix
35
+
36
+ __all__ = [
37
+ "Beremin",
38
+ "BereminResult",
39
+ "failure_probability",
40
+ "normal_stress",
41
+ "path_beremin",
42
+ "principal_stress",
43
+ "weibull_stress",
44
+ ]
45
+
46
+ #: The curves that the criterion adds to a loading path, and its field
47
+ SERIES = ("beremin_weibull", "beremin_probability")
48
+ FIELD = "beremin_stress"
49
+
50
+
51
+ def _tensors(stress) -> np.ndarray:
52
+ """Stress tensors (..., 3, 3) of Voigt components (..., 6): 11, 22, 33, 23, 31, 12."""
53
+ s = np.asarray(stress, dtype=float)
54
+ if s.shape[-1] != 6:
55
+ raise ValueError(f"beremin: stresses of 6 components, got {s.shape}")
56
+ out = np.empty((*s.shape[:-1], 3, 3))
57
+ out[..., 0, 0], out[..., 1, 1], out[..., 2, 2] = s[..., 0], s[..., 1], s[..., 2]
58
+ out[..., 1, 2] = out[..., 2, 1] = s[..., 3]
59
+ out[..., 2, 0] = out[..., 0, 2] = s[..., 4]
60
+ out[..., 0, 1] = out[..., 1, 0] = s[..., 5]
61
+ return out
62
+
63
+
64
+ def principal_stress(stress) -> np.ndarray:
65
+ """The largest principal stress of stresses (..., 6)."""
66
+ return np.linalg.eigvalsh(_tensors(stress))[..., -1]
67
+
68
+
69
+ def normal_stress(stress, planes: str = "cube", orientations=None, c_over_a=None) -> np.ndarray:
70
+ """The largest normal stress ``n . sigma . n`` of the cleavage planes of a family
71
+ (:data:`~morphogen.homogenization.crystal.CLEAVAGE`) at points of stresses (..., 6) in
72
+ the axes of the sample; ``orientations``: the Bunge angles (degrees) of the crystal
73
+ of each point (..., 3), or of all of them (3); none: the axes of the sample."""
74
+ if planes not in CLEAVAGE:
75
+ raise ValueError(f"cleavage planes: one of {sorted(CLEAVAGE)}, got {planes!r}")
76
+ normals, _, kinds, _ = cleavage_systems(planes, c_over_a)
77
+ normals = normals[kinds == OPENING] # in the axes of the crystal
78
+ sigma = _tensors(stress)
79
+ if orientations is not None:
80
+ euler = np.asarray(orientations, dtype=float)
81
+ if euler.shape[-1] != 3 or (euler.ndim > 1 and euler.shape[:-1] != sigma.shape[:-2]):
82
+ raise ValueError(
83
+ f"beremin: the Bunge angles of each point {sigma.shape[:-2]}, or three "
84
+ f"angles, got {euler.shape}"
85
+ )
86
+ g = euler_to_matrix(euler.reshape(-1, 3)).reshape(*euler.shape[:-1], 3, 3)
87
+ # the stress in the axes of the crystal: g sigma g^T
88
+ sigma = g @ sigma @ np.swapaxes(g, -1, -2)
89
+ return np.einsum("pi,...ij,pj->...p", normals, sigma, normals).max(axis=-1)
90
+
91
+
92
+ def weibull_stress(driving, volumes, modulus: float, volume: float) -> float:
93
+ """The Weibull stress ``(sum_i <sigma_i>^m V_i / V_0)^(1/m)`` of the points of
94
+ stresses ``driving`` and volumes ``volumes`` (NaN: points that do not count)."""
95
+ sigma = np.asarray(driving, dtype=float).ravel()
96
+ v = np.broadcast_to(np.asarray(volumes, dtype=float), np.shape(driving)).ravel()
97
+ keep = np.isfinite(sigma) & (sigma > 0.0)
98
+ if not keep.any():
99
+ return 0.0
100
+ # scaled by the largest stress: powers of 20 and more of stresses of hundreds of MPa
101
+ top = float(sigma[keep].max())
102
+ total = float(np.sum((sigma[keep] / top) ** modulus * v[keep]) / volume)
103
+ return top * total ** (1.0 / modulus)
104
+
105
+
106
+ def failure_probability(weibull, modulus: float, scale: float):
107
+ """``1 - exp(-(sigma_w / sigma_u)^m)``."""
108
+ return -np.expm1(-((np.asarray(weibull, dtype=float) / scale) ** modulus))
109
+
110
+
111
+ @dataclass(frozen=True)
112
+ class Beremin:
113
+ """The criterion of Beremin (1983): the ``modulus`` ``m`` of Weibull, the ``scale``
114
+ ``sigma_u`` of the cleavage stresses of the reference ``volume`` ``V_0``. ``planes``:
115
+ the cleavage planes of the crystals of the points, whose largest normal stress drives
116
+ the cleavage (none: the largest principal stress), with ``c_over_a`` for hexagonal
117
+ crystals; ``plastic``: the cumulated plastic strain beyond which a point belongs to
118
+ the plastic zone (none: every point counts)."""
119
+
120
+ modulus: float
121
+ scale: float
122
+ volume: float
123
+ planes: str | None = None
124
+ c_over_a: float | None = None
125
+ plastic: float | None = None
126
+
127
+ def __post_init__(self) -> None:
128
+ for name in ("modulus", "scale", "volume"):
129
+ value = getattr(self, name)
130
+ if isinstance(value, bool) or not isinstance(value, (int, float)) or not value > 0:
131
+ raise ValueError(f"beremin: {name}, a positive number, got {value!r}")
132
+ object.__setattr__(self, name, float(value))
133
+ if self.modulus < 1.0:
134
+ raise ValueError("beremin: a modulus of Weibull of 1 or more")
135
+ if self.planes is not None and self.planes not in CLEAVAGE:
136
+ raise ValueError(f"beremin: planes, one of {sorted(CLEAVAGE)}, got {self.planes!r}")
137
+ if self.plastic is not None and not self.plastic >= 0:
138
+ raise ValueError("beremin: plastic, a cumulated plastic strain of 0 or more")
139
+
140
+ @classmethod
141
+ def from_config(cls, spec) -> Beremin:
142
+ """``{modulus, scale, volume, planes, c_over_a, plastic}``."""
143
+ if isinstance(spec, Beremin):
144
+ return spec
145
+ if not isinstance(spec, dict):
146
+ raise ValueError("beremin: a mapping (modulus, scale, volume, planes, plastic)")
147
+ allowed = {"modulus", "scale", "volume", "planes", "c_over_a", "plastic"}
148
+ unknown = sorted(set(spec) - allowed)
149
+ if unknown:
150
+ raise ValueError(f"beremin: unknown parameters {unknown}; use {sorted(allowed)}")
151
+ missing = [k for k in ("modulus", "scale", "volume") if k not in spec]
152
+ if missing:
153
+ raise ValueError(f"beremin: give {missing}")
154
+ return cls(**spec)
155
+
156
+ def driving(self, stress, orientations=None) -> np.ndarray:
157
+ """The stress that drives the cleavage of points of stresses (..., 6)."""
158
+ if self.planes is None:
159
+ return principal_stress(stress)
160
+ return normal_stress(stress, self.planes, orientations, self.c_over_a)
161
+
162
+ def weibull(self, driving, volumes) -> float:
163
+ return weibull_stress(driving, volumes, self.modulus, self.volume)
164
+
165
+ def probability(self, weibull):
166
+ return failure_probability(weibull, self.modulus, self.scale)
167
+
168
+
169
+ @dataclass
170
+ class BereminResult:
171
+ """The cleavage of a cell along a loading path: at each of its ``times``, the
172
+ ``weibull`` stress of its fields and the ``probability`` of failure up to then; the
173
+ ``driving`` stress of its points at the time of the largest Weibull stress (NaN
174
+ outside the plastic zone), their ``weights`` and their ``support``."""
175
+
176
+ times: np.ndarray
177
+ weibull: np.ndarray
178
+ probability: np.ndarray
179
+ driving: np.ndarray
180
+ weights: np.ndarray | None = field(default=None, repr=False)
181
+ support: object | None = field(default=None, repr=False)
182
+
183
+ @property
184
+ def largest(self) -> float:
185
+ """The largest Weibull stress of the path."""
186
+ return float(self.weibull.max())
187
+
188
+ def fields(self) -> dict:
189
+ """The fields of the points, by name (for the writers of fields)."""
190
+ return {FIELD: self.driving}
191
+
192
+ def components(self) -> dict:
193
+ """The scalar results: the largest Weibull stress and the probability of failure
194
+ at the end of the path."""
195
+ return {"weibull": self.largest, "probability": float(self.probability[-1])}
196
+
197
+ def series(self, times) -> dict | None:
198
+ """The curves of the criterion at the ``times`` of a path (:data:`SERIES`: the
199
+ Weibull stress and the probability of failure, zero before the first fields), or
200
+ None when the fields were not kept at each of them."""
201
+ times = np.asarray(times, dtype=float)
202
+ if times.size != self.times.size + 1 or not np.allclose(times[1:], self.times):
203
+ return None
204
+ return {
205
+ SERIES[0]: np.concatenate([[0.0], self.weibull]),
206
+ SERIES[1]: np.concatenate([[0.0], self.probability]),
207
+ }
208
+
209
+
210
+ def path_beremin(result, criterion, *, orientations=None) -> BereminResult:
211
+ """The criterion of Beremin along a loading path: ``result``, a :class:`~morphogen.
212
+ homogenization.paths.PathResult` that kept its fields (``fields="steps"``, or the
213
+ times wanted); ``criterion``: a :class:`Beremin` or its mapping; ``orientations``: the
214
+ Bunge angles of the crystals of the points of the fields (those of the grains of the
215
+ elements of a mesh, of the voxels of an image), for the normal stress of their
216
+ cleavage planes (none: crystals in the axes of the sample). Where the fields of the
217
+ path have the ``orientation`` of the lattices at each time (those that their twins
218
+ turn; finite strains), the planes are those of the lattices as they are then. The
219
+ stresses are those of the fields (Cauchy's in finite strains), the volumes those of
220
+ the elements of a mesh (the points of an image weigh the same)."""
221
+ law = Beremin.from_config(criterion)
222
+ times = np.array([t for t in sorted(result.fields) if "stress" in result.fields[t]])
223
+ if times.size == 0:
224
+ raise ValueError("beremin: the stress fields of the path (run it with fields='steps')")
225
+ support = result.support
226
+ first = np.asarray(result.fields[times[0]]["stress"], dtype=float)
227
+ shape = first.shape[:-1]
228
+ if support is not None and hasattr(support, "volumes"): # a mesh
229
+ weights = np.abs(support.volumes())
230
+ elif support is not None and hasattr(support, "spacing"): # an image
231
+ weights = np.full(shape, float(np.prod(support.spacing)))
232
+ else:
233
+ weights = np.ones(shape)
234
+ if weights.shape != shape:
235
+ raise ValueError(f"beremin: one volume per point {shape}, got {weights.shape}")
236
+ zone = np.zeros(shape, dtype=bool) if law.plastic is not None else np.ones(shape, dtype=bool)
237
+ weibull = np.zeros(times.size)
238
+ best = np.full(shape, np.nan)
239
+ for k, t in enumerate(times):
240
+ arrays = result.fields[t]
241
+ stress = np.asarray(arrays["stress"], dtype=float)
242
+ solid = np.all(np.isfinite(stress), axis=-1)
243
+ if law.plastic is not None:
244
+ zone |= solid & (np.nan_to_num(np.asarray(arrays["p"], dtype=float)) > law.plastic)
245
+ driving = np.full(shape, np.nan)
246
+ counted = zone & solid
247
+ if counted.any():
248
+ euler = orientations
249
+ if euler is not None and np.ndim(euler) > 1:
250
+ euler = np.asarray(euler, dtype=float).reshape(*shape, 3)[counted]
251
+ if law.planes is not None and "orientation" in arrays:
252
+ # the lattices as they are at that time (NaN: not those of crystals)
253
+ now = np.asarray(arrays["orientation"], dtype=float).reshape(*shape, 3)[counted]
254
+ known = np.all(np.isfinite(now), axis=-1)
255
+ first = np.zeros(3) if euler is None else np.asarray(euler, dtype=float)
256
+ euler = np.where(known[:, None], now, np.broadcast_to(first, now.shape))
257
+ driving[counted] = law.driving(stress[counted], euler)
258
+ weibull[k] = law.weibull(driving, weights)
259
+ if weibull[k] >= weibull[:k].max(initial=0.0):
260
+ best = driving
261
+ probability = law.probability(np.maximum.accumulate(weibull))
262
+ return BereminResult(times=times, weibull=weibull, probability=np.asarray(probability),
263
+ driving=best, weights=weights, support=support) # fmt: skip