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:
objectA 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 normalnof 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(alongmajor, by default the axis of the frame least aligned with the normal, made normal to it) andb(by defaulta: a penny), its plane throughcentrenormal tonormal: 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 aKinkedCrackin 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
dandtof 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).
- 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 distancerto the front, the axesn,d,tof its nearest point and the coordinatesalong 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
daatangle(radians) from their direction of propagation towards the normal of the surface (numbers, or one value per station): a new row. A negativeda, 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:
objectThe steps of the growth of a
SurfaceCrack: thecracks, the coordinatessof the stations of the interaction integrals along the front and, at them (steps x stations), the energy releaserates, the stress intensityfactors(a last axis: the three modes) and theanglesof kinking; the largest advance of each step and thecycles(Paris), withkeepthe solutions.
- morphogen.fracture.surface.at_stations(crack: SurfaceCrack, s, values, harmonics: int | None = None) ndarray[source]¶
Values given at the coordinates
salong the front (increasing), at the stations of the crack: interpolated linearly, or, around a closed front whosesare evenly spaced, by their Fourier series up toharmonics(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) andloadload it (options: those ofsolve_crack()). At each of thestepsthe energy release rate and the factors are taken atstationsalong the front (at least two elements apart), and the point whereGis largest advances byincrement, the others byincrement (G / G_max)^(exponent / 2)(exponent: that of Paris’ law; withparis = (C, m)it ism, and the cycles are counted), each in the direction of the largest hoop stress of itsK_IandK_II;Gis that of the factors,(K_I² + K_II²) / E' + K_III² / 2μ.domain: the radiir_inandr_outof 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 toharmonics(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.