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,391 @@
|
|
|
1
|
+
"""Nonlinear homogenization of periodic voxel images along loading paths: the periodic
|
|
2
|
+
element of :mod:`morphogen.homogenization.nonlinear` on the voxels of the FFT solver.
|
|
3
|
+
|
|
4
|
+
Each voxel is the trilinear hexahedron of :mod:`morphogen.homogenization.fft`, its 2 x 2
|
|
5
|
+
x 2 Gauss points the integration points of the behaviours. Fully integrated, these
|
|
6
|
+
elements lock under isochoric plastic flow (the macroscopic flow stress of a composite
|
|
7
|
+
with a plastic matrix converges from far above as the voxels are refined): by default the
|
|
8
|
+
volumetric part of the measures is averaged over each voxel, the B-bar method in small
|
|
9
|
+
strains (Hughes 1980) and the F-bar method in finite strains (de Souza Neto, Perić,
|
|
10
|
+
Dutko & Owen 1996), in their variational form (the forces derive from the energy of
|
|
11
|
+
these measures), so that the tangent stays symmetric. The unknowns of a step are the
|
|
12
|
+
periodic nodal fluctuation ``w`` and the components of the macroscopic strain prescribed
|
|
13
|
+
as stresses (the macroscopic degrees of freedom of the periodic element), solved by the
|
|
14
|
+
Newton iterations of :class:`~morphogen.homogenization.nonlinear._PathSolver`: the
|
|
15
|
+
macroscopic block is condensed, the corrections are inexact, the steps are divided when
|
|
16
|
+
they do not converge.
|
|
17
|
+
|
|
18
|
+
Each linearized equilibrium ``K_t dw = -R_w`` is solved by conjugate gradients
|
|
19
|
+
preconditioned by the inverse of the stiffness of a homogeneous elastic reference medium,
|
|
20
|
+
applied in Fourier space (:class:`~morphogen.homogenization.fft.FourierPreconditioner`): a
|
|
21
|
+
Newton-Krylov scheme (Gélébart & Mondon-Cancel 2013; Kabel, Böhlke & Schneider 2014) on
|
|
22
|
+
the discretization of Schneider, Merkert & Kabel (2017). The tangent operator is applied
|
|
23
|
+
matrix-free from the consistent tangents of the points: stress increments ``C_t : B v`` at
|
|
24
|
+
the points, then nodal forces gathered node by node; nothing is assembled. The tangents
|
|
25
|
+
are symmetrized, so that conjugate gradients apply, when the laws of all the phases have
|
|
26
|
+
symmetric ones; otherwise (crystal and porous plasticity, the Armstrong-Frederick
|
|
27
|
+
hardening, learned laws that are not potentials, MFront behaviours without a symmetric
|
|
28
|
+
tangent) they are kept full, symmetrized again at the linearizations where their measured
|
|
29
|
+
asymmetry is small (:data:`~morphogen.homogenization.nonlinear.ASYMMETRY`), and GMRES
|
|
30
|
+
with deflated restarts and the same preconditioner solves the corrections of the others
|
|
31
|
+
(:func:`~morphogen.homogenization.solvers.gmres`; ``tangent`` chooses), recycling from a
|
|
32
|
+
solve to the next of the path the space of the first one that restarts (GCRO-DR,
|
|
33
|
+
:class:`~morphogen.homogenization.solvers.Recycling`) and stopping a solve that stagnates
|
|
34
|
+
(an inexact correction). Pores
|
|
35
|
+
have no integration points and, as in the linear solver, need no ersatz material.
|
|
36
|
+
|
|
37
|
+
The behaviours are those of the finite elements: von Mises elasto-(visco)plasticity, and
|
|
38
|
+
crystal plasticity with the slip systems of each grain turned by its orientation, in
|
|
39
|
+
small or finite strains (total Lagrangian, upper triangular macroscopic gradient).
|
|
40
|
+
|
|
41
|
+
Memory: per integration point, the measure of strain, the stress, the tangent (36 or 81
|
|
42
|
+
values) and the internal variables twice (a crystal with 12 slip systems: about 1 kB in
|
|
43
|
+
small strains, 1.7 kB in finite strains), with 8 points per voxel: about 2 GB for a 64³
|
|
44
|
+
polycrystal in small strains.
|
|
45
|
+
"""
|
|
46
|
+
|
|
47
|
+
from __future__ import annotations
|
|
48
|
+
|
|
49
|
+
import dataclasses
|
|
50
|
+
import logging
|
|
51
|
+
import time
|
|
52
|
+
from functools import partial
|
|
53
|
+
|
|
54
|
+
import numpy as np
|
|
55
|
+
|
|
56
|
+
from morphogen.homogenization import finite as fin
|
|
57
|
+
from morphogen.homogenization import kernels
|
|
58
|
+
from morphogen.homogenization.elements import voigt_to_tensor
|
|
59
|
+
from morphogen.homogenization.fft import FFTElasticProblem, FourierPreconditioner
|
|
60
|
+
from morphogen.homogenization.materials import Material
|
|
61
|
+
from morphogen.homogenization.nonlinear import _PathSolver, _PointArrays, behaviour_table
|
|
62
|
+
from morphogen.homogenization.solvers import (
|
|
63
|
+
GMRES_STAGNATION,
|
|
64
|
+
NEGLIGIBLE,
|
|
65
|
+
Recycling,
|
|
66
|
+
SolveInfo,
|
|
67
|
+
conjugate_gradient,
|
|
68
|
+
gmres,
|
|
69
|
+
norm,
|
|
70
|
+
)
|
|
71
|
+
from morphogen.image import VoxelImage
|
|
72
|
+
|
|
73
|
+
log = logging.getLogger("morphogen")
|
|
74
|
+
|
|
75
|
+
#: Integration of the voxels: B-bar (F-bar in finite strains), or full
|
|
76
|
+
INTEGRATIONS = ("bbar", "full")
|
|
77
|
+
|
|
78
|
+
|
|
79
|
+
class _KrylovSolver:
|
|
80
|
+
"""Conjugate gradients on a tangent operator applied matrix-free (``apply``),
|
|
81
|
+
preconditioned in Fourier space (``precondition``), from a starting point when one is
|
|
82
|
+
given (the solver of :meth:`_VoxelPaths.linearize`); GMRES on an operator that is not
|
|
83
|
+
``symmetric``, recycling the space of ``recycle`` (shared by the solves of a path: the
|
|
84
|
+
operator is a new one for it) and stopped where it stagnates
|
|
85
|
+
(:data:`~morphogen.homogenization.solvers.GMRES_STAGNATION`)."""
|
|
86
|
+
|
|
87
|
+
method = "fft"
|
|
88
|
+
|
|
89
|
+
def __init__(self, apply, precondition, tol: float, maxiter: int, symmetric: bool = True,
|
|
90
|
+
recycle: Recycling | None = None): # fmt: skip
|
|
91
|
+
self.apply = apply
|
|
92
|
+
self.precondition = precondition
|
|
93
|
+
self.tol = float(tol)
|
|
94
|
+
self.maxiter = int(maxiter)
|
|
95
|
+
self.krylov = conjugate_gradient
|
|
96
|
+
if not symmetric:
|
|
97
|
+
self.krylov = partial(gmres, recycle=recycle, stagnation=GMRES_STAGNATION)
|
|
98
|
+
if recycle is not None:
|
|
99
|
+
recycle.renew()
|
|
100
|
+
|
|
101
|
+
def solve(self, rhs, x0=None, tol=None) -> tuple[np.ndarray, SolveInfo]:
|
|
102
|
+
"""Solution of ``K x = rhs`` to the relative residual ``tol`` (default: that of
|
|
103
|
+
the solver), from ``x0`` if given. The nodal forces of a periodic grid sum to
|
|
104
|
+
zero (the translations are the kernel of ``K``): the mean of ``rhs``, round-off,
|
|
105
|
+
is removed."""
|
|
106
|
+
b = np.asarray(rhs, dtype=float).reshape(-1, 3)
|
|
107
|
+
b = (b - b.mean(axis=0)).ravel()
|
|
108
|
+
n = b.size
|
|
109
|
+
t0 = time.perf_counter()
|
|
110
|
+
tol = self.tol if tol is None else float(tol)
|
|
111
|
+
norm_b = norm(b)
|
|
112
|
+
if norm_b == 0.0:
|
|
113
|
+
return np.zeros(n), SolveInfo(self.method, n, 0, 0.0, 0.0, 0.0)
|
|
114
|
+
start = None if x0 is None or not np.any(x0) else np.asarray(x0, dtype=float)
|
|
115
|
+
r = b if start is None else b - self.apply(start)
|
|
116
|
+
norm_r = norm(r)
|
|
117
|
+
iterations, residual = 0, norm_r / norm_b
|
|
118
|
+
if norm_r <= tol * norm_b:
|
|
119
|
+
x = np.zeros(n) if start is None else start.copy()
|
|
120
|
+
else:
|
|
121
|
+
x, iterations, rel = self.krylov(
|
|
122
|
+
self.apply, self.precondition, r, tol * norm_b / norm_r, self.maxiter
|
|
123
|
+
)
|
|
124
|
+
residual = rel * norm_r / norm_b
|
|
125
|
+
if start is not None:
|
|
126
|
+
x += start
|
|
127
|
+
if residual > 10 * tol:
|
|
128
|
+
log.warning(
|
|
129
|
+
"FFT solver stopped at relative residual %.2e (tolerance %.1e)", residual, tol
|
|
130
|
+
)
|
|
131
|
+
info = SolveInfo(self.method, n, iterations, residual, 0.0, time.perf_counter() - t0)
|
|
132
|
+
return x, info
|
|
133
|
+
|
|
134
|
+
|
|
135
|
+
class _VoxelPaths(_PointArrays):
|
|
136
|
+
"""Discretization of the loading paths on the voxels (see
|
|
137
|
+
:class:`~morphogen.homogenization.nonlinear._PathSolver`): the periodic nodal
|
|
138
|
+
fluctuation (3 unknowns per voxel), the integration points of the voxels that carry
|
|
139
|
+
material, the tangent applied matrix-free and solved by FFT-preconditioned conjugate
|
|
140
|
+
gradients (GMRES for full tangents); on the CPU (on the GPU:
|
|
141
|
+
:class:`morphogen.homogenization.gpu.VoxelPaths`)."""
|
|
142
|
+
|
|
143
|
+
def __init__(self, problem: NonlinearFFTProblem):
|
|
144
|
+
self.problem = problem
|
|
145
|
+
self.shape = problem.shape
|
|
146
|
+
self.finite = problem.finite
|
|
147
|
+
self.elem = problem.elem
|
|
148
|
+
self.slot = problem.slot
|
|
149
|
+
el = problem.element
|
|
150
|
+
self.g_gauss = np.array(el.g_gauss)
|
|
151
|
+
self.weight = float(el.weight)
|
|
152
|
+
self.n_q = 3 * int(np.prod(self.shape))
|
|
153
|
+
self.reference = problem._reference_element()
|
|
154
|
+
self.bbar = problem.integration == "bbar"
|
|
155
|
+
self.tol = problem.tol
|
|
156
|
+
self.maxiter = problem.maxiter or 20 * int(max(self.shape)) + 1000
|
|
157
|
+
#: The space that the GMRES solves of the path recycle (empty until one restarts)
|
|
158
|
+
self.recycling = Recycling()
|
|
159
|
+
self._buffers(problem.kind.size, 9 if self.finite else 6)
|
|
160
|
+
|
|
161
|
+
def _buffers(self, n_pts: int, nc: int) -> None:
|
|
162
|
+
"""The preconditioner and the work arrays of ``n_pts`` points (``nc`` components)."""
|
|
163
|
+
self.precondition = FourierPreconditioner.from_element(self.shape, self.reference, 3)
|
|
164
|
+
self.work = np.zeros((n_pts, nc))
|
|
165
|
+
# F-bar: the gradients of the points and the stresses of their behaviours
|
|
166
|
+
keep = self.finite and self.bbar
|
|
167
|
+
self.base = np.zeros((n_pts if keep else 1, 9))
|
|
168
|
+
self.stress = np.zeros((n_pts if keep else 1, nc))
|
|
169
|
+
self.zero = np.zeros(9)
|
|
170
|
+
|
|
171
|
+
def _nodal(self, s) -> tuple[np.ndarray, float]:
|
|
172
|
+
"""Nodal forces of the point stresses ``s`` and their norm before they cancel;
|
|
173
|
+
forces below ``NEGLIGIBLE`` times that norm are round-off (uniform stresses, as
|
|
174
|
+
in a homogeneous medium), set to zero."""
|
|
175
|
+
nx, ny, nz = self.shape
|
|
176
|
+
out = np.empty(self.n_q)
|
|
177
|
+
scale = kernels.voxel_forces(
|
|
178
|
+
nx, ny, nz, self.slot, s, self.weight, self.g_gauss, self.finite, out
|
|
179
|
+
)
|
|
180
|
+
if norm(out) <= NEGLIGIBLE * scale:
|
|
181
|
+
out[:] = 0.0
|
|
182
|
+
return out, scale
|
|
183
|
+
|
|
184
|
+
def _macro(self, e) -> np.ndarray:
|
|
185
|
+
"""Macroscopic gradient (9, row by row) of the macroscopic components ``e``:
|
|
186
|
+
upper triangular in finite strains, symmetric in small strains."""
|
|
187
|
+
if self.finite:
|
|
188
|
+
return fin.gradient_of(e)
|
|
189
|
+
return voigt_to_tensor(e, strain=True).ravel()
|
|
190
|
+
|
|
191
|
+
def measures(self, q, e, grads, wts) -> None:
|
|
192
|
+
nx, ny, nz = self.shape
|
|
193
|
+
kernels.voxel_measures(nx, ny, nz, self.elem, q, self._macro(e), self.g_gauss,
|
|
194
|
+
self.finite, self.bbar, grads, self.base) # fmt: skip
|
|
195
|
+
wts.fill(self.weight)
|
|
196
|
+
|
|
197
|
+
def forces(self, sigma, wts):
|
|
198
|
+
"""With B-bar (F-bar), the stresses of the points are first replaced by their
|
|
199
|
+
conjugates: the outputs report them."""
|
|
200
|
+
if self.bbar:
|
|
201
|
+
if self.finite:
|
|
202
|
+
np.copyto(self.stress, sigma)
|
|
203
|
+
kernels.voxel_effective(self.elem.size, self.finite, sigma, self.base)
|
|
204
|
+
out, scale = self._nodal(sigma)
|
|
205
|
+
return out, self.weight * sigma.sum(axis=0), scale
|
|
206
|
+
|
|
207
|
+
def _increments(self, v, direction, tangent) -> np.ndarray:
|
|
208
|
+
"""Stress increments (conjugate ones with B-bar) of the points for the nodal
|
|
209
|
+
displacements ``v`` and the uniform gradient ``direction``."""
|
|
210
|
+
nx, ny, nz = self.shape
|
|
211
|
+
kernels.voxel_tangent_stress(nx, ny, nz, self.elem, v, direction, tangent, self.stress,
|
|
212
|
+
self.base, self.g_gauss, self.finite, self.bbar,
|
|
213
|
+
self.work) # fmt: skip
|
|
214
|
+
return self.work
|
|
215
|
+
|
|
216
|
+
#: The linear solver is a Krylov method (see :attr:`_PathSolver.measured`)
|
|
217
|
+
iterative = True
|
|
218
|
+
|
|
219
|
+
def linearize(self, tangent, wts, first: bool, symmetric: bool | None = None):
|
|
220
|
+
def apply(v):
|
|
221
|
+
return self._nodal(self._increments(v, self.zero, tangent))[0]
|
|
222
|
+
|
|
223
|
+
symmetric = self.problem.symmetrize if symmetric is None else symmetric
|
|
224
|
+
return _KrylovSolver(apply, self.precondition, self.tol, self.maxiter, symmetric,
|
|
225
|
+
self.recycling) # fmt: skip
|
|
226
|
+
|
|
227
|
+
def macro_response(self, tangent, wts, v) -> np.ndarray:
|
|
228
|
+
"""``K_Ew v``: the integral of the stress increments (conjugate ones with B-bar and
|
|
229
|
+
F-bar) of the points for the nodal fluctuation ``v``."""
|
|
230
|
+
total = self.weight * self._increments(v, self.zero, tangent).sum(axis=0)
|
|
231
|
+
return fin.macro_part(total) if self.finite else total
|
|
232
|
+
|
|
233
|
+
def coupling(self, tangent, wts, unknown):
|
|
234
|
+
g = np.empty((self.n_q, unknown.size))
|
|
235
|
+
kee = np.zeros((6, 6))
|
|
236
|
+
still = np.zeros(self.n_q)
|
|
237
|
+
for k, j in enumerate(unknown):
|
|
238
|
+
unit = np.zeros(6)
|
|
239
|
+
unit[j] = 1.0
|
|
240
|
+
ds = self._increments(still, self._macro(unit), tangent)
|
|
241
|
+
g[:, k] = self._nodal(ds)[0]
|
|
242
|
+
total = self.weight * ds.sum(axis=0)
|
|
243
|
+
kee[:, j] = fin.macro_part(total) if self.finite else total
|
|
244
|
+
return g, kee
|
|
245
|
+
|
|
246
|
+
def displacement(self, q, e) -> np.ndarray:
|
|
247
|
+
"""Displacement at the centres of all the voxels (voxels x 3)."""
|
|
248
|
+
image = self.problem.image
|
|
249
|
+
nx, ny, nz = self.shape
|
|
250
|
+
if self.finite:
|
|
251
|
+
macro = fin.gradient_of(e).reshape(3, 3)
|
|
252
|
+
else:
|
|
253
|
+
macro = voigt_to_tensor(e, strain=True)
|
|
254
|
+
axes = [
|
|
255
|
+
image.origin[d] + (np.arange(n) + 0.5) * image.spacing[d]
|
|
256
|
+
for d, n in enumerate(self.shape)
|
|
257
|
+
]
|
|
258
|
+
x = np.stack(np.meshgrid(*axes, indexing="ij"), axis=-1).reshape(-1, 3)
|
|
259
|
+
mean = np.empty((nx * ny * nz, 3))
|
|
260
|
+
kernels.voxel_centres(nx, ny, nz, q, mean)
|
|
261
|
+
return x @ macro.T + mean
|
|
262
|
+
|
|
263
|
+
|
|
264
|
+
class NonlinearFFTProblem(_PathSolver, FFTElasticProblem):
|
|
265
|
+
"""Nonlinear behaviours of the phases (von Mises elasto-(visco)plasticity, crystal
|
|
266
|
+
plasticity) on a periodic voxel image, loaded along paths: the periodic element on
|
|
267
|
+
trilinear voxels, whose macroscopic strain components are degrees of freedom, each
|
|
268
|
+
Newton correction solved by FFT-preconditioned conjugate gradients (GMRES with full
|
|
269
|
+
tangents), in small or finite strains (``kinematics``). Crystals are turned by the
|
|
270
|
+
orientations of their grains (``grains``: image or array of grain labels;
|
|
271
|
+
``orientations``: Bunge angles of each grain).
|
|
272
|
+
|
|
273
|
+
``integration``: ``"bbar"`` (default) averages the volumetric part of the measures
|
|
274
|
+
over each voxel (B-bar in small strains, F-bar in finite strains), so that the
|
|
275
|
+
trilinear voxels do not lock under isochoric plastic flow; ``"full"`` integrates every
|
|
276
|
+
component at the 8 Gauss points (the discretization of the linear FFT solver).
|
|
277
|
+
``device``: ``"gpu"`` runs the iterations on the GPU, where the arrays of the points
|
|
278
|
+
stay (the measures, the integration of the behaviours, the nodal forces and the
|
|
279
|
+
conjugate gradients; see :mod:`morphogen.homogenization.gpu`), ``"auto"`` when there
|
|
280
|
+
is one. ``tangent``: the consistent tangents of the points symmetrized and solved by
|
|
281
|
+
conjugate gradients (``"symmetric"``), full and solved by GMRES (``"full"``), or by
|
|
282
|
+
default (``"auto"``) symmetrized when the laws of all the phases have symmetric
|
|
283
|
+
tangents (:func:`~morphogen.homogenization.nonlinear.behaviour_table`:
|
|
284
|
+
:attr:`symmetrize` tells which), and otherwise at each linearization where their
|
|
285
|
+
asymmetry is below :data:`~morphogen.homogenization.nonlinear.ASYMMETRY`
|
|
286
|
+
(:attr:`measured`; the outputs report the largest asymmetry and the linearizations
|
|
287
|
+
solved with the full tangents).
|
|
288
|
+
``tol``: relative residual of the conjugate gradients (the Newton corrections are
|
|
289
|
+
solved inexactly above it); ``maxiter``: their iterations; ``reference``: Lamé
|
|
290
|
+
coefficients of the reference medium of the preconditioner (default: the means of the
|
|
291
|
+
extreme elastic moduli of the phases); ``newton_tol``, ``max_newton`` and
|
|
292
|
+
``max_cuts``: as for :class:`~morphogen.homogenization.nonlinear.NonlinearFEProblem`.
|
|
293
|
+
"""
|
|
294
|
+
|
|
295
|
+
def __init__(
|
|
296
|
+
self,
|
|
297
|
+
image: VoxelImage,
|
|
298
|
+
materials: dict[int, Material],
|
|
299
|
+
bc: str = "periodic",
|
|
300
|
+
*,
|
|
301
|
+
tol: float = 1e-8,
|
|
302
|
+
maxiter: int | None = None,
|
|
303
|
+
reference: tuple[float, float] | None = None,
|
|
304
|
+
grains=None,
|
|
305
|
+
orientations=None,
|
|
306
|
+
newton_tol: float = 1e-6,
|
|
307
|
+
max_newton: int = 25,
|
|
308
|
+
max_cuts: int = 10,
|
|
309
|
+
kinematics: str = "small",
|
|
310
|
+
integration: str = "bbar",
|
|
311
|
+
device: str = "cpu",
|
|
312
|
+
tangent: str = "auto",
|
|
313
|
+
):
|
|
314
|
+
if integration not in INTEGRATIONS:
|
|
315
|
+
raise ValueError(f"integration: one of {INTEGRATIONS}, got {integration!r}")
|
|
316
|
+
self.integration = integration
|
|
317
|
+
super().__init__(
|
|
318
|
+
image,
|
|
319
|
+
materials,
|
|
320
|
+
bc,
|
|
321
|
+
tol=tol,
|
|
322
|
+
maxiter=maxiter,
|
|
323
|
+
reference=reference,
|
|
324
|
+
grains=grains,
|
|
325
|
+
orientations=orientations,
|
|
326
|
+
device=device,
|
|
327
|
+
)
|
|
328
|
+
self._path_options(newton_tol, max_newton, max_cuts, kinematics, tangent)
|
|
329
|
+
self.materials = materials
|
|
330
|
+
self._smoothing: dict = {} # the Fourier symbols of the equation of the microdamage
|
|
331
|
+
self.groups: tuple[int, ...] = ()
|
|
332
|
+
if not self.empty:
|
|
333
|
+
# the voxels that carry material, and the phases they belong to
|
|
334
|
+
self.elem = np.flatnonzero(self.active)
|
|
335
|
+
self.slot = np.full(self.mat.size, -1, dtype=np.int64)
|
|
336
|
+
self.slot[self.elem] = np.arange(self.elem.size)
|
|
337
|
+
present = np.unique(self.stat[self.elem])
|
|
338
|
+
self.groups = tuple(self.table.phases[g] for g in present)
|
|
339
|
+
group = np.searchsorted(present, self.stat[self.elem])
|
|
340
|
+
table = dataclasses.replace(self.table, mat=self.mat[self.elem], stat=group)
|
|
341
|
+
phase = np.asarray(image.data).ravel()[self.elem]
|
|
342
|
+
beh = behaviour_table(phase, materials, table, finite=self.finite)
|
|
343
|
+
self._point_behaviours(beh, self.mat[self.elem], group, 8)
|
|
344
|
+
|
|
345
|
+
def _discretization(self) -> _VoxelPaths:
|
|
346
|
+
if self.device == "gpu":
|
|
347
|
+
from morphogen.homogenization import gpu
|
|
348
|
+
|
|
349
|
+
return gpu.VoxelPaths(self)
|
|
350
|
+
return _VoxelPaths(self)
|
|
351
|
+
|
|
352
|
+
def _support(self) -> VoxelImage:
|
|
353
|
+
return self.image
|
|
354
|
+
|
|
355
|
+
def _smooth(self, elements, values, length) -> np.ndarray:
|
|
356
|
+
"""The equation of the microdamage on the grid of the voxels, ``chi - length^2
|
|
357
|
+
lap chi = values`` with the ``values`` of the voxels ``elements`` (among those
|
|
358
|
+
that carry material; nothing elsewhere) and the seven-point Laplacian, solved in
|
|
359
|
+
Fourier space: the inverse of a positive operator, so that the microdamage of a
|
|
360
|
+
damage is positive, and spreads through the voxels of the other phases."""
|
|
361
|
+
voxels = self.elem[elements]
|
|
362
|
+
grid = np.zeros(self.mat.size)
|
|
363
|
+
grid[voxels] = values
|
|
364
|
+
symbol = self._smoothing.get(float(length))
|
|
365
|
+
if symbol is None:
|
|
366
|
+
symbol = np.ones(1)
|
|
367
|
+
for axis, (n, h) in enumerate(zip(self.shape, self.image.spacing, strict=True)):
|
|
368
|
+
last = axis == len(self.shape) - 1
|
|
369
|
+
k = np.arange(n // 2 + 1) if last else np.arange(n)
|
|
370
|
+
term = (length / h) ** 2 * (2.0 - 2.0 * np.cos(2.0 * np.pi * k / n))
|
|
371
|
+
shape = [1] * len(self.shape)
|
|
372
|
+
shape[axis] = term.size
|
|
373
|
+
symbol = symbol + term.reshape(shape)
|
|
374
|
+
self._smoothing[float(length)] = symbol
|
|
375
|
+
axes = tuple(range(len(self.shape)))
|
|
376
|
+
spectrum = np.fft.rfftn(grid.reshape(self.shape), axes=axes) / symbol
|
|
377
|
+
smooth = np.fft.irfftn(spectrum, s=self.shape, axes=axes)
|
|
378
|
+
return smooth.ravel()[voxels]
|
|
379
|
+
|
|
380
|
+
def _fields(self, sigma, grads, state, u) -> dict[str, np.ndarray]:
|
|
381
|
+
"""The fields of the finite elements on the grid of the image (voxels x
|
|
382
|
+
components; NaN in the pores), the displacement at the centres of the voxels."""
|
|
383
|
+
out = {}
|
|
384
|
+
for name, values in super()._fields(sigma, grads, state, u).items():
|
|
385
|
+
if name == "displacement":
|
|
386
|
+
out[name] = values.reshape(*self.shape, 3)
|
|
387
|
+
continue
|
|
388
|
+
full = np.full((self.mat.size, *values.shape[1:]), np.nan)
|
|
389
|
+
full[self.elem] = values
|
|
390
|
+
out[name] = full.reshape(*self.shape, *values.shape[1:])
|
|
391
|
+
return out
|