morphogen.fracture.mixed

Mixed-mode cracks in 3D, in small and finite strains: the energy release rate along the front by the G-θ method, its partition into the modes I, II and III by the interaction integrals, the direction of kinking, and the propagation of kinked cracks on meshes conforming to them, rebuilt by MMG at each step (as Z-cracks).

Problem. The crack (a planar Crack or a KinkedCrack) is opened on a mesh conforming to it (its lips duplicated, crack_faces()), the displacements prescribed on node sets; the bulk is linear elastic in small strains or a compressible neo-Hookean solid in finite strains (total Lagrangian), the lips free or in frictionless contact (a penalty against their interpenetration, under shear and closure): solve_crack().

Energy release rate (the G-θ method of Destuynder & Djaoua 1981, as in Code_Aster and Z-set): for a virtual advance θ = q(r) w(s) d of the front (d the direction of propagation, q from 1 within r_in of the front to 0 beyond r_out, w a weight along the front), ∫ G w ds = ∫ (Hᵀ P - W I) : ∇θ dV with the displacement gradient H, the first Piola-Kirchhoff stress P and the energy density W of the reference configuration (Eshelby’s energy-momentum tensor): exact for hyperelastic solids in finite strains, the J-integral in small strains. The weights are the piecewise linear functions of stations along the front, giving G(s) (a small system with the mass matrix of the front), or 1, giving its mean. θ stays tangent to the lips: its domain does not reach the mouth of the crack, nor the last kink of a kinked one. The check: the energy of the body at fixed prescribed displacements, G = -dU/dA (energy_release_rate()).

Modes (the interaction integral of Yau, Wang & Corten 1980, in 3D as Moran & Shih 1987): with the same θ, the cross term of the energy-momentum tensors of the body and of the asymptotic field of a unit factor of each mode (plane strain for I and II, antiplane for III, in the axes (d, n, t = d × n) of the front), M = ∫ (σ_ij u'_i,k + σ'_ij u_i,k - σ' : ε δ_kj) θ_k,j dV, gives K_I = E' M_I / 2, K_II = E' M_II / 2 and K_III = μ M_III (E' = E / (1 - ν²), the isotropic elasticity of the material at the front, the Voigt-Reuss-Hill estimate of an anisotropic one such as a crystal): more accurate than the jumps of the lips, whose fit by sqrt(r) on linear elements biases the mixity. Along a curved front the auxiliary fields, those of a straight front in the turning axes of the front, are neither compatible nor balanced: the divergence of the cross tensor, ∫ (σ_ij (u'_i,kj - ε'_ij,k) + σ'_ij,j u_i,k) θ_k dV, is added (Gosz & Moran 2002), which makes the factors independent of the domain (zero along a straight front, where it is skipped). Behind the front the auxiliary fields of an element are those of its side of the crack (the angle continued across the plane of the crack): an element flat along the lips, whose centroid lies within a step of differences of the plane (or across it, where the mesh moved the lips), would otherwise difference the two sides of the auxiliary displacement. The energy release rate of the G-θ method is shared in the proportions K_I² / E', K_II² / E', K_III² / 2μ (in small strains, it converges with their sum). The mean rotation of the domain, which adds nothing to the integrals, is removed from the displacement gradient (the auxiliary stress is not in discrete equilibrium: without it, a rigid rotation would bias the factors). In finite strains, where the modes do not separate, the integral takes the stress and the displacement gradient turned back by the rotation of the polar decomposition of the mean deformation gradient around the front: an estimate of the mixity of the remote field. Lips in contact carry tractions, whose work in the auxiliary fields, ∫ t · (∇u' θ) dS over the lips, is subtracted (their work in the actual field, that of the penalty, is neglected in G); frictionless, it only concerns the mode I, which lips closed at the front do not have: K_I ≥ 0 (the closure of the singular integral near the front being the least accurate part).

Kinking (Erdogan & Sih 1963): the direction of the largest hoop stress, θ = 2 atan((K_I - sqrt(K_I² + 8 K_II²)) / (4 K_II)) from d towards n (-70.5° in pure mode II); the tearing mode III, which twists the front, counts in G but does not turn the path here.

