morphogen.homogenization.fatigue

Multiaxial high-cycle fatigue: criteria on the stress histories of a cycle.

In the high-cycle regime a material stays elastic at the scale of the cell, and whether a point lasts is read from the cycle of its stress: an amplitude of shear, which initiates the cracks, and a normal or hydrostatic stress, which opens them. The criteria below judge the stresses of the points of a cell along a cycle of a loading path (its fields at each step: path_fatigue()), or any history of stresses (steps x ... x 6, Voigt components 11, 22, 33, 23, 31, 12).

The amplitude of a multiaxial cycle. The deviator of the stress describes a closed path in the five-dimensional space of deviators, with the norm sqrt(J2) = sqrt(s : s / 2). Its amplitude is the radius of the smallest hypersphere that holds the path, and its mean the centre of that hypersphere (Papadopoulos et al. 1997; the longest chord, which does not see the phase of the components, is not used): half the range of a proportional cycle, the larger of σ_a / sqrt(3) and τ_a for a tension and a torsion a quarter of a cycle apart. The hypersphere is found by Frank and Wolfe’s iteration with away steps on the dual problem (Yıldırım 2008), from the two points farthest apart: at once for a proportional cycle.

Criteria (f: the fatigue limit in fully reversed tension or bending, t: in fully reversed torsion, f0: in repeated tension, the largest stress of a cycle from zero; each criterion gives an equivalent stress, to be compared with its limit):

  • Crossland (1956): sqrt(J2)_a + α σ_H,max <= β, σ_H the hydrostatic stress; α = 3 t / f - sqrt(3), β = t.

  • Sines (1959): sqrt(J2)_a + α σ_H,mean <= β; α = 6 t / f0 - sqrt(3), β = t.

  • DangVan (1973; Dang Van, Griveau & Message 1989): at each instant, Tresca’s shear of the deviator less its mean (the stress of a grain that has shaken down in its elastic matrix) and the hydrostatic stress, max_t [τ(t) + α σ_H(t)] <= β; α = 3 t / f - 3 / 2, β = t.

  • Findley (1959), a critical plane: max_n [τ_a(n) + k σ_n,max(n)] <= λ over the planes of normal n, τ_a the amplitude of the shear vector of the plane (the radius of the smallest circle that holds its path) and σ_n,max its largest normal stress; with r = f / t, k = (2 - r) / (2 sqrt(r - 1)) and λ = t sqrt(1 + k²).

  • Matake (1977): τ_a + k σ_n,max <= λ on the plane of the largest shear amplitude; k = 2 t / f - 1, λ = t.

The planes are searched on a spiral of normals over a hemisphere, then around the best of them by grids three times finer at each of four levels.

morphogen.homogenization.fatigue.CRITERIA = ('crossland', 'sines', 'dang_van', 'findley', 'matake')

The criteria by their names in configurations

morphogen.homogenization.fatigue.PLANES = 400

Normals of the first search of a critical plane (a spiral over a hemisphere)

morphogen.homogenization.fatigue.hydrostatic(history) → ndarray[source]

The hydrostatic stress tr σ / 3 of the stresses of a history (steps x …).

morphogen.homogenization.fatigue.stress_amplitude(history, tol: float = 1e-10) → tuple[ndarray, ndarray][source]

The amplitude and the mean of the deviator of a cycle of stresses (history: steps x … x 6): sqrt(J2)_a, the radius of the smallest hypersphere that holds the path of the deviator (norm sqrt(s : s / 2); to the relative accuracy tol), and its centre, the mean deviator (… x 6).

class morphogen.homogenization.fatigue.Crossland(alpha: float, beta: float)[source]

Bases: object

Crossland’s criterion (see the module): sqrt(J2)_a + alpha σ_H,max <= beta.

classmethod from_limits(bending: float, torsion: float) → Crossland[source]

From the fatigue limits in fully reversed bending (or tension) and torsion.

property limit: float
equivalent(history) → ndarray[source]

The equivalent stress of each point, to be compared with limit.

class morphogen.homogenization.fatigue.Sines(alpha: float, beta: float)[source]

