morphogen.contact.periodic

Self-contact in the cells of the nonlinear homogenization: the walls of the pores of a periodic cell that close on themselves along a loading path.

ContactCell is the periodic element of NonlinearFEProblem (the fluctuation and the macroscopic strain components as unknowns, loading paths in strains, stresses or both, the behaviours of morphoGen’s points) with the forces of the contact of its free surface with itself (morphogen.contact).

Images. A wall of a pore may meet the image of another across a face of the cell. The faces of the surface near the boundary of the cell are therefore given images, translated by the periods of the cell: the image of a node of displacement u moved by a period L is displaced by u + H L, H the macroscopic displacement gradient (the cell deforms with it), and the forces that it receives go to the node itself.

Macroscopic stress. The positions of the nodes follow the macroscopic gradient, x = X + H X + w: the forces f of the contacts work in a change of H by Σ f ⊗ X over the nodes (the images at their own places X + L). This term — nothing for two walls that touch inside the cell, whose forces are opposite at the same place; the force that crosses a face of the cell times the period for a wall and an image — is added to the integral of the stress of the points: in the equilibrium of the stress-controlled components, in the macroscopic stress of the results, and its derivatives in the tangent of the macroscopic unknowns.

morphogen.contact.periodic.SERIES = ('contact_area', 'contact_pressure', 'contact_penetration', 'contact_dissipation')

the area in contact (reference area, of one of the two sides), the largest pressure, the deepest penetration and the energy dissipated by friction

Type:

The curves that a cell records at each step (PathResult.series)

morphogen.contact.periodic.walls(mesh: TetMesh) → Surface[source]

The free faces of a cell that are not on its boundary: the walls of its pores (the faces of the solid on the faces of the box, or on the outer boundary of whole periodic cells, go on in the neighbouring cells).

class morphogen.contact.periodic.ContactCell(mesh: TetMesh, materials, bc: str = 'periodic', *, friction: float = 0.0, stiffness: float | None = None, tangential: float | None = None, depth: float | None = None, points: str = 'gauss', surface: Surface | None = None, augmentations: int = 0, tolerance: float | None = None, neighbours: int = 12, kinematics: str = 'finite', **options)[source]

Bases: NonlinearFEProblem

A cell whose free surface may touch itself along a loading path (see the module): the mesh of its solid (the pores left out: conforming_mesh(..., phases="solid"), or mesh.subset), the materials of its phases and the boundary conditions ("periodic": the walls also meet their images across the faces of the cell; "kubc").

friction, stiffness, tangential, depth and points: those of a Pair; surface: the faces that may touch (by default the walls of the pores, walls()); augmentations, tolerance and neighbours: those of ContactProblem. The other options are those of NonlinearFEProblem (kinematics, finite strains by default; integration, newton_tol…); the tangent is factorized (solver="direct"), and kept whole with friction or with the points at the nodes (the derivatives of their shares).

run() returns the response to a path with, in its series (columns of its curves, SERIES), at each step the area in contact contact_area (reference area, of one of the two sides), the largest pressure contact_pressure, the deepest penetration contact_penetration and the energy that friction dissipated contact_dissipation.

run(path, **options)[source]

The response to a loading path (run()), with the records of the contact in its series (see the class).

slave_points() → dict[source]

The slave points at the end of the last path: their pressure, tangential traction, gap, weight (reference area; of the points at the nodes of the faces, the share that the other surface sees) and energy dissipated by friction per unit area, and their position.