morphogen.laser.mechanics

Tensile tests of laser-architectured sheets: finite elements of a membrane in plane stress, with large rotations and the flow law of each point.

The sheet is a membrane of quadrilaterals (bilinear, 2 x 2 Gauss points), each Gauss point split into the layers of the treatment through the thickness, each layer in plane stress with its own flow law (morphogen.laser.materials): a point treated on one face only is a stack of layers of different hardness that stretch together (bending is not modelled).

Kinematics (total Lagrangian displacements, corotational stresses). At each Gauss point the increment ΔF = F F_n⁻¹ of the in-plane deformation gradient splits into its rotation and stretch, ΔF = ΔR ΔU (polar decomposition); the strain increment is ln ΔU, the old Cauchy stress is updated in the frame of F_n then turned by ΔR (an incrementally objective scheme: exact for rigid rotations, the logarithmic strains of proportional paths). The thickness strain of each layer comes from its plane stress, h = h0 exp(Σ Δε33). The internal forces are ∫ Bᵀ τ h0 dA0 with the Kirchhoff stress τ = J σ (J = det F λ3) and the spatial gradients of the shape functions; the tangent, ∫ (Bᵀ J C B + Gᵀ τ G) h0 dA0, adds the geometric stiffness of the stresses (the large rotations of the corrugated reinforcements that unbend).

Plasticity of each layer: von Mises, isotropic hardening σ_y(p); the radial return of the trial stress in 3D with the thickness strain increment Δε33 found by Newton’s method so that σ33 = 0; the consistent tangent of the radial return (Simo & Hughes 1998), condensed on the in-plane components, C_ps = C_ab − C_a3 C_3b / C_33.

Tensile test (tensile_test()): the grips pull the ends of the specimen along x (displacement control, lateral displacements of the gripped ends held, or free for a strip with free ends); a virtual extensometer reads the elongation of the parallel part (the mean axial displacement of two cross-sections). Results: the engineering curve, the 0.2 % proof stress, the tensile strength and the uniform elongation at the maximum force (diffuse necking, Considère’s criterion of the specimen), the energy absorbed up to it, and the fields.

morphogen.laser.mechanics.ISOTROPIC = (0.5, 0.5, 0.5, 1.5, 0.0)

F, G, H, N (normalized by G + H = 1) and the angle of its rolling direction (radians).

Type:

The coefficients of Hill’s 1948 criterion of an isotropic point (von Mises)

morphogen.laser.mechanics.hill_from_r(r0: float, r45: float, r90: float, angle: float = 0.0) → tuple[source]

Hill’s 1948 coefficients (F, G, H, N) of a sheet of Lankford coefficients r0, r45, r90 (normalized by G + H = 1: the yield stress along the rolling direction), and the angle of its rolling direction from the axis of the specimen (degrees; radians in the tuple): the anisotropy of a point of a Membrane.

morphogen.laser.mechanics.yld2000_profile(alpha, a: float, angles=(0.0, 45.0, 90.0)) → dict[source]

The yield stresses (over that along the rolling direction) and the Lankford coefficients of Yld2000-2d (alpha, a) in uniaxial tension at angles (degrees), and in equibiaxial tension ("b"): {"stress": [...], "r": [...], "stress_b", "r_b"}.

morphogen.laser.mechanics.yld2000_from_data(s0: float, s45: float, s90: float, sb: float, r0: float, r45: float, r90: float, rb: float = 1.0, a: float = 6.0, angle: float = 0.0) → tuple[source]

Barlat’s Yld2000-2d coefficients α1 … α8 fitted exactly to the yield stresses s0, s45, s90 of uniaxial tension at 0°, 45°, 90° from the rolling direction, sb of equibiaxial tension, the Lankford coefficients r0, r45, r90 and the biaxial ratio rb (Barlat et al. 2003; the stresses in any unit, the equivalent stress being normalized to s0), with the exponent a (6 for cubic-centred metals, 8 for face-centred), and the angle of the rolling direction from the axis of the specimen (degrees): the anisotropy of a point of a Membrane (10 values).

morphogen.laser.mechanics.YLD_ISOTROPIC = (1.0, 1.0, 1.0, 1.0, 1.0, 1.0, 1.0, 1.0, 2.0, 0.0)

α1 … α8 = 1, the exponent 2 (von Mises), the angle of the rolling direction (radians).

Type:

The isotropic point of Barlat’s Yld2000-2d criterion

class morphogen.laser.mechanics.Fracture(centroids, w0, critical, radius: float | None = None)[source]

Bases: object

The fracture of the brittle points of a membrane (finite critical plastic strains, (e, 4, layers)): local, a point breaks at its critical strain; or nonlocal over a radius (mm), the plastic strain of the brittle points of each element averaged with that of its neighbours of the same critical strain (the same phase) within the radius (weights radius − d between centres times their brittle volume; Pijaudier-Cabot & Bažant 1987), against the critical strain of the element (the least of its points): the crack crosses a region of the size of a track, not a point of its edge.

element_strain(plastic) → ndarray[source]

The mean plastic strain of the brittle points of each element ((..., e, 4, layers) to (..., e)).

ratios(plastic, alive=None) → ndarray[source]

The ratio of the (averaged) plastic strain to the critical one of each element, (..., e) from the plastic strains (..., e, 4, layers); only the alive elements (all by default) are averaged and have a ratio (the broken ones of a growing crack, Membrane, none).

