morphogen.fracture.cohesive

Cohesive zone elements: the interfaces of composites and fracture along given surfaces, in small and finite strains.

Traction-separation laws, per unit area of the reference interface (δ = u⁺ - u⁻ the separation, n the normal from side - to side +, δ_n = δ · n and δ_s = δ - δ_n n):

  • Bilinear (Camanho & Dávila 2002; Turon, Camanho, Costa & Dávila 2006): a penalty stiffness K, the onset tractions N (normal) and S (shear), the fracture energies G_Ic and G_IIc and the exponent η of the mixed-mode criterion of Benzeggagh & Kenane. The equivalent separation λ = sqrt(<δ_n>² + |δ_s|²) and the mode mixity B = |δ_s|² / λ² give the separations of onset, λ0² = δn0² + (δs0² - δn0²) B^η, and of failure, λf = (δn0 δnf + (δs0 δsf - δn0 δnf) B^η) / λ0 (δn0 = N/K, δs0 = S/K, δnf = 2 G_Ic / N, δsf = 2 G_IIc / S), hence the damage d = λf (λ - λ0) / (λ (λf - λ0)), irreversible (its largest value); the traction is (1 - d) K δ, except in compression, t_n = K δ_n (no interpenetration, no damage). The energy of a separation at fixed mixity is G_Ic + (G_IIc - G_Ic) B^η.

  • Exponential (Ortiz & Pandolfi 1999): the effective opening δ = sqrt(<δ_n>² + β² |δ_s|²) and the effective traction e σc (δ/δc) exp(-δ/δc) along its envelope (G_c = e σc δc), unloading linearly to the origin; t = (t_eff / δ) (<δ_n> n + β² δ_s), and a penalty K_c in compression.

  • Contact: the contact of the lips of a crack, a penalty against their interpenetration and no normal traction otherwise (morphogen.fracture.mixed), frictionless or with Coulomb’s friction.

Friction (the three laws take a coefficient friction μ; Alfano & Sacco 2006): a point of damage d is a share 1 - d of sound interface, which carries the traction of its law, and a share d of broken interface, whose lips touch under a negative δ_n (the pressure p = K <-δ_n> of the penalty) and rub: an elastic stick, τ = K_t (δ_s - δ_s^p), within Coulomb’s cone |τ| <= μ p, and beyond it a slip δ_s^p along τ (a non-associated flow: the slip opens nothing), integrated by a radial return, τ = μ p τ_trial / |τ_trial| and δ_s^p = δ_s - τ / K_t. The shear traction is (1 - d) K δ_s + d τ: that of the sound law alone while the interface is intact, Coulomb’s μ p once it is broken, and the lips of a crack (Contact: d = 1) stick or slide. Lips apart carry nothing and forget their slip. The slip of each point (two components in its frame, which turns with the interface in finite strains) and the energy that friction dissipated there per unit area, ∫ d τ · dδ_s^p, are kept with the history of its law; the tangent, the derivative of the tractions of the radial return, is not symmetric where the lips slide (∂τ/∂δ_n = -μ K τ/|τ|).

Interface elements: zero-thickness elements of six nodes between the faces of two linear tetrahedra, integrated at three points of their mid-surface; of twelve nodes between the faces of two 10-node tetrahedra (the six nodes of each face: the separation is quadratic, as the displacements of the two sides), integrated at six points (a rule exact to degree 4: three points would leave openings without traction), with the normal and the area element of each point: their faces may be curved, as those of the meshes whose nodes lie on the interfaces of the phases (morphogen.mesh.curved). In finite strains the normal and tangents are those of the current mid-surface (the tractions turn with the interface: frame-indifferent under rigid rotations), and the tangent of an element is the derivative of its forces by central differences.

Insertion (insert_interfaces()): the faces between elements of different phases (the interfaces of composites), or the faces chosen by a mask or a function of their centroids (a crack path), are opened by duplicating their nodes: the elements around each of their nodes are grouped by the faces (through that node) by which they remain connected, and each group gets its own copy, so that the nodes of a crack front, around which the two sides remain connected, are not split. A mesh of 10-node elements is opened by its corners, and the mid-edge nodes of the two lips made again where they were (on the curved interfaces of the phases).

