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 stiffnessK, the onset tractionsN(normal) andS(shear), the fracture energiesG_IcandG_IIcand the exponentηof the mixed-mode criterion of Benzeggagh & Kenane. The equivalent separationλ = sqrt(<δ_n>² + |δ_s|²)and the mode mixityB = |δ_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 damaged = λ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 isG_Ic + (G_IIc - G_Ic) B^η.Exponential(Ortiz & Pandolfi 1999): the effective openingδ = sqrt(<δ_n>² + β² |δ_s|²)and the effective tractione σ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 penaltyK_cin 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:
objectThe bilinear mixed-mode law (see the module):
stiffnessK (penalty),normal_strengthN,shear_strengthS, the fracture energiesmode_Iandmode_II(G_Ic, G_IIc) and the exponentetaof Benzeggagh & Kenane.
- class morphogen.fracture.cohesive.Exponential(strength: float, energy: float, beta: float = 1.0, penalty: float | None = None, friction: float = 0.0)[source]¶
Bases:
objectThe irreversible exponential law of Ortiz & Pandolfi (see the module): the cohesive
strengthσc, the fractureenergyG_c, the shear-to-normal ratiobeta, thepenaltystiffness in compression (by default10 e σc / δc), which is also that of the stick of the broken share, and the coefficient offrictionof that share.- property critical_opening: float¶
δc = G_c / (e σc).
- class morphogen.fracture.cohesive.Contact(stiffness: float, friction: float = 0.0, tangential: float | None = None)[source]¶
Bases:
objectContact of the lips of a crack: a penalty
stiffnessagainst their interpenetration (t_n = K min(δ_n, 0)), no normal traction otherwise; with a coefficient offriction, lips in contact stick (thetangentialstiffness 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()).
- 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. Withslip(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 ofdisplacement(nodes x 3) from the history and the frictional slip ofresult(aCohesiveResult; none: new points).
- class morphogen.fracture.cohesive.Interfaces(minus: ndarray, plus: ndarray, phases: ndarray)[source]¶
Bases:
objectInterface elements: the nodes of their side
minusand of their sideplus(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).
- 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):
facesis"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:
objectThe 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
fieldsthe 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), andfrictionthe energy that friction dissipated at each per unit area.
- class morphogen.fracture.cohesive.CohesiveProblem(mesh: TetMesh, interfaces: Interfaces, materials, law, *, kinematics='small', bulk: str = 'auto')[source]¶
Bases:
objectA body with interface elements (see the module):
mesh(tetrahedra of 4 or 10 nodes, afterinsert_interfaces()), the cohesiveinterfaces(of three or six nodes a side, as the faces of the mesh), thematerialsof the phases, the cohesivelawand thekinematics("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
loadtimes their values instepssteps (divided when Newton’s method fails,max_cutstimes in a row at most).prescribed: entries(nodes, components, value), the displacement of the components (an index or a list) of the nodes beingload factor x value(0: fixed; an array of the nodes x components: one value each), orvalue(load factor)whenvalueis 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 lastsduration.initial: a displacement (nodes x 3) at the load factorstart, 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 aContact.
- write(path, result: CohesiveResult, step: int = -1)[source]¶
The bulk (
<path>.vtu: the displacement ofstepwithfields, 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²(factorM: 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
elementselements of sizeelement_sizein 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
openingof the loading line, for arms of thicknessarmandwidthof an isotropic material, a precrackprecrackand the mode I fracture energy:P = 3 E I d / (2 (a + χ h)³)witha = a0until the crack grows, thena = (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(lengthxwidth), meshed by six tetrahedra per voxel of edgesize(of 4 nodes, or of 10 withorder2), 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 atx = 0on the mid-plane of each arm).