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.
- morphogen/__init__.py +60 -0
- morphogen/__main__.py +7 -0
- morphogen/_platform.py +55 -0
- morphogen/_public.py +153 -0
- morphogen/_utils.py +80 -0
- morphogen/_version.py +1 -0
- morphogen/analysis/__init__.py +174 -0
- morphogen/analysis/anisotropy.py +135 -0
- morphogen/analysis/basic.py +38 -0
- morphogen/analysis/cells.py +54 -0
- morphogen/analysis/connectivity.py +156 -0
- morphogen/analysis/correlation.py +195 -0
- morphogen/analysis/covariance.py +80 -0
- morphogen/analysis/fractal.py +54 -0
- morphogen/analysis/measures.py +188 -0
- morphogen/analysis/morphology.py +265 -0
- morphogen/analysis/particles.py +160 -0
- morphogen/analysis/percolation.py +2034 -0
- morphogen/analysis/power_laws.py +143 -0
- morphogen/analysis/random_sets.py +351 -0
- morphogen/analysis/stereology.py +289 -0
- morphogen/analysis/surface.py +107 -0
- morphogen/analysis/topology.py +92 -0
- morphogen/automata/__init__.py +74 -0
- morphogen/automata/engine.py +211 -0
- morphogen/automata/growth.py +686 -0
- morphogen/automata/lattice.py +143 -0
- morphogen/automata/reaction.py +255 -0
- morphogen/automata/rules.py +353 -0
- morphogen/automata/tilings.py +1715 -0
- morphogen/cli.py +3526 -0
- morphogen/config.py +2167 -0
- morphogen/contact/__init__.py +113 -0
- morphogen/contact/experiments.py +368 -0
- morphogen/contact/hertz.py +104 -0
- morphogen/contact/kernels.py +827 -0
- morphogen/contact/periodic.py +278 -0
- morphogen/contact/problem.py +578 -0
- morphogen/contact/surfaces.py +310 -0
- morphogen/coupling/__init__.py +43 -0
- morphogen/coupling/ageing.py +143 -0
- morphogen/coupling/diffusion.py +226 -0
- morphogen/coupling/fenicsx.py +484 -0
- morphogen/coupling/oxidation.py +447 -0
- morphogen/coupling/plates.py +247 -0
- morphogen/design/__init__.py +51 -0
- morphogen/design/csp.py +616 -0
- morphogen/design/frames.py +277 -0
- morphogen/design/search.py +287 -0
- morphogen/design/tiles.py +336 -0
- morphogen/distributions.py +312 -0
- morphogen/domain.py +203 -0
- morphogen/dynamics/__init__.py +179 -0
- morphogen/dynamics/model.py +638 -0
- morphogen/dynamics/openradioss.py +643 -0
- morphogen/dynamics/results.py +515 -0
- morphogen/fracture/__init__.py +170 -0
- morphogen/fracture/bulk.py +349 -0
- morphogen/fracture/cohesive.py +1614 -0
- morphogen/fracture/ductile.py +557 -0
- morphogen/fracture/lefm.py +1168 -0
- morphogen/fracture/mixed.py +1178 -0
- morphogen/fracture/periodic.py +733 -0
- morphogen/fracture/phasefield.py +714 -0
- morphogen/fracture/phasefield_finite.py +368 -0
- morphogen/fracture/surface.py +572 -0
- morphogen/fracture/toughness.py +566 -0
- morphogen/gpu.py +108 -0
- morphogen/gui/__init__.py +8 -0
- morphogen/gui/api.py +1927 -0
- morphogen/gui/desktop.py +387 -0
- morphogen/gui/icon.png +0 -0
- morphogen/gui/index.html +1909 -0
- morphogen/gui/server.py +229 -0
- morphogen/gui/tools/__init__.py +629 -0
- morphogen/gui/tools/compare.py +149 -0
- morphogen/gui/tools/contact.py +391 -0
- morphogen/gui/tools/couplings.py +1085 -0
- morphogen/gui/tools/crackfront.py +245 -0
- morphogen/gui/tools/design.py +224 -0
- morphogen/gui/tools/dynamics.py +824 -0
- morphogen/gui/tools/fracture.py +2586 -0
- morphogen/gui/tools/interop.py +1654 -0
- morphogen/gui/tools/learning.py +595 -0
- morphogen/gui/tools/mechanics.py +3881 -0
- morphogen/gui/tools/nonlocal_damage.py +1321 -0
- morphogen/gui/tools/phasefield.py +215 -0
- morphogen/gui/tools/physics.py +597 -0
- morphogen/gui/tools/stability.py +1756 -0
- morphogen/gui/tools/statistics.py +1408 -0
- morphogen/gui/viewer.js +1100 -0
- morphogen/homogenization/__init__.py +210 -0
- morphogen/homogenization/acoustics.py +566 -0
- morphogen/homogenization/amg.py +1005 -0
- morphogen/homogenization/apparent.py +1046 -0
- morphogen/homogenization/behaviours.cu +2285 -0
- morphogen/homogenization/behaviours.py +944 -0
- morphogen/homogenization/beremin.py +263 -0
- morphogen/homogenization/bifurcation.py +1085 -0
- morphogen/homogenization/bloch.py +507 -0
- morphogen/homogenization/bounds.py +226 -0
- morphogen/homogenization/core.py +458 -0
- morphogen/homogenization/coupled.py +1135 -0
- morphogen/homogenization/crystal.py +2967 -0
- morphogen/homogenization/dilatation.py +454 -0
- morphogen/homogenization/elements.py +157 -0
- morphogen/homogenization/fatigue.py +768 -0
- morphogen/homogenization/fe.py +1739 -0
- morphogen/homogenization/fenicsx.py +307 -0
- morphogen/homogenization/fft.py +499 -0
- morphogen/homogenization/fft_nonlinear.py +391 -0
- morphogen/homogenization/finite.py +613 -0
- morphogen/homogenization/flow.py +361 -0
- morphogen/homogenization/frames.py +1125 -0
- morphogen/homogenization/gpu.py +1241 -0
- morphogen/homogenization/harmonic.py +427 -0
- morphogen/homogenization/identification.py +579 -0
- morphogen/homogenization/kernels.py +760 -0
- morphogen/homogenization/laws.py +2061 -0
- morphogen/homogenization/materials.py +1080 -0
- morphogen/homogenization/mfront.py +589 -0
- morphogen/homogenization/networks.py +880 -0
- morphogen/homogenization/nonlinear.py +2612 -0
- morphogen/homogenization/ntfa.py +577 -0
- morphogen/homogenization/paths.py +476 -0
- morphogen/homogenization/photonic.py +467 -0
- morphogen/homogenization/poroelastic.py +212 -0
- morphogen/homogenization/porous.py +1120 -0
- morphogen/homogenization/postprocess.py +290 -0
- morphogen/homogenization/solvers.py +1140 -0
- morphogen/homogenization/tensors.py +240 -0
- morphogen/homogenization/voxel_fe.py +457 -0
- morphogen/homogenization/xfem.py +1016 -0
- morphogen/homogenization/zmat.py +1258 -0
- morphogen/iga/__init__.py +48 -0
- morphogen/iga/analysis.py +508 -0
- morphogen/iga/basis.py +214 -0
- morphogen/iga/geometry.py +501 -0
- morphogen/iga/homogenization.py +219 -0
- morphogen/iga/optimization.py +700 -0
- morphogen/iga/shapes.py +331 -0
- morphogen/image.py +128 -0
- morphogen/io/__init__.py +246 -0
- morphogen/io/amitex.py +741 -0
- morphogen/io/ebsd.py +881 -0
- morphogen/io/export.py +196 -0
- morphogen/io/geometry.py +158 -0
- morphogen/io/medit.py +147 -0
- morphogen/io/meshes.py +844 -0
- morphogen/io/metaimage.py +97 -0
- morphogen/io/mfront.py +1104 -0
- morphogen/io/native.py +57 -0
- morphogen/io/radioss.py +764 -0
- morphogen/io/solvers.py +371 -0
- morphogen/io/tables.py +278 -0
- morphogen/io/tiff.py +66 -0
- morphogen/io/vtk.py +701 -0
- morphogen/io/xdmf.py +200 -0
- morphogen/kernels/__init__.py +5 -0
- morphogen/kernels/annealing.py +192 -0
- morphogen/kernels/cells.py +69 -0
- morphogen/kernels/collective.py +87 -0
- morphogen/kernels/force_biased.py +595 -0
- morphogen/kernels/implicit.py +145 -0
- morphogen/kernels/leaves.py +132 -0
- morphogen/kernels/packing.py +304 -0
- morphogen/kernels/raster.py +279 -0
- morphogen/kernels/rsa.py +371 -0
- morphogen/kernels/union.py +135 -0
- morphogen/kernels/watershed.py +190 -0
- morphogen/laser/__init__.py +234 -0
- morphogen/laser/architectures.py +375 -0
- morphogen/laser/bending.py +216 -0
- morphogen/laser/cells.py +1694 -0
- morphogen/laser/design.py +940 -0
- morphogen/laser/figures.py +227 -0
- morphogen/laser/heat.py +804 -0
- morphogen/laser/materials.py +691 -0
- morphogen/laser/mechanics.py +1670 -0
- morphogen/laser/metallurgy.py +615 -0
- morphogen/laser/patterns.py +828 -0
- morphogen/laser/periodic.py +392 -0
- morphogen/laser/process.py +362 -0
- morphogen/laser/run.py +534 -0
- morphogen/laser/solid.py +216 -0
- morphogen/laser/specimen.py +200 -0
- morphogen/laser/structures.py +708 -0
- morphogen/learning/__init__.py +81 -0
- morphogen/learning/behaviour.py +398 -0
- morphogen/learning/data.py +328 -0
- morphogen/learning/learned.cpp +668 -0
- morphogen/learning/logarithmic.py +202 -0
- morphogen/learning/mfront.py +409 -0
- morphogen/learning/networks.py +767 -0
- morphogen/learning/run.py +212 -0
- morphogen/learning/standard.py +814 -0
- morphogen/learning/training.py +235 -0
- morphogen/mesh/__init__.py +29 -0
- morphogen/mesh/conforming.py +1423 -0
- morphogen/mesh/curved.py +600 -0
- morphogen/mesh/exact.py +1717 -0
- morphogen/mesh/octree.py +350 -0
- morphogen/mesh/polycrystal.py +1041 -0
- morphogen/mesh/polyhedra.py +677 -0
- morphogen/mesh/regularize.py +570 -0
- morphogen/mesh/surface.py +97 -0
- morphogen/mesh/tetra.py +512 -0
- morphogen/mesh/voxel.py +124 -0
- morphogen/micromorphic/__init__.py +31 -0
- morphogen/micromorphic/damage.py +359 -0
- morphogen/micromorphic/ductile.py +534 -0
- morphogen/micromorphic/finite.py +220 -0
- morphogen/micromorphic/microfoam.py +787 -0
- morphogen/micromorphic/space.py +341 -0
- morphogen/models/__init__.py +195 -0
- morphogen/models/affine.py +384 -0
- morphogen/models/automata.py +592 -0
- morphogen/models/base.py +500 -0
- morphogen/models/boolean.py +310 -0
- morphogen/models/bouligand.py +331 -0
- morphogen/models/branching.py +241 -0
- morphogen/models/combination.py +430 -0
- morphogen/models/deadleaves.py +766 -0
- morphogen/models/design.py +289 -0
- morphogen/models/ebsd.py +206 -0
- morphogen/models/fibers.py +1476 -0
- morphogen/models/foam.py +594 -0
- morphogen/models/gaussian.py +314 -0
- morphogen/models/growth.py +459 -0
- morphogen/models/hardcore.py +317 -0
- morphogen/models/hierarchical.py +269 -0
- morphogen/models/honeycomb.py +749 -0
- morphogen/models/implicit.py +177 -0
- morphogen/models/laminate.py +470 -0
- morphogen/models/lattice.py +351 -0
- morphogen/models/lattice_field.py +345 -0
- morphogen/models/levelset_foam.py +563 -0
- morphogen/models/nacre.py +411 -0
- morphogen/models/nested.py +924 -0
- morphogen/models/osteons.py +374 -0
- morphogen/models/pieces.py +167 -0
- morphogen/models/planar.py +126 -0
- morphogen/models/reconstruction.py +203 -0
- morphogen/models/scale_rich.py +1409 -0
- morphogen/models/scale_rich_3d.py +1616 -0
- morphogen/models/tessellation.py +735 -0
- morphogen/models/tiling_field.py +302 -0
- morphogen/models/tpms.py +197 -0
- morphogen/models/transparent.py +406 -0
- morphogen/models/union.py +141 -0
- morphogen/optimization/__init__.py +43 -0
- morphogen/optimization/cell.py +295 -0
- morphogen/optimization/filters.py +115 -0
- morphogen/optimization/mma.py +226 -0
- morphogen/optimization/run.py +219 -0
- morphogen/optimization/topology.py +632 -0
- morphogen/orientations.py +568 -0
- morphogen/parallel.py +599 -0
- morphogen/pipeline.py +978 -0
- morphogen/primitives.py +188 -0
- morphogen/results.py +564 -0
- morphogen/rve/__init__.py +73 -0
- morphogen/rve/report.py +627 -0
- morphogen/rve/scaling.py +363 -0
- morphogen/rve/study.py +1054 -0
- morphogen/rve/windows.py +345 -0
- morphogen/seeding.py +51 -0
- morphogen/settings.py +118 -0
- morphogen/stopping.py +48 -0
- morphogen/symmetry.py +384 -0
- morphogen/templates/activator_inhibitor.yaml +22 -0
- morphogen/templates/aggregation.yaml +23 -0
- morphogen/templates/boolean_cylinders.yaml +20 -0
- morphogen/templates/boolean_spheres.yaml +22 -0
- morphogen/templates/bouligand.yaml +28 -0
- morphogen/templates/cellular_automaton.yaml +25 -0
- morphogen/templates/coated_spheres.yaml +26 -0
- morphogen/templates/contact_fibers.yaml +27 -0
- morphogen/templates/cox_nanocomposite.yaml +22 -0
- morphogen/templates/cross_linked_fibers.yaml +26 -0
- morphogen/templates/curved_arcs.yaml +28 -0
- morphogen/templates/curved_fibers.yaml +24 -0
- morphogen/templates/dead_leaves.yaml +22 -0
- morphogen/templates/delaunay_network.yaml +22 -0
- morphogen/templates/dense_packing.yaml +22 -0
- morphogen/templates/diffusion.yaml +33 -0
- morphogen/templates/ebsd.yaml +34 -0
- morphogen/templates/ebsd_map.ctf +3087 -0
- morphogen/templates/fracture_composite.yaml +42 -0
- morphogen/templates/fracture_rubber.yaml +47 -0
- morphogen/templates/gaussian_excursion.yaml +17 -0
- morphogen/templates/graded_lattice.yaml +24 -0
- morphogen/templates/hardcore_fibers.yaml +22 -0
- morphogen/templates/hardcore_spheres.yaml +22 -0
- morphogen/templates/hierarchical_lattice.yaml +22 -0
- morphogen/templates/homogenization_acoustic_foam.yaml +36 -0
- morphogen/templates/homogenization_beremin.yaml +50 -0
- morphogen/templates/homogenization_cleavage.yaml +51 -0
- morphogen/templates/homogenization_cleavage_band.yaml +55 -0
- morphogen/templates/homogenization_contact.yaml +43 -0
- morphogen/templates/homogenization_crack_closure.yaml +49 -0
- morphogen/templates/homogenization_crystal_plasticity.yaml +50 -0
- morphogen/templates/homogenization_crystal_plasticity_fft.yaml +52 -0
- morphogen/templates/homogenization_crystallization.yaml +30 -0
- morphogen/templates/homogenization_debonding.yaml +43 -0
- morphogen/templates/homogenization_detwinning.yaml +58 -0
- morphogen/templates/homogenization_ductile_damage.yaml +47 -0
- morphogen/templates/homogenization_fatigue.yaml +40 -0
- morphogen/templates/homogenization_grain_fracture.yaml +56 -0
- morphogen/templates/homogenization_gyroid.yaml +30 -0
- morphogen/templates/homogenization_intergranular.yaml +43 -0
- morphogen/templates/homogenization_interphase.yaml +42 -0
- morphogen/templates/homogenization_mixed_loading.yaml +33 -0
- morphogen/templates/homogenization_ntfa.yaml +56 -0
- morphogen/templates/homogenization_piezoelectric.yaml +27 -0
- morphogen/templates/homogenization_polycrystal.yaml +30 -0
- morphogen/templates/homogenization_polycrystal_inclusions.yaml +30 -0
- morphogen/templates/homogenization_poroelastic.yaml +26 -0
- morphogen/templates/homogenization_rubber.yaml +40 -0
- morphogen/templates/homogenization_slip_cleavage.yaml +50 -0
- morphogen/templates/homogenization_spheres.yaml +31 -0
- morphogen/templates/homogenization_transport.yaml +29 -0
- morphogen/templates/homogenization_twinning.yaml +54 -0
- morphogen/templates/homogenization_viscoelastic.yaml +34 -0
- morphogen/templates/homogenization_viscoplastic.yaml +42 -0
- morphogen/templates/homogenization_voronoi.yaml +26 -0
- morphogen/templates/homogenization_xfem.yaml +23 -0
- morphogen/templates/hyperuniform_cells.yaml +24 -0
- morphogen/templates/laguerre.yaml +18 -0
- morphogen/templates/laser_bending.yaml +35 -0
- morphogen/templates/laser_cells.yaml +38 -0
- morphogen/templates/laser_corrugated.yaml +36 -0
- morphogen/templates/level_set_foam.yaml +29 -0
- morphogen/templates/menger_sponge.yaml +17 -0
- morphogen/templates/nacre.yaml +25 -0
- morphogen/templates/nucleation_growth.yaml +25 -0
- morphogen/templates/optimize_auxetic.yaml +29 -0
- morphogen/templates/optimize_auxetic_3d.yaml +27 -0
- morphogen/templates/optimize_bulk.yaml +23 -0
- morphogen/templates/optimize_conductivity.yaml +20 -0
- morphogen/templates/osteons.yaml +28 -0
- morphogen/templates/penetrable_spheres.yaml +21 -0
- morphogen/templates/poisson_fibers.yaml +21 -0
- morphogen/templates/random_laminate.yaml +26 -0
- morphogen/templates/random_lattice.yaml +27 -0
- morphogen/templates/random_walk_fibers.yaml +26 -0
- morphogen/templates/reaction_diffusion.yaml +22 -0
- morphogen/templates/reconstruction.yaml +22 -0
- morphogen/templates/rve_cellular_automaton.yaml +23 -0
- morphogen/templates/rve_crystal_plasticity_fft.yaml +51 -0
- morphogen/templates/rve_multiphysics.yaml +43 -0
- morphogen/templates/rve_poisson_fibers.yaml +22 -0
- morphogen/templates/rve_poisson_fibers_fe.yaml +33 -0
- morphogen/templates/rve_voronoi_windows.yaml +20 -0
- morphogen/templates/scale_rich_network.yaml +29 -0
- morphogen/templates/scale_rich_plates.yaml +30 -0
- morphogen/templates/sequential_dead_leaves.yaml +25 -0
- morphogen/templates/strut_lattice.yaml +21 -0
- morphogen/templates/tile_assembly.yaml +28 -0
- morphogen/templates/tpms.yaml +19 -0
- morphogen/templates/trabecular_bone.yaml +29 -0
- morphogen/templates/transparent_dead_leaves.yaml +23 -0
- morphogen/templates/vascular_tree.yaml +23 -0
- morphogen/templates/voronoi.yaml +20 -0
- morphogen/templates/wood.yaml +34 -0
- morphogen/templates/workflow.yaml +56 -0
- morphogen/texture.py +665 -0
- morphogen/theory.py +162 -0
- morphogen/viz/__init__.py +12 -0
- morphogen/viz/export.py +244 -0
- morphogen/viz/figures.py +707 -0
- morphogen/viz/png.py +148 -0
- morphogen/viz/sections.py +696 -0
- morphogen/viz/surfaces.py +1352 -0
- morphogen/viz/video.py +904 -0
- morphogen/viz/workflow.py +488 -0
- morphogen-1.0.0.dist-info/METADATA +2316 -0
- morphogen-1.0.0.dist-info/RECORD +381 -0
- morphogen-1.0.0.dist-info/WHEEL +4 -0
- morphogen-1.0.0.dist-info/entry_points.txt +5 -0
- 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
|