Morphologies (crack meshes whose phases are those of the materials and whose sides of the crack are apart, crack_mesh() with morphology): the material at the front is that of the elements in which the points of the front lie; the interaction integrals, their G and the driving force at the tip (energy="tip") take θ zero beyond r_in at the nodes outside that material (its interfaces with the others, the other materials, the walls of the pores), so that they are those of the material at the front, the configurational forces of the inclusions and of the pores in the domain left out (the inhomogeneity term of Simha, Fischer, Kolednik & Chen 2003); the far J ("work", "free") keeps them. A front grown into a pore goes through it (through_voids()).

Inelastic bulks (bulk="points", or automatically when a phase is inelastic: the behaviours of morphoGen’s points, morphogen.fracture.bulk: von Mises elasto-viscoplasticity, crystal plasticity, MFront laws, in small and finite strains). The energy-momentum tensor then takes either the work density w = ∫ P : dF (the J of the deformation theory of plasticity, independent of the domain under monotonic proportional loading, and the release of the work of the loads at fixed displacements, -dW/dA, the J of Begley & Landes), or the free energy ψ: its divergence is then -∂ψ/∂α · ∇α in the zone where the internal variables α vary, so that ∫ (Hᵀ P - ψ I) : ∇θ dV grows with the domain, and adding -∫ ∂ψ/∂α · ∇α · θ dV gives the driving force at the tip (the configurational force of Simha, Fischer, Shan, Chen & Kolednik 2008), smaller than the far J by the shielding of the plastic zone: energy="work", "free" or "tip" of CrackSolution.release_rate() (the same for elastic bodies).

Propagation (propagate_kinked()): at each step the body is meshed again conforming to the crack (MMG through the signed distance to its path), solved, its G and modes computed, and its front advanced by an increment in the direction of kinking (by Paris’ law da/dN = C ΔK^m, ΔK = sqrt(E' G), the cycles of the increment). With a toughness of the phases and of their interfaces (morphogen.fracture.toughness), each advance is the candidate of the largest G(θ) / Γ(θ), the kink of the bulk or a deflection along an interface ahead (the first-order kinked factors of Cotterell & Rice), and each crack has the critical load factor sqrt(Γ / G) of its advance.

class morphogen.fracture.mixed.KinkedCrack(points: tuple, axis: tuple = (0.0, 0.0, 1.0))[source]

Bases: object

A crack with a straight front along axis, whose path in the planes normal to the front is the polyline of points (from its mouth, on the boundary of the body, to its front): an edge or through crack that kinks as it grows (grown()); the normal of each segment e is axis × e (towards the side +).

classmethod of(crack) → KinkedCrack[source]

The kinked crack of a straight planar Crack.

property size: float

The length of the path.

property last: float

The length of the last segment.

property tip: ndarray
phi(x) → ndarray[source]

Signed distance to the path, its first and last segments extended. The points nearest a kink take the side of the sum of the normals of its two segments (its pseudo-normal; that of one segment turns the side of the points ahead of it beyond a kink of 90° or more, such as a deflection along an interface).

psi(x) → ndarray[source]

Distance beyond the front along the last segment (negative behind it).

local(x)[source]

The coordinates of points along the axes d and n of the front.

frame(x)[source]

As frame(): the distance r to the front, the axes n, d, t of the last segment and the coordinate s along the front.

front(lower, upper, count: int = 400)[source]

Points of the front inside the box [lower, upper] and their lengths.

grown(da: float, angle: float = 0.0) → KinkedCrack[source]

The crack advanced by da at angle (radians) from its last segment towards its normal (a new segment, or the last one longer if angle is 0), or its last segment shortened by -da (da < 0). The new front is rounded to 10⁻¹⁰: the meshes of MMG change with the last digits of the crack, so that rounding makes a growth reproducible whatever the load at which its angles were computed.

morphogen.fracture.mixed.element_sides(mesh: TetMesh, crack) → ndarray[source]

The side of a crack of each element of a mesh (1 or -1): that of its phase on a mesh of crack_mesh() (the median sign of φ over it), or of its label mesh.side on a crack mesh of a morphology, otherwise the sign of φ at its centroid.

morphogen.fracture.mixed.material_groups(phase, materials: dict) → ndarray[source]

The material of each element (of its phase) as a label: the first phase of an equal material (phases of the same material make one group).

morphogen.fracture.mixed.material_nodes(mesh: TetMesh, materials: dict, phase: int, lips=None) → ndarray[source]

The nodes (a mask) inside the material of the phase phase of a crack mesh of a morphology: those whose elements all have it (the phases of the same material alike), off the walls of the pores (the free faces off the faces of the box and off the lips, an Interfaces of the opened crack).

class morphogen.fracture.mixed.CrackSolution(mesh: TetMesh, faces: Interfaces, crack: object, materials: dict, finite: bool, displacement: ndarray, steps: CohesiveResult, forces: ndarray | None = None, contact: float | None = None, bulk: object | None = None, friction: float = 0.0)[source]

Bases: object

A solved cracked body: its opened mesh, the lips faces (pairs of faces), the crack, the materials of the phases, the kinematics, the final displacement (nodes x 3), the steps of the solver, the final nodal forces, the stiffness of the contact of the lips and the bulk of points with its final state (inelastic bodies; PointBulk).

stresses(energy: str = 'work')[source]

The displacement gradient H, the first Piola-Kirchhoff stress P (Cauchy in small strains) and the energy density W of each element, its volume and the gradients of its shape functions: W the elastic energy of an elastic body; for a bulk of points, their work density (energy="work") or their free energy ("free" or "tip").

energy(kind: str = 'work') → float[source]

The elastic energy of an elastic body; for a bulk of points, the work of its stresses (kind="work": the stored and dissipated energies, the work of the loads at fixed displacements) or its free energy ("free").

potential() → float[source]

The potential energy: the elastic energy (the work of the bulk) less the work of the forces (dead loads).

area() → float[source]

The area of the crack (its opened faces, in the reference configuration).

element_size() → float[source]

The mean length of the edges of the elements; on a mesh refined around the front (refine_front()), of the elements that reach within half their size of it: the size that the domains of the integrals and the stations along the front are counted in.

front_phase() → int[source]

The phase at the front (its material: that of the front): of the elements in which most of the points of the front lie (or of the element nearest the front, if none of them lies in the body).

release_rate(r_in=None, r_out=None, stations: int | None = None, energy: str = 'work')[source]

The energy release rate by the G-θ method (see the module): its mean along the front, or (s, G) at stations points along it (the coordinate s: a length, an angle on a penny; at least two elements apart); q from 1 within r_in (by default one element) to 0 beyond r_out (four), within the reach of the lips. energy of an inelastic bulk (see the module): "work", the J of the deformation theory; "free", the configurational force on the domain; "tip", the driving force at the tip.

On a crack mesh of a morphology, the domain of "work" and "free" takes in the other materials and the walls of the pores within it, their configurational forces with it (the far J); that of "tip" is the material at the front: θ vanishes beyond r_in at the nodes of its interfaces with the other materials, in them and on the walls of the pores, which leaves their configurational forces out (the inhomogeneity term of Simha, Fischer, Kolednik & Chen 2003).

modes(r_in=None, r_out=None, stations: int | None = None, release_rate=None) → dict[source]

The stress intensity factors of the three modes by the interaction integrals, the energy release rate G by the G-θ method (or the value given, the same at all the stations) shared between them (the same domain), and the angle of kinking (see the module): floats, or arrays at the stations along the front ("s"). On a crack mesh of a morphology, the domain is the material at the front (that of release_rate() with energy="tip"), whose moduli the auxiliary fields take.

morphogen.fracture.mixed.solve_crack(mesh: TetMesh, crack, materials, prescribed, load: float = 1.0, *, kinematics: str = 'small', steps: int | None = None, contact: float | bool | None = None, friction: float = 0.0, forces=None, sides=None, bulk: str = 'auto', initial: CrackSolution | None = None, start: float | None = None, transfer: str = 'projection', equilibrate: bool = True, **options) → CrackSolution[source]

Open the crack on its conforming mesh and solve the body (see the module): materials a material (all the phases) or a dict of the phases; prescribed the entries (nodes, components, value) of run(), or a function of the opened mesh returning them, and forces nodal forces (3 x nodes, or a function of the opened mesh), both grown to load times their values in steps (by default 1, or 10 in finite strains, with contact or an inelastic bulk); contact: the penalty stiffness of the contact of the lips (True: 50 E / h; none by default) and friction their coefficient of friction (Coulomb: lips in contact stick or slide; see the module); bulk: that of CohesiveProblem (inelastic phases: their points); options: those of the solver (tol, max_newton, duration…).

initial: the solution of another crack (another mesh) whose state goes on: its displacement, and the internal variables of its points, are transferred to this mesh by transfer (transfer_state()), brought to equilibrium (equilibrate) at the load start (by default the last of initial), and the loading resumes from there up to load.

morphogen.fracture.mixed.kink_angle(k1: float, k2: float) → float[source]

The direction of the largest hoop stress (Erdogan & Sih), in radians from the direction of propagation towards the normal of the crack.

morphogen.fracture.mixed.energy_release_rate(solve, crack, delta: float) → float[source]

G = -(Π(a + δ) - Π(a - δ)) / (A(a + δ) - A(a - δ)), the potential energies at fixed prescribed displacements and forces, solve(crack) returning the CrackSolution of a crack: the check of the G-θ method (the mean along the front).

class morphogen.fracture.mixed.KinkedGrowth(cracks: list, rates: ndarray, factors: ndarray, angles: ndarray, cycles: ndarray, solutions: list = <factory>, loads: ndarray | None = None, advances: list = <factory>)[source]

Bases: object

The steps of a propagation: the cracks, their energy release rates, stress intensity factors (steps x 3), angles of their advances and cycles (Paris), with keep the solutions; with a toughness, the critical load factor of each crack (loads: sqrt(Γ / G) of its advance at the load of the growth) and its advance (advances: the Advance chosen; that of the last crack is not taken).

rows() → list[dict][source]
morphogen.fracture.mixed.propagate_kinked(mesh_of, crack: KinkedCrack, materials, prescribed, load: float = 1.0, *, increment: float, steps: int, kinematics: str = 'small', paris: tuple[float, float] | None = None, contact: float | bool | None = None, toughness=None, keep: bool = False, **options) → KinkedGrowth[source]

Grow a kinked crack (see the module): mesh_of(crack) meshes the body conforming to it (crack_mesh()), prescribed (entries, or a function of the opened mesh) and load load it; each of the steps advances the front by increment in the direction of kinking; paris = (C, m) counts the cycles; options those of solve_crack().

toughness: a Toughness (or one value, or a dict of the phases): each advance is then the candidate of the largest G(θ) / Γ(θ), the kink of the bulk or along an interface within an increment ahead (advance_candidates()), and the critical load factor of each crack is load sqrt(Γ / G) of its advance (G growing as the square of the load: small strains); one value for all the phases without interfaces gives the advances in the direction of kinking.

morphogen.fracture.mixed.inside_elements(mesh: TetMesh, points, k: int = 16, tol: float = 1e-09) → ndarray[source]

Whether points (rows) lie in an element of a mesh of linear tetrahedra (among the k whose centroids are nearest; tol: of their barycentric coordinates).

morphogen.fracture.mixed.through_voids(crack, mesh: TetMesh, increment: float, count: int = 64)[source]

The crack grown on through the voids of a mesh (its pores) in which its front would end: its last segment lengthened by halves of increment until most of the count points of its front, and most of the points a quarter of increment behind them (on its lips), lie in elements again (inside_elements()), or its front leaves the box. A front that ran into a pore so goes through it, the crack then emanating from its far wall, its front a quarter to three quarters of increment beyond it.