Solver (CohesiveProblem): quasi-static, the displacements prescribed on node sets (and dead loads) grown with a load factor; Newton’s method on the bulk (linear elasticity of the materials in small strains; a compressible neo-Hookean solid, W = μ/2 (I1 - 3) - μ ln J + λ/2 (ln J)², total Lagrangian, in finite strains, both with 4- or 10-node elements; or the behaviours of morphoGen’s points, elasto-viscoplastic, crystalline or MFront, with their internal variables, on 4-node elements: morphogen.fracture.bulk) and the interfaces, with a line search and the steps divided when they fail; results: the reactions, the damage and the cracked area at each step, and optionally the displacements. The local instabilities of softening interfaces (an element failing at once: no equilibrium beyond a limit point under the prescribed displacements) are passed by the viscous regularization of Gao & Bower (2004), the load factor as time: d = (d_n + Δt/ζ d_∞) / (1 + Δt/ζ), the steps being divided until the damage, slowed, lets Newton’s method converge; the solution tends to the rate-independent one as the viscosity ζ tends to 0.

Calibration (Turon, Dávila, Camanho & Costa 2007; Linke & Lammering 2023): the length of the cohesive zone l_cz = M E G / T², the strength that coarse meshes need, T = sqrt(9π E G / (32 N_e l_e)), and the corrected beam theory of the double cantilever beam (load and crack length against the opening).

morphogen.fracture.cohesive.STATE = 5

the history of its law (the damage, or the largest effective opening), the two components of the frictional slip of its broken share, the energy dissipated there by friction per unit area, and its normal separation (negative or zero: lips that touch)

Type:

The values kept at an interface point

morphogen.fracture.cohesive.BROKEN = 0.999

Damage above which an integration point is broken (its area counts as cracked)

class morphogen.fracture.cohesive.Bilinear(stiffness: float, normal_strength: float, shear_strength: float, mode_I: float, mode_II: float, eta: float = 2.0, friction: float = 0.0)[source]

Bases: object

The bilinear mixed-mode law (see the module): stiffness K (penalty), normal_strength N, shear_strength S, the fracture energies mode_I and mode_II (G_Ic, G_IIc) and the exponent eta of Benzeggagh & Kenane.

params() → ndarray[source]
class morphogen.fracture.cohesive.Exponential(strength: float, energy: float, beta: float = 1.0, penalty: float | None = None, friction: float = 0.0)[source]

Bases: object

The irreversible exponential law of Ortiz & Pandolfi (see the module): the cohesive strength σc, the fracture energy G_c, the shear-to-normal ratio beta, the penalty stiffness in compression (by default 10 e σc / δc), which is also that of the stick of the broken share, and the coefficient of friction of that share.

property critical_opening: float

δc = G_c / (e σc).

params() → ndarray[source]
class morphogen.fracture.cohesive.Contact(stiffness: float, friction: float = 0.0, tangential: float | None = None)[source]

Bases: object

Contact of the lips of a crack: a penalty stiffness against their interpenetration (t_n = K min(δ_n, 0)), no normal traction otherwise; with a coefficient of friction, lips in contact stick (the tangential stiffness of the stick, by default that of the penalty) or slide under Coulomb’s μ |t_n| (see the module). Points whose history is negative (CohesiveProblem.run()) are bonded by the two stiffnesses, in tension as in compression: the ligament ahead of the front of a crack whose lips rub (morphogen.fracture.mixed.solve_crack()).

params() → ndarray[source]
morphogen.fracture.cohesive.traction(law, separation, history=0.0, slip=None)[source]

The traction (local components: normal, shear, shear) of a law for a separation (local components) from a history (damage or largest opening), and the new history: a material point of the interfaces. With slip (the frictional slip of the point at the start: two components, zeros for a new point), also the new slip and the energy that friction dissipated per unit area on the way.

morphogen.fracture.cohesive.lip_tractions(nodes, interfaces, displacement, law, result=None, finite: bool = False)[source]

