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,328 @@
|
|
|
1
|
+
"""Training data: random strain paths and the responses of a behaviour along them.
|
|
2
|
+
|
|
3
|
+
A path starts from the natural state and joins ``segments`` random strains linearly, each
|
|
4
|
+
segment in ``increments`` steps: a random walk (each strain the previous one plus a
|
|
5
|
+
random step, held within the amplitude) or independent strains (each component uniform
|
|
6
|
+
within the amplitude). The volumetric part of the strains is scaled by ``volumetric``:
|
|
7
|
+
the volumetric strains of metals are elastic and small, those of porous media are not.
|
|
8
|
+
The responses come from a material point (:func:`~morphogen.homogenization.nonlinear.
|
|
9
|
+
simulate_point`) or from any solver of the paths of a microstructure (the homogenized
|
|
10
|
+
response of :class:`~morphogen.homogenization.fft_nonlinear.NonlinearFFTProblem` or of
|
|
11
|
+
:class:`~morphogen.homogenization.nonlinear.NonlinearFEProblem`), at the planned steps
|
|
12
|
+
of each path (the steps that a solver divides are dropped).
|
|
13
|
+
|
|
14
|
+
In small strains the data are the strain (engineering shears) and the stress; in finite
|
|
15
|
+
strains the Green-Lagrange strain ``E = (F^T F - I) / 2`` (engineering shears) and the
|
|
16
|
+
second Piola-Kirchhoff stress ``S = J F^-1 sigma F^-T``, objective measures conjugate to
|
|
17
|
+
each other, whatever the rotation of the gradient (the upper triangular gradients of the
|
|
18
|
+
paths, their Cauchy stresses).
|
|
19
|
+
"""
|
|
20
|
+
|
|
21
|
+
from __future__ import annotations
|
|
22
|
+
|
|
23
|
+
import json
|
|
24
|
+
from collections.abc import Callable
|
|
25
|
+
from dataclasses import dataclass, field
|
|
26
|
+
from pathlib import Path
|
|
27
|
+
|
|
28
|
+
import numpy as np
|
|
29
|
+
|
|
30
|
+
from morphogen.homogenization.paths import LoadingPath, PathResult, _index
|
|
31
|
+
|
|
32
|
+
#: The kinds of random paths
|
|
33
|
+
KINDS = ("walk", "linear")
|
|
34
|
+
#: The measures of the data: small strains (the strain, the stress) or finite strains (the
|
|
35
|
+
#: Green-Lagrange strain, the second Piola-Kirchhoff stress)
|
|
36
|
+
MEASURES = ("small", "green-lagrange")
|
|
37
|
+
#: The Voigt pairs (11, 22, 33, 23, 31, 12)
|
|
38
|
+
PAIRS = ((0, 0), (1, 1), (2, 2), (1, 2), (2, 0), (0, 1))
|
|
39
|
+
_TRACE = np.array([1.0, 1.0, 1.0, 0.0, 0.0, 0.0])
|
|
40
|
+
_ENGINEERING = np.array([1.0, 1.0, 1.0, 2.0, 2.0, 2.0])
|
|
41
|
+
|
|
42
|
+
|
|
43
|
+
def random_paths(
|
|
44
|
+
n: int,
|
|
45
|
+
*,
|
|
46
|
+
segments: int = 4,
|
|
47
|
+
increments: int = 10,
|
|
48
|
+
amplitude: float = 0.01,
|
|
49
|
+
volumetric: float = 0.2,
|
|
50
|
+
kind: str = "walk",
|
|
51
|
+
components=None,
|
|
52
|
+
free=False,
|
|
53
|
+
rate: float | None = None,
|
|
54
|
+
seed: int = 0,
|
|
55
|
+
) -> list[LoadingPath]:
|
|
56
|
+
"""``n`` random strain paths of ``segments`` linear segments of ``increments`` steps.
|
|
57
|
+
|
|
58
|
+
The strains at the ends of the segments: with ``kind="walk"`` a random walk (steps of
|
|
59
|
+
tensor components uniform, of standard deviation ``amplitude / sqrt(segments)``, the
|
|
60
|
+
components held within ``amplitude``), with ``kind="linear"`` independent strains
|
|
61
|
+
(tensor components uniform within ``amplitude``); their volumetric part scaled by
|
|
62
|
+
``volumetric``. ``components``: the components driven (names ``"11"`` ... or Voigt
|
|
63
|
+
indices; by default all six), the others held at zero strain but those of ``free``
|
|
64
|
+
(components, or True for all of them), left free (zero stress): a tension-torsion
|
|
65
|
+
test drives 11 and 12 and frees 22 and 33. A model learns the responses to the
|
|
66
|
+
components of its data only: the paths it runs must hold the others likewise.
|
|
67
|
+
``rate``: the largest strain rate of a component on each segment (the segments then
|
|
68
|
+
last the time of their strain), by default a unit time each."""
|
|
69
|
+
if kind not in KINDS:
|
|
70
|
+
raise ValueError(f"kind: one of {KINDS}, got {kind!r}")
|
|
71
|
+
if int(n) < 1 or int(segments) < 1 or int(increments) < 1:
|
|
72
|
+
raise ValueError("paths, segments and increments: at least one")
|
|
73
|
+
if not (amplitude > 0 and volumetric >= 0):
|
|
74
|
+
raise ValueError("amplitude: positive; volumetric: non-negative")
|
|
75
|
+
if rate is not None and not rate > 0:
|
|
76
|
+
raise ValueError("rate: positive")
|
|
77
|
+
driven = list(range(6)) if components is None else sorted({_component(c) for c in components})
|
|
78
|
+
mask = np.zeros(6, dtype=bool)
|
|
79
|
+
mask[driven] = True
|
|
80
|
+
released = np.zeros(6, dtype=bool)
|
|
81
|
+
if free is True:
|
|
82
|
+
released = ~mask
|
|
83
|
+
elif free:
|
|
84
|
+
released[[_component(c) for c in free]] = True
|
|
85
|
+
if np.any(released & mask):
|
|
86
|
+
raise ValueError("free: components not driven")
|
|
87
|
+
rng = np.random.default_rng(seed)
|
|
88
|
+
step = amplitude / np.sqrt(segments) * np.sqrt(3.0) # uniform of that deviation
|
|
89
|
+
out = []
|
|
90
|
+
for _ in range(int(n)):
|
|
91
|
+
tensor = np.zeros(6) # tensor components (half the engineering shears)
|
|
92
|
+
ends = [np.zeros(6)]
|
|
93
|
+
for _ in range(int(segments)):
|
|
94
|
+
if kind == "walk":
|
|
95
|
+
tensor = np.clip(tensor + rng.uniform(-step, step, 6), -amplitude, amplitude)
|
|
96
|
+
else:
|
|
97
|
+
tensor = rng.uniform(-amplitude, amplitude, 6)
|
|
98
|
+
strain = np.where(mask, tensor, 0.0)
|
|
99
|
+
mean = strain[:3].mean() if mask[:3].all() else 0.0
|
|
100
|
+
strain = strain - (1.0 - volumetric) * mean * _TRACE
|
|
101
|
+
ends.append(strain * _ENGINEERING)
|
|
102
|
+
values = np.array(ends)
|
|
103
|
+
if rate is None:
|
|
104
|
+
times = np.arange(len(ends), dtype=float)
|
|
105
|
+
else:
|
|
106
|
+
span = np.abs(np.diff(values, axis=0)).max(axis=1)
|
|
107
|
+
times = np.concatenate([[0.0], np.cumsum(np.maximum(span, 1e-3 * amplitude) / rate)])
|
|
108
|
+
controls = ~released
|
|
109
|
+
out.append(LoadingPath(times, np.where(controls, values, 0.0), controls,
|
|
110
|
+
increments=(int(increments),))) # fmt: skip
|
|
111
|
+
return out
|
|
112
|
+
|
|
113
|
+
|
|
114
|
+
def _component(c) -> int:
|
|
115
|
+
if isinstance(c, (int, np.integer)):
|
|
116
|
+
if not 0 <= int(c) < 6:
|
|
117
|
+
raise ValueError(f"component index {c}: from 0 to 5")
|
|
118
|
+
return int(c)
|
|
119
|
+
return _index(str(c))
|
|
120
|
+
|
|
121
|
+
|
|
122
|
+
def _tensor(v, engineering: bool) -> np.ndarray:
|
|
123
|
+
"""Symmetric tensors (n, 3, 3) of Voigt components (n, 6)."""
|
|
124
|
+
v = np.asarray(v, dtype=float)
|
|
125
|
+
t = np.empty((*v.shape[:-1], 3, 3))
|
|
126
|
+
for k, (i, j) in enumerate(PAIRS):
|
|
127
|
+
x = v[..., k] * (0.5 if engineering and i != j else 1.0)
|
|
128
|
+
t[..., i, j] = x
|
|
129
|
+
t[..., j, i] = x
|
|
130
|
+
return t
|
|
131
|
+
|
|
132
|
+
|
|
133
|
+
def _voigt(t, engineering: bool) -> np.ndarray:
|
|
134
|
+
"""Voigt components (n, 6) of symmetric tensors (n, 3, 3)."""
|
|
135
|
+
out = np.stack([t[..., i, j] for i, j in PAIRS], axis=-1)
|
|
136
|
+
if engineering:
|
|
137
|
+
out[..., 3:] *= 2.0
|
|
138
|
+
return out
|
|
139
|
+
|
|
140
|
+
|
|
141
|
+
def gradient_tensor(h) -> np.ndarray:
|
|
142
|
+
"""The deformation gradients ``F`` (n, 3, 3) of the components 11, 22, 33, 23, 13, 12 of
|
|
143
|
+
the upper triangular displacement gradients of the paths in finite strains (n, 6)."""
|
|
144
|
+
h = np.asarray(h, dtype=float)
|
|
145
|
+
f = np.zeros((*h.shape[:-1], 3, 3))
|
|
146
|
+
f[..., [0, 1, 2], [0, 1, 2]] = 1.0 + h[..., :3]
|
|
147
|
+
f[..., 1, 2], f[..., 0, 2], f[..., 0, 1] = h[..., 3], h[..., 4], h[..., 5]
|
|
148
|
+
return f
|
|
149
|
+
|
|
150
|
+
|
|
151
|
+
def green_lagrange(f) -> np.ndarray:
|
|
152
|
+
"""The Green-Lagrange strains (n, 6; engineering shears) of gradients ``F`` (n, 3, 3)."""
|
|
153
|
+
c = np.einsum("...ki,...kj->...ij", f, f)
|
|
154
|
+
return _voigt(0.5 * (c - np.eye(3)), engineering=True)
|
|
155
|
+
|
|
156
|
+
|
|
157
|
+
def second_piola(f, cauchy) -> np.ndarray:
|
|
158
|
+
"""The second Piola-Kirchhoff stresses (n, 6) of the gradients ``F`` (n, 3, 3) and the
|
|
159
|
+
Cauchy stresses (n, 6)."""
|
|
160
|
+
inv = np.linalg.inv(f)
|
|
161
|
+
s = np.linalg.det(f)[..., None, None] * inv @ _tensor(cauchy, False) @ np.swapaxes(inv, -1, -2)
|
|
162
|
+
return _voigt(s, engineering=False)
|
|
163
|
+
|
|
164
|
+
|
|
165
|
+
@dataclass
|
|
166
|
+
class Dataset:
|
|
167
|
+
"""Responses along paths: the ``times`` (paths x points), the ``strain`` and the
|
|
168
|
+
``stress`` (paths x points x 6, Voigt; engineering shears), the first point of each
|
|
169
|
+
path the natural state, in small strains or (``measure="green-lagrange"``) the
|
|
170
|
+
Green-Lagrange strain and the second Piola-Kirchhoff stress; ``info``: how they were
|
|
171
|
+
made (the behaviour, the paths)."""
|
|
172
|
+
|
|
173
|
+
times: np.ndarray
|
|
174
|
+
strain: np.ndarray
|
|
175
|
+
stress: np.ndarray
|
|
176
|
+
measure: str = "small"
|
|
177
|
+
info: dict = field(default_factory=dict)
|
|
178
|
+
|
|
179
|
+
def __post_init__(self) -> None:
|
|
180
|
+
self.times = np.atleast_2d(np.asarray(self.times, dtype=float))
|
|
181
|
+
self.strain = np.asarray(self.strain, dtype=float)
|
|
182
|
+
self.stress = np.asarray(self.stress, dtype=float)
|
|
183
|
+
n, m = self.times.shape
|
|
184
|
+
if self.strain.shape != (n, m, 6) or self.stress.shape != (n, m, 6) or m < 2:
|
|
185
|
+
raise ValueError("data: times (paths x points), strains and stresses (x 6)")
|
|
186
|
+
if self.measure not in MEASURES:
|
|
187
|
+
raise ValueError(f"measure: one of {MEASURES}, got {self.measure!r}")
|
|
188
|
+
if not (np.all(np.isfinite(self.strain)) and np.all(np.isfinite(self.stress))):
|
|
189
|
+
raise ValueError("data: finite strains and stresses")
|
|
190
|
+
|
|
191
|
+
@property
|
|
192
|
+
def n_paths(self) -> int:
|
|
193
|
+
return self.times.shape[0]
|
|
194
|
+
|
|
195
|
+
@property
|
|
196
|
+
def n_points(self) -> int:
|
|
197
|
+
return self.times.shape[1]
|
|
198
|
+
|
|
199
|
+
def subset(self, index) -> Dataset:
|
|
200
|
+
"""The paths of ``index``."""
|
|
201
|
+
index = np.asarray(index)
|
|
202
|
+
return Dataset(self.times[index], self.strain[index], self.stress[index], self.measure,
|
|
203
|
+
dict(self.info)) # fmt: skip
|
|
204
|
+
|
|
205
|
+
def split(self, validation: float = 0.2, *, seed: int = 0) -> tuple[Dataset, Dataset]:
|
|
206
|
+
"""The paths shuffled (``seed``) into a training set and a validation set of the
|
|
207
|
+
fraction ``validation`` of them (at least one path each)."""
|
|
208
|
+
if not 0.0 < validation < 1.0 or self.n_paths < 2:
|
|
209
|
+
raise ValueError("split: a fraction between 0 and 1 of at least two paths")
|
|
210
|
+
order = np.random.default_rng(seed).permutation(self.n_paths)
|
|
211
|
+
k = min(max(round(validation * self.n_paths), 1), self.n_paths - 1)
|
|
212
|
+
return self.subset(np.sort(order[k:])), self.subset(np.sort(order[:k]))
|
|
213
|
+
|
|
214
|
+
def save(self, path) -> Path:
|
|
215
|
+
"""The data in an ``.npz`` file (their ``info`` as JSON)."""
|
|
216
|
+
path = Path(path)
|
|
217
|
+
np.savez_compressed(path, times=self.times, strain=self.strain, stress=self.stress,
|
|
218
|
+
measure=np.array(self.measure),
|
|
219
|
+
info=np.array(json.dumps(self.info))) # fmt: skip
|
|
220
|
+
return path if path.suffix == ".npz" else path.with_name(path.name + ".npz")
|
|
221
|
+
|
|
222
|
+
@classmethod
|
|
223
|
+
def load(cls, path) -> Dataset:
|
|
224
|
+
with np.load(path, allow_pickle=False) as f:
|
|
225
|
+
return cls(f["times"], f["strain"], f["stress"], str(f["measure"]),
|
|
226
|
+
json.loads(str(f["info"]))) # fmt: skip
|
|
227
|
+
|
|
228
|
+
|
|
229
|
+
def _planned(result: PathResult, path: LoadingPath) -> np.ndarray:
|
|
230
|
+
"""The rows of a response at the start and at the planned steps of its path."""
|
|
231
|
+
planned = np.concatenate([[path.times[0]], path.schedule()])
|
|
232
|
+
times = np.asarray(result.times)
|
|
233
|
+
k = np.clip(np.searchsorted(times, planned - 1e-9 * max(1.0, abs(planned[-1]))), 0,
|
|
234
|
+
len(times) - 1) # fmt: skip
|
|
235
|
+
if not np.allclose(times[k], planned, rtol=1e-9, atol=1e-12):
|
|
236
|
+
raise ValueError(f"path {result.name!r}: the response misses planned steps")
|
|
237
|
+
return k
|
|
238
|
+
|
|
239
|
+
|
|
240
|
+
def measures(result: PathResult, rows=None) -> tuple[np.ndarray, np.ndarray, str]:
|
|
241
|
+
"""The strain and the stress of a response (its ``rows``) in the measure of its
|
|
242
|
+
kinematics: small strains, or the Green-Lagrange strain and the second
|
|
243
|
+
Piola-Kirchhoff stress (finite strains)."""
|
|
244
|
+
rows = slice(None) if rows is None else rows
|
|
245
|
+
if not result.finite:
|
|
246
|
+
return np.asarray(result.strain)[rows], np.asarray(result.stress)[rows], "small"
|
|
247
|
+
f = gradient_tensor(np.asarray(result.strain)[rows])
|
|
248
|
+
return green_lagrange(f), second_piola(f, np.asarray(result.cauchy)[rows]), "green-lagrange"
|
|
249
|
+
|
|
250
|
+
|
|
251
|
+
def responder(
|
|
252
|
+
source, kinematics: str = "small", orientation=None
|
|
253
|
+
) -> Callable[[LoadingPath], PathResult]:
|
|
254
|
+
"""The response to a path of ``source``: a material (a
|
|
255
|
+
:class:`~morphogen.homogenization.materials.Material` or its configuration) at a
|
|
256
|
+
material point (turned by the Bunge angles ``orientation`` of a crystal), or a callable
|
|
257
|
+
``path -> PathResult`` (a microstructure)."""
|
|
258
|
+
if callable(source) and not isinstance(source, dict):
|
|
259
|
+
return source
|
|
260
|
+
from morphogen.homogenization.materials import Material
|
|
261
|
+
from morphogen.homogenization.nonlinear import simulate_point
|
|
262
|
+
|
|
263
|
+
material = Material.from_config(source)
|
|
264
|
+
return lambda path: simulate_point(material, path, kinematics=kinematics,
|
|
265
|
+
orientation=orientation) # fmt: skip
|
|
266
|
+
|
|
267
|
+
|
|
268
|
+
def generate(
|
|
269
|
+
source,
|
|
270
|
+
paths,
|
|
271
|
+
*,
|
|
272
|
+
kinematics: str = "small",
|
|
273
|
+
info: dict | None = None,
|
|
274
|
+
callback: Callable[[int, int], None] | None = None,
|
|
275
|
+
) -> Dataset:
|
|
276
|
+
"""The responses of ``source`` (see :func:`responder`: a material at a material point,
|
|
277
|
+
or a callable ``path -> PathResult`` of a microstructure) along ``paths`` (loading
|
|
278
|
+
paths or their specifications, all of the same numbers of steps), at their planned
|
|
279
|
+
steps. ``callback(done, total)`` after each path (it may raise
|
|
280
|
+
:class:`~morphogen.stopping.Stopped`)."""
|
|
281
|
+
respond = responder(source, kinematics)
|
|
282
|
+
paths = [LoadingPath.from_spec(p) for p in paths]
|
|
283
|
+
if not paths:
|
|
284
|
+
raise ValueError("generate: at least one path")
|
|
285
|
+
times, strains, stresses, measure = [], [], [], "small"
|
|
286
|
+
for k, path in enumerate(paths):
|
|
287
|
+
result = respond(path)
|
|
288
|
+
rows = _planned(result, path)
|
|
289
|
+
e, s, measure = measures(result, rows)
|
|
290
|
+
times.append(np.asarray(result.times)[rows])
|
|
291
|
+
strains.append(e)
|
|
292
|
+
stresses.append(s)
|
|
293
|
+
if callback is not None:
|
|
294
|
+
callback(k + 1, len(paths))
|
|
295
|
+
if len({len(t) for t in times}) != 1:
|
|
296
|
+
raise ValueError("generate: paths of the same numbers of steps")
|
|
297
|
+
return Dataset(np.array(times), np.array(strains), np.array(stresses), measure,
|
|
298
|
+
dict(info or {})) # fmt: skip
|
|
299
|
+
|
|
300
|
+
|
|
301
|
+
@dataclass(frozen=True)
|
|
302
|
+
class Scales:
|
|
303
|
+
"""The normalization of the data: the root mean squares of the strain, of the stress,
|
|
304
|
+
of the strain increments and the mean time step of a training set. The networks see
|
|
305
|
+
the strains and the increments divided by theirs and give stresses divided by
|
|
306
|
+
theirs: scalars, which keep the isotropy of the data and the potential of the
|
|
307
|
+
stresses (:class:`~morphogen.learning.networks.Potential`)."""
|
|
308
|
+
|
|
309
|
+
strain: float
|
|
310
|
+
stress: float
|
|
311
|
+
increment: float
|
|
312
|
+
time: float
|
|
313
|
+
|
|
314
|
+
@classmethod
|
|
315
|
+
def of(cls, data: Dataset) -> Scales:
|
|
316
|
+
def rms(a) -> float:
|
|
317
|
+
return float(np.sqrt(np.mean(np.square(a))))
|
|
318
|
+
|
|
319
|
+
strain, stress = rms(data.strain), rms(data.stress)
|
|
320
|
+
if not (strain > 0 and stress > 0):
|
|
321
|
+
raise ValueError("data: some strains and stresses")
|
|
322
|
+
increment = rms(np.diff(data.strain, axis=1)) or strain
|
|
323
|
+
dt = float(np.mean(np.diff(data.times, axis=1)))
|
|
324
|
+
return cls(strain, stress, increment, dt if dt > 0 else 1.0)
|
|
325
|
+
|
|
326
|
+
def to_dict(self) -> dict:
|
|
327
|
+
return {"strain": self.strain, "stress": self.stress, "increment": self.increment,
|
|
328
|
+
"time": self.time} # fmt: skip
|