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,392 @@
|
|
|
1
|
+
"""The periodic cell of a laser-architectured sheet and its homogenized tensile tests.
|
|
2
|
+
|
|
3
|
+
A pattern repeated over a whole sheet — a family of straight tracks at its spacing,
|
|
4
|
+
crossed families, corrugations, a honeycomb — is periodic: its *lattice*
|
|
5
|
+
(:func:`lattice`) is spanned by two vectors ``a1``, ``a2`` (mm; reduced to the most
|
|
6
|
+
compact pair, :func:`reduce_basis`). The *cell* (:class:`PeriodicCell`) is the
|
|
7
|
+
parallelogram they span, meshed by quadrilaterals whose nodes match on opposite edges.
|
|
8
|
+
Its displacements are periodic up to the macroscopic displacement gradient ``H``: a
|
|
9
|
+
node of the right (top) edge moves as its image on the left (bottom) edge plus ``H a1``
|
|
10
|
+
(``H a2``); one node is held (no translation), ``H`` is symmetric (no rotation): the
|
|
11
|
+
computational homogenization of periodic media (Michel, Moulinec & Suquet 1999). The
|
|
12
|
+
unknowns are the displacements of the independent nodes and ``H`` (:meth:`PeriodicCell.map`).
|
|
13
|
+
|
|
14
|
+
**Tensile test of the sheet** (:func:`cell_test`) in the direction ``n`` at ``angle``
|
|
15
|
+
degrees from ``x`` (the rolling direction), ``t`` across: ``H = a n⊗n + b t⊗t + c (n⊗t
|
|
16
|
+
+ t⊗n)``, ``a`` prescribed, ``b`` and ``c`` free — their conjugate forces, the volume of
|
|
17
|
+
the cell times the mean nominal stresses ``P_tt`` and ``P_nt + P_tn``, vanish: a
|
|
18
|
+
uniaxial stress. The mean nominal stress ``P_nn`` against the engineering strain ``|(I
|
|
19
|
+
+ H) n| − 1`` gives the yield and tensile strengths and the uniform elongation (the
|
|
20
|
+
maximum of the nominal stress: Considère's, the sheet's own, no specimen necking); the
|
|
21
|
+
width strain (the distance between two lines of the sheet along ``n``, the edges of a
|
|
22
|
+
strip: ``ln (det(I + H) / |(I + H) n|)``) over the thickness strain (the mean of ``ln
|
|
23
|
+
λ3`` over the cell) gives Lankford's coefficient — those of the sheet, free of the edges
|
|
24
|
+
of a specimen and of where its tracks fall in its gauge (Hill 1963: the representative
|
|
25
|
+
volume).
|
|
26
|
+
|
|
27
|
+
**Biaxial stretching** (``ratio``): ``b`` prescribed with ``a`` so that the true
|
|
28
|
+
strains across and along ``n`` keep the ratio, ``ln(1 + b) = ratio ln(1 + a)``, ``c``
|
|
29
|
+
free: the linear strain paths of sheet forming, from uniaxial tension (−½) through plane
|
|
30
|
+
strain (0) to equibiaxial stretching (1); the result's stress is then the mean nominal
|
|
31
|
+
stress ``P_nn`` (its maximum: the diffuse necking along ``n``), ``fields["nominal"]``
|
|
32
|
+
holds ``P_nn``, ``P_tt`` and ``P_nt`` (:func:`mean_nominal`).
|
|
33
|
+
|
|
34
|
+
**The shear** (``free_shear``): free by default, its conjugate stress vanishing, so that
|
|
35
|
+
a sheet whose tracks are oblique to ``n`` shears as it is stretched; held at zero, the
|
|
36
|
+
principal axes of the mean stretch stay along ``n`` and ``t``, the mean shear stress
|
|
37
|
+
then free: the path of the strains is prescribed in full, as by the tools of a forming
|
|
38
|
+
operation and in the analysis of Marciniak and Kuczyński.
|
|
39
|
+
"""
|
|
40
|
+
|
|
41
|
+
from __future__ import annotations
|
|
42
|
+
|
|
43
|
+
import math
|
|
44
|
+
from dataclasses import dataclass, replace
|
|
45
|
+
|
|
46
|
+
import numpy as np
|
|
47
|
+
from scipy import sparse
|
|
48
|
+
|
|
49
|
+
from morphogen.laser.mechanics import Membrane, TensileResult, curve_measures
|
|
50
|
+
from morphogen.laser.specimen import QuadMesh
|
|
51
|
+
from morphogen.laser.structures import load_test
|
|
52
|
+
|
|
53
|
+
__all__ = ["PeriodicCell", "cell_test", "lattice", "mean_nominal", "reduce_basis"]
|
|
54
|
+
|
|
55
|
+
|
|
56
|
+
def reduce_basis(a1, a2) -> tuple[np.ndarray, np.ndarray]:
|
|
57
|
+
"""The Lagrange–Gauss reduction of a basis of a plane lattice: the shortest pair of
|
|
58
|
+
vectors spanning it (at 60° to 120° from each other), counter-clockwise."""
|
|
59
|
+
a1, a2 = np.asarray(a1, dtype=float), np.asarray(a2, dtype=float)
|
|
60
|
+
if abs(a1[0] * a2[1] - a1[1] * a2[0]) < 1e-12 * max(a1 @ a1, a2 @ a2, 1e-300):
|
|
61
|
+
raise ValueError("lattice: the vectors are parallel")
|
|
62
|
+
for _ in range(64):
|
|
63
|
+
if a1 @ a1 > a2 @ a2:
|
|
64
|
+
a1, a2 = a2, a1
|
|
65
|
+
mu = round(float(a1 @ a2) / float(a1 @ a1))
|
|
66
|
+
if mu == 0:
|
|
67
|
+
break
|
|
68
|
+
a2 = a2 - mu * a1
|
|
69
|
+
if a1[0] * a2[1] - a1[1] * a2[0] < 0:
|
|
70
|
+
a2 = -a2
|
|
71
|
+
return a1, a2
|
|
72
|
+
|
|
73
|
+
|
|
74
|
+
def _turn(v, degrees: float) -> np.ndarray:
|
|
75
|
+
th = math.radians(degrees)
|
|
76
|
+
c, s = math.cos(th), math.sin(th)
|
|
77
|
+
return np.array([c * v[0] - s * v[1], s * v[0] + c * v[1]])
|
|
78
|
+
|
|
79
|
+
|
|
80
|
+
def lattice(pattern: dict, along: float | None = None) -> tuple[np.ndarray, np.ndarray]:
|
|
81
|
+
"""The lattice vectors (mm, reduced) of a pattern repeated over the sheet (see the
|
|
82
|
+
module): ``straight`` (``spacing`` across the tracks, ``along`` them: by default the
|
|
83
|
+
spacing, 2 mm at most, the treatment being the same all along a track),
|
|
84
|
+
``corrugated`` and ``fourier`` (``period`` along, ``spacing`` across, shifted by the
|
|
85
|
+
``phase`` between neighbours), ``crossed`` (along each family, from a track of the
|
|
86
|
+
other family to the next: ``spacing2 / sin 2θ`` along the first, ``spacing / sin
|
|
87
|
+
2θ`` along the second), ``honeycomb`` (the centres of the hexagons), ``none`` (a
|
|
88
|
+
square of 2 mm); all turned by the pattern's ``rotation``."""
|
|
89
|
+
p = dict(pattern)
|
|
90
|
+
kind = p.get("kind")
|
|
91
|
+
if kind == "none":
|
|
92
|
+
a1, a2 = np.array([2.0, 0.0]), np.array([0.0, 2.0])
|
|
93
|
+
elif kind == "straight":
|
|
94
|
+
s = p.get("spacing")
|
|
95
|
+
if not s:
|
|
96
|
+
raise ValueError("the cell of a straight family: give its spacing")
|
|
97
|
+
th = float(p.get("angle", 0.0))
|
|
98
|
+
along = min(float(s), 2.0) if along is None else float(along)
|
|
99
|
+
a1, a2 = _turn([along, 0.0], th), _turn([0.0, float(s)], th)
|
|
100
|
+
elif kind in ("corrugated", "fourier"):
|
|
101
|
+
s = p.get("spacing")
|
|
102
|
+
if not s:
|
|
103
|
+
raise ValueError(f"the cell of {kind} tracks: give their spacing")
|
|
104
|
+
period = float(p.get("period", 10.0))
|
|
105
|
+
a1 = np.array([period, 0.0])
|
|
106
|
+
a2 = np.array([-float(p.get("phase", 0.0)) / 360.0 * period, float(s)])
|
|
107
|
+
elif kind == "crossed":
|
|
108
|
+
th = math.radians(float(p.get("angle", 45.0)))
|
|
109
|
+
s1 = float(p.get("spacing", 3.0))
|
|
110
|
+
s2 = float(p.get("spacing2") or s1)
|
|
111
|
+
sin2 = abs(math.sin(2.0 * th))
|
|
112
|
+
if sin2 < 1e-6:
|
|
113
|
+
raise ValueError("crossed: the families are parallel")
|
|
114
|
+
a1 = s2 / sin2 * np.array([math.cos(th), math.sin(th)])
|
|
115
|
+
a2 = s1 / sin2 * np.array([math.cos(th), -math.sin(th)])
|
|
116
|
+
elif kind == "honeycomb":
|
|
117
|
+
c = float(p.get("cell", 3.0))
|
|
118
|
+
th = float(p.get("angle", 0.0))
|
|
119
|
+
a1 = _turn([1.5 * c, 0.5 * math.sqrt(3.0) * c], th)
|
|
120
|
+
a2 = _turn([0.0, math.sqrt(3.0) * c], th)
|
|
121
|
+
else:
|
|
122
|
+
raise ValueError(f"no lattice for the pattern {kind!r}: give the cell's vectors")
|
|
123
|
+
rot = float(p.get("rotation", 0.0))
|
|
124
|
+
return reduce_basis(_turn(a1, rot), _turn(a2, rot))
|
|
125
|
+
|
|
126
|
+
|
|
127
|
+
@dataclass
|
|
128
|
+
class PeriodicCell:
|
|
129
|
+
"""The parallelogram spanned by ``a1`` and ``a2`` from ``origin`` (mm), meshed by
|
|
130
|
+
``n1 x n2`` quadrilaterals (``mesh``); ``master``: the independent node each node
|
|
131
|
+
moves with (itself for the independent ones, ``i < n1`` and ``j < n2``); ``shift``:
|
|
132
|
+
the multiples ``(k1, k2)`` of ``a1`` and ``a2`` between them."""
|
|
133
|
+
|
|
134
|
+
a1: np.ndarray
|
|
135
|
+
a2: np.ndarray
|
|
136
|
+
origin: np.ndarray
|
|
137
|
+
mesh: QuadMesh
|
|
138
|
+
master: np.ndarray
|
|
139
|
+
shift: np.ndarray
|
|
140
|
+
|
|
141
|
+
@classmethod
|
|
142
|
+
def build(cls, a1, a2, *, element: float = 0.25, centre=(0.0, 0.0), shape=None) -> PeriodicCell:
|
|
143
|
+
"""The cell of a lattice centred at ``centre``, its elements about ``element``
|
|
144
|
+
mm, or ``shape = (n1, n2)`` elements along ``a1`` and ``a2``."""
|
|
145
|
+
a1, a2 = np.asarray(a1, dtype=float), np.asarray(a2, dtype=float)
|
|
146
|
+
if a1[0] * a2[1] - a1[1] * a2[0] <= 0:
|
|
147
|
+
raise ValueError("cell: a1, a2 counter-clockwise (reduce_basis)")
|
|
148
|
+
if shape is None:
|
|
149
|
+
n1 = max(2, math.ceil(np.linalg.norm(a1) / element - 1e-9))
|
|
150
|
+
n2 = max(2, math.ceil(np.linalg.norm(a2) / element - 1e-9))
|
|
151
|
+
else:
|
|
152
|
+
n1, n2 = (int(v) for v in shape)
|
|
153
|
+
if min(n1, n2) < 2:
|
|
154
|
+
raise ValueError("cell: two elements at least along each vector")
|
|
155
|
+
origin = np.asarray(centre, dtype=float) - 0.5 * (a1 + a2)
|
|
156
|
+
i, j = np.meshgrid(np.arange(n1 + 1), np.arange(n2 + 1), indexing="ij")
|
|
157
|
+
i, j = i.ravel(), j.ravel()
|
|
158
|
+
nodes = origin + (i / n1)[:, None] * a1 + (j / n2)[:, None] * a2
|
|
159
|
+
|
|
160
|
+
def ids(ii, jj):
|
|
161
|
+
return ii * (n2 + 1) + jj
|
|
162
|
+
|
|
163
|
+
qi, qj = np.meshgrid(np.arange(n1), np.arange(n2), indexing="ij")
|
|
164
|
+
qi, qj = qi.ravel(), qj.ravel()
|
|
165
|
+
quads = np.stack(
|
|
166
|
+
[ids(qi, qj), ids(qi + 1, qj), ids(qi + 1, qj + 1), ids(qi, qj + 1)], axis=1
|
|
167
|
+
)
|
|
168
|
+
master = ids(i % n1, j % n2)
|
|
169
|
+
shift = np.stack([i // n1, j // n2], axis=1)
|
|
170
|
+
mesh = QuadMesh(
|
|
171
|
+
nodes,
|
|
172
|
+
quads.astype(np.int64),
|
|
173
|
+
np.flatnonzero(i == 0),
|
|
174
|
+
np.flatnonzero(i == n1),
|
|
175
|
+
np.flatnonzero(j == 0),
|
|
176
|
+
np.flatnonzero(j == n2),
|
|
177
|
+
(n1, n2),
|
|
178
|
+
)
|
|
179
|
+
return cls(a1, a2, origin, mesh, master.astype(np.int64), shift)
|
|
180
|
+
|
|
181
|
+
@property
|
|
182
|
+
def area(self) -> float:
|
|
183
|
+
"""The area of the cell (mm²)."""
|
|
184
|
+
return float(abs(self.a1[0] * self.a2[1] - self.a1[1] * self.a2[0]))
|
|
185
|
+
|
|
186
|
+
@property
|
|
187
|
+
def independent(self) -> np.ndarray:
|
|
188
|
+
"""The independent nodes (``i < n1``, ``j < n2``), in the order of the unknowns."""
|
|
189
|
+
return np.flatnonzero(self.master == np.arange(len(self.master)))
|
|
190
|
+
|
|
191
|
+
def box(self, margin: float = 0.0) -> tuple[float, float, float, float]:
|
|
192
|
+
"""The box ``(x0, x1, y0, y1)`` around the cell, widened by ``margin``."""
|
|
193
|
+
lo = self.mesh.nodes.min(axis=0) - margin
|
|
194
|
+
hi = self.mesh.nodes.max(axis=0) + margin
|
|
195
|
+
return (float(lo[0]), float(hi[0]), float(lo[1]), float(hi[1]))
|
|
196
|
+
|
|
197
|
+
def map(self, angle: float = 0.0) -> sparse.csr_matrix:
|
|
198
|
+
"""The map ``T`` of the unknowns ``q`` (the displacements of the independent
|
|
199
|
+
nodes, then ``a``, ``b``, ``c`` of ``H``, see the module, for the direction at
|
|
200
|
+
``angle`` degrees) to the nodal displacements ``u = T q``."""
|
|
201
|
+
th = math.radians(angle)
|
|
202
|
+
c, s = math.cos(th), math.sin(th)
|
|
203
|
+
bases = (
|
|
204
|
+
np.array([[c * c, c * s], [c * s, s * s]]), # n ⊗ n
|
|
205
|
+
np.array([[s * s, -c * s], [-c * s, c * c]]), # t ⊗ t
|
|
206
|
+
np.array([[-2 * c * s, c * c - s * s], [c * c - s * s, 2 * c * s]]), # n⊗t + t⊗n
|
|
207
|
+
)
|
|
208
|
+
ind = self.independent
|
|
209
|
+
col = np.full(len(self.master), -1, dtype=np.int64)
|
|
210
|
+
col[ind] = np.arange(len(ind))
|
|
211
|
+
m = col[self.master]
|
|
212
|
+
nn = len(self.master)
|
|
213
|
+
rows = [np.arange(2 * nn)]
|
|
214
|
+
cols = [np.stack([2 * m, 2 * m + 1], axis=1).ravel()]
|
|
215
|
+
vals = [np.ones(2 * nn)]
|
|
216
|
+
d = self.shift[:, :1] * self.a1 + self.shift[:, 1:] * self.a2 # nodes x 2
|
|
217
|
+
dep = np.flatnonzero(np.any(self.shift != 0, axis=1))
|
|
218
|
+
for k, B in enumerate(bases):
|
|
219
|
+
v = d[dep] @ B.T # B d for each dependent node
|
|
220
|
+
rows.append(np.stack([2 * dep, 2 * dep + 1], axis=1).ravel())
|
|
221
|
+
cols.append(np.full(2 * len(dep), 2 * len(ind) + k))
|
|
222
|
+
vals.append(v.ravel())
|
|
223
|
+
return sparse.csr_matrix(
|
|
224
|
+
(np.concatenate(vals), (np.concatenate(rows), np.concatenate(cols))),
|
|
225
|
+
shape=(2 * nn, 2 * len(ind) + 3),
|
|
226
|
+
)
|
|
227
|
+
|
|
228
|
+
|
|
229
|
+
def mean_nominal(membrane: Membrane) -> np.ndarray:
|
|
230
|
+
"""The mean nominal stress of a membrane in its current state (2 x 2, MPa): ``J σ
|
|
231
|
+
F⁻ᵀ`` (``J`` the change of volume, ``det F λ3``) averaged over its layers and its
|
|
232
|
+
area; over a periodic cell, the macroscopic nominal stress (Hill–Mandel)."""
|
|
233
|
+
F = membrane.Fn
|
|
234
|
+
sig = membrane.sig_n # (elements, 4, layers, 3): xx, yy, xy
|
|
235
|
+
S = np.empty((*sig.shape[:-1], 2, 2))
|
|
236
|
+
S[..., 0, 0], S[..., 1, 1] = sig[..., 0], sig[..., 1]
|
|
237
|
+
S[..., 0, 1] = S[..., 1, 0] = sig[..., 2]
|
|
238
|
+
inv_t = np.linalg.inv(F).swapaxes(-1, -2)[:, :, None]
|
|
239
|
+
J = np.linalg.det(F)[..., None] * membrane.lam_n
|
|
240
|
+
P = (J[..., None, None] * (S @ inv_t)).mean(axis=2)
|
|
241
|
+
w = membrane.w0
|
|
242
|
+
return np.einsum("eg,egij->ij", w, P) / float(w.sum())
|
|
243
|
+
|
|
244
|
+
|
|
245
|
+
class _Reduced:
|
|
246
|
+
"""A membrane seen through the periodic map ``u = T q`` (forces ``Tᵀ f``, tangent
|
|
247
|
+
``Tᵀ K T``); its other attributes are those of the membrane."""
|
|
248
|
+
|
|
249
|
+
def __init__(self, membrane: Membrane, T):
|
|
250
|
+
self.inner = membrane
|
|
251
|
+
self.T = T.tocsr()
|
|
252
|
+
self.Tt = self.T.T.tocsr()
|
|
253
|
+
self.ndof = self.T.shape[1]
|
|
254
|
+
self.u = np.zeros(self.ndof)
|
|
255
|
+
|
|
256
|
+
def __getattr__(self, name):
|
|
257
|
+
return getattr(self.inner, name)
|
|
258
|
+
|
|
259
|
+
def full(self, q) -> np.ndarray:
|
|
260
|
+
return self.T @ q
|
|
261
|
+
|
|
262
|
+
def reset(self) -> None:
|
|
263
|
+
self.inner.reset()
|
|
264
|
+
self.u = np.zeros(self.ndof)
|
|
265
|
+
|
|
266
|
+
def evaluate(self, q):
|
|
267
|
+
f, K, state, bad = self.inner.evaluate(self.T @ q)
|
|
268
|
+
return self.Tt @ f, (self.Tt @ K @ self.T).tocsr(), state, bad
|
|
269
|
+
|
|
270
|
+
def commit(self, q, state) -> None:
|
|
271
|
+
self.inner.commit(self.T @ q, state)
|
|
272
|
+
self.u = np.asarray(q, dtype=float).copy()
|
|
273
|
+
|
|
274
|
+
|
|
275
|
+
def cell_test(
|
|
276
|
+
membrane: Membrane,
|
|
277
|
+
cell: PeriodicCell,
|
|
278
|
+
angle: float = 0.0,
|
|
279
|
+
*,
|
|
280
|
+
max_strain: float = 0.25,
|
|
281
|
+
step: float = 0.004,
|
|
282
|
+
max_step: float = 0.02,
|
|
283
|
+
drop: float = 0.05,
|
|
284
|
+
tol: float = 1e-5,
|
|
285
|
+
max_iterations: int = 20,
|
|
286
|
+
max_steps: int = 400,
|
|
287
|
+
failure_margin: float | None = None,
|
|
288
|
+
record_history: bool = False,
|
|
289
|
+
keep_fields: bool = False,
|
|
290
|
+
monitors: dict | None = None,
|
|
291
|
+
ratio: float | None = None,
|
|
292
|
+
until=None,
|
|
293
|
+
free_shear: bool = True,
|
|
294
|
+
) -> TensileResult:
|
|
295
|
+
"""The tensile test of the sheet in the direction at ``angle`` degrees from x (see
|
|
296
|
+
the module) on the membrane of the cell: the engineering strain along it up to
|
|
297
|
+
``max_strain`` (the steps and stops of
|
|
298
|
+
:func:`~morphogen.laser.structures.load_test`); the result's stress is the mean
|
|
299
|
+
nominal stress along the direction, its width and thickness strains give
|
|
300
|
+
Lankford's coefficient (:meth:`~morphogen.laser.mechanics.TensileResult.r_value`).
|
|
301
|
+
``monitors``: more functions of the unknowns recorded at each step, after the
|
|
302
|
+
membrane has taken its new state (``fields["monitors"]``). ``ratio``: biaxial
|
|
303
|
+
stretching, the true strain across the direction prescribed at ``ratio`` times the
|
|
304
|
+
true strain along it (see the module); ``until``: the test stops when this function
|
|
305
|
+
of the unknowns returns true (after the monitors of the step); ``free_shear``: false
|
|
306
|
+
holds the shear ``c`` at zero (see the module)."""
|
|
307
|
+
T = cell.map(angle)
|
|
308
|
+
red = _Reduced(membrane, T)
|
|
309
|
+
na = T.shape[1] - 3 # the unknown a, then b and c
|
|
310
|
+
w = membrane.w0
|
|
311
|
+
wsum = float(w.sum())
|
|
312
|
+
th = math.radians(angle)
|
|
313
|
+
n, t = np.array([math.cos(th), math.sin(th)]), np.array([-math.sin(th), math.cos(th)])
|
|
314
|
+
|
|
315
|
+
def thickness(_q):
|
|
316
|
+
return float((np.log(membrane.lam_n).mean(axis=2) * w).sum() / wsum)
|
|
317
|
+
|
|
318
|
+
def nominal(u, v):
|
|
319
|
+
return lambda _q: float(u @ mean_nominal(membrane) @ v)
|
|
320
|
+
|
|
321
|
+
monitors = {
|
|
322
|
+
**(monitors or {}),
|
|
323
|
+
"c": lambda q: float(q[na + 2]),
|
|
324
|
+
"b": lambda q: float(q[na + 1]),
|
|
325
|
+
"thickness_strain": thickness,
|
|
326
|
+
}
|
|
327
|
+
if ratio is not None:
|
|
328
|
+
monitors.update({"P_nn": nominal(n, n), "P_tt": nominal(t, t), "P_nt": nominal(n, t)})
|
|
329
|
+
moved, direction = [na], [1.0]
|
|
330
|
+
if ratio is not None: # a linear path of the true strains: ln(1 + b) = ratio ln(1 + a)
|
|
331
|
+
rho = float(ratio)
|
|
332
|
+
moved = [na, na + 1]
|
|
333
|
+
|
|
334
|
+
def direction(d):
|
|
335
|
+
return (
|
|
336
|
+
np.array([d, (1.0 + d) ** rho - 1.0]),
|
|
337
|
+
np.array([1.0, rho * (1.0 + d) ** (rho - 1.0)]),
|
|
338
|
+
)
|
|
339
|
+
|
|
340
|
+
# the first independent node, the origin of the cell, and with fixed axes the shear
|
|
341
|
+
fixed = [0, 1] if free_shear else [0, 1, na + 2]
|
|
342
|
+
res = load_test(
|
|
343
|
+
red,
|
|
344
|
+
fixed,
|
|
345
|
+
moved,
|
|
346
|
+
direction,
|
|
347
|
+
length=1.0,
|
|
348
|
+
section=cell.area * membrane.thickness,
|
|
349
|
+
max_disp=max_strain,
|
|
350
|
+
step=step,
|
|
351
|
+
max_step=max_step,
|
|
352
|
+
drop=drop,
|
|
353
|
+
tol=tol,
|
|
354
|
+
max_iterations=max_iterations,
|
|
355
|
+
max_steps=max_steps,
|
|
356
|
+
failure_margin=failure_margin,
|
|
357
|
+
record_history=record_history,
|
|
358
|
+
monitors=monitors,
|
|
359
|
+
keep_fields=keep_fields,
|
|
360
|
+
until=until,
|
|
361
|
+
)
|
|
362
|
+
mon = res.fields["monitors"]
|
|
363
|
+
a, b, c = res.displacement, mon["b"], mon["c"]
|
|
364
|
+
strain = np.sqrt((1.0 + a) ** 2 + c**2) - 1.0
|
|
365
|
+
stress = res.stress if ratio is None else np.asarray(mon["P_nn"])
|
|
366
|
+
# the proof stress on the elastic slope: the phases of a treated steel share it
|
|
367
|
+
ys, uts, eu, energy, necked = curve_measures(strain, stress, young=membrane.young)
|
|
368
|
+
failure = res.failure_strain
|
|
369
|
+
if math.isfinite(failure): # from a (the controlled unknown) to the strain along n
|
|
370
|
+
failure = float(np.interp(failure, a, strain))
|
|
371
|
+
fields = dict(res.fields)
|
|
372
|
+
fields["cell"] = (cell.a1.copy(), cell.a2.copy())
|
|
373
|
+
fields["macroscopic"] = {"a": a.copy(), "b": np.asarray(b), "c": np.asarray(c)}
|
|
374
|
+
if ratio is not None:
|
|
375
|
+
fields["nominal"] = {k: np.asarray(mon[f"P_{k}"]) for k in ("nn", "tt", "nt")}
|
|
376
|
+
return replace(
|
|
377
|
+
res,
|
|
378
|
+
strain=strain,
|
|
379
|
+
stress=stress,
|
|
380
|
+
yield_strength=ys,
|
|
381
|
+
tensile_strength=uts,
|
|
382
|
+
uniform_elongation=eu,
|
|
383
|
+
energy=energy,
|
|
384
|
+
necked=necked,
|
|
385
|
+
failure_strain=failure,
|
|
386
|
+
# the distance between the edges of a strip along n: det(I + H) / |(I + H) n|
|
|
387
|
+
width_strain=np.log(
|
|
388
|
+
((1.0 + a) * (1.0 + np.asarray(b)) - np.asarray(c) ** 2) / (1.0 + strain)
|
|
389
|
+
),
|
|
390
|
+
thickness_strain=np.asarray(mon["thickness_strain"]),
|
|
391
|
+
fields=fields,
|
|
392
|
+
)
|