Bases: object

Sines’ criterion (see the module): sqrt(J2)_a + alpha σ_H,mean <= beta, the mean of the hydrostatic stress being that of its extremes over the cycle.

classmethod from_limits(torsion: float, repeated: float) → Sines[source]

From the fatigue limits in fully reversed torsion and in repeated tension (the largest stress of a cycle from zero).

property limit: float
equivalent(history) → ndarray[source]
class morphogen.homogenization.fatigue.DangVan(alpha: float, beta: float)[source]

Bases: object

Dang Van’s criterion (see the module): max_t [τ(t) + alpha σ_H(t)] <= beta.

classmethod from_limits(bending: float, torsion: float) → DangVan[source]

From the fatigue limits in fully reversed bending (or tension) and torsion.

property limit: float
equivalent(history) → ndarray[source]
class morphogen.homogenization.fatigue.Findley(k: float, limit: float, planes: int = 400)[source]

Bases: _CriticalPlane

Findley’s criterion (see the module): max_n [τ_a(n) + k σ_n,max(n)] <= limit; planes: the normals of the first search.

classmethod from_limits(bending: float, torsion: float, planes: int = 400) → Findley[source]

From the fatigue limits in fully reversed bending (or tension) and torsion.

class morphogen.homogenization.fatigue.Matake(k: float, limit: float, planes: int = 400)[source]

Bases: _CriticalPlane

Matake’s criterion (see the module): τ_a + k σ_n,max <= limit on the plane of the largest shear amplitude; planes: the normals of the first search.

classmethod from_limits(bending: float, torsion: float, planes: int = 400) → Matake[source]

From the fatigue limits in fully reversed bending (or tension) and torsion.

morphogen.homogenization.fatigue.criterion_from_config(spec)[source]

A criterion from a mapping: its criterion (one of CRITERIA) and either its fatigue limits (bending and torsion; torsion and repeated for Sines) or its coefficients (alpha and beta; k and limit for the critical planes, with their planes).

class morphogen.homogenization.fatigue.FatigueResult(equivalent: ndarray, utilization: ndarray, amplitude: ndarray, hydrostatic_max: ndarray, hydrostatic_mean: ndarray, times: ndarray, weights: ndarray | None = None, support: object | None = None)[source]

Bases: object

The fatigue of the points of a cell along a cycle: the equivalent stress of the criterion of each point and its utilization, the equivalent stress over the limit (1: at the fatigue limit; NaN where no criterion applies), the amplitude sqrt(J2)_a of the deviator, the largest and the mean hydrostatic stress (hydrostatic_max, hydrostatic_mean), the times of the cycle, the weights of the points (volumes, when their support gives them) and their support (mesh or image).

property largest: float

The largest utilization of the cell (NaN when no point is judged).

property safety: float

The factor by which the stresses of the cycle may be multiplied before a point reaches its limit, for a loading that grows in proportion: the inverse of the largest utilization.

fraction(level: float = 1.0) → float[source]

The share (of the volume, with weights; of the points otherwise) of the points judged whose utilization is above level.

fields() → dict[source]

The fields of the points, by name (for the writers of fields).

components() → dict[source]

The scalar results: the largest utilization, the safety factor and the share of the points beyond their limit.

morphogen.homogenization.fatigue.fatigue(history, criterion, *, phases=None, weights=None, times=None, support=None)[source]

The fatigue of points along a cycle of stresses (history: steps x … x 6): a FatigueResult. criterion: one criterion for all the points, or a mapping of the phases to their criteria (or to mappings of them: criterion_from_config()), with phases the phase of each point; the points of the other phases are not judged.

morphogen.homogenization.fatigue.path_fatigue(result, criterion, *, cycle=None) → FatigueResult[source]

The fatigue of the points of a cell along a cycle of a loading path: result, a PathResult that kept its fields at the steps of the cycle (fields="steps"); criterion: as for fatigue(), the phases being those of the support of the fields; cycle: the times of its start and of its end (by default the whole path). The stresses are those of the fields (Cauchy’s in finite strains).