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,212 @@
|
|
|
1
|
+
"""Learning from a configuration (``morphogen learn``): the data of a behaviour at a
|
|
2
|
+
material point or of a microstructure along random paths, the training of a model, its
|
|
3
|
+
errors on the validation paths and on named paths that the learned law runs at a
|
|
4
|
+
material point against the reference, the files of the model and of the data.
|
|
5
|
+
|
|
6
|
+
A configuration (a mapping, or its ``learning`` mapping)::
|
|
7
|
+
|
|
8
|
+
material: {young: 200000, poisson: 0.3, plasticity: {yield: 200, hardening: 10000}}
|
|
9
|
+
# or a microstructure: sample: image.npy, materials: {0: ..., 1: ...}, bc: periodic
|
|
10
|
+
kinematics: small
|
|
11
|
+
data: {paths: 128, segments: 4, increments: 8, amplitude: 0.01, volumetric: 0.2,
|
|
12
|
+
kind: walk, components: null, free: false, rate: null, seed: 0,
|
|
13
|
+
validation: 0.25}
|
|
14
|
+
model: {kind: recurrent, hidden: 32, rate: false, seed: 0} # or kind: standard, internal: 8
|
|
15
|
+
# (and strain: logarithmic or green-lagrange, the strain a model sees in finite strains)
|
|
16
|
+
training: {epochs: 300, batch: 16, learning_rate: 0.01, final: 0.1, patience: null,
|
|
17
|
+
clip: 1.0, rotate: false, seed: 0}
|
|
18
|
+
paths: {cycle: "t=0,1,3 n=8,16 E11=0,0.01,-0.01"}
|
|
19
|
+
output: model.npz
|
|
20
|
+
save_data: data.npz
|
|
21
|
+
|
|
22
|
+
``data`` are the options of :func:`~morphogen.learning.data.random_paths` and the fraction
|
|
23
|
+
of validation paths, ``model`` those of :func:`~morphogen.learning.networks.make_model`
|
|
24
|
+
(``hidden`` by default 32, or two layers of 32; ``internal``, the internal variables of a
|
|
25
|
+
``standard`` model, by default 8; ``strain``, the strain that a model of any kind sees in
|
|
26
|
+
finite strains: ``logarithmic``, the default, ``1/2 ln C`` and its conjugate stress, or
|
|
27
|
+
``green-lagrange``, ``E`` and ``S``), ``training`` those of
|
|
28
|
+
:func:`~morphogen.learning.training.train` (``rotate``: true for isotropic behaviours,
|
|
29
|
+
``cubic`` for a cubic crystal in its axes). The learned law of a crystal runs in the axes
|
|
30
|
+
of its material, turned by the orientation of each grain (``learned: {model: ...,
|
|
31
|
+
oriented: true}``, the default); the elastic constants and the thermal expansion of a
|
|
32
|
+
reference material go to its learned material.
|
|
33
|
+
"""
|
|
34
|
+
|
|
35
|
+
from __future__ import annotations
|
|
36
|
+
|
|
37
|
+
import math
|
|
38
|
+
from collections.abc import Callable
|
|
39
|
+
from pathlib import Path
|
|
40
|
+
|
|
41
|
+
import numpy as np
|
|
42
|
+
|
|
43
|
+
from morphogen.homogenization.paths import LoadingPath
|
|
44
|
+
from morphogen.learning.behaviour import learned_material
|
|
45
|
+
from morphogen.learning.data import generate, random_paths, responder
|
|
46
|
+
from morphogen.learning.networks import Model, make_model
|
|
47
|
+
from morphogen.learning.training import errors, train
|
|
48
|
+
|
|
49
|
+
#: The keys of a configuration, and the defaults of its sections
|
|
50
|
+
KEYS = ("material", "sample", "materials", "bc", "kinematics", "data", "model", "training",
|
|
51
|
+
"paths", "output", "save_data") # fmt: skip
|
|
52
|
+
DATA = {"paths": 128, "segments": 4, "increments": 8, "amplitude": 0.01, "volumetric": 0.2,
|
|
53
|
+
"kind": "walk", "components": None, "free": False, "rate": None, "seed": 0,
|
|
54
|
+
"validation": 0.25} # fmt: skip
|
|
55
|
+
MODEL = {"kind": "recurrent", "hidden": None, "rate": False, "internal": None, "strain": None,
|
|
56
|
+
"seed": 0} # fmt: skip
|
|
57
|
+
TRAINING = {"epochs": 300, "batch": 16, "learning_rate": 0.01, "final": 0.1, "patience": None,
|
|
58
|
+
"clip": 1.0, "rotate": False, "seed": 0} # fmt: skip
|
|
59
|
+
|
|
60
|
+
|
|
61
|
+
def _section(cfg: dict, name: str, defaults: dict) -> dict:
|
|
62
|
+
given = cfg.get(name) or {}
|
|
63
|
+
if not isinstance(given, dict):
|
|
64
|
+
raise ValueError(f"learning.{name}: a mapping")
|
|
65
|
+
unknown = sorted(set(given) - set(defaults))
|
|
66
|
+
if unknown:
|
|
67
|
+
raise ValueError(f"learning.{name}: unknown keys {unknown}; allowed {sorted(defaults)}")
|
|
68
|
+
return {**defaults, **given}
|
|
69
|
+
|
|
70
|
+
|
|
71
|
+
def source_of(cfg: dict, base=None, kinematics: str = "small") -> Callable:
|
|
72
|
+
"""The response to a path of the ``material`` (a material point) or of the ``sample``
|
|
73
|
+
(a voxel image, relative to ``base``) of ``materials`` (the FFT solver of the paths,
|
|
74
|
+
under the boundary condition ``bc``) of a configuration."""
|
|
75
|
+
if ("material" in cfg) == ("sample" in cfg):
|
|
76
|
+
raise ValueError("learning: give a material (a material point) or a sample (an image)")
|
|
77
|
+
if "material" in cfg:
|
|
78
|
+
return responder(cfg["material"], kinematics)
|
|
79
|
+
from morphogen import io
|
|
80
|
+
from morphogen.homogenization import materials_from_config
|
|
81
|
+
from morphogen.homogenization.fft_nonlinear import NonlinearFFTProblem
|
|
82
|
+
|
|
83
|
+
if "materials" not in cfg:
|
|
84
|
+
raise ValueError("learning.sample: give the materials of its phases")
|
|
85
|
+
sample = Path(cfg["sample"])
|
|
86
|
+
image = io.load_image(sample if base is None or sample.is_absolute() else Path(base) / sample)
|
|
87
|
+
problem = NonlinearFFTProblem(image, materials_from_config(cfg["materials"]),
|
|
88
|
+
cfg.get("bc", "periodic"), kinematics=kinematics) # fmt: skip
|
|
89
|
+
return problem.run
|
|
90
|
+
|
|
91
|
+
|
|
92
|
+
def _at(result, key: str, times) -> np.ndarray:
|
|
93
|
+
"""The strains or stresses (``key``) of a response at ``times`` (times x 6)."""
|
|
94
|
+
values = np.asarray(getattr(result, key))
|
|
95
|
+
return np.array([np.interp(times, result.times, values[:, c]) for c in range(6)]).T
|
|
96
|
+
|
|
97
|
+
|
|
98
|
+
def reference_elasticity(source) -> dict:
|
|
99
|
+
"""The elastic constants of a reference material (young, poisson), for the linear
|
|
100
|
+
problems and the reference media of its learned law, and its thermal expansion; none
|
|
101
|
+
of a microstructure, nor the constants of a crystal (the learned law then takes those
|
|
102
|
+
of its initial tangent)."""
|
|
103
|
+
from morphogen.homogenization.materials import Material
|
|
104
|
+
|
|
105
|
+
if callable(source) and not isinstance(source, (dict, Material)):
|
|
106
|
+
return {}
|
|
107
|
+
reference = Material.from_config(source)
|
|
108
|
+
out = {}
|
|
109
|
+
if reference.young is not None:
|
|
110
|
+
out = {"young": reference.young, "poisson": reference.poisson}
|
|
111
|
+
if reference.expands:
|
|
112
|
+
out["expansion"] = reference.expansion
|
|
113
|
+
return out
|
|
114
|
+
|
|
115
|
+
|
|
116
|
+
def compare_path(material, respond, path, kinematics: str = "small", orientation=None) -> tuple:
|
|
117
|
+
"""The response of the reference ``respond`` along ``path`` (a
|
|
118
|
+
:class:`~morphogen.homogenization.paths.LoadingPath`), that of the learned ``material``
|
|
119
|
+
at a material point (turned by ``orientation``, Bunge angles; None where it fails) and
|
|
120
|
+
their gaps, a row of :func:`path_errors`."""
|
|
121
|
+
from morphogen.homogenization.nonlinear import simulate_point
|
|
122
|
+
|
|
123
|
+
ref = respond(path)
|
|
124
|
+
try: # a learned law may have no solution for the stresses prescribed
|
|
125
|
+
got = simulate_point(material, path, kinematics=kinematics, orientation=orientation,
|
|
126
|
+
max_cuts=4) # fmt: skip
|
|
127
|
+
except RuntimeError as exc:
|
|
128
|
+
return ref, None, {"stress": math.inf, "strain": math.inf, "failed": str(exc)}
|
|
129
|
+
times = np.concatenate([[path.times[0]], path.schedule()])
|
|
130
|
+
row = {}
|
|
131
|
+
for key in ("stress", "strain"):
|
|
132
|
+
a, b = _at(got, key, times), _at(ref, key, times)
|
|
133
|
+
row[key] = float(np.sqrt(np.sum((a - b) ** 2) / max(np.sum(b**2), 1e-300)))
|
|
134
|
+
row["final_stress"] = np.asarray(got.stress)[-1].tolist()
|
|
135
|
+
row["reference_stress"] = np.asarray(ref.stress)[-1].tolist()
|
|
136
|
+
return ref, got, row
|
|
137
|
+
|
|
138
|
+
|
|
139
|
+
def path_errors(model, source, paths, kinematics: str = "small", orientation=None) -> dict:
|
|
140
|
+
"""The gaps of the learned law of ``model`` at a material point to the responses of
|
|
141
|
+
``source`` (:func:`~morphogen.learning.data.responder`) along named ``paths`` (name ->
|
|
142
|
+
path, its specification or its text): the root mean square of the gaps of the stresses
|
|
143
|
+
(of the strains) relative to that of the stresses (of the strains) of the reference
|
|
144
|
+
at the planned steps, and the final stresses of both; infinite gaps and the message
|
|
145
|
+
where the learned law fails (no solution for the stresses prescribed, after four
|
|
146
|
+
divisions of a step). The learned material takes the elastic constants of a
|
|
147
|
+
reference material (else those of its initial tangent); ``orientation`` (Bunge
|
|
148
|
+
angles) turns both, a crystal and its law learned in its axes."""
|
|
149
|
+
respond = responder(source, kinematics, orientation)
|
|
150
|
+
material = learned_material(model, **reference_elasticity(source))
|
|
151
|
+
out = {}
|
|
152
|
+
for name, spec in dict(paths).items():
|
|
153
|
+
path = LoadingPath.parse(spec) if isinstance(spec, str) else LoadingPath.from_spec(spec)
|
|
154
|
+
out[str(name)] = compare_path(material, respond, path, kinematics, orientation)[2]
|
|
155
|
+
return out
|
|
156
|
+
|
|
157
|
+
|
|
158
|
+
def learn(
|
|
159
|
+
config: dict, base=None, *, callback=None, model: Model | None = None
|
|
160
|
+
) -> tuple[Model, dict]:
|
|
161
|
+
"""Learn the behaviour of a configuration (see the module): the trained model (or
|
|
162
|
+
``model``, trained further) and the summary of the data, of the training, of its
|
|
163
|
+
errors and of the files written (relative to ``base``). ``callback``: that of
|
|
164
|
+
:func:`~morphogen.learning.training.train`."""
|
|
165
|
+
cfg = config.get("learning", config) if isinstance(config, dict) else None
|
|
166
|
+
if not isinstance(cfg, dict):
|
|
167
|
+
raise ValueError("learning: a mapping")
|
|
168
|
+
unknown = sorted(set(cfg) - set(KEYS))
|
|
169
|
+
if unknown:
|
|
170
|
+
raise ValueError(f"learning: unknown keys {unknown}; allowed {sorted(KEYS)}")
|
|
171
|
+
kinematics = cfg.get("kinematics", "small")
|
|
172
|
+
base = None if base is None else Path(base)
|
|
173
|
+
data_opts = _section(cfg, "data", DATA)
|
|
174
|
+
model_opts = _section(cfg, "model", MODEL)
|
|
175
|
+
training = _section(cfg, "training", TRAINING)
|
|
176
|
+
source = source_of(cfg, base, kinematics)
|
|
177
|
+
validation = float(data_opts.pop("validation"))
|
|
178
|
+
count = int(data_opts.pop("paths"))
|
|
179
|
+
paths = random_paths(count, **data_opts)
|
|
180
|
+
info = {"source": cfg.get("material") or {"sample": str(cfg["sample"])},
|
|
181
|
+
"kinematics": kinematics, "paths": {"count": count, **data_opts}} # fmt: skip
|
|
182
|
+
data = generate(source, paths, kinematics=kinematics, info=info)
|
|
183
|
+
train_set, valid = data.split(validation, seed=int(data_opts["seed"]))
|
|
184
|
+
if model is None:
|
|
185
|
+
kind = model_opts.pop("kind")
|
|
186
|
+
hidden = model_opts.pop("hidden")
|
|
187
|
+
if kind not in ("recurrent", "standard"):
|
|
188
|
+
model_opts.pop("rate")
|
|
189
|
+
if hidden is not None:
|
|
190
|
+
model_opts["hidden"] = hidden
|
|
191
|
+
for key in ("internal", "strain"):
|
|
192
|
+
value = model_opts.pop(key)
|
|
193
|
+
if value is not None:
|
|
194
|
+
if key == "internal" and kind != "standard":
|
|
195
|
+
raise ValueError("learning.model.internal: the internal variables of a "
|
|
196
|
+
"standard model only") # fmt: skip
|
|
197
|
+
model_opts[key] = value
|
|
198
|
+
model = make_model(kind, **model_opts)
|
|
199
|
+
model.metadata["data"] = info
|
|
200
|
+
fit = train(model, train_set, valid, callback=callback, **training)
|
|
201
|
+
out = {"model": model.kind, "options": model.options, "paths": data.n_paths,
|
|
202
|
+
"points": data.n_points, "training": fit.summary()} # fmt: skip
|
|
203
|
+
out["validation"] = {k: v for k, v in errors(model, valid).items() if k != "paths"}
|
|
204
|
+
model.metadata["validation"] = out["validation"]
|
|
205
|
+
if cfg.get("paths"):
|
|
206
|
+
out["tests"] = path_errors(model, source, cfg["paths"], kinematics)
|
|
207
|
+
for key, write in (("output", model.save), ("save_data", data.save)):
|
|
208
|
+
if cfg.get(key):
|
|
209
|
+
target = Path(cfg[key])
|
|
210
|
+
target = target if base is None or target.is_absolute() else base / target
|
|
211
|
+
out[key] = str(write(target))
|
|
212
|
+
return model, out
|