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,290 @@
|
|
|
1
|
+
"""Post-processing of apparent properties: compliance, engineering constants and
|
|
2
|
+
anisotropy of stiffness tensors, macroscopic values of porous media, normalized and
|
|
3
|
+
specific values.
|
|
4
|
+
|
|
5
|
+
Stiffness and compliance. Every output of an elastic stiffness ``C`` gives its compliance
|
|
6
|
+
``S = C^-1`` beside it, in the same notation (:data:`NOTATION`): morphoGen's Voigt order
|
|
7
|
+
``11, 22, 33, 23, 31, 12`` with engineering shears (``11, 22, 12`` for plane problems,
|
|
8
|
+
:data:`PLANE_NOTATION`), so that ``S_11 = 1/E_1``, ``S_12 = -nu_12/E_1 = -nu_21/E_2`` and
|
|
9
|
+
``S_44 = 1/G_23``, ``S_55 = 1/G_31``, ``S_66 = 1/G_12`` for an orthotropic material in its
|
|
10
|
+
axes (:func:`engineering_constants`). TFEL (MFront) and Abaqus order their shears ``12,
|
|
11
|
+
13, 23``: a component ``C_44`` of morphoGen is their ``C_66``. The Mandel form of a
|
|
12
|
+
stiffness is ``W C W``, ``W = diag(1, 1, 1, √2, √2, √2)``, and of a compliance ``W^-1 S
|
|
13
|
+
W^-1``.
|
|
14
|
+
|
|
15
|
+
Macroscopic values of porous media. Meshes (or images) without their pores give the
|
|
16
|
+
macroscopic stress as the average over the whole volume element, the pores carrying
|
|
17
|
+
none: ``Sigma = phi <sigma>_s``, the average over the solid times the solid fraction
|
|
18
|
+
``phi`` (as in the homogenization notice of Z-set). The macroscopic strain is not the
|
|
19
|
+
average over the solid: it is the prescribed strain, or the macroscopic unknowns solved
|
|
20
|
+
for under stress or mixed loadings (:func:`morphogen.homogenization.core.superpose`), as
|
|
21
|
+
the degrees of freedom of a periodic element. Solutions hold both (``Solution.strain``,
|
|
22
|
+
``Solution.stress``) and the averages over each phase (``Solution.phases``).
|
|
23
|
+
|
|
24
|
+
Normalized values. For a property ``P`` (bulk, shear or Young's modulus, conductivity)
|
|
25
|
+
of a microstructure of solid fraction ``phi``, whose solid phases have the properties
|
|
26
|
+
``P_i`` and the fractions ``f_i``:
|
|
27
|
+
|
|
28
|
+
* relative: ``P / P_s``, with ``P_s = sum f_i P_i / phi`` the property of the solid (of
|
|
29
|
+
its single phase for a porous medium);
|
|
30
|
+
* normalized: ``P / (phi P_s) = P / sum f_i P_i``, the property per unit of solid
|
|
31
|
+
fraction, relative to the Voigt bound (rule of mixtures), which bounds it by 1;
|
|
32
|
+
* specific: ``P / rho`` with the effective density ``rho = sum f_i rho_i``.
|
|
33
|
+
|
|
34
|
+
Relative properties against the relative density ``phi`` are the coordinates of the
|
|
35
|
+
normalized Ashby charts (:mod:`morphogen.results`); Gibson & Ashby (1997) scalings read
|
|
36
|
+
``E / E_s ~ phi^n`` (``n = 1`` stretching-dominated, 2 bending-dominated foams).
|
|
37
|
+
"""
|
|
38
|
+
|
|
39
|
+
from __future__ import annotations
|
|
40
|
+
|
|
41
|
+
import numpy as np
|
|
42
|
+
|
|
43
|
+
from morphogen.homogenization.materials import TRANSPORT, Material
|
|
44
|
+
|
|
45
|
+
#: Mandel weights of the Voigt order (sqrt(2) on the shears)
|
|
46
|
+
_W = np.array([1.0, 1.0, 1.0, np.sqrt(2.0), np.sqrt(2.0), np.sqrt(2.0)])
|
|
47
|
+
|
|
48
|
+
#: morphoGen's Voigt order of the rows and columns of stiffnesses and compliances, in space
|
|
49
|
+
#: and in the plane
|
|
50
|
+
VOIGT_ORDER = ("11", "22", "33", "23", "31", "12")
|
|
51
|
+
PLANE_ORDER = ("11", "22", "12")
|
|
52
|
+
#: The notation of a stiffness and of its compliance, stated by the outputs that give them
|
|
53
|
+
NOTATION = (
|
|
54
|
+
"Voigt, order 11 22 33 23 31 12 (TFEL and Abaqus: 11 22 33 12 13 23), engineering "
|
|
55
|
+
"shears; S = C^-1 in the same notation"
|
|
56
|
+
)
|
|
57
|
+
PLANE_NOTATION = "Voigt, order 11 22 12, engineering shear; S = C^-1 in the same notation"
|
|
58
|
+
|
|
59
|
+
|
|
60
|
+
#: The smallest eigenvalue of a stiffness, relative to its largest, at or below which the
|
|
61
|
+
#: stiffness is singular to round-off (a direction without stiffness, as across layers of
|
|
62
|
+
#: void, at 1e-17 of the rest), or not positive definite: it has no compliance
|
|
63
|
+
_ROUND_OFF = 10.0 * np.finfo(float).eps
|
|
64
|
+
|
|
65
|
+
|
|
66
|
+
def compliance(stiffness) -> np.ndarray:
|
|
67
|
+
"""The compliance ``S = C^-1`` of a Voigt stiffness (6 x 6, order 11 22 33 23 31 12; 3
|
|
68
|
+
x 3, order 11 22 12, for plane problems; engineering shears), in the same notation:
|
|
69
|
+
``S_11 = 1/E_1``, ``S_12 = -nu_12/E_1``, ``S_44 = 1/G_23`` (see the module). A
|
|
70
|
+
stiffness singular to round-off (its smallest eigenvalue within 10 machine epsilons of
|
|
71
|
+
its largest, or negative: a direction without stiffness, as across layers of void) has
|
|
72
|
+
none: NaN, not the inverse of its round-off; an exactly singular one raises
|
|
73
|
+
:class:`numpy.linalg.LinAlgError`; one only badly scaled keeps its inverse (a design
|
|
74
|
+
stiff along its fibres, 3, whose plane is as stiff as its void, 1e-12: 1e-14)."""
|
|
75
|
+
c = np.asarray(stiffness, dtype=float)
|
|
76
|
+
if c.shape not in ((6, 6), (3, 3)):
|
|
77
|
+
raise ValueError(f"stiffness: a 6 x 6 matrix (3 x 3 in the plane), got shape {c.shape}")
|
|
78
|
+
s = np.linalg.inv(c)
|
|
79
|
+
if np.all(np.isfinite(c)):
|
|
80
|
+
w = np.linalg.eigvalsh(0.5 * (c + c.T))
|
|
81
|
+
if not w[0] > _ROUND_OFF * w[-1]:
|
|
82
|
+
return np.full_like(c, np.nan)
|
|
83
|
+
return s
|
|
84
|
+
|
|
85
|
+
|
|
86
|
+
def notation(stiffness) -> str:
|
|
87
|
+
"""The notation of a stiffness and of its compliance (:data:`NOTATION`;
|
|
88
|
+
:data:`PLANE_NOTATION` for a 3 x 3 one)."""
|
|
89
|
+
return PLANE_NOTATION if np.shape(stiffness) == (3, 3) else NOTATION
|
|
90
|
+
|
|
91
|
+
|
|
92
|
+
def matrix_entries(matrix, prefix: str) -> dict[str, float]:
|
|
93
|
+
"""The entries of the upper triangle of a symmetric matrix as ``<prefix><i><j>``, the
|
|
94
|
+
indices from 1 in the Voigt order (``C11`` ... ``C66``, ``S11`` ... ``S66``): the
|
|
95
|
+
columns of the tables of results."""
|
|
96
|
+
m = np.asarray(matrix, dtype=float)
|
|
97
|
+
n = len(m)
|
|
98
|
+
return {f"{prefix}{i + 1}{j + 1}": float(m[i, j]) for i in range(n) for j in range(i, n)}
|
|
99
|
+
|
|
100
|
+
|
|
101
|
+
def engineering_constants(stiffness) -> dict[str, float]:
|
|
102
|
+
"""Young's moduli ``E1, E2, E3``, Poisson's ratios ``nu_ij`` (contraction along
|
|
103
|
+
``j`` under a stress along ``i``: ``-S_ij / S_ii``) and shear moduli ``G23, G31,
|
|
104
|
+
G12`` of a Voigt stiffness (order 11 22 33 23 31 12, engineering shears)."""
|
|
105
|
+
s = np.linalg.inv(np.asarray(stiffness, dtype=float))
|
|
106
|
+
out = {f"E{i + 1}": float(1.0 / s[i, i]) for i in range(3)}
|
|
107
|
+
for i in range(3):
|
|
108
|
+
for j in range(3):
|
|
109
|
+
if i != j:
|
|
110
|
+
out[f"nu{i + 1}{j + 1}"] = float(-s[i, j] / s[i, i])
|
|
111
|
+
for k, name in zip((3, 4, 5), ("G23", "G31", "G12"), strict=True):
|
|
112
|
+
out[name] = float(1.0 / s[k, k])
|
|
113
|
+
return out
|
|
114
|
+
|
|
115
|
+
|
|
116
|
+
#: The Voigt index of the shear of each plane of the axes
|
|
117
|
+
_SHEAR = {(0, 1): 5, (1, 2): 3, (0, 2): 4}
|
|
118
|
+
|
|
119
|
+
|
|
120
|
+
def directional_modulus(stiffness, angles, *, plane=(0, 1), plane_strain: bool = True):
|
|
121
|
+
"""The Young's modulus ``1 / (n n : S : n n)`` along the directions ``n = cos(theta)
|
|
122
|
+
e_a + sin(theta) e_b`` of ``angles`` (radians) in the plane of the axes ``(a, b)`` of a
|
|
123
|
+
Voigt stiffness (6 x 6), under a uniaxial stress along ``n``: in plane strain (``S``
|
|
124
|
+
the inverse of the in-plane block ``a, b, ab`` of the stiffness: prisms across the
|
|
125
|
+
plane, as planar images one voxel thick) or in plane stress (``S`` the in-plane block
|
|
126
|
+
of the compliance, the other stresses free). A plane stiffness (3 x 3, Voigt 11, 22,
|
|
127
|
+
12) is taken in plane strain as it is. The ratio of its least to its largest value
|
|
128
|
+
over the angles is the elastic anisotropy ``eta_E = E_min / E_max`` of Both et al.
|
|
129
|
+
(2026)."""
|
|
130
|
+
c = np.asarray(stiffness, dtype=float)
|
|
131
|
+
a, b = sorted(int(v) for v in plane)
|
|
132
|
+
if c.shape == (3, 3):
|
|
133
|
+
s = np.linalg.inv(c)
|
|
134
|
+
elif c.shape == (6, 6):
|
|
135
|
+
if (a, b) not in _SHEAR:
|
|
136
|
+
raise ValueError("plane: two distinct axes among 0, 1 and 2")
|
|
137
|
+
k = [a, b, _SHEAR[(a, b)]]
|
|
138
|
+
s = np.linalg.inv(c[np.ix_(k, k)]) if plane_strain else np.linalg.inv(c)[np.ix_(k, k)]
|
|
139
|
+
else:
|
|
140
|
+
raise ValueError("stiffness: a Voigt matrix of 6 x 6, or 3 x 3 in the plane")
|
|
141
|
+
if tuple(int(v) for v in plane) == (b, a): # the angles from the second axis given
|
|
142
|
+
s = s[np.ix_([1, 0, 2], [1, 0, 2])]
|
|
143
|
+
t = np.asarray(angles, dtype=float)
|
|
144
|
+
v = np.stack([np.cos(t) ** 2, np.sin(t) ** 2, np.cos(t) * np.sin(t)], axis=-1)
|
|
145
|
+
return 1.0 / np.einsum("...i,ij,...j->...", v, s, v)
|
|
146
|
+
|
|
147
|
+
|
|
148
|
+
def sphere_directions(count: int = 2000) -> np.ndarray:
|
|
149
|
+
"""``count`` unit vectors spread evenly over the half-sphere ``z > 0`` (a Fibonacci
|
|
150
|
+
lattice): the directions of space up to their sign, as axes of moduli."""
|
|
151
|
+
k = np.arange(int(count)) + 0.5
|
|
152
|
+
z = k / int(count)
|
|
153
|
+
phi = np.pi * (1.0 + np.sqrt(5.0)) * k
|
|
154
|
+
r = np.sqrt(1.0 - z * z)
|
|
155
|
+
return np.column_stack([r * np.cos(phi), r * np.sin(phi), z])
|
|
156
|
+
|
|
157
|
+
|
|
158
|
+
def spatial_modulus(stiffness, directions) -> np.ndarray:
|
|
159
|
+
"""The Young's modulus ``1 / (n n : S : n n)`` along unit vectors ``n`` of space
|
|
160
|
+
(``(m, 3)``, normalized here) of a Voigt stiffness (6 x 6, engineering shears), under a
|
|
161
|
+
uniaxial stress along ``n``: the plane-stress :func:`directional_modulus` in every
|
|
162
|
+
plane. Its least and largest values over :func:`sphere_directions` give the elastic
|
|
163
|
+
anisotropy ``eta_E = E_min / E_max`` of a 3D sample (Both et al. 2026)."""
|
|
164
|
+
c = np.asarray(stiffness, dtype=float)
|
|
165
|
+
if c.shape != (6, 6):
|
|
166
|
+
raise ValueError("stiffness: a Voigt matrix of 6 x 6")
|
|
167
|
+
s = np.linalg.inv(c)
|
|
168
|
+
n = np.asarray(directions, dtype=float).reshape(-1, 3)
|
|
169
|
+
n = n / np.linalg.norm(n, axis=1, keepdims=True)
|
|
170
|
+
v = np.column_stack([n[:, 0] ** 2, n[:, 1] ** 2, n[:, 2] ** 2,
|
|
171
|
+
n[:, 1] * n[:, 2], n[:, 2] * n[:, 0], n[:, 0] * n[:, 1]]) # fmt: skip
|
|
172
|
+
return 1.0 / np.einsum("mi,ij,mj->m", v, s, v)
|
|
173
|
+
|
|
174
|
+
|
|
175
|
+
def anisotropy(stiffness) -> dict[str, float]:
|
|
176
|
+
"""Voigt and Reuss bulk and shear moduli of a Voigt stiffness, the universal
|
|
177
|
+
anisotropy index ``A_U = 5 G_V / G_R + K_V / K_R - 6`` (Ranganathan & Ostoja-
|
|
178
|
+
Starzewski 2008, zero for isotropy), the Zener ratio ``2 C44 / (C11 - C12)`` of its
|
|
179
|
+
mean cubic part (1 for isotropy) and the relative distance to the nearest isotropic
|
|
180
|
+
stiffness (its Voigt average, in the Mandel norm)."""
|
|
181
|
+
c = np.asarray(stiffness, dtype=float)
|
|
182
|
+
s = np.linalg.inv(c)
|
|
183
|
+
a, b, d = np.trace(c[:3, :3]), c[0, 1] + c[0, 2] + c[1, 2], np.trace(c[3:, 3:])
|
|
184
|
+
kv, gv = (a + 2.0 * b) / 9.0, (a - b + 3.0 * d) / 15.0
|
|
185
|
+
a, b, d = np.trace(s[:3, :3]), s[0, 1] + s[0, 2] + s[1, 2], np.trace(s[3:, 3:])
|
|
186
|
+
kr, gr = 1.0 / (a + 2.0 * b), 15.0 / (4.0 * a - 4.0 * b + 3.0 * d)
|
|
187
|
+
c11 = np.trace(c[:3, :3]) / 3.0
|
|
188
|
+
c12 = (c[0, 1] + c[0, 2] + c[1, 2]) / 3.0
|
|
189
|
+
c44 = np.trace(c[3:, 3:]) / 3.0
|
|
190
|
+
iso = np.zeros((6, 6))
|
|
191
|
+
iso[:3, :3] = kv - 2.0 * gv / 3.0
|
|
192
|
+
iso[[0, 1, 2], [0, 1, 2]] += 2.0 * gv
|
|
193
|
+
iso[[3, 4, 5], [3, 4, 5]] = gv
|
|
194
|
+
mandel = _W[:, None] * _W[None, :]
|
|
195
|
+
return {
|
|
196
|
+
"bulk_voigt": float(kv),
|
|
197
|
+
"bulk_reuss": float(kr),
|
|
198
|
+
"shear_voigt": float(gv),
|
|
199
|
+
"shear_reuss": float(gr),
|
|
200
|
+
"universal_anisotropy": float(5.0 * gv / gr + kv / kr - 6.0),
|
|
201
|
+
"zener_ratio": float(2.0 * c44 / (c11 - c12)) if c11 != c12 else float("nan"),
|
|
202
|
+
"isotropy_distance": float(np.linalg.norm((c - iso) * mandel) / np.linalg.norm(c * mandel)),
|
|
203
|
+
}
|
|
204
|
+
|
|
205
|
+
|
|
206
|
+
def solid_fraction(fractions: dict[int, float], materials: dict[int, Material]) -> float:
|
|
207
|
+
"""Volume fraction of the phases that are not voids."""
|
|
208
|
+
return float(sum(f for p, f in fractions.items() if not materials[p].void))
|
|
209
|
+
|
|
210
|
+
|
|
211
|
+
def effective_density(fractions: dict[int, float], materials: dict[int, Material]):
|
|
212
|
+
"""``sum f_i rho_i`` (exact), or None when a solid phase has no density."""
|
|
213
|
+
solid = [p for p in fractions if not materials[p].void]
|
|
214
|
+
if not solid or any(materials[p].density is None for p in solid):
|
|
215
|
+
return None
|
|
216
|
+
return float(sum(fractions[p] * materials[p].density for p in solid))
|
|
217
|
+
|
|
218
|
+
|
|
219
|
+
def _property(material: Material, name: str) -> float | None:
|
|
220
|
+
"""Property of a phase: exact for isotropic materials, the Hill average of a crystal
|
|
221
|
+
(uniform orientations)."""
|
|
222
|
+
if name in _TRANSPORT: # the coefficient of a transport phenomenon
|
|
223
|
+
physics = _TRANSPORT[name]
|
|
224
|
+
if not material.has(physics):
|
|
225
|
+
return None
|
|
226
|
+
voigt = material.mean_conductivity("voigt", physics)
|
|
227
|
+
if voigt == 0.0: # an insulator
|
|
228
|
+
return 0.0
|
|
229
|
+
return 0.5 * (voigt + material.mean_conductivity("reuss", physics))
|
|
230
|
+
if not material.elastic:
|
|
231
|
+
return None
|
|
232
|
+
k, g = material.moduli("hill")
|
|
233
|
+
return {"bulk_modulus": k, "shear_modulus": g, "young": 9.0 * k * g / (3.0 * k + g)}[name]
|
|
234
|
+
|
|
235
|
+
|
|
236
|
+
#: the physics of the scalar property of each transport phenomenon
|
|
237
|
+
_TRANSPORT = {name: physics for physics, name in TRANSPORT.items()}
|
|
238
|
+
#: base property of the scalar results: apparent properties, and entries of tensors
|
|
239
|
+
_BASE = {
|
|
240
|
+
"bulk_modulus": "bulk_modulus",
|
|
241
|
+
"shear_modulus": "shear_modulus",
|
|
242
|
+
"conductivity": "conductivity",
|
|
243
|
+
"E1": "young",
|
|
244
|
+
"E2": "young",
|
|
245
|
+
"E3": "young",
|
|
246
|
+
"G23": "shear_modulus",
|
|
247
|
+
"G31": "shear_modulus",
|
|
248
|
+
"G12": "shear_modulus",
|
|
249
|
+
"mean": "conductivity",
|
|
250
|
+
}
|
|
251
|
+
|
|
252
|
+
|
|
253
|
+
def _base(key: str) -> str | None:
|
|
254
|
+
parts = key.split(".")
|
|
255
|
+
if parts[0] in ("bulk_modulus", "shear_modulus", *_TRANSPORT) and len(parts) == 2:
|
|
256
|
+
return parts[0]
|
|
257
|
+
if parts[0] == "stiffness" and len(parts) == 3 and parts[2] != "mean":
|
|
258
|
+
return _BASE.get(parts[2])
|
|
259
|
+
scalar = parts[0].removesuffix("_tensor") # the mean of the tensor of a transport
|
|
260
|
+
if scalar != parts[0] and scalar in _TRANSPORT and len(parts) == 3 and parts[2] == "mean":
|
|
261
|
+
return scalar
|
|
262
|
+
return None
|
|
263
|
+
|
|
264
|
+
|
|
265
|
+
def normalized_values(
|
|
266
|
+
values: dict, fractions: dict[int, float], materials: dict[int, Material]
|
|
267
|
+
) -> dict[str, float]:
|
|
268
|
+
"""Solid fraction, effective density, and the relative, normalized and specific
|
|
269
|
+
values (see the module) of the apparent properties in ``values`` (keys
|
|
270
|
+
``<property>.<bc>``, and ``stiffness.<bc>.E1``... for the entries of tensors)."""
|
|
271
|
+
phi = solid_fraction(fractions, materials)
|
|
272
|
+
rho = effective_density(fractions, materials)
|
|
273
|
+
out: dict[str, float] = {"solid_fraction": phi}
|
|
274
|
+
if rho is not None:
|
|
275
|
+
out["density"] = rho
|
|
276
|
+
solid = [p for p in fractions if not materials[p].void and fractions[p] > 0]
|
|
277
|
+
for key, value in values.items():
|
|
278
|
+
base = _base(key)
|
|
279
|
+
if base is None or not isinstance(value, float):
|
|
280
|
+
continue
|
|
281
|
+
props = [_property(materials[p], base) for p in solid]
|
|
282
|
+
if not props or any(v is None for v in props):
|
|
283
|
+
continue
|
|
284
|
+
voigt = sum(fractions[p] * v for p, v in zip(solid, props, strict=True))
|
|
285
|
+
if voigt > 0 and phi > 0:
|
|
286
|
+
out[f"{key}.relative"] = value * phi / voigt
|
|
287
|
+
out[f"{key}.normalized"] = value / voigt
|
|
288
|
+
if rho:
|
|
289
|
+
out[f"{key}.specific"] = value / rho
|
|
290
|
+
return out
|