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,81 @@
|
|
|
1
|
+
"""Behaviours learned from data: networks trained on the responses of morphoGen's
|
|
2
|
+
behaviours (or of a microstructure) along random loading paths, then integrated in place
|
|
3
|
+
of a behaviour.
|
|
4
|
+
|
|
5
|
+
* Data (:mod:`.data`): random strain paths, the responses of a material point
|
|
6
|
+
(:func:`~morphogen.homogenization.nonlinear.simulate_point`) or of the path solvers of a
|
|
7
|
+
microstructure along them, splits and normalization.
|
|
8
|
+
* Models (:mod:`.networks`), their gradients written out: a perceptron of the stress
|
|
9
|
+
(:class:`FeedForward`), the stress derived from a learned convex potential
|
|
10
|
+
(:class:`Potential`: hyperelastic, a symmetric positive tangent) and a recurrent network
|
|
11
|
+
over the strain increments with learned internal variables (:class:`Recurrent`:
|
|
12
|
+
path-dependent responses, plasticity) and a learned generalized standard material
|
|
13
|
+
(:class:`Standard`, :mod:`.standard`: a convex free energy and a convex dissipation
|
|
14
|
+
potential of learned internal variables, the state of a step the minimizer of the
|
|
15
|
+
incremental potential: a nonnegative dissipation and a symmetric tangent by
|
|
16
|
+
construction). In finite strains every model is of the logarithmic strain ``1/2 ln C``
|
|
17
|
+
(by default; its stress ``T`` conjugate to it, ``S = J^T T``, :mod:`.logarithmic`) or of
|
|
18
|
+
the Green-Lagrange strain, objective.
|
|
19
|
+
* Training (:mod:`.training`): Adam on mini-batches, early stopping on a validation
|
|
20
|
+
set, the paths turned by the symmetries of the behaviour (uniform rotations, those of
|
|
21
|
+
the cube), seeded; the files of the models (``.npz`` with JSON metadata).
|
|
22
|
+
* Learned laws (:mod:`.behaviour`): ``learned`` in the configuration of a material
|
|
23
|
+
integrates its points by a model, at a material point, by finite elements and on voxels,
|
|
24
|
+
in the axes of its material (turned by the orientation of each grain, as crystals), the
|
|
25
|
+
stress-free thermal strain of its expansion taken out.
|
|
26
|
+
* :func:`learn`: data, training, evaluation and file of a configuration (``morphogen
|
|
27
|
+
learn``).
|
|
28
|
+
* MFront sources (:mod:`.mfront`): a learned law as an MFront behaviour (its trained
|
|
29
|
+
parameters as constants, morphoGen's C++ port of the model, ``learned.cpp``), for
|
|
30
|
+
AMITEX_FFTP, Cast3M, Abaqus and Code_Aster (:func:`morphogen.io.mfront.mfront_source`,
|
|
31
|
+
``morphogen mfront``, the AMITEX and Abaqus exports).
|
|
32
|
+
"""
|
|
33
|
+
|
|
34
|
+
from morphogen.learning.behaviour import (
|
|
35
|
+
LearnedBehaviour,
|
|
36
|
+
LearnedLaw,
|
|
37
|
+
LearnedPoints,
|
|
38
|
+
isotropic_constants,
|
|
39
|
+
learned_law,
|
|
40
|
+
learned_material,
|
|
41
|
+
)
|
|
42
|
+
from morphogen.learning.data import Dataset, Scales, generate, random_paths, responder
|
|
43
|
+
from morphogen.learning.networks import (
|
|
44
|
+
KINDS,
|
|
45
|
+
FeedForward,
|
|
46
|
+
Model,
|
|
47
|
+
Potential,
|
|
48
|
+
Recurrent,
|
|
49
|
+
load_model,
|
|
50
|
+
make_model,
|
|
51
|
+
)
|
|
52
|
+
from morphogen.learning.run import learn, path_errors
|
|
53
|
+
from morphogen.learning.standard import Standard
|
|
54
|
+
from morphogen.learning.training import Training, errors, train
|
|
55
|
+
|
|
56
|
+
__all__ = [
|
|
57
|
+
"KINDS",
|
|
58
|
+
"Dataset",
|
|
59
|
+
"FeedForward",
|
|
60
|
+
"LearnedBehaviour",
|
|
61
|
+
"LearnedLaw",
|
|
62
|
+
"LearnedPoints",
|
|
63
|
+
"Model",
|
|
64
|
+
"Potential",
|
|
65
|
+
"Recurrent",
|
|
66
|
+
"Scales",
|
|
67
|
+
"Standard",
|
|
68
|
+
"Training",
|
|
69
|
+
"errors",
|
|
70
|
+
"generate",
|
|
71
|
+
"isotropic_constants",
|
|
72
|
+
"learn",
|
|
73
|
+
"learned_law",
|
|
74
|
+
"learned_material",
|
|
75
|
+
"load_model",
|
|
76
|
+
"make_model",
|
|
77
|
+
"path_errors",
|
|
78
|
+
"random_paths",
|
|
79
|
+
"responder",
|
|
80
|
+
"train",
|
|
81
|
+
]
|
|
@@ -0,0 +1,398 @@
|
|
|
1
|
+
"""Learned laws in the solvers of morphoGen: a material whose ``learned`` names a model
|
|
2
|
+
(:class:`LearnedBehaviour`) has its points integrated by the model, along the seam of the
|
|
3
|
+
MFront behaviours (points of the kind ``MFRONT``, which the kernels skip; their
|
|
4
|
+
integration after them): at a material point, by finite elements and on voxels. The
|
|
5
|
+
rest of the solvers is unchanged (the periodic element, Newton's method, the outputs);
|
|
6
|
+
the elastic constants of the material remain those of the linear problems and of the
|
|
7
|
+
reference medium of the FFT solver (:func:`learned_material` takes those of the initial
|
|
8
|
+
tangent of the model).
|
|
9
|
+
|
|
10
|
+
A step of a point gives the model the strain at its end, the strain and the state of the
|
|
11
|
+
model at its start (the internal variables of the point) and the time step: the stress
|
|
12
|
+
and the consistent tangent, and the state at its end. The tangent is exact at a material
|
|
13
|
+
point; in volume elements it is symmetrized for the conjugate gradients when the laws of
|
|
14
|
+
all the phases have symmetric tangents (those of the potential and of the standard model
|
|
15
|
+
are), and kept whole for GMRES otherwise (the perceptron, the recurrent network:
|
|
16
|
+
:attr:`LearnedLaw.symmetric`). In finite strains, the model of the Green-Lagrange strain
|
|
17
|
+
``E`` and the second Piola-Kirchhoff stress ``S`` gives the first Piola-Kirchhoff stress
|
|
18
|
+
``P = F S`` and its tangent ``dP/dF = I (x) S + F . dS/dE . dE/dF``.
|
|
19
|
+
|
|
20
|
+
A learned law depends on the temperature through the thermal expansion of its material
|
|
21
|
+
only, as morphoGen's own behaviours do: the model sees the mechanical strain, the strain
|
|
22
|
+
less the stress-free thermal strain ``alpha dT`` (``dT`` from the stress-free state, the
|
|
23
|
+
expansion tensor in the axes of the material). In finite strains the split is that of
|
|
24
|
+
morphoGen's Hencky points (:mod:`morphogen.homogenization.finite`): the mechanical
|
|
25
|
+
logarithmic strain ``H_m = 1/2 ln C - alpha dT``, the stress ``T`` conjugate to ``H = 1/2
|
|
26
|
+
ln C`` and the free energy per unit reference volume (no factor ``J_th``). The model sees
|
|
27
|
+
the Green-Lagrange strain of ``H_m``, ``E_m = (exp(2 H_m) - I)/2`` (a law of ``ln C``
|
|
28
|
+
sees ``H_m`` itself), its stress gives ``T = J_m^-T S_m`` and ``K = dT/dH = J_m^-T
|
|
29
|
+
(dS_m/dE_m - T : d2H/dE2 (E_m)) J_m^-1`` (``J = dH/dE``, ``J_m`` at ``E_m``), and ``S =
|
|
30
|
+
J^T T``, ``dS/dE = J^T K J + T : d2H/dE2`` (:mod:`morphogen.learning.logarithmic`): a law
|
|
31
|
+
of ``E`` that is Hencky's elasticity gives the stresses of the Hencky points. For an
|
|
32
|
+
isotropic expansion ``E_m = A (E + I/2) A - I/2`` and ``S = A S_m A`` (``A = exp(-alpha
|
|
33
|
+
dT)``: the multiplicative split ``F = F_m F_th``, ``F_th = exp(alpha dT)``); for an
|
|
34
|
+
anisotropic one that split is not the Hencky points' (the logarithms add only where ``C``
|
|
35
|
+
and ``alpha`` commute). Without an expansion, a change of temperature leaves the law
|
|
36
|
+
unchanged.
|
|
37
|
+
|
|
38
|
+
A learned law runs in the axes of its material, which the orientation of its point turns
|
|
39
|
+
as it turns crystals (``crystal = g sample``: Bunge angles at a material point, those of
|
|
40
|
+
the grain of each point in polycrystals): the model sees the strain ``g eps g^T`` (``g E
|
|
41
|
+
g^T`` in finite strains) and its stress and tangent are turned back, ``sigma = g^T
|
|
42
|
+
sigma_g g`` and ``C = T^T C_g T`` (``T``: the 6 x 6 matrix of ``g`` on the strains); a law
|
|
43
|
+
learned once in the axes of a crystal serves every grain. Without an orientation, or with
|
|
44
|
+
``oriented: false``, it runs in the axes of the sample. Order of the components at every
|
|
45
|
+
interface: morphoGen's Voigt order 11, 22, 33, 23, 31, 12 (engineering shears of the
|
|
46
|
+
strains) in the data, the models, the arrays of the points and the 6 x 6 rotations; the
|
|
47
|
+
learned points never pass TFEL's order 12, 13, 23 of the MFront points beside them.
|
|
48
|
+
|
|
49
|
+
Slots of the internal variables of a point: the plastic strain and the cumulated plastic
|
|
50
|
+
strain of the outputs (zero: the model has no plastic strain), the strain (or ``E``) of
|
|
51
|
+
the model at the end of the step (in the axes of its material), then the state of the
|
|
52
|
+
model.
|
|
53
|
+
"""
|
|
54
|
+
|
|
55
|
+
from __future__ import annotations
|
|
56
|
+
|
|
57
|
+
import math
|
|
58
|
+
from dataclasses import dataclass
|
|
59
|
+
from pathlib import Path
|
|
60
|
+
|
|
61
|
+
import numpy as np
|
|
62
|
+
|
|
63
|
+
from morphogen.homogenization.behaviours import MFRONT, STATE_P
|
|
64
|
+
from morphogen.learning.data import PAIRS, _tensor, _voigt
|
|
65
|
+
from morphogen.learning.logarithmic import _measures, _pullback
|
|
66
|
+
from morphogen.learning.networks import Model, load_model
|
|
67
|
+
|
|
68
|
+
_STRAIN = STATE_P + 1
|
|
69
|
+
_STATE = _STRAIN + 6
|
|
70
|
+
#: The models loaded from their files (path -> (modification time, model))
|
|
71
|
+
_LOADED: dict[str, tuple[float, Model]] = {}
|
|
72
|
+
|
|
73
|
+
|
|
74
|
+
@dataclass(frozen=True)
|
|
75
|
+
class LearnedBehaviour:
|
|
76
|
+
"""A learned law of a material: ``model``, the file of a model of
|
|
77
|
+
:mod:`morphogen.learning` (``.npz``, :meth:`~morphogen.learning.networks.Model.save`)
|
|
78
|
+
or the model itself; ``oriented``: the law in the axes of its material, turned by the
|
|
79
|
+
orientation of its point (that of its grain in a polycrystal) as a crystal is, or
|
|
80
|
+
(false) in the axes of the sample everywhere."""
|
|
81
|
+
|
|
82
|
+
model: object
|
|
83
|
+
oriented: bool = True
|
|
84
|
+
|
|
85
|
+
def __post_init__(self) -> None:
|
|
86
|
+
object.__setattr__(self, "oriented", bool(self.oriented))
|
|
87
|
+
if isinstance(self.model, (str, Path)):
|
|
88
|
+
object.__setattr__(self, "model", str(self.model))
|
|
89
|
+
elif not isinstance(self.model, Model):
|
|
90
|
+
raise ValueError("learned: the file of a model of morphogen.learning, or the model")
|
|
91
|
+
elif not self.model.ready:
|
|
92
|
+
raise ValueError("learned: the model is not trained")
|
|
93
|
+
|
|
94
|
+
@classmethod
|
|
95
|
+
def from_config(cls, spec) -> LearnedBehaviour:
|
|
96
|
+
"""The file of a model, or a mapping ``model: <file>`` (and ``oriented``)."""
|
|
97
|
+
if isinstance(spec, LearnedBehaviour):
|
|
98
|
+
return spec
|
|
99
|
+
if isinstance(spec, dict):
|
|
100
|
+
unknown = sorted(set(spec) - {"model", "oriented"})
|
|
101
|
+
if unknown or "model" not in spec:
|
|
102
|
+
raise ValueError(f"learned: a mapping of model (and oriented), got {sorted(spec)}")
|
|
103
|
+
return cls(spec["model"], spec.get("oriented", True))
|
|
104
|
+
return cls(spec)
|
|
105
|
+
|
|
106
|
+
def to_config(self) -> dict:
|
|
107
|
+
model = self.model
|
|
108
|
+
path = model.path if isinstance(model, Model) else model
|
|
109
|
+
out = {"model": None if path is None else str(path)}
|
|
110
|
+
if not self.oriented:
|
|
111
|
+
out["oriented"] = False
|
|
112
|
+
return out
|
|
113
|
+
|
|
114
|
+
def load(self) -> Model:
|
|
115
|
+
"""The model (loaded once from its file while the file does not change)."""
|
|
116
|
+
if isinstance(self.model, Model):
|
|
117
|
+
return self.model
|
|
118
|
+
path = Path(self.model)
|
|
119
|
+
if not path.is_file():
|
|
120
|
+
raise FileNotFoundError(f"learned: no model {path}")
|
|
121
|
+
key, stamp = str(path.resolve()), path.stat().st_mtime
|
|
122
|
+
cached = _LOADED.get(key)
|
|
123
|
+
if cached is None or cached[0] != stamp:
|
|
124
|
+
cached = (stamp, load_model(path))
|
|
125
|
+
_LOADED[key] = cached
|
|
126
|
+
return cached[1]
|
|
127
|
+
|
|
128
|
+
|
|
129
|
+
@dataclass
|
|
130
|
+
class LearnedLaw:
|
|
131
|
+
"""A learned law loaded for the points of a material: its model and kinematics, and
|
|
132
|
+
the thermal expansion of its material (3 x 3, per unit change of temperature, in the
|
|
133
|
+
axes of the material; None without one)."""
|
|
134
|
+
|
|
135
|
+
spec: LearnedBehaviour
|
|
136
|
+
model: Model
|
|
137
|
+
finite: bool
|
|
138
|
+
expansion: np.ndarray | None = None
|
|
139
|
+
|
|
140
|
+
@property
|
|
141
|
+
def width(self) -> int:
|
|
142
|
+
"""Internal variables of a point in morphoGen's arrays."""
|
|
143
|
+
return _STATE + self.model.n_state
|
|
144
|
+
|
|
145
|
+
@property
|
|
146
|
+
def symmetric(self) -> bool:
|
|
147
|
+
"""Whether the consistent tangent of the law is symmetric: that of a potential (the
|
|
148
|
+
Hessian of its free energy) and of a standard model (of its two convex
|
|
149
|
+
potentials), not those of the perceptron and of the recurrent network; a law that
|
|
150
|
+
says so itself (``model.symmetric``: those of
|
|
151
|
+
:mod:`morphogen.homogenization.laws`)."""
|
|
152
|
+
own = getattr(self.model, "symmetric", None)
|
|
153
|
+
return self.model.kind in ("potential", "standard") if own is None else bool(own)
|
|
154
|
+
|
|
155
|
+
|
|
156
|
+
def learned_law(spec, *, finite: bool, expansion=None) -> LearnedLaw:
|
|
157
|
+
"""The learned law of ``spec`` for the points of a solver, its model checked against
|
|
158
|
+
the kinematics (small strains, or the Green-Lagrange measures in finite strains);
|
|
159
|
+
``expansion``: the thermal expansion tensor of its material (in its axes)."""
|
|
160
|
+
spec = LearnedBehaviour.from_config(spec)
|
|
161
|
+
model = spec.load()
|
|
162
|
+
wanted = "green-lagrange" if finite else "small"
|
|
163
|
+
if model.measure != wanted:
|
|
164
|
+
kind = "finite" if finite else "small"
|
|
165
|
+
raise ValueError(f"learned: a model of {model.measure} data; the paths in {kind} "
|
|
166
|
+
f"strains need one of {wanted} data") # fmt: skip
|
|
167
|
+
if expansion is not None:
|
|
168
|
+
expansion = np.asarray(expansion, dtype=float).reshape(3, 3)
|
|
169
|
+
expansion = 0.5 * (expansion + expansion.T) if np.any(expansion) else None
|
|
170
|
+
return LearnedLaw(spec, model, bool(finite), expansion)
|
|
171
|
+
|
|
172
|
+
|
|
173
|
+
def finite_stress(f, s6, c6) -> tuple[np.ndarray, np.ndarray]:
|
|
174
|
+
"""The first Piola-Kirchhoff stresses (n, 9) and their tangents ``dP/dF`` (n, 9, 9;
|
|
175
|
+
tensors row by row) of the gradients ``f`` (n, 3, 3), of the second Piola-Kirchhoff
|
|
176
|
+
stresses ``s6`` (n, 6) and of their tangents with respect to the Green-Lagrange
|
|
177
|
+
strain ``c6`` (n, 6, 6; engineering shears)."""
|
|
178
|
+
n = f.shape[0]
|
|
179
|
+
s = _tensor(s6, engineering=False)
|
|
180
|
+
# dE_a/dF_kL: E_AA = (F_mA F_mA - 1) / 2, 2 E_AB = F_mA F_mB
|
|
181
|
+
de = np.zeros((n, 6, 3, 3))
|
|
182
|
+
for a, (i, j) in enumerate(PAIRS):
|
|
183
|
+
de[:, a, :, i] += f[:, :, j]
|
|
184
|
+
if i != j:
|
|
185
|
+
de[:, a, :, j] += f[:, :, i]
|
|
186
|
+
ds6 = np.einsum("nba,nakl->nbkl", c6, de)
|
|
187
|
+
ds = np.empty((n, 3, 3, 3, 3))
|
|
188
|
+
for b, (i, j) in enumerate(PAIRS):
|
|
189
|
+
ds[:, i, j] = ds6[:, b]
|
|
190
|
+
ds[:, j, i] = ds6[:, b]
|
|
191
|
+
tangent = np.einsum("ik,nlj->nijkl", np.eye(3), s) + np.einsum("nim,nmjkl->nijkl", f, ds)
|
|
192
|
+
return (f @ s).reshape(n, 9), tangent.reshape(n, 9, 9)
|
|
193
|
+
|
|
194
|
+
|
|
195
|
+
def turned(t, s, c) -> tuple[np.ndarray, np.ndarray]:
|
|
196
|
+
"""The stresses (n, 6) and tangents (n, 6, 6) of a law in the axes of its material
|
|
197
|
+
(``s``, ``c``) turned back to the axes of the sample by the 6 x 6 matrices ``t`` (n, 6,
|
|
198
|
+
6) of its orientations on the strains (engineering shears): ``T^T s`` and ``T^T c T``,
|
|
199
|
+
the work and the energy unchanged."""
|
|
200
|
+
return np.einsum("nji,nj->ni", t, s), np.einsum("nki,nkl,nlj->nij", t, c, t)
|
|
201
|
+
|
|
202
|
+
|
|
203
|
+
def thermal_split(e, heat, dtemp) -> np.ndarray:
|
|
204
|
+
"""The mechanical Green-Lagrange strains (n, 6; engineering shears) of Green-Lagrange
|
|
205
|
+
strains ``e`` (n, 6) heated by ``dtemp`` with the expansions ``heat`` (n, 3, 3), by the
|
|
206
|
+
split of the Hencky points: the Green-Lagrange strain ``E_m = (exp(2 H_m) - I)/2`` of
|
|
207
|
+
the mechanical logarithmic strain ``H_m = 1/2 ln C - dtemp alpha`` (``C = I + 2 E``;
|
|
208
|
+
``expm1`` of the eigenvalues of ``2 H_m``, exact to round-off near zero); NaN where
|
|
209
|
+
``C`` is not positive definite."""
|
|
210
|
+
h = _measures(np.ascontiguousarray(e, dtype=float), 1.0)[0]
|
|
211
|
+
h = h - float(dtemp) * _voigt(heat, engineering=True)
|
|
212
|
+
out = np.full_like(h, np.nan)
|
|
213
|
+
ok = np.all(np.isfinite(h), axis=1)
|
|
214
|
+
if ok.any():
|
|
215
|
+
w, v = np.linalg.eigh(_tensor(h[ok], engineering=True))
|
|
216
|
+
out[ok] = _voigt(np.einsum("nij,nj,nkj->nik", v, 0.5 * np.expm1(2.0 * w), v),
|
|
217
|
+
engineering=True) # fmt: skip
|
|
218
|
+
return out
|
|
219
|
+
|
|
220
|
+
|
|
221
|
+
def thermal_conjugate(e, em, s, c) -> tuple[np.ndarray, np.ndarray]:
|
|
222
|
+
"""The stresses (n, 6) conjugate to the Green-Lagrange strains ``e`` (n, 6) and their
|
|
223
|
+
tangents (n, 6, 6) of a law heated as the Hencky points are, of its stresses ``s`` and
|
|
224
|
+
tangents ``c`` at the mechanical strains ``em`` of :func:`thermal_split`: the stress
|
|
225
|
+
``T = J_m^-T S_m`` conjugate to the logarithmic strain and its tangent ``K = dT/dH =
|
|
226
|
+
J_m^-T (dS_m/dE_m - T : d2H/dE2 (E_m)) J_m^-1`` (``J = dH/dE``, ``J_m`` at ``em``),
|
|
227
|
+
then ``S = J^T T`` and ``dS/dE = J^T K J + T : d2H/dE2`` at ``e`` (``S : dE = T : dH =
|
|
228
|
+
S_m : dE_m``: the free energy of the law per unit reference volume); the tangent
|
|
229
|
+
symmetrized if that of the law is symmetric to the bit (a potential, a standard
|
|
230
|
+
model)."""
|
|
231
|
+
e, em = (np.ascontiguousarray(a, dtype=float) for a in (e, em))
|
|
232
|
+
s, c = np.asarray(s, dtype=float), np.asarray(c, dtype=float)
|
|
233
|
+
n = e.shape[0]
|
|
234
|
+
jm = _measures(em, 1.0)[1]
|
|
235
|
+
# J_m^-T where C is positive definite (NaN elsewhere, as the stresses: a failed point)
|
|
236
|
+
inverse = np.full((n, 6, 6), np.nan)
|
|
237
|
+
ok = np.all(np.isfinite(jm), axis=(1, 2))
|
|
238
|
+
if ok.any():
|
|
239
|
+
inverse[ok] = np.linalg.inv(np.swapaxes(jm[ok], 1, 2))
|
|
240
|
+
t = np.ascontiguousarray(np.einsum("nij,nj->ni", inverse, s))
|
|
241
|
+
geometric = _pullback(em, t, np.zeros((n, 6, 6)), 1.0, False)[1]
|
|
242
|
+
k = np.ascontiguousarray(inverse @ (c - geometric) @ np.swapaxes(inverse, 1, 2))
|
|
243
|
+
return _pullback(e, t, k, 1.0, bool(np.array_equal(c, np.swapaxes(c, 1, 2))))
|
|
244
|
+
|
|
245
|
+
|
|
246
|
+
def _model_step(model, e, e_old, h_old, dt, dtemp=0.0):
|
|
247
|
+
"""The step of ``model`` at the points of finite strains ``e`` (n, 6); NaN at the others,
|
|
248
|
+
where the model is not called: failed points (heated where ``C`` is not positive
|
|
249
|
+
definite, as a Hencky point fails, or of a gradient that is not finite). A model whose
|
|
250
|
+
law depends on the temperature (``model.thermal``: the shifted times of a
|
|
251
|
+
viscoelastic law) also gets the change of temperature ``dtemp``."""
|
|
252
|
+
extra = (dtemp,) if getattr(model, "thermal", False) else ()
|
|
253
|
+
ok = np.all(np.isfinite(e), axis=1)
|
|
254
|
+
if ok.all():
|
|
255
|
+
return model.step(e, e_old, h_old, dt, *extra)
|
|
256
|
+
n = e.shape[0]
|
|
257
|
+
s, c = np.full((n, 6), np.nan), np.full((n, 6, 6), np.nan)
|
|
258
|
+
h = np.full((n, model.n_state), np.nan)
|
|
259
|
+
if ok.any():
|
|
260
|
+
s[ok], c[ok], h[ok] = model.step(e[ok], e_old[ok], h_old[ok], dt, *extra)
|
|
261
|
+
return s, c, h
|
|
262
|
+
|
|
263
|
+
|
|
264
|
+
class LearnedPoints:
|
|
265
|
+
"""The integration points of the materials with a learned law (those of kind
|
|
266
|
+
``MFRONT`` among ``kind``, of the laws ``pmat``), integrated by their models in the
|
|
267
|
+
axes of their materials (``rotations``: the orientation of each row ``point_mat`` of
|
|
268
|
+
the materials, ``crystal = g sample``; the laws not oriented in the axes of the
|
|
269
|
+
sample); the interface of :class:`~morphogen.homogenization.mfront.MFrontPoints`."""
|
|
270
|
+
|
|
271
|
+
def __init__(self, laws, kind, pmat, point_mat, rotations, finite: bool, threads=None,
|
|
272
|
+
symmetric: bool = True): # fmt: skip
|
|
273
|
+
from morphogen.learning.training import voigt_rotations
|
|
274
|
+
|
|
275
|
+
self.finite = bool(finite)
|
|
276
|
+
self.symmetric = bool(symmetric)
|
|
277
|
+
self.points = np.flatnonzero(np.asarray(kind) == MFRONT)
|
|
278
|
+
pmat = np.asarray(pmat)[self.points]
|
|
279
|
+
point_mat = np.asarray(point_mat)[self.points]
|
|
280
|
+
self.groups = []
|
|
281
|
+
for c, law in enumerate(laws):
|
|
282
|
+
if law.finite != self.finite:
|
|
283
|
+
raise ValueError("learned: the law and the solver have other kinematics")
|
|
284
|
+
local = np.flatnonzero(pmat == c)
|
|
285
|
+
if not local.size:
|
|
286
|
+
continue
|
|
287
|
+
# the 6 x 6 matrices of the orientations of the points on the strains, if any
|
|
288
|
+
t = None
|
|
289
|
+
g = np.repeat(np.eye(3)[None], local.size, axis=0)
|
|
290
|
+
if rotations is not None and len(rotations):
|
|
291
|
+
g = np.asarray(rotations, dtype=float)[point_mat[local]]
|
|
292
|
+
turn = law.spec.oriented and not np.allclose(g, np.eye(3), rtol=0.0, atol=1e-14)
|
|
293
|
+
if turn:
|
|
294
|
+
t = voigt_rotations(g)[0]
|
|
295
|
+
# the expansions in the axes of the model: its material's, or (a law in the axes
|
|
296
|
+
# of the sample) turned by the orientation of the point as the kernels turn it
|
|
297
|
+
heat = None
|
|
298
|
+
if law.expansion is not None:
|
|
299
|
+
heat = np.repeat(law.expansion[None], local.size, axis=0)
|
|
300
|
+
if not law.spec.oriented:
|
|
301
|
+
heat = np.einsum("npi,pq,nqj->nij", g, law.expansion, g)
|
|
302
|
+
self.groups.append((law, local, t, heat))
|
|
303
|
+
|
|
304
|
+
def integrate(self, grads, dtemp, dt, old, new, stress, tangent) -> int:
|
|
305
|
+
"""Integration of the points of learned laws among the arrays of all the points;
|
|
306
|
+
returns the number of points whose stress is not finite."""
|
|
307
|
+
idx = self.points
|
|
308
|
+
out = [new[idx], stress[idx], tangent[idx]]
|
|
309
|
+
failed = self.integrate_compact(grads[idx], dtemp, dt, old[idx], *out)
|
|
310
|
+
new[idx], stress[idx], tangent[idx] = out
|
|
311
|
+
return failed
|
|
312
|
+
|
|
313
|
+
def integrate_compact(self, grads, dtemp, dt, old, new, stress, tangent) -> int:
|
|
314
|
+
"""The same for the arrays of these points only (in the order of :attr:`points`)."""
|
|
315
|
+
failed = 0
|
|
316
|
+
dtemp = float(dtemp)
|
|
317
|
+
for law, local, t, heat in self.groups:
|
|
318
|
+
o = old[local]
|
|
319
|
+
n_state = law.model.n_state
|
|
320
|
+
if self.finite: # E = (H + H^T + H^T H) / 2: no cancellation of 1
|
|
321
|
+
hg = np.asarray(grads[local]).reshape(-1, 3, 3)
|
|
322
|
+
f = np.eye(3) + hg
|
|
323
|
+
gl = hg + np.swapaxes(hg, 1, 2) + np.einsum("nki,nkj->nij", hg, hg)
|
|
324
|
+
e = _voigt(0.5 * gl, engineering=True)
|
|
325
|
+
else:
|
|
326
|
+
e = np.asarray(grads[local])
|
|
327
|
+
if t is not None: # in the axes of the material: g eps g^T (g E g^T)
|
|
328
|
+
e = np.einsum("nij,nj->ni", t, e)
|
|
329
|
+
total = None
|
|
330
|
+
if heat is not None and dtemp != 0.0: # the mechanical strain
|
|
331
|
+
if self.finite: # of the Hencky points: 1/2 ln C - alpha dT
|
|
332
|
+
total, e = e, thermal_split(e, heat, dtemp)
|
|
333
|
+
else:
|
|
334
|
+
e = e - dtemp * _voigt(heat, engineering=True)
|
|
335
|
+
s, c, h = _model_step(law.model, e, o[:, _STRAIN:_STATE],
|
|
336
|
+
o[:, _STATE : _STATE + n_state], dt, dtemp) # fmt: skip
|
|
337
|
+
if total is not None: # S = J^T T, T = J_m^-T S_m: conjugate to E
|
|
338
|
+
s, c = thermal_conjugate(total, e, s, c)
|
|
339
|
+
if t is not None:
|
|
340
|
+
s, c = turned(t, s, c)
|
|
341
|
+
if self.finite:
|
|
342
|
+
s, c = finite_stress(f, s, c)
|
|
343
|
+
if self.symmetric:
|
|
344
|
+
c = 0.5 * (c + np.swapaxes(c, 1, 2))
|
|
345
|
+
bad = ~(np.all(np.isfinite(s), axis=1) & np.all(np.isfinite(c), axis=(1, 2)))
|
|
346
|
+
failed += int(bad.sum())
|
|
347
|
+
stress[local] = s
|
|
348
|
+
tangent[local] = c
|
|
349
|
+
state = np.zeros((local.size, new.shape[1]))
|
|
350
|
+
state[:, _STRAIN:_STATE] = e
|
|
351
|
+
state[:, _STATE : _STATE + n_state] = h
|
|
352
|
+
if hasattr(law.model, "scalar"): # the variable p of the outputs (a damage)
|
|
353
|
+
state[:, STATE_P] = law.model.scalar(h)
|
|
354
|
+
new[local] = state
|
|
355
|
+
return failed
|
|
356
|
+
|
|
357
|
+
|
|
358
|
+
def isotropic_constants(stiffness) -> tuple[float, float]:
|
|
359
|
+
"""Young's modulus and Poisson's ratio of the isotropic projection (Voigt's means of
|
|
360
|
+
the bulk and shear moduli) of a 6 x 6 stiffness (engineering shears)."""
|
|
361
|
+
c = np.asarray(stiffness, dtype=float)
|
|
362
|
+
normal = np.trace(c[:3, :3])
|
|
363
|
+
off = c[0, 1] + c[0, 2] + c[1, 2]
|
|
364
|
+
bulk = (normal + 2.0 * off) / 9.0
|
|
365
|
+
shear = (normal - off + 3.0 * np.trace(c[3:, 3:])) / 15.0
|
|
366
|
+
if not (bulk > 0 and shear > 0):
|
|
367
|
+
raise ValueError("the stiffness has no positive isotropic part")
|
|
368
|
+
young = 9.0 * bulk * shear / (3.0 * bulk + shear)
|
|
369
|
+
poisson = (3.0 * bulk - 2.0 * shear) / (2.0 * (3.0 * bulk + shear))
|
|
370
|
+
return float(young), float(min(max(poisson, -0.99), 0.49))
|
|
371
|
+
|
|
372
|
+
|
|
373
|
+
def initial_tangent(model: Model) -> np.ndarray:
|
|
374
|
+
"""The tangent of a model at the natural state (of its first step from it)."""
|
|
375
|
+
zero = np.zeros((1, 6))
|
|
376
|
+
return model.step(zero, zero, np.zeros((1, model.n_state)), 1.0)[1][0]
|
|
377
|
+
|
|
378
|
+
|
|
379
|
+
def learned_material(
|
|
380
|
+
model, *, young: float | None = None, poisson: float | None = None, expansion=None
|
|
381
|
+
):
|
|
382
|
+
"""A :class:`~morphogen.homogenization.materials.Material` of the learned law of
|
|
383
|
+
``model`` (a model, its file, or a :class:`LearnedBehaviour`), its elastic constants
|
|
384
|
+
(the linear problems and the reference media) those given or of the isotropic
|
|
385
|
+
projection of its initial tangent; ``expansion``: its thermal expansion (one
|
|
386
|
+
coefficient, principal values or a tensor in the axes of the material), the
|
|
387
|
+
stress-free thermal strain taken out of the strain the model sees."""
|
|
388
|
+
from morphogen.homogenization.materials import Material
|
|
389
|
+
|
|
390
|
+
spec = LearnedBehaviour.from_config(model)
|
|
391
|
+
if young is None or poisson is None:
|
|
392
|
+
e, nu = isotropic_constants(initial_tangent(spec.load()))
|
|
393
|
+
young = e if young is None else young
|
|
394
|
+
poisson = nu if poisson is None else poisson
|
|
395
|
+
if not (math.isfinite(young) and young > 0):
|
|
396
|
+
raise ValueError(f"young: positive, got {young}")
|
|
397
|
+
return Material(young=float(young), poisson=float(poisson), expansion=expansion,
|
|
398
|
+
learned=spec) # fmt: skip
|