class morphogen.laser.mechanics.TensileResult(strain: ndarray, stress: ndarray, force: ndarray, displacement: ndarray, yield_strength: float, tensile_strength: float, uniform_elongation: float, energy: float, necked: bool, steps: int, iterations: int, time_s: float, fields: dict = <factory>, failure_strain: float = nan, history: list = <factory>, width_strain: ndarray | None = None, thickness_strain: ndarray | None = None)[source]

Bases: object

A tensile test: the engineering strain (extensometer) and stress (force over the initial section of the parallel part), the force (N) and grip displacement (mm) at each converged step, their measures and the final fields.

r_value(strain: float | None = None) → float[source]

Lankford’s coefficient of the gauge, the true width strain over the true thickness strain (their means over the extensometer) at an engineering strain (default: 10 %, or 0.8 of the uniform elongation if smaller).

property ductility: float

the uniform elongation, or the strain at which a point reaches its critical plastic strain if earlier.

Type:

The strain at which the specimen fails

work(strain: float | None = None) → float[source]

The work absorbed per unit volume of the parallel part (MJ/m³) up to an engineering strain (the last one reached by default; the failure strain if earlier): the area under the engineering curve.

summary() → dict[source]

The measures as a mapping (MPa, engineering strain, MJ/m³).

morphogen.laser.mechanics.curve_measures(strain, stress, *, young: float | None = None, offset: float = 0.002)[source]

Measures of an engineering curve: the offset proof stress (the line of slope young, default the initial slope, shifted by the offset), the maximum (parabola through the three points around it) and its strain, and the energy absorbed up to it (MJ/m³ = MPa); necked: the curve fell after its maximum.

class morphogen.laser.mechanics.Membrane(mesh: QuadMesh, flow, *, young=210000.0, poisson: float = 0.3, thickness: float = 1.0, critical=None, fracture_radius: float | None = None, springs=None, anisotropy=None)[source]

Bases: object

The finite element problem of a specimen: its mesh, the flow laws of its Gauss points and layers (kind, σ0, a, b), each (elements, 4, layers) — or two laws and the weight w of the second, (kind1, σ01, a1, b1, kind2, σ02, a2, b2, w), the flow stress of a point then (1 − w) σ_1(p) + w σ_2(p) (the phases of an ideal design, the densities of a topology optimization) —, elasticity (MPa; Young’s modulus one value or one per point and layer, (elements, 4, layers): phases of different stiffness), thickness (mm) and the critical plastic strains of the points (critical: the fracture of a brittle phase; infinite by default), local or averaged over fracture_radius (Fracture); springs: linear bars (i, j, k, e) between nodes (stiffness k N/mm along the unit vector e: the pins of a specimen, which turn freely about them); anisotropy: Hill’s 1948 coefficients and the angle of the rolling direction of the points (..., 5) (hill_from_r(); ISOTROPIC by default: von Mises), or Barlat’s Yld2000-2d coefficients, its exponent and the angle (..., 10) (yld2000_from_data()).

moduli

their mean over the area (the modulus of the sheet along stiff and soft bands, the scale of the forces)

Type:

Young’s modulus of each point and layer; young

residual = 1e-06

The stiffness left to a broken element, a share of its elastic one.

reset() → None[source]
evaluate(u)[source]

Internal forces, tangent matrix and the trial states at displacements u.

commit(u, trial) → None[source]
elastic_stiffness() → ndarray[source]

The small-strain elastic stiffness of each element in its initial shape ((e, 8, 8), plane stress over the thickness; computed once).

class morphogen.laser.mechanics.Replay(strain: ndarray, displacement: ndarray, work: ndarray, plastic: ndarray, ratio: ndarray)[source]

Bases: object

The replay of the history of a tensile test with other flow laws: at each recorded step, the extensometer strain, the grip displacement (mm), the stress work of each element (steps x elements, mJ), the plastic strains of the points (steps x elements x 4 x layers) and the ratio of each element to fracture (Fracture).

morphogen.laser.mechanics.replay(membrane: Membrane, history, law=None, critical=None, anisotropy=None) → Replay[source]

Replay the deformation gradients of the Gauss points recorded by tensile_test() (record_history) with the flow laws law (the membrane’s by default; an array (elements, 4, layers, 9) like Membrane.law) and the critical plastic strains (the fracture of the membrane, its radius): the work and the fracture each element would have seen had it followed the same path with another material (the kinematics held, the first-order effect of a change of material: the sensitivities of morphogen.laser.cells).

morphogen.laser.mechanics.tensile_test(specimen: Specimen, membrane: Membrane, *, max_strain: float = 0.3, step: float = 0.002, max_step: float = 0.01, drop: float = 0.02, beyond: float = 0.02, tol: float = 1e-05, max_iterations: int = 20, max_steps: int = 600, callback=None, keep_fields: bool = True, failure_margin: float | None = None, record_history: bool = False) → TensileResult[source]

Pull the specimen (see the module): steps of grip displacement of step times the parallel length at first, grown up to max_step while Newton’s method converges in few iterations (shrunk when it needs many, halved when it fails), back to step after the maximum force; until the extensometer reads max_strain, or the force has fallen by drop after its maximum, or the strain exceeds that of the maximum by beyond (the neck has formed: the measures are taken). A point whose plastic strain reaches its critical one (Membrane.critical: a brittle phase) sets the failure_strain of the specimen (interpolated between the steps); the test stops failure_margin beyond it if given; record_history keeps the deformation gradients of the Gauss points at every step (the replays of replay()).