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 of Bilinear (normal_strength and mode_I at least), Exponential (strength and energy) or Contact. 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 penalty stiffness is 100 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): faces is "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. periodic false: 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: NonlinearFEProblem

A cell whose interfaces may debond along a loading path (see the module): the mesh of its phases (4- or 10-node tetrahedra; periodic conditions need the same faces of elements on the opposite faces of the cell), their materials, the traction-separation law of the interfaces ( Bilinear, Exponential, or Contact for lips without adhesion, each with its coefficient of friction; 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, unless faces says 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 of NonlinearFEProblem (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 its series (columns of its curves, SERIES), at each step the area of the interfaces whose points are broken debonded_area (reference area), their mean damage interface_damage, their largest normal opening interface_opening and the energy that friction dissipated interface_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 its series (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, normal opening (negative: lips pressed on each other), frictional slip (two components in the frame of each point), energy dissipated by friction per unit area and weight (reference area).