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:
objectA crack with a straight front along
axis, whose path in the planes normal to the front is the polyline ofpoints(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 segmenteisaxis × 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).
- frame(x)[source]¶
As
frame(): the distancerto the front, the axesn,d,tof the last segment and the coordinatesalong 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
daatangle(radians) from its last segment towards its normal (a new segment, or the last one longer ifangleis 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 labelmesh.sideon 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
phaseof 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 thelips, anInterfacesof 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:
objectA solved cracked body: its opened
mesh, the lipsfaces(pairs of faces), thecrack, thematerialsof the phases, the kinematics, the finaldisplacement(nodes x 3), thestepsof the solver, the final nodalforces, the stiffness of thecontactof the lips and thebulkof points with its final state (inelastic bodies;PointBulk).- stresses(energy: str = 'work')[source]¶
The displacement gradient
H, the first Piola-Kirchhoff stressP(Cauchy in small strains) and the energy densityWof each element, its volume and the gradients of its shape functions:Wthe 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).
- 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)atstationspoints along it (the coordinates: a length, an angle on a penny; at least two elements apart);qfrom 1 withinr_in(by default one element) to 0 beyondr_out(four), within the reach of the lips.energyof 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 beyondr_inat 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
Gby 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 thestationsalong the front ("s"). On a crack mesh of a morphology, the domain is the material at the front (that ofrelease_rate()withenergy="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):
materialsa material (all the phases) or a dict of the phases;prescribedthe entries(nodes, components, value)ofrun(), or a function of the opened mesh returning them, andforcesnodal forces (3 x nodes, or a function of the opened mesh), both grown toloadtimes their values insteps(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) andfrictiontheir coefficient of friction (Coulomb: lips in contact stick or slide; see the module);bulk: that ofCohesiveProblem(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 bytransfer(transfer_state()), brought to equilibrium (equilibrate) at the loadstart(by default the last ofinitial), and the loading resumes from there up toload.
- 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 theCrackSolutionof 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:
objectThe steps of a propagation: the cracks, their energy release rates, stress intensity factors (steps x 3), angles of their advances and cycles (Paris), with
keepthe 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: theAdvancechosen; that of the last crack is not taken).
- 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) andloadload it; each of thestepsadvances the front byincrementin the direction of kinking;paris = (C, m)counts the cycles;optionsthose ofsolve_crack().toughness: aToughness(or one value, or a dict of the phases): each advance is then the candidate of the largestG(θ) / Γ(θ), the kink of the bulk or along an interface within an increment ahead (advance_candidates()), and the critical load factor of each crack isload sqrt(Γ / G)of its advance (Ggrowing 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
kwhose 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
incrementuntil most of thecountpoints of its front, and most of the points a quarter ofincrementbehind 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 ofincrementbeyond it.