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 coefficientsr0,r45,r90(normalized byG + 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 aMembrane.
- 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 atangles(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,s90of uniaxial tension at 0°, 45°, 90° from the rolling direction,sbof equibiaxial tension, the Lankford coefficientsr0,r45,r90and the biaxial ratiorb(Barlat et al. 2003; the stresses in any unit, the equivalent stress being normalized tos0), with the exponenta(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 aMembrane(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:
objectThe fracture of the brittle points of a membrane (finite
criticalplastic strains,(e, 4, layers)):local, a point breaks at its critical strain; or nonlocal over aradius(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 (weightsradius − dbetween 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 thealiveelements (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:
objectA tensile test: the engineering
strain(extensometer) andstress(force over the initial section of the parallel part), theforce(N) and gripdisplacement(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
- morphogen.laser.mechanics.curve_measures(strain, stress, *, young: float | None = None, offset: float = 0.002)[source]¶
Measures of an engineering curve: the
offsetproof stress (the line of slopeyoung, 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:
objectThe 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 weightwof 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 overfracture_radius(Fracture);springs: linear bars(i, j, k, e)between nodes (stiffnesskN/mm along the unit vectore: 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();ISOTROPICby 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.
- class morphogen.laser.mechanics.Replay(strain: ndarray, displacement: ndarray, work: ndarray, plastic: ndarray, ratio: ndarray)[source]¶
Bases:
objectThe replay of the history of a tensile test with other flow laws: at each recorded step, the extensometer
strain, the gripdisplacement(mm), the stressworkof each element (steps x elements, mJ), theplasticstrains of the points (steps x elements x 4 x layers) and theratioof 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 lawslaw(the membrane’s by default; an array(elements, 4, layers, 9)likeMembrane.law) and thecriticalplastic 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 ofmorphogen.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
steptimes the parallel length at first, grown up tomax_stepwhile Newton’s method converges in few iterations (shrunk when it needs many, halved when it fails), back tostepafter the maximum force; until the extensometer readsmax_strain, or the force has fallen bydropafter its maximum, or the strain exceeds that of the maximum bybeyond(the neck has formed: the measures are taken). A point whose plastic strain reaches its critical one (Membrane.critical: a brittle phase) sets thefailure_strainof the specimen (interpolated between the steps); the test stopsfailure_marginbeyond it if given;record_historykeeps the deformation gradients of the Gauss points at every step (the replays ofreplay()).