morphogen.fracture.surface

Cracks of any surface and front in 3D: the surface swept by the successive positions of a front, which advances by its own amount and kinks by its own angle at each of its points.

The planar cracks of morphogen.fracture.lefm have a straight or circular front that advances uniformly, and the kinked cracks of morphogen.fracture.mixed a path in a plane, the same all along a straight front. A SurfaceCrack is a grid of points, rows x stations: each row a position of the front, from the centre of the crack (a closed front: a crack inside the body, such as an ellipse) or from its mouth (an open front, which leaves the body by its two ends: a through, edge or surface crack) to the front, the last row; each station follows its own path across the rows. Between the rows the surface is that of the triangles of the grid.

Front. At each station the tangent τ of the front (along the stations), the direction of propagation d (that of the last move of the station, made normal to τ) and the normal n = d × τ of the surface: the axes (d, n, t = d × n) of the asymptotic fields. They are interpolated along the front, whose curvature the auxiliary fields of the interaction integrals then see (Gosz & Moran 2002). A point has the coordinates x1 = (x - f) · d and x2 = (x - f) · n from its nearest point f of the front: ψ = x1 (negative behind the front), and φ the signed distance to the triangles behind the front and x2 ahead of it, the surface continued along d: the two level sets that the conforming meshes and the opening of the lips take (crack_mesh(), crack_faces()). An open front is continued beyond its ends, and its surface behind its mouth.

Growth (SurfaceCrack.grown()): a new row, each station moved by its advance at its angle from d towards n. propagate_front() solves the body on a mesh rebuilt for each crack, takes the energy release rate and the stress intensity factors at stations along the front (modes()), and moves each point of the front in the direction of the largest hoop stress of its own K_I and K_II (Erdogan & Sih 1963), by an advance that grows with its own energy release rate, da = Δa (G / G_max)^(m / 2) (Paris’ law da/dN = C ΔK^m for the cycles that advance the fastest point by Δa): an elliptical crack in tension grows towards a circle, a crack inclined to the load turns its surface towards the plane normal to it, by a different angle at each point of its front.

morphogen.fracture.surface.FAR = 1000.0

How far the surface of an open crack is continued beyond the ends of its front and behind its mouth, in units of its size

class morphogen.fracture.surface.SurfaceCrack(points, closed: bool = True)[source]

Bases: object

A crack of any surface (see the module): points (rows x stations x 3), the successive positions of its front from its centre (closed: the stations go round a front inside the body; the first row may be one point repeated) or from its mouth (an open front, whose first and last stations lie outside the body or on its boundary); the front is the last row. With the normal n of the surface towards the reader, the stations of a closed front go anticlockwise.

classmethod ellipse(centre, normal, a: float, b: float | None = None, *, major=None, stations: int = 48, rows: int = 4) → SurfaceCrack[source]

A planar elliptical crack of semi-axes a (along major, by default the axis of the frame least aligned with the normal, made normal to it) and b (by default a: a penny), its plane through centre normal to normal: rows from its centre to its front.

classmethod of(crack, lower=None, upper=None, *, stations: int = 48, rows: int = 4)[source]

The surface crack of a planar Crack (a penny: a closed front) or of a straight one or a KinkedCrack in the box [lower, upper] (an open front, continued beyond the box).

property stations: int
property s: ndarray

an angle from -π for a closed front (the length along it over its whole length), a length for an open one.

Type:

The coordinate of the stations along the front

property length: float

The length of the front.

property size: float

the mean distance of the front to its centre (a closed front), or the mean length of the paths of its stations.

Type:

The size of the crack

property reach: float

How far behind the front the surface stays in the plane of the axes d and t of the front, at the station where it does least: the domain of a virtual advance tangent to the lips (the size of a planar crack, the last advance of a kinked one).

area() → float[source]

The area of the surface (without its continuations).

local(x)[source]

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

psi(x) → ndarray[source]

Distance beyond the front along its direction of propagation (negative behind it).

phi(x) → ndarray[source]

Signed distance to the surface behind the front; ahead of it, to the surface continued along the direction of propagation.

frame(x)[source]

As frame(): the distance r to the front, the axes n, d, t of its nearest point and the coordinate s along it.

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

Points of the front inside the box [lower, upper] and the length of front that each represents.

grown(da, angle=0.0) → SurfaceCrack[source]

The crack whose stations have advanced by da at angle (radians) from their direction of propagation towards the normal of the surface (numbers, or one value per station): a new row. A negative da, the same at all the stations and shorter than the last row, moves the front back along it.

class morphogen.fracture.surface.FrontGrowth(cracks: list, s: ndarray, rates: ndarray, factors: ndarray, angles: ndarray, advances: ndarray, cycles: ndarray, solutions: list = <factory>)[source]

Bases: object

The steps of the growth of a SurfaceCrack: the cracks, the coordinates s of the stations of the interaction integrals along the front and, at them (steps x stations), the energy release rates, the stress intensity factors (a last axis: the three modes) and the angles of kinking; the largest advance of each step and the cycles (Paris), with keep the solutions.

rows() → list[dict][source]

A row per step: the size and the area of the crack, the extremes of the energy release rate and of the factors along its front, the largest angle of kinking.

morphogen.fracture.surface.at_stations(crack: SurfaceCrack, s, values, harmonics: int | None = None) → ndarray[source]

Values given at the coordinates s along the front (increasing), at the stations of the crack: interpolated linearly, or, around a closed front whose s are evenly spaced, by their Fourier series up to harmonics (a smooth distribution, less the noise of the values from station to station).

morphogen.fracture.surface.propagate_front(mesh_of, crack: SurfaceCrack, materials, prescribed, load: float = 1.0, *, increment: float, steps: int, stations: int = 12, exponent: float = 2.0, harmonics: int | None = None, paris: tuple[float, float] | None = None, kinematics: str = 'small', contact: float | bool | None = None, domain: dict | None = None, keep: bool = False, **options) → FrontGrowth[source]

Grow a crack of any surface, each point of its front by its own advance and at its own angle (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 (options: those of solve_crack()). At each of the steps the energy release rate and the factors are taken at stations along the front (at least two elements apart), and the point where G is largest advances by increment, the others by increment (G / G_max)^(exponent / 2) (exponent: that of Paris’ law; with paris = (C, m) it is m, and the cycles are counted), each in the direction of the largest hoop stress of its K_I and K_II; G is that of the factors, (K_I² + K_II²) / E' + K_III² / 2μ. domain: the radii r_in and r_out of the domain of the interaction integrals (by default one and four elements, within the last advance). Around a closed front the advances and the angles are those of the Fourier series of their values at the stations up to harmonics (by default a third of the stations): a front that stays smooth, where the noise of the factors, raised to the power of Paris’ law, would scallop it.