morphogen.fracture.toughness

The toughness of the phases of a morphology and of the interfaces between them, and the direction of each advance of a crack through them: the kink of the bulk against the deflection along an interface ahead of the front (He & Hutchinson 1989), which turns cracks along the weak interfaces of architectured materials (the brick-and-mortar of nacre, the plies of Bouligand structures) and holds them back at tough phases.

Toughness (Toughness): a critical energy release rate Γ (in the units of G) for each phase, that of its material, and for the interfaces between two phases (a value per pair, or one for all; none: no interface criterion).

Kinked factors (Cotterell & Rice 1980): a kink of infinitesimal length at the angle θ (from the direction of propagation towards the normal of the crack) has to first order the factors k_I(θ) = cos³(θ/2) K_I - 3 sin(θ/2) cos²(θ/2) K_II and k_II(θ) = sin(θ/2) cos²(θ/2) K_I + cos(θ/2) (1 - 3 sin²(θ/2)) K_II, the hoop and shear stresses of the asymptotic field on the ray θ (kinked_factors()), and the energy release rate G(θ) = (k_I² + k_II²) / E' + K_III² / 2μ (kinked_release_rate(); a kink whose k_I would be negative is closed, its mode I releasing nothing; the tearing mode is kept). k_II vanishes in the direction of the largest hoop stress (Erdogan & Sih), where k_I is largest. A crack normal to an interface in pure mode I has G(±90°) = G(0) / 4.

Candidates (advance_candidates()), in the plane of growth through the middle of the front (straight fronts of KinkedCrack):

  • the bulk: the kink of the largest hoop stress (straight ahead with kink=False), by one increment; its toughness is that of the toughest solid phase met along it, the phase at the front or a tougher one that the advance enters;

  • the interfaces (interface_paths()), when the toughness has interfaces: where the front lies on an interface (two of its phases within a quarter of an element of the front, ahead of it) or meets one straight ahead within an increment, the chords of one increment from that point along the interfaces running from it (to the transitions of the phases on the circle of one increment around it, the phases on the two sides of the chord those of the interface along it), in the senses within 90° of the direction of the crack: the crack goes on to the interface and turns along it, and follows a curved interface by chords. A chord along which the pair of phases changes, at a junction of interfaces (a head joint meeting the interface between two layers of a brick-and-mortar), stops there, or, within half an increment, the branches of the junction are the advances. Their toughness is that of the interface.

The phases at points are those of the morphology of the toughness (exact for a morphology of point queries), or those of the elements of the crack mesh containing them (the interfaces of conforming meshes, or the staircases of the others). The bulk takes the driving force of the crack (G of the G-θ method, J_tip of an inelastic bulk), the interfaces that driving force in the proportion of their first-order G(θ) to that of the kink of the bulk, so that the choice between them is that of the first-order kinked factors and the bulk alone is the growth without interfaces. The advance is the candidate of the largest ratio G(θ) / Γ(θ) (choose_advance(); the bulk on a tie): an elastic body grows at the load factor sqrt(Γ / G) of that candidate, an inelastic one once its ratio reaches 1 (the driving force at the tip against the toughness of the phase at the front, unless an interface ahead or a tougher phase within the increment rules the advance).

Deflection or penetration (He & Hutchinson 1989): a crack normal to the interface of two identical materials deflects into it, at ±90°, when Γ_interface / Γ_bulk is below G(90°) / G(0) = 1/4 (0.26 for the kinks of He & Hutchinson, α = β = 0), and goes through it above. Once along an interface the crack follows it while that stays the most favourable: along an interface parallel to the remote tension, in pure mode II, rather than kink back into the bulk while Γ_interface / Γ_bulk < G(0) / G(-70.5°) = 3/4.

class morphogen.fracture.toughness.Toughness(phases: Any = 1.0, interfaces: Any = None, default: float | None = None, morphology: Any = None)[source]

Bases: object

The toughness of the phases and of their interfaces (see the module): phases one value for every phase or a dict of the phases (default: that of the phases not in it); interfaces None (no interface criterion), one value for every interface between two solid phases, or a dict of pairs of phases (in either order; the pairs not in it: no criterion); morphology: the phases at points whose interfaces the advances follow (a function of points, or a microstructure: phases_at(); by default the phases of the elements of the crack meshes of a morphology).

classmethod of(value) → Toughness | None[source]

A toughness from None, a Toughness, one value for all the phases or a dict of the phases.

property uniform: bool

the toughness of a homogeneous body, the growth without interfaces.

Type:

Whether it is one value for all the phases without interfaces

property value: float

The toughness of a uniform toughness (uniform).

of_phase(phase: int) → float[source]

The toughness of a phase.

of_interface(a: int, b: int) → float | None[source]

The toughness of the interface between two phases (None: no criterion).

phases_at(points) → ndarray[source]

The phases of the morphology at points (rows): its point queries, or a voxel image of it made once (phases_at()).

morphogen.fracture.toughness.kinked_factors(k1, k2, angle)[source]

The stress intensity factors (k_I, k_II) of a kink of infinitesimal length at angle (radians, from the direction of propagation towards the normal of the crack) from a front of factors k1, k2 (Cotterell & Rice 1980, to first order).

morphogen.fracture.toughness.kinked_release_rate(k1, k2, k3, angle, e_prime: float, mu: float)[source]

The energy release rate G(θ) = (k_I² + k_II²) / E' + K_III² / 2μ of the kink at angle (kinked_factors(); a negative k_I, a closed kink, counts nothing).

class morphogen.fracture.toughness.Advance(kind: str, angle: float, crack: Any, release_rate: float, toughness: float, met: Any)[source]

Bases: object

A candidate advance of a crack (see the module): kind "bulk" or "interface", the angle of its last segment from the last segment of the crack (radians, towards its normal), the crack after it, the energy release rate G(θ) of its direction (release_rate), the toughness Γ(θ) it meets and what it meets (met: the phase whose toughness it is, or the pair of phases of the interface).

property ratio: float

the advance happens once it reaches 1.

Type:

G(θ) / Γ(θ)

property label: str

a phase, or the interface p/q.

Type:

What the advance meets

morphogen.fracture.toughness.interface_paths(solution, toughness, increment: float) → list[source]

The advances of the crack of a solved body along the interfaces within an increment ahead of its front (see the module): (angle, crack, pair) for each, the angle of its last segment from the last segment of the crack, the crack after it and the pair of phases of the interface (none without interfaces in the toughness).

morphogen.fracture.toughness.advance_candidates(solution, toughness, increment: float, *, modes=None, driving=None, kink: bool = True, paths=None) → list[Advance][source]

The candidate advances of the crack of a solved body by increment (see the module): the bulk, and along the interfaces ahead (paths: those of interface_paths(), computed by default). modes: those of modes() (computed by default); driving: the driving force of the bulk (by default G of the modes; J_tip of an inelastic bulk); kink: the bulk in the direction of the largest hoop stress, else straight.

morphogen.fracture.toughness.choose_advance(candidates) → Advance[source]

The candidate of the largest ratio G(θ) / Γ(θ) (the first, the bulk, on a tie).