morphogen.fracture.periodic¶
Debonding in the cells of the nonlinear homogenization: the interfaces of the phases of a periodic cell (or the boundaries of its grains) that open, break, close again and rub along a loading path.
CohesiveCell 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
interface elements of morphogen.fracture.cohesive between its phases: the bilinear
mixed-mode law, the exponential one, or the contact of lips without adhesion, each with
Coulomb’s friction of the broken share of a point.
Insertion on the torus (open_cell()). A periodic cell is a torus: a node of a face
of the cell and its translate on the opposite face are one point of the medium, and so
are a face of an element there and its translate. The faces to open are chosen among the
faces that two elements share on the torus — two elements of different phases on either
side of a face of the cell included — and the nodes are duplicated there: the corners of
the elements around each point of the torus are grouped by the faces (through that point)
by which they remain connected, and each group gets its own node, or its own nodes where
the point has translates in the cell; the nodes of a group are linked by the periodic
conditions, those of different groups are not. An interface that crosses a face of the
cell thus goes on in the next cell, its two lips each with their images.
Images. An interface element that lies on a face of the cell joins a face of an element
there and the image of a face of the opposite side: the image of a node of displacement
u moved by a period L is displaced by u + H L, H the macroscopic
displacement gradient, so that its separation is the jump of the fluctuation, and the
forces that the image receives go to the node itself.
Macroscopic stress. The tractions of an interface are opposite on its two lips, at one
place of the reference cell: they carry no part of the macroscopic stress, the integral of
the stress of the points over the volume of the cell — but for the interfaces on its
faces, whose forces work in a change of H by the force that crosses the face times
the period (Σ f ⊗ X over the nodes, the images at their own places). The macroscopic
strain is that of the points and of the separations: E = <ε> + 1/V ∫ sym([u] ⊗ n) dS.
Softening. An interface that breaks at once has no equilibrium beyond a limit point
under prescribed strains (a snap-back): the steps are divided, and the viscous
regularization of Gao & Bower (2004), with the time of the path, lets them through
(viscosity; morphogen.fracture.cohesive).
Iterations. Lips open, close and rub along Newton’s corrections. The first tangent of
a step keeps closed the lips of broken points that touched at its start; the line search
is nonmonotone (the residual may rise, below the largest of the last WINDOW
iterates: an active-set iteration that does not cycle); and Coulomb’s bound is reached
over an elastic slip (slip) — lips that come to touch, whose pressure and slip both
start from nothing, would otherwise slide along a direction that means nothing.
- morphogen.fracture.periodic.SERIES = ('debonded_area', 'interface_damage', 'interface_opening', 'interface_dissipation')¶
the area of the interfaces that is broken (reference area), their mean damage, their largest normal opening and the energy dissipated by friction
- Type:
The curves that a cell records at each step (
PathResult.series)
- morphogen.fracture.periodic.WINDOW = 4¶
The number of iterates whose largest residual bounds the line search of Newton’s corrections (a nonmonotone search)
- morphogen.fracture.periodic.LAW_OPTIONS = {'bilinear': ('stiffness', 'normal_strength', 'shear_strength', 'mode_I', 'mode_II', 'eta', 'friction'), 'contact': ('stiffness', 'tangential', 'friction'), 'exponential': ('strength', 'energy', 'beta', 'penalty', 'friction')}¶
The parameters of the laws of the interfaces given as mappings (
interface_law())
- morphogen.fracture.periodic.interface_law(spec, young: float, size: float)[source]¶
The traction-separation law of a mapping: its
law("bilinear", by default,"exponential"or"contact": lips without adhesion) and the parameters ofBilinear(normal_strengthandmode_Iat least),Exponential(strengthandenergy) orContact. Left out: the shear strength is the normal one, the energy of mode II that of mode I times the square of the ratio of the strengths (the separations at failure in the ratio of the strengths), and the penaltystiffnessis100 young / size: a Young’s modulus (the stiffest of the cell) over a length (the size of its interface elements).
- morphogen.fracture.periodic.open_cell(mesh: TetMesh, faces='phases', *, periodic: bool = True)[source]¶
Open faces of the mesh of a periodic cell on its torus (see the module):
facesis"phases"(the faces between different phases; side - the lower phase),"grains"(between different grains of a polycrystal,mesh.cell), pairs of phases (the faces between the two phases of a pair) or a function of the centroids (rows) of the faces that two elements share, returning a mask.Returns the mesh with the duplicated nodes, whose
periodic_links()are those of the copies (the two lips of an interface that crosses a face of the cell each linked to their own translates); the interface elements of the opened faces; and for each of them the periods (three integers) from its side - to its side +: zeros inside the cell, the period that an interface on a face of the cell crosses.periodicfalse: the faces of the cell are not joined (insert_interfaces()), as for kinematic conditions. A mesh of 10-node elements is opened by its corners, its mid-edge nodes made again where they were.
- class morphogen.fracture.periodic.CohesiveCell(mesh: TetMesh, materials, law, bc: str = 'periodic', *, faces='phases', viscosity: float = 0.0, slip: float | None = None, **options)[source]¶
Bases:
NonlinearFEProblemA cell whose interfaces may debond along a loading path (see the module): the
meshof its phases (4- or 10-node tetrahedra; periodic conditions need the same faces of elements on the opposite faces of the cell), theirmaterials, the traction-separationlawof the interfaces (Bilinear,Exponential, orContactfor lips without adhesion, each with its coefficient offriction; or a mapping of its parameters:interface_law(), with the stiffest Young’s modulus of the cell and the size of its interface elements) and the boundary conditions ("periodic"or"kubc"). A law for each pair of phases: a mapping of the pairs to their laws,{(0, 1): law, (0, 2): other}— the interfaces are then those of these pairs, unlessfacessays otherwise ("grains": every boundary of a grain, with the law of the two phases that it parts,(1, 1)for two grains of the phase 1).faces: the faces that are interfaces (open_cell():"phases","grains", pairs of phases or a function of centroids).viscosity: the time of the viscous regularization of the damage of the interfaces (Gao & Bower 2004), in the time of the paths; 0: none.slip: the elastic slip of the friction, over which lips that stick reach Coulomb’s bound (a stiffness of the stick ofμ p / slip, whatever that of the law; by default 0.005 times the size of the interface elements): the friction of lips that come to touch, whose pressure and slip both start from nothing, would otherwise have no direction. The other options are those ofNonlinearFEProblem(kinematics:"small"by default, or"finite", the tractions then turning with the interfaces;newton_tol,max_cuts…); the tangent is factorized (solver="direct") and kept whole.run()returns the response to a path with, in itsseries(columns of its curves,SERIES), at each step the area of the interfaces whose points are brokendebonded_area(reference area), their mean damageinterface_damage, their largest normal openinginterface_openingand the energy that friction dissipatedinterface_dissipation. Its fields have, for each element, the damage and the opening of the interface elements on its faces (interface_damage,interface_opening: the largest of their means; zero away from the interfaces).laws: the laws of the interfaces, by pair of phases;law: the first of them.- damage() ndarray[source]¶
The damage of the points of the interfaces (elements x points) at the end of the last step.
- run(path, **options)[source]¶
The response to a loading path (
run()) from sound interfaces, with the records of the interfaces in itsseries(see the class).
- interface_points() dict[source]¶
The integration points of the interfaces at the end of the last path (rows: elements x points): their
position(reference),damage, normalopening(negative: lips pressed on each other), frictionalslip(two components in the frame of each point), energydissipatedby friction per unit area andweight(reference area).