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,278 @@
|
|
|
1
|
+
"""Self-contact in the cells of the nonlinear homogenization: the walls of the pores of a
|
|
2
|
+
periodic cell that close on themselves along a loading path.
|
|
3
|
+
|
|
4
|
+
:class:`ContactCell` is the periodic element of :class:`~morphogen.homogenization.nonlinear.
|
|
5
|
+
NonlinearFEProblem` (the fluctuation and the macroscopic strain components as unknowns,
|
|
6
|
+
loading paths in strains, stresses or both, the behaviours of morphoGen's points) with the
|
|
7
|
+
forces of the contact of its free surface with itself (:mod:`morphogen.contact`).
|
|
8
|
+
|
|
9
|
+
*Images.* A wall of a pore may meet the image of another across a face of the cell. The
|
|
10
|
+
faces of the surface near the boundary of the cell are therefore given images, translated
|
|
11
|
+
by the periods of the cell: the image of a node of displacement ``u`` moved by a period
|
|
12
|
+
``L`` is displaced by ``u + H L``, ``H`` the macroscopic displacement gradient (the cell
|
|
13
|
+
deforms with it), and the forces that it receives go to the node itself.
|
|
14
|
+
|
|
15
|
+
*Macroscopic stress.* The positions of the nodes follow the macroscopic gradient, ``x = X +
|
|
16
|
+
H X + w``: the forces ``f`` of the contacts work in a change of ``H`` by ``Σ f ⊗ X`` over the
|
|
17
|
+
nodes (the images at their own places ``X + L``). This term — nothing for two walls that
|
|
18
|
+
touch inside the cell, whose forces are opposite at the same place; the force that crosses
|
|
19
|
+
a face of the cell times the period for a wall and an image — is added to the integral of
|
|
20
|
+
the stress of the points: in the equilibrium of the stress-controlled components, in the
|
|
21
|
+
macroscopic stress of the results, and its derivatives in the tangent of the macroscopic
|
|
22
|
+
unknowns.
|
|
23
|
+
"""
|
|
24
|
+
|
|
25
|
+
from __future__ import annotations
|
|
26
|
+
|
|
27
|
+
import numpy as np
|
|
28
|
+
|
|
29
|
+
from morphogen.contact.kernels import (
|
|
30
|
+
S_FACE,
|
|
31
|
+
S_GAP,
|
|
32
|
+
S_LAMBDA,
|
|
33
|
+
S_PRESSURE,
|
|
34
|
+
S_SHARE,
|
|
35
|
+
S_TX,
|
|
36
|
+
S_WORK,
|
|
37
|
+
)
|
|
38
|
+
from morphogen.contact.problem import contact_forces, contact_pass, stiffest_modulus
|
|
39
|
+
from morphogen.contact.surfaces import Pair, Surface
|
|
40
|
+
from morphogen.homogenization.nonlinear import Extended, NonlinearFEProblem, _SurfacePaths
|
|
41
|
+
from morphogen.mesh.tetra import TetMesh
|
|
42
|
+
|
|
43
|
+
#: The curves that a cell records at each step (``PathResult.series``): the area in
|
|
44
|
+
#: contact (reference area, of one of the two sides), the largest pressure, the deepest
|
|
45
|
+
#: penetration and the energy dissipated by friction
|
|
46
|
+
SERIES = ("contact_area", "contact_pressure", "contact_penetration", "contact_dissipation")
|
|
47
|
+
|
|
48
|
+
|
|
49
|
+
def walls(mesh: TetMesh) -> Surface:
|
|
50
|
+
"""The free faces of a cell that are not on its boundary: the walls of its pores (the
|
|
51
|
+
faces of the solid on the faces of the box, or on the outer boundary of whole periodic
|
|
52
|
+
cells, go on in the neighbouring cells)."""
|
|
53
|
+
skin = Surface.of(mesh)
|
|
54
|
+
outer = np.sort(mesh.outer_faces()[:, :3], axis=1)
|
|
55
|
+
keys = {tuple(face) for face in outer.tolist()}
|
|
56
|
+
mine = np.sort(skin.faces[:, :3], axis=1)
|
|
57
|
+
inside = np.array([tuple(face) not in keys for face in mine.tolist()], dtype=bool)
|
|
58
|
+
if not mesh.whole: # and the faces that lie on a face of the box
|
|
59
|
+
centroids = skin.centroids(mesh.nodes)
|
|
60
|
+
tol = mesh.tolerance()
|
|
61
|
+
on_box = np.any(
|
|
62
|
+
(np.abs(centroids - mesh.lower) <= tol) | (np.abs(centroids - mesh.upper) <= tol),
|
|
63
|
+
axis=1,
|
|
64
|
+
)
|
|
65
|
+
inside &= ~on_box
|
|
66
|
+
return skin.subset(inside)
|
|
67
|
+
|
|
68
|
+
|
|
69
|
+
class _Images(Extended):
|
|
70
|
+
"""A surface of a periodic cell and its images near the cell: the extended nodes (the
|
|
71
|
+
nodes of the mesh, then the images of some: ``node`` the node of each, ``offset`` its
|
|
72
|
+
translation), the faces of the surface and of its images on them, and the pass of the
|
|
73
|
+
contact of the surface with all of these."""
|
|
74
|
+
|
|
75
|
+
def __init__(self, mesh: TetMesh, surface: Surface, spec: Pair, stiffest: float, periodic):
|
|
76
|
+
n = mesh.n_nodes
|
|
77
|
+
size = np.asarray(mesh.size, dtype=float)
|
|
78
|
+
# the images kept: those within twice the reach of the search of the cell (the
|
|
79
|
+
# deepest penetration and two faces), half a period at most
|
|
80
|
+
edge = surface.size(mesh.nodes)
|
|
81
|
+
depth = 0.5 * edge if spec.depth is None else float(spec.depth)
|
|
82
|
+
reach = np.minimum(0.5 * size, 2.0 * (depth + 2.0 * edge))
|
|
83
|
+
faces = [surface.faces]
|
|
84
|
+
node, offset = [np.zeros(0, dtype=np.int64)], [np.zeros((0, 3))]
|
|
85
|
+
count = n
|
|
86
|
+
centroids = surface.centroids(mesh.nodes)
|
|
87
|
+
for shift in np.ndindex(3, 3, 3):
|
|
88
|
+
shift = np.array(shift) - 1
|
|
89
|
+
if not shift.any() or np.any((shift != 0) & ~np.asarray(periodic)):
|
|
90
|
+
continue
|
|
91
|
+
moved = centroids + shift * size
|
|
92
|
+
near = np.all((moved >= mesh.lower - reach) & (moved <= mesh.upper + reach), axis=1)
|
|
93
|
+
if not near.any():
|
|
94
|
+
continue
|
|
95
|
+
used, inverse = np.unique(surface.faces[near], return_inverse=True)
|
|
96
|
+
faces.append(count + inverse.reshape(-1, surface.faces.shape[1]))
|
|
97
|
+
node.append(used)
|
|
98
|
+
offset.append(np.broadcast_to(shift * size, (len(used), 3)))
|
|
99
|
+
count += len(used)
|
|
100
|
+
super().__init__(mesh.nodes, np.concatenate(node), np.concatenate(offset))
|
|
101
|
+
master = Surface(np.concatenate(faces))
|
|
102
|
+
self.surface = surface
|
|
103
|
+
self.contact = contact_pass(self.reference, surface, master, True, None, spec, stiffest, 2)
|
|
104
|
+
if len(self.node) > n:
|
|
105
|
+
# a node of the boundary of the cell and the image of the node across it are
|
|
106
|
+
# one node: the edges that a face shares with the image of its neighbour are
|
|
107
|
+
# not on the rim of the surface, and the two faces share their nodes
|
|
108
|
+
linked, to, shift = mesh.periodic_links()
|
|
109
|
+
first, moved = np.arange(n), np.zeros((n, 3), dtype=np.int64)
|
|
110
|
+
first[linked], moved[linked] = to, shift
|
|
111
|
+
periods = np.rint(self.offset / size).astype(np.int64)
|
|
112
|
+
key = np.column_stack([first[self.node], moved[self.node] + periods])
|
|
113
|
+
_, ident = np.unique(key, axis=0, return_inverse=True)
|
|
114
|
+
ident = np.ascontiguousarray(ident.ravel(), dtype=np.int64)
|
|
115
|
+
self.contact.ident = ident
|
|
116
|
+
self.contact.rims = np.ascontiguousarray(Surface(ident[master.faces[:, :3]]).rims())
|
|
117
|
+
|
|
118
|
+
|
|
119
|
+
class ContactCell(NonlinearFEProblem):
|
|
120
|
+
"""A cell whose free surface may touch itself along a loading path (see the module):
|
|
121
|
+
the ``mesh`` of its solid (the pores left out: ``conforming_mesh(..., phases="solid")``,
|
|
122
|
+
or ``mesh.subset``), the ``materials`` of its phases and the boundary conditions
|
|
123
|
+
(``"periodic"``: the walls also meet their images across the faces of the cell;
|
|
124
|
+
``"kubc"``).
|
|
125
|
+
|
|
126
|
+
``friction``, ``stiffness``, ``tangential``, ``depth`` and ``points``: those of a
|
|
127
|
+
:class:`~morphogen.contact.surfaces.Pair`; ``surface``: the faces that may touch (by
|
|
128
|
+
default the walls of the pores, :func:`walls`); ``augmentations``, ``tolerance`` and
|
|
129
|
+
``neighbours``: those of :class:`~morphogen.contact.problem.ContactProblem`. The other
|
|
130
|
+
options are those of :class:`~morphogen.homogenization.nonlinear.NonlinearFEProblem`
|
|
131
|
+
(``kinematics``, finite strains by default; ``integration``, ``newton_tol``...); the
|
|
132
|
+
tangent is factorized (``solver="direct"``), and kept whole with friction or with the
|
|
133
|
+
points at the nodes (the derivatives of their shares).
|
|
134
|
+
|
|
135
|
+
:meth:`run` returns the response to a path with, in its ``series`` (columns of its
|
|
136
|
+
curves, :data:`SERIES`), at each step the area in contact ``contact_area`` (reference
|
|
137
|
+
area, of one of the two sides), the largest pressure ``contact_pressure``, the deepest
|
|
138
|
+
penetration ``contact_penetration`` and the energy that friction dissipated
|
|
139
|
+
``contact_dissipation``."""
|
|
140
|
+
|
|
141
|
+
def __init__(
|
|
142
|
+
self,
|
|
143
|
+
mesh: TetMesh,
|
|
144
|
+
materials,
|
|
145
|
+
bc: str = "periodic",
|
|
146
|
+
*,
|
|
147
|
+
friction: float = 0.0,
|
|
148
|
+
stiffness: float | None = None,
|
|
149
|
+
tangential: float | None = None,
|
|
150
|
+
depth: float | None = None,
|
|
151
|
+
points: str = "gauss",
|
|
152
|
+
surface: Surface | None = None,
|
|
153
|
+
augmentations: int = 0,
|
|
154
|
+
tolerance: float | None = None,
|
|
155
|
+
neighbours: int = 12,
|
|
156
|
+
kinematics: str = "finite",
|
|
157
|
+
**options,
|
|
158
|
+
):
|
|
159
|
+
if options.pop("solver", "direct") not in ("direct", "auto"):
|
|
160
|
+
raise ValueError(
|
|
161
|
+
"ContactCell: the tangent of the contacts is factorized (solver 'direct')"
|
|
162
|
+
)
|
|
163
|
+
if friction > 0 or points == "nodes": # tangents that are not symmetric
|
|
164
|
+
options.setdefault("tangent", "full")
|
|
165
|
+
super().__init__(mesh, materials, bc, kinematics=kinematics, solver="direct", **options)
|
|
166
|
+
surface = walls(mesh) if surface is None else surface
|
|
167
|
+
if surface.order != mesh.order:
|
|
168
|
+
raise ValueError("ContactCell: a surface of the faces of the mesh (Surface.of)")
|
|
169
|
+
if not surface.n_faces:
|
|
170
|
+
raise ValueError("ContactCell: no free surface inside the cell (no pore to close)")
|
|
171
|
+
if augmentations < 0 or neighbours < 1:
|
|
172
|
+
raise ValueError("ContactCell: augmentations >= 0, neighbours >= 1")
|
|
173
|
+
spec = Pair(surface, friction=friction, stiffness=stiffness, tangential=tangential,
|
|
174
|
+
depth=depth, points=points) # fmt: skip
|
|
175
|
+
periodic = (self.bc == "periodic",) * 3
|
|
176
|
+
stiffest = stiffest_modulus(materials, mesh.phase)
|
|
177
|
+
self._images = self._extended = _Images(mesh, surface, spec, stiffest, periodic)
|
|
178
|
+
self.augmentations, self.neighbours = int(augmentations), int(neighbours)
|
|
179
|
+
size = surface.size(mesh.nodes)
|
|
180
|
+
self._floor = 1e-6 * stiffest * size**2 # the force of a strain of 1e-6 on a face
|
|
181
|
+
self._floor_stress = 1e-6 * stiffest * self.box_volume # and its stress in the cell
|
|
182
|
+
# parts that float until they touch: a shift of the diagonal of the tangent
|
|
183
|
+
self.regularization = max(self.regularization, 1e-12)
|
|
184
|
+
self.tolerance = 0.01 * size if tolerance is None else float(tolerance)
|
|
185
|
+
if not self.tolerance > 0:
|
|
186
|
+
raise ValueError("ContactCell: a positive tolerance")
|
|
187
|
+
self._x_old = self._images.reference
|
|
188
|
+
self._x_now = self._images.reference
|
|
189
|
+
self._virial = 0.0
|
|
190
|
+
self._augmented = 0
|
|
191
|
+
self._history: list[tuple] = []
|
|
192
|
+
|
|
193
|
+
def _discretization(self) -> _SurfacePaths:
|
|
194
|
+
return _SurfacePaths(self)
|
|
195
|
+
|
|
196
|
+
def _surface_forces(self, x, tangent: bool, first: bool):
|
|
197
|
+
"""The forces of the contact of the surface with itself and its images at the
|
|
198
|
+
positions ``x`` of the extended nodes, and their tangent."""
|
|
199
|
+
self._x_now = x
|
|
200
|
+
return contact_forces(
|
|
201
|
+
[self._images.contact], x, self._x_old, self.neighbours, 0.0, tangent, first
|
|
202
|
+
)
|
|
203
|
+
|
|
204
|
+
def _extra_stress(self):
|
|
205
|
+
"""The part of the macroscopic stress that the forces of the contacts carry (see
|
|
206
|
+
the module), at the last evaluation."""
|
|
207
|
+
return self._virial / self.box_volume
|
|
208
|
+
|
|
209
|
+
def _begin(self) -> None:
|
|
210
|
+
"""The state of the slave points before a path: the faces and the gaps that they
|
|
211
|
+
see in the cell at rest, none pressing."""
|
|
212
|
+
contact = self._images.contact
|
|
213
|
+
contact.state = contact.fresh()
|
|
214
|
+
contact.multiplier = np.zeros(len(contact.face))
|
|
215
|
+
self._x_old = self._x_now = self._images.reference
|
|
216
|
+
contact_forces([contact], self._x_old, self._x_old, self.neighbours, 0.0, False, False)
|
|
217
|
+
contact.state = contact.trial.copy()
|
|
218
|
+
contact.state[:, S_PRESSURE] = 0.0
|
|
219
|
+
contact.state[:, S_TX : S_TX + 3] = 0.0
|
|
220
|
+
contact.state[:, S_WORK] = 0.0
|
|
221
|
+
self._virial, self._augmented = 0.0, 0
|
|
222
|
+
self._history = [(0.0, 0.0, 0.0, 0.0)]
|
|
223
|
+
|
|
224
|
+
def _settle(self, state) -> bool:
|
|
225
|
+
"""On a converged state: the multipliers are updated and the step solved again
|
|
226
|
+
while a point penetrates deeper than the tolerance; otherwise the state of the
|
|
227
|
+
slave points is kept and the step recorded."""
|
|
228
|
+
contact = self._images.contact
|
|
229
|
+
pressed = contact.pressed
|
|
230
|
+
deepest = float(-contact.trial[pressed, S_GAP].min()) if pressed.any() else 0.0
|
|
231
|
+
if self._augmented < self.augmentations and deepest > self.tolerance:
|
|
232
|
+
contact.state[:, S_LAMBDA] = contact.trial[:, S_PRESSURE]
|
|
233
|
+
self._augmented += 1
|
|
234
|
+
return True
|
|
235
|
+
self._augmented = 0
|
|
236
|
+
contact.state = contact.trial.copy()
|
|
237
|
+
contact.multiplier = contact.state[:, S_LAMBDA].copy()
|
|
238
|
+
self._x_old = self._x_now
|
|
239
|
+
area = float((contact.weight * contact.state[:, S_SHARE])[pressed].sum())
|
|
240
|
+
area /= contact.shares
|
|
241
|
+
most = contact.shares * float(contact.state[pressed, S_PRESSURE].max()) if area else 0.0
|
|
242
|
+
rubbed = float(contact.weight @ contact.state[:, S_WORK])
|
|
243
|
+
self._history.append((area, most, max(deepest, 0.0), rubbed))
|
|
244
|
+
return False
|
|
245
|
+
|
|
246
|
+
def _rollback(self) -> None:
|
|
247
|
+
"""A step is divided: the multipliers and the faces of the end of the last one."""
|
|
248
|
+
contact = self._images.contact
|
|
249
|
+
contact.state[:, S_LAMBDA] = contact.multiplier
|
|
250
|
+
contact.last = contact.state[:, S_FACE].astype(np.int64)
|
|
251
|
+
self._augmented = 0
|
|
252
|
+
|
|
253
|
+
def run(self, path, **options):
|
|
254
|
+
"""The response to a loading path (:meth:`~morphogen.homogenization.nonlinear.
|
|
255
|
+
NonlinearFEProblem.run`), with the records of the contact in its ``series`` (see
|
|
256
|
+
the class)."""
|
|
257
|
+
self._begin()
|
|
258
|
+
result = super().run(path, **options)
|
|
259
|
+
history = np.array(self._history[: len(result.times)])
|
|
260
|
+
result.series.update({name: history[:, j] for j, name in enumerate(SERIES)})
|
|
261
|
+
return result
|
|
262
|
+
|
|
263
|
+
def slave_points(self) -> dict:
|
|
264
|
+
"""The slave points at the end of the last path: their ``pressure``, tangential
|
|
265
|
+
``traction``, ``gap``, ``weight`` (reference area; of the points at the nodes of
|
|
266
|
+
the faces, the share that the other surface sees) and energy ``dissipated`` by
|
|
267
|
+
friction per unit area, and their ``position``."""
|
|
268
|
+
contact = self._images.contact
|
|
269
|
+
return {
|
|
270
|
+
"position": contact.surface.positions(
|
|
271
|
+
self._x_old, contact.face, contact.xi, contact.eta
|
|
272
|
+
),
|
|
273
|
+
"pressure": contact.shares * contact.state[:, S_PRESSURE],
|
|
274
|
+
"traction": contact.shares * contact.state[:, S_TX : S_TX + 3],
|
|
275
|
+
"gap": contact.state[:, S_GAP],
|
|
276
|
+
"weight": contact.weight * contact.state[:, S_SHARE],
|
|
277
|
+
"dissipated": contact.state[:, S_WORK],
|
|
278
|
+
}
|