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,368 @@
|
|
|
1
|
+
"""Brittle fracture of voxel images by the phase-field method in finite strains: the cell
|
|
2
|
+
of :mod:`morphogen.fracture.phasefield` whose phases stretch much before they break
|
|
3
|
+
(rubbers, foams, soft tissues).
|
|
4
|
+
|
|
5
|
+
The phases are hyperelastic (the strain energies of :mod:`morphogen.homogenization.laws`)
|
|
6
|
+
or elastic (the energy of Hencky of the logarithmic strain, the elasticity of every
|
|
7
|
+
finite-strain solver of the package), and the energy of the cell is that of the small
|
|
8
|
+
strains with the energy of the deformation gradient, over the reference configuration,
|
|
9
|
+
|
|
10
|
+
E(u, d) = int g(d) psi(F) dV0 + int G_c gamma(d, grad0 d) dV0, g(d) = (1 - d)^2 + k:
|
|
11
|
+
|
|
12
|
+
the damage and its gradient are Lagrangian fields, and the toughness is an energy per unit
|
|
13
|
+
area of the reference configuration (Miehe & Schänzel 2014). The crack densities
|
|
14
|
+
(``AT2``, ``AT1``), the regularization length and the irreversibility are those of the
|
|
15
|
+
small strains (:class:`~morphogen.fracture.phasefield.PhaseField`).
|
|
16
|
+
|
|
17
|
+
A step of a loading path is solved by alternate minimization, as in small strains: until
|
|
18
|
+
the damage no longer moves,
|
|
19
|
+
|
|
20
|
+
1. the displacement at fixed damage: the periodic problem of the voxels of the nonlinear
|
|
21
|
+
FFT solver (:class:`~morphogen.homogenization.fft_nonlinear.NonlinearFFTProblem`: total
|
|
22
|
+
Lagrangian, F-bar voxels, Newton's method, the macroscopic components prescribed as
|
|
23
|
+
stresses among its unknowns), the nominal stress and the tangent of each point times the
|
|
24
|
+
degradation of its voxel (the stress is degraded as a whole, as in small strains: the
|
|
25
|
+
hybrid formulation), the Fourier preconditioner of its Krylov solves scaled by the
|
|
26
|
+
degradation of the nodes;
|
|
27
|
+
2. the damage of the driving energy ``psi+`` of the state reached: the problem of the
|
|
28
|
+
small strains (the same equation, its bound or its history field).
|
|
29
|
+
|
|
30
|
+
The solver of the paths divides a step where Newton's method fails (a cell that breaks at
|
|
31
|
+
once): the damage then starts again from that of the last converged step. Where a crack
|
|
32
|
+
runs at a fixed load, the F-bar voxels of its band, sheared far, may turn inside out under
|
|
33
|
+
Newton's corrections from an equilibrium where none is near it, and dividing the step only
|
|
34
|
+
replays the run of the crack: the compressible solids, which do not lock, are better solved
|
|
35
|
+
on fully integrated voxels (``integration="full"``).
|
|
36
|
+
|
|
37
|
+
The energy that drives the damage (``split``) is all the energy (``"none"``); or its
|
|
38
|
+
isochoric part and its volumetric part in expansion, ``J > 1`` (``"volumetric"``: the split
|
|
39
|
+
of Amor et al. between the two terms of the strain energies, so that a hydrostatic
|
|
40
|
+
compression does not break); or, for the elastic phases only, the tensile part of the
|
|
41
|
+
energy of Hencky in the principal logarithmic strains (``"spectral"``, as in small
|
|
42
|
+
strains: ``lambda <tr e>+^2 / 2 + mu sum <e_i>+^2``). The compressible energies that are
|
|
43
|
+
not split (Blatz-Ko, hyperfoam) drive the damage as a whole.
|
|
44
|
+
"""
|
|
45
|
+
|
|
46
|
+
from __future__ import annotations
|
|
47
|
+
|
|
48
|
+
import logging
|
|
49
|
+
|
|
50
|
+
import numpy as np
|
|
51
|
+
|
|
52
|
+
from morphogen.fracture.phasefield import (
|
|
53
|
+
PhaseField,
|
|
54
|
+
PhaseFieldProblem,
|
|
55
|
+
PhaseFieldResult,
|
|
56
|
+
_to_nodes,
|
|
57
|
+
_to_voxels,
|
|
58
|
+
)
|
|
59
|
+
from morphogen.homogenization import finite as fin
|
|
60
|
+
from morphogen.homogenization.fft_nonlinear import NonlinearFFTProblem, _VoxelPaths
|
|
61
|
+
from morphogen.homogenization.materials import Material
|
|
62
|
+
from morphogen.homogenization.paths import LoadingPath
|
|
63
|
+
from morphogen.image import VoxelImage
|
|
64
|
+
|
|
65
|
+
log = logging.getLogger("morphogen")
|
|
66
|
+
|
|
67
|
+
__all__ = ["FinitePhaseFieldProblem", "green_lagrange"]
|
|
68
|
+
|
|
69
|
+
|
|
70
|
+
def green_lagrange(grads: np.ndarray) -> tuple[np.ndarray, np.ndarray]:
|
|
71
|
+
"""The Green-Lagrange strains (n, 6; engineering shears) and the Jacobians ``det F``
|
|
72
|
+
of displacement gradients (n, 9; row by row)."""
|
|
73
|
+
h = np.asarray(grads, dtype=float).reshape(-1, 3, 3)
|
|
74
|
+
e = 0.5 * (h + np.swapaxes(h, 1, 2) + np.swapaxes(h, 1, 2) @ h)
|
|
75
|
+
out = fin._voigt(e)
|
|
76
|
+
out[:, 3:] *= 2.0
|
|
77
|
+
return out, np.linalg.det(np.eye(3) + h)
|
|
78
|
+
|
|
79
|
+
|
|
80
|
+
class _DegradedVoxels(_VoxelPaths):
|
|
81
|
+
"""The voxels of a cell whose points are degraded: their stresses and tangents times
|
|
82
|
+
the degradation of their voxel, and the preconditioner of the Krylov solves scaled by
|
|
83
|
+
that of the nodes (the stiffness of a damaged cell is that of the sound one times
|
|
84
|
+
``g``, which the Fourier inverse of the sound reference medium ignores)."""
|
|
85
|
+
|
|
86
|
+
def _buffers(self, n_pts: int, nc: int) -> None:
|
|
87
|
+
super()._buffers(n_pts, nc)
|
|
88
|
+
reference, problem = self.precondition, self.problem
|
|
89
|
+
|
|
90
|
+
def scaled(r):
|
|
91
|
+
w = problem.node_weight
|
|
92
|
+
return w * reference(w * r)
|
|
93
|
+
|
|
94
|
+
self.precondition = scaled
|
|
95
|
+
|
|
96
|
+
def integrate(self, grads, dtemp, dt, old, new, stress, tangent, guess, ratio) -> int:
|
|
97
|
+
failed = super().integrate(grads, dtemp, dt, old, new, stress, tangent, guess, ratio)
|
|
98
|
+
g = self.problem.point_scale
|
|
99
|
+
stress *= g[:, None]
|
|
100
|
+
tangent *= g[:, None, None]
|
|
101
|
+
return failed
|
|
102
|
+
|
|
103
|
+
|
|
104
|
+
class _DegradedFFTProblem(NonlinearFFTProblem):
|
|
105
|
+
"""The loading paths of a voxel image whose voxels are degraded by ``point_scale``
|
|
106
|
+
(one value per integration point) and ``node_weight`` (one per nodal unknown), the
|
|
107
|
+
damage of its ``owner`` settled on each state reached (the hooks of
|
|
108
|
+
:meth:`~morphogen.homogenization.nonlinear._PathSolver.run`)."""
|
|
109
|
+
|
|
110
|
+
def __init__(self, image, materials, owner, **options):
|
|
111
|
+
super().__init__(image, materials, "periodic", kinematics="finite", **options)
|
|
112
|
+
self.owner = owner
|
|
113
|
+
self.point_scale = np.ones(0 if self.empty else self.kind.size)
|
|
114
|
+
self.node_weight = np.ones(3 * int(np.prod(self.shape)))
|
|
115
|
+
|
|
116
|
+
def _discretization(self) -> _VoxelPaths:
|
|
117
|
+
return _DegradedVoxels(self)
|
|
118
|
+
|
|
119
|
+
def _settle(self, state) -> bool:
|
|
120
|
+
return self.owner._settle(state)
|
|
121
|
+
|
|
122
|
+
def _rollback(self) -> None:
|
|
123
|
+
self.owner._rollback()
|
|
124
|
+
|
|
125
|
+
|
|
126
|
+
class FinitePhaseFieldProblem:
|
|
127
|
+
"""The brittle fracture of a periodic voxel image in finite strains (see the module):
|
|
128
|
+
``materials`` of its phases, those that break hyperelastic or elastic (isotropic);
|
|
129
|
+
``fracture`` (:class:`~morphogen.fracture.phasefield.PhaseField`, or a mapping of its
|
|
130
|
+
parameters); ``initial``: the voxels broken from the start. ``tol``: the relative
|
|
131
|
+
residual of the linear solves; ``staggered_tol``: the largest change of the damage
|
|
132
|
+
that ends the alternate minimization of a step, of at most ``max_staggered``
|
|
133
|
+
iterations; ``nonlinear``: the other options of
|
|
134
|
+
:class:`~morphogen.homogenization.fft_nonlinear.NonlinearFFTProblem` (``newton_tol``,
|
|
135
|
+
``max_newton``, ``max_cuts``, ``integration``, ``tangent``)."""
|
|
136
|
+
|
|
137
|
+
def __init__(self, image: VoxelImage, materials: dict[int, Material], fracture, *,
|
|
138
|
+
initial=None, tol: float = 1e-7, staggered_tol: float = 1e-3,
|
|
139
|
+
max_staggered: int = 200, **nonlinear): # fmt: skip
|
|
140
|
+
fracture = PhaseField.from_config(fracture)
|
|
141
|
+
self.staggered_tol, self.max_staggered = float(staggered_tol), int(max_staggered)
|
|
142
|
+
for name in ("kinematics", "device", "grains", "orientations"):
|
|
143
|
+
if name in nonlinear:
|
|
144
|
+
raise ValueError(
|
|
145
|
+
f"phase field in finite strains: no option {name!r} (isotropic phases, "
|
|
146
|
+
"on the CPU)"
|
|
147
|
+
)
|
|
148
|
+
#: the damage problem (that of the small strains) and the state of the damage
|
|
149
|
+
self.damage = PhaseFieldProblem(image, materials, fracture, initial=initial, tol=tol)
|
|
150
|
+
self.fracture = fracture
|
|
151
|
+
self.image, self.shape = image, image.shape
|
|
152
|
+
self.paths = _DegradedFFTProblem(image, materials, self, tol=tol, **nonlinear)
|
|
153
|
+
self.materials = materials
|
|
154
|
+
self._energies = self._energy_laws()
|
|
155
|
+
#: the damage and the history of the last converged step, the alternate
|
|
156
|
+
#: minimizations of the step under way and what the last of them found
|
|
157
|
+
self._committed = (self.damage.d, self.damage.history)
|
|
158
|
+
self._staggered, self._trial = 0, (self.damage.history, 0.0, 0.0)
|
|
159
|
+
self._degrade()
|
|
160
|
+
|
|
161
|
+
# -- the energies of the points ------------------------------------------------------
|
|
162
|
+
|
|
163
|
+
def _energy_laws(self) -> list:
|
|
164
|
+
"""For each phase whose energy is known (elastic or hyperelastic), its points and
|
|
165
|
+
the function of their displacement gradients that gives the driving energy and
|
|
166
|
+
the whole energy; the phases that break must be among them."""
|
|
167
|
+
from morphogen.homogenization.laws import analytic_model
|
|
168
|
+
|
|
169
|
+
paths, split = self.paths, self.fracture.split
|
|
170
|
+
phase = np.asarray(self.image.data).ravel()[paths.elem]
|
|
171
|
+
out = []
|
|
172
|
+
for ph in np.unique(phase):
|
|
173
|
+
m = self.materials[int(ph)]
|
|
174
|
+
breaks = self.fracture.of(int(ph)) is not None
|
|
175
|
+
points = np.flatnonzero(np.repeat(phase == ph, paths.ng))
|
|
176
|
+
if m.hyperelasticity is not None and m.viscoelasticity is None:
|
|
177
|
+
if breaks and split == "spectral":
|
|
178
|
+
raise ValueError(
|
|
179
|
+
f"phase {int(ph)}: the spectral split is that of the logarithmic "
|
|
180
|
+
"strain of elastic phases; a hyperelastic phase takes split "
|
|
181
|
+
"'volumetric' (its isochoric energy, and the volumetric one in "
|
|
182
|
+
"expansion) or 'none'"
|
|
183
|
+
)
|
|
184
|
+
out.append((points, _hyperelastic_energy(analytic_model(m, finite=True), split)))
|
|
185
|
+
elif not m.nonlinear and m.isotropic and m.stiffness is None:
|
|
186
|
+
out.append((points, _hencky_energy(*m.lame, split)))
|
|
187
|
+
elif breaks:
|
|
188
|
+
raise ValueError(
|
|
189
|
+
f"phase {int(ph)}: in finite strains the phases that break are elastic "
|
|
190
|
+
"(isotropic) or hyperelastic"
|
|
191
|
+
)
|
|
192
|
+
return out
|
|
193
|
+
|
|
194
|
+
def _energy(self, grads: np.ndarray) -> tuple[np.ndarray, np.ndarray]:
|
|
195
|
+
"""The driving energy ``psi+`` and the whole energy of the voxels (the means of
|
|
196
|
+
their points; zero in the voids and in the phases whose energy is not known)."""
|
|
197
|
+
paths = self.paths
|
|
198
|
+
plus, whole = np.zeros(paths.kind.size), np.zeros(paths.kind.size)
|
|
199
|
+
for points, law in self._energies:
|
|
200
|
+
plus[points], whole[points] = law(grads[points])
|
|
201
|
+
out = []
|
|
202
|
+
for values in (plus, whole):
|
|
203
|
+
voxels = np.zeros(int(np.prod(self.shape)))
|
|
204
|
+
voxels[paths.elem] = values.reshape(-1, paths.ng).mean(axis=1)
|
|
205
|
+
out.append(voxels.reshape(self.shape))
|
|
206
|
+
return out[0], out[1]
|
|
207
|
+
|
|
208
|
+
def _degrade(self) -> np.ndarray:
|
|
209
|
+
"""The degradation of the voxels for the damage reached, given to the points of
|
|
210
|
+
the mechanical problem and to its preconditioner."""
|
|
211
|
+
g = self.damage.degradation()
|
|
212
|
+
paths = self.paths
|
|
213
|
+
paths.point_scale = np.ascontiguousarray(np.repeat(g.ravel()[paths.elem], paths.ng))
|
|
214
|
+
nodal = _to_nodes(g) / 8.0
|
|
215
|
+
paths.node_weight = np.repeat(1.0 / np.sqrt(nodal.ravel()), 3)
|
|
216
|
+
return g
|
|
217
|
+
|
|
218
|
+
# -- the damage of a state: the hooks of the solver of the paths ----------------------
|
|
219
|
+
|
|
220
|
+
def _settle(self, state) -> bool:
|
|
221
|
+
"""The damage of the driving energy of the state reached, from that of the last
|
|
222
|
+
converged step (its bound); true while it moves: the step is solved again."""
|
|
223
|
+
dmg = self.damage
|
|
224
|
+
plus, whole = self._energy(state.grads)
|
|
225
|
+
history = plus
|
|
226
|
+
if self.fracture.irreversibility == "history":
|
|
227
|
+
history = np.maximum(self._committed[1], plus)
|
|
228
|
+
g = dmg.degradation() # of the damage the state was solved with
|
|
229
|
+
elastic = float(np.sum(g * whole)) * dmg.voxel / dmg.volume
|
|
230
|
+
new = dmg._damage(history, self._committed[0])
|
|
231
|
+
change = float(np.abs(new - dmg.d).max())
|
|
232
|
+
dmg.d = new
|
|
233
|
+
self._trial = (history, elastic, change)
|
|
234
|
+
self._degrade()
|
|
235
|
+
self._staggered += 1
|
|
236
|
+
return change >= self.staggered_tol and self._staggered < self.max_staggered
|
|
237
|
+
|
|
238
|
+
def _rollback(self) -> None:
|
|
239
|
+
"""A step divided: the damage of the last converged step again."""
|
|
240
|
+
self.damage.d = self._committed[0]
|
|
241
|
+
self._staggered = 0
|
|
242
|
+
self._degrade()
|
|
243
|
+
|
|
244
|
+
# -- loading paths -------------------------------------------------------------------
|
|
245
|
+
|
|
246
|
+
def run(self, path, *, name: str = "path", fields=False, monitor=None) -> PhaseFieldResult:
|
|
247
|
+
"""Follow a loading path (:class:`~morphogen.homogenization.paths.LoadingPath`, or
|
|
248
|
+
a mapping for it; nominal strains and stresses, as for the loading paths in finite
|
|
249
|
+
strains): :class:`~morphogen.fracture.phasefield.PhaseFieldResult` with the nominal
|
|
250
|
+
and true measures of the path. ``fields``: true for the damage, strain and stress
|
|
251
|
+
of the voxels at the end of each segment of the path, ``"steps"`` at the end of
|
|
252
|
+
each step, or a list of times of its steps. ``monitor(time, records so far)``
|
|
253
|
+
after each step; a true value ends the path there."""
|
|
254
|
+
path = LoadingPath.from_spec(path)
|
|
255
|
+
if np.any(np.asarray(path.temperature) != 0):
|
|
256
|
+
raise ValueError("phase field in finite strains: no change of temperature")
|
|
257
|
+
dmg, paths = self.damage, self.paths
|
|
258
|
+
wanted = paths._field_times(path, fields)
|
|
259
|
+
volume = dmg.volume
|
|
260
|
+
rec = {k: [] for k in ("t", "d", "gamma", "elastic", "fracture", "its", "phases")}
|
|
261
|
+
kept: dict = {}
|
|
262
|
+
|
|
263
|
+
def record(t: float, elastic: float) -> None:
|
|
264
|
+
rec["t"].append(float(t))
|
|
265
|
+
rec["d"].append(dmg._mean_damage())
|
|
266
|
+
rec["gamma"].append(dmg.crack_surface() / volume)
|
|
267
|
+
rec["elastic"].append(elastic)
|
|
268
|
+
rec["fracture"].append(dmg.crack_surface(weight=dmg.gc) / volume)
|
|
269
|
+
means = dmg._phase_means(None, None)
|
|
270
|
+
rec["phases"].append({ph: v["plastic"] for ph, v in means.items()})
|
|
271
|
+
|
|
272
|
+
record(float(path.times[0]), 0.0)
|
|
273
|
+
|
|
274
|
+
def after(state) -> bool:
|
|
275
|
+
"""A converged step: its damage and its history kept."""
|
|
276
|
+
history, elastic, change = self._trial
|
|
277
|
+
if change >= self.staggered_tol:
|
|
278
|
+
log.warning(
|
|
279
|
+
"phase field: the alternate minimization of the step to t = %g stopped at "
|
|
280
|
+
"a change of the damage of %.2e", state.time, change
|
|
281
|
+
) # fmt: skip
|
|
282
|
+
dmg.history = history
|
|
283
|
+
self._committed = (dmg.d, history)
|
|
284
|
+
rec["its"].append(self._staggered)
|
|
285
|
+
self._staggered = 0
|
|
286
|
+
record(state.time, elastic)
|
|
287
|
+
if wanted.size and np.any(np.isclose(state.time, wanted, rtol=1e-12, atol=0.0)):
|
|
288
|
+
kept[float(state.time)] = np.clip(_to_voxels(dmg.d), 0.0, 1.0)
|
|
289
|
+
return bool(monitor is not None and monitor(float(state.time), rec))
|
|
290
|
+
|
|
291
|
+
res = paths.run(path, name=name, fields=fields, monitor=after)
|
|
292
|
+
for t, values in res.fields.items(): # the damage with the fields of the voxels
|
|
293
|
+
values["damage"] = values["p"] = kept[float(t)]
|
|
294
|
+
phases = {}
|
|
295
|
+
for ph, means in res.phases.items():
|
|
296
|
+
phases[ph] = dict(means)
|
|
297
|
+
if ph in rec["phases"][0]:
|
|
298
|
+
phases[ph]["plastic"] = np.array([step[ph] for step in rec["phases"]])
|
|
299
|
+
info = dict(res.info)
|
|
300
|
+
info["newton_iterations"] = int(np.sum(res.iterations))
|
|
301
|
+
return PhaseFieldResult(
|
|
302
|
+
name=res.name,
|
|
303
|
+
bc=res.bc,
|
|
304
|
+
path=res.path,
|
|
305
|
+
times=res.times,
|
|
306
|
+
strain=res.strain,
|
|
307
|
+
stress=res.stress,
|
|
308
|
+
temperature=res.temperature,
|
|
309
|
+
plastic=np.array(rec["d"]),
|
|
310
|
+
phases=phases,
|
|
311
|
+
iterations=np.array(rec["its"], dtype=int),
|
|
312
|
+
info=info,
|
|
313
|
+
fields=res.fields,
|
|
314
|
+
support=res.support,
|
|
315
|
+
kinematics="finite",
|
|
316
|
+
cauchy=res.cauchy,
|
|
317
|
+
log_strain=res.log_strain,
|
|
318
|
+
damage=np.array(rec["d"]),
|
|
319
|
+
crack_surface=np.array(rec["gamma"]),
|
|
320
|
+
elastic_energy=np.array(rec["elastic"]),
|
|
321
|
+
fracture_energy=np.array(rec["fracture"]),
|
|
322
|
+
)
|
|
323
|
+
|
|
324
|
+
|
|
325
|
+
def _hyperelastic_energy(law, split: str):
|
|
326
|
+
"""The driving and whole energies of the points of a hyperelastic law (its isochoric
|
|
327
|
+
and volumetric parts) from their displacement gradients."""
|
|
328
|
+
|
|
329
|
+
def energy(grads):
|
|
330
|
+
e, j = green_lagrange(grads)
|
|
331
|
+
with np.errstate(invalid="ignore", divide="ignore", over="ignore"):
|
|
332
|
+
iso, vol = law._parts(e)[4]
|
|
333
|
+
iso, vol = np.nan_to_num(iso), np.nan_to_num(vol)
|
|
334
|
+
whole = iso + vol
|
|
335
|
+
if split == "none":
|
|
336
|
+
return whole, whole
|
|
337
|
+
return iso + np.where(j >= 1.0, vol, 0.0), whole
|
|
338
|
+
|
|
339
|
+
return energy
|
|
340
|
+
|
|
341
|
+
|
|
342
|
+
def _hencky_energy(lam: float, mu: float, split: str):
|
|
343
|
+
"""The driving and whole energies of the points of an elastic phase in finite strains:
|
|
344
|
+
the energy of Hencky ``lambda (tr e)^2 / 2 + mu e : e`` of the logarithmic strain."""
|
|
345
|
+
bulk = lam + 2.0 * mu / 3.0
|
|
346
|
+
|
|
347
|
+
def energy(grads):
|
|
348
|
+
e = fin.log_strain(grads)
|
|
349
|
+
e[:, 3:] *= 0.5 # tensor shears
|
|
350
|
+
tr = e[:, :3].sum(axis=1)
|
|
351
|
+
dev2 = np.sum((e[:, :3] - tr[:, None] / 3.0) ** 2, axis=1) + 2.0 * np.sum(
|
|
352
|
+
e[:, 3:] ** 2, axis=1
|
|
353
|
+
)
|
|
354
|
+
whole = 0.5 * bulk * tr**2 + mu * dev2
|
|
355
|
+
if split == "none":
|
|
356
|
+
return whole, whole
|
|
357
|
+
if split == "volumetric":
|
|
358
|
+
return 0.5 * bulk * np.maximum(tr, 0.0) ** 2 + mu * dev2, whole
|
|
359
|
+
t = np.empty((len(e), 3, 3))
|
|
360
|
+
for k, (a, b) in enumerate(((0, 0), (1, 1), (2, 2), (1, 2), (2, 0), (0, 1))):
|
|
361
|
+
t[:, a, b] = t[:, b, a] = e[:, k]
|
|
362
|
+
principal = np.linalg.eigvalsh(t)
|
|
363
|
+
plus = 0.5 * lam * np.maximum(tr, 0.0) ** 2 + mu * np.sum(
|
|
364
|
+
np.maximum(principal, 0.0) ** 2, axis=1
|
|
365
|
+
)
|
|
366
|
+
return plus, whole
|
|
367
|
+
|
|
368
|
+
return energy
|