The tractions that the points of interface elements of three nodes a side carry at the end of a solution: (tractions, jumps), elements x 3 points x 3, in global components; the traction is that on the side - (its opposite on the side +), of the separation of displacement (nodes x 3) from the history and the frictional slip of result (a CohesiveResult; none: new points).

class morphogen.fracture.cohesive.Interfaces(minus: ndarray, plus: ndarray, phases: ndarray)[source]

Bases: object

Interface elements: the nodes of their side minus and of their side plus (matching; elements x 3 between 4-node tetrahedra, elements x 6 between 10-node ones: the corners, then the mid-edge nodes of the edges 0-1, 1-2 and 2-0), the phases of the two sides (elements x 2; -1 unknown); the normal goes from side - to side +.

property n_elements: int
property order: int

1 for faces of three nodes, 2 for faces of six.

property weights: ndarray

The shares of the area of an element of its integration points.

subset(keep) → Interfaces[source]

The interface elements keep (mask or indices).

centroids(mesh: TetMesh) → ndarray[source]
areas(mesh: TetMesh) → ndarray[source]

The areas of the elements (of their side -; curved faces of six nodes: the integral of their area element).

morphogen.fracture.cohesive.interior_faces(mesh: TetMesh) → tuple[ndarray, ndarray][source]

The faces that two elements of a mesh share, in the order of the masks of insert_interfaces(): their corners (faces x 3) and their two elements (faces x 2).

morphogen.fracture.cohesive.insert_interfaces(mesh: TetMesh, faces='phases', *, sides=None) → tuple[TetMesh, Interfaces][source]

Open faces of a tetrahedral mesh (see the module): faces is "phases" (the faces between different phases; side - the lower phase), a boolean mask of the interior faces or a function of the centroids of their corners (rows) returning one. Returns the mesh with the duplicated nodes and the interface elements of the opened faces (all of them: keep a subset for the cohesive ones, the others being free crack faces). sides: a label per element, the faces kept only between different labels (the two sides of a crack). A mesh of 10-node elements is opened by its corners; its mid-edge nodes are made again, each lip with its own, where they were (the curved edges of the interfaces of the phases stay curved), and the interface elements have six nodes a side.

morphogen.fracture.cohesive.plus(a, b)[source]

The sum of two sparse matrices with the stored entries of both, zeros included: the sum of SciPy drops the zeros, and with them the full blocks of the three dofs of each pair of nodes, on which the sparse factorization is several times faster.

class morphogen.fracture.cohesive.CohesiveResult(loads: ndarray, reactions: ndarray, cracked: ndarray, damage_max: ndarray, iterations: ndarray, history: ndarray, damage: ndarray, displacement: ndarray, fields: list = <factory>, time_s: float = 0.0, work: dict = <factory>, slip: ndarray | None = None, friction: ndarray | None = None)[source]

Bases: object

The steps of a cohesive problem: load factors, reactions (steps x prescribed sets x 3, summed over the nodes of each set), cracked area and largest damage, Newton iterations, the history of the interface points at the end (elements x 3, or x 6 for elements of six nodes a side) and their damage, the final displacement (nodes x 3), with fields the displacements of the steps, and the works at each step (work: "external", of the prescribed displacements and the forces; "bulk" and "interfaces", of their internal forces: the energy stored and dissipated by each, which add up to the external work; with a law that rubs, "friction": the part of the work of the interfaces that friction dissipated). slip: the frictional slip of the points at the end (elements x points x 2, in the frame of each point: the tangents of its mid-surface), and friction the energy that friction dissipated at each per unit area.

rows() → list[dict][source]

One row per step: load factor, the reactions of each prescribed set, the cracked area and the largest damage.

class morphogen.fracture.cohesive.CohesiveProblem(mesh: TetMesh, interfaces: Interfaces, materials, law, *, kinematics='small', bulk: str = 'auto')[source]

Bases: object

A body with interface elements (see the module): mesh (tetrahedra of 4 or 10 nodes, after insert_interfaces()), the cohesive interfaces (of three or six nodes a side, as the faces of the mesh), the materials of the phases, the cohesive law and the kinematics ("small" or "finite" strains).

bulk: "elastic", isotropic elasticity (Young’s modulus and Poisson’s ratio, which also give the neo-Hookean solid of finite strains); "points", the behaviours of morphoGen’s points (PointBulk: von Mises elasto-(visco)plasticity, crystal plasticity with the orientations of the grains, MFront laws, and Hencky’s elasticity in finite strains), with their internal variables committed at each converged step, on 4-node elements; "auto", the points when a phase is inelastic, or anisotropic in finite strains.

run(prescribed, load: float = 1.0, *, steps: int = 20, tol: float = 1e-06, max_newton: int = 25, max_cuts: int = 12, fields: bool = False, viscosity: float = 0.0, forces=None, duration: float | None = None, start: float = 0.0, initial=None, equilibrate: bool = True, history=None) → CohesiveResult[source]

Grow the prescribed displacements to load times their values in steps steps (divided when Newton’s method fails, max_cuts times in a row at most). prescribed: entries (nodes, components, value), the displacement of the components (an index or a list) of the nodes being load factor x value (0: fixed; an array of the nodes x components: one value each), or value(load factor) when value is a function: loadings in several stages, such as a pressure held while a shear grows. forces: nodal forces (3 x nodes, dead loads) grown with them, or a function of the load factor returning them. viscosity: the ζ of the viscous regularization (in units of the load factor; 0: none). The load factor is the time of the viscous behaviours of the bulk, or the loading lasts duration.

initial: a displacement (nodes x 3) at the load factor start, from which the loading resumes, the internal variables of the bulk as they are (those of an earlier run, or a state transferred from another mesh: morphogen.fracture.ductile. transfer_state()); equilibrate: first bring it to equilibrium at that load, over a vanishing time (no viscous flow), the plastic correction of the points included but dissipating nothing (the bulk keeps the dissipated part of its work density, its free energy that of the equilibrium; result.equilibration: the Newton iterations).

history: that of the interface points at the start (one value per element, or elements x points): a damage of 1 for the part of a bilinear interface that is already broken, a negative value for the bonded points of a Contact.

write(path, result: CohesiveResult, step: int = -1)[source]

The bulk (<path>.vtu: the displacement of step with fields, else the final one) and the interfaces (<path>_interfaces.vtu: wedges of six nodes with the damage of their points and its mean, and with a law that rubs the mean slip of their points and the energy that friction dissipated per unit area); returns both paths.

morphogen.fracture.cohesive.cohesive_zone_length(young: float, energy: float, strength: float, factor: float = 1.0) → float[source]

l_cz = M E G / T² (factor M: 1 after Hillerborg, 9π/32 after Rice for a bilinear law in mode I, 0.21 after Falk; Turon et al. 2007).

morphogen.fracture.cohesive.turon_strength(young: float, energy: float, element_size: float, elements: int = 3) → float[source]

The cohesive strength that keeps elements elements of size element_size in the cohesive zone (Turon, Dávila, Camanho & Costa 2007): sqrt(9π E G / (32 N_e l_e)).

morphogen.fracture.cohesive.dcb_beam_theory(young: float, poisson: float, width: float, arm: float, precrack: float, energy: float, opening)[source]

The corrected beam theory of the double cantilever beam (Williams 1989; Reeder et al.; Linke & Lammering 2023, eqs. 2 to 6): the load and the crack length against the opening opening of the loading line, for arms of thickness arm and width of an isotropic material, a precrack precrack and the mode I fracture energy: P = 3 E I d / (2 (a + χ h)³) with a = a0 until the crack grows, then a = (9 d² E I / (4 w G))^(1/4) - χ h; χ = sqrt(E / (11 S) (3 - 2 (Γ / (1 + Γ))²)), Γ = 1.18 E / S.

morphogen.fracture.cohesive.dcb_specimen(length: float, width: float, arm: float, precrack: float, size: float, order: int = 1)[source]

A double cantilever beam of two arms of thickness arm (length x width), meshed by six tetrahedra per voxel of edge size (of 4 nodes, or of 10 with order 2), opened along its mid-plane: the mesh, the interface elements of the bonded part (beyond the precrack) and the node sets of the loading lines ("top", "bottom": the nodes at x = 0 on the mid-plane of each arm).