morphogen.laser

Architectured sheets by localized laser treatment: the simulation and the optimization of the laser path that hardens (or softens, carburizes, nitrides, alloys) a pattern of tracks in a metal sheet, for a mechanical load case.

The chain of a study (after Wang’s thesis, PIMM 2022, and the ANR project SCOLASTIC):

  • morphogen.laser.heat: the moving beams on a plate (one face, or both faces at once), quasi-steady cycles of a track (Rosenthal’s limits) and transient finite volumes of a whole blank;

  • morphogen.laser.metallurgy: austenite, martensite and tempering of C–Mn steels (lever rule, Koistinen–Marburger, Maynier, Hollomon–Jaffe), the peak-temperature hardening of ferritic stainless steels, melt-pool carburizing, nitriding and alloying;

  • morphogen.laser.materials: flow laws from tensile properties (Considère), the strength of each hardness, the steels of the PIMM studies (AISI 430, annealed MS1500, DP1180);

  • morphogen.laser.patterns: laser paths (straight, corrugated, Fourier, crossed, honeycomb tracks; G-code);

  • morphogen.laser.process: the hardness a path leaves at the points of a sheet;

  • morphogen.laser.specimen and morphogen.laser.mechanics: tensile specimens and their finite elements (a layered membrane in plane stress, large rotations, Considère’s necking, the fracture of brittle points, local or nonlocal; the replay of the history of a test with other flow laws);

  • morphogen.laser.bending: three-point bending of a strip (fibre sections);

  • morphogen.laser.design: the measures, objectives and constraints of a case and the optimization of its path (grid, Nelder–Mead, differential evolution, genetic, Bayesian);

  • morphogen.laser.cells: cellular designs (phases on a grid of cells, the ideal two-phase sheets of Wang et al. 2023) and their optimization by cellular automata (BESO, neighbour exchanges, HCA) and by densities (MMA), the tracks that draw them;

  • morphogen.laser.structures: load cases beyond the tensile test, a compact tension specimen (the initiation of a crack) and an L-shaped plate (its strength);

  • morphogen.laser.periodic: the periodic cell of a sheet treated all over, its homogenized tensile tests in any direction (the anisotropy of the sheet itself: a rolling texture compensated by the pattern);

  • morphogen.laser.architectures: any morphology treated at the scale of the spot, its treatment and the sheet it makes (the periodic cell of a design of pixels), smooth tracks over a periodic cell, phases of different stiffness;

  • morphogen.laser.solid: the treated sheet in its volume, voxels of graded elastoplastic phases with free faces for the solvers of three-dimensional fields (its tensile test by FFT, its fields across the thickness);

  • morphogen.laser.run: configuration files and outputs (morphogen laser).

Public names

  • Alloying — A thermochemical treatment in the melt pool of each track: carburizing (a graphite coating of coating g/m² on the treated faces), alloying (a coating of composition elements, wt%), nitriding (nitrogen at the partial pressure pressure atm); efficiency: the share of the coating (or of Sieverts’s solubility) that the melt takes up, the rest burnt or evaporated.

  • Beam — A continuous laser beam: incident power per beam (W), speed (mm/s), radius (mm: the 1/e² radius of a Gaussian beam, the half side of a top hat), absorptivity, and for a rectangular top hat its half length along the motion (length, default the radius).

  • BendingResult — The load (N) against the deflection (mm) under it, the largest load of the tables (the limit load of a perfectly plastic strip; of a hardening one, the load at an outer strain of about 100 times the strain of first yield), the initial stiffness (N/mm), the load and the energy (mJ) at the reference deflection, and the moment-curvature tables of the sections.

  • CellEvaluation — A design and its tensile test: measures (failure_measures(), the budget used), value (the objective with the penalties of the constraints).

  • CellGrid — Square cells of about size mm over [x0, x0 + length] x [y0, y0 + width] (the parallel part of a specimen, the region of a structure): ny rows (along y) and nx columns; a design is an array (ny, nx).

  • CellOptimization — The result of an automaton: the best design and its evaluation, the history of the iterations (value, measures, budget, time) and their designs.

  • CellProblem — The load case of a cellular design (see the module): a specimen (its parallel part is the grid of cells of size mm), the phases (phase 0: the untreated sheet), the mesh (element mm, a divisor of the cell size), the objective (OBJECTIVES, maximized) and the constraints {measure: [low, high]} (penalty exp(-penalty * relative violation) on the objective).

  • CompactTension — A compact tension specimen (see the module) pulled by its pins: the nominal stress F / (B W), the nominal strain the load-line displacement over W; the cells over region (default: a box around the crack tip and the ligament); the crack mouth opening displacement among the monitors; refine: the box of fine elements (ct_mesh()); propagate: the crack grows by the breaking of the elements (load_test() with erosion) until the force has fallen to 5 % of its maximum (the specimen separated) or max_disp.

  • FlowLaw — True stress (MPa) of the equivalent plastic strain: ludwik, σ0 + a((p + δ)^b − δ^b) (a = K, b = n), voce, σ0 + a(1 − exp(−b p)) (a = Q, b the rate), or swift, K (ε0 + p)^n (a = K, b = n, ε0 = (σ0/K)^(1/n): Hollomon’s σ = K ε^n from the yield stress σ0, as Wang et al. 2023 for their phases).

  • Fracture — 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.

  • GaussianProcess — Gaussian process regression of costs on the unit cube: a constant mean, a Matérn 5/2 kernel with a length scale per dimension, a nugget; the hyperparameters maximize the marginal likelihood (L-BFGS-B from a few starts).

  • LPlate — An L-shaped plate (see the module) held along its top edge and pulled down at the end of its arm: the nominal stress F / (t arm), the nominal strain the displacement over size; the cells over region (default: around the re-entrant corner).

  • LaserPath — Tracks in the order of the treatment.

  • LaserTreatment — A treatment of a sheet (see the module): material (a SheetMaterial or a preset name), thickness (mm; the material’s by default), configuration, layers through the thickness, treatment (hardening, carburizing, nitriding, alloying) and its alloying parameters, ambient (°C).

  • Membrane — 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()).

  • OptimizationResult — The best values found, their evaluation, the objective and the history of every evaluation (values, measures, objective, penalty, cost).

  • Parameter — A design variable: a dotted name (see SheetCase.with_values()), its bounds, whether it takes integer values.

  • PeakHardening — Hardness gained as a function of the peak temperature of a cycle (table: pairs (T_peak °C, ΔHV), increasing from 0 at its first temperature), on a matrix of hardness base_hardness; full: the peak above which a new cycle replaces the gain of the previous ones (re-transformed share (T_p − onset)/(full − onset)); tempering of the gain; carbon_hardening: HV gained per wt% of carbon and nitrogen dissolved in the melt (carburizing, nitriding).

  • PeakSoftening — Hardness lost as a function of the peak temperature of a cycle — the dissolution of the hardening precipitates of an age-hardened aluminium alloy (Myhr & Grong 1991; Shercliff & Ashby): table pairs (T_peak °C, ΔHV ≤ 0), 0 at its first temperature, the hardness of the treated points after their natural ageing; a cycle keeps the larger of its loss and that of the previous cycles (the precipitates do not form again).

  • PeriodicCell — The parallelogram spanned by a1 and a2 from origin (mm), meshed by n1 x n2 quadrilaterals (mesh); master: the independent node each node moves with (itself for the independent ones, i < n1 and j < n2); shift: the multiples (k1, k2) of a1 and a2 between them.

  • Phase — A material state of the cells (see the module): law, critical plastic strain (infinite: ductile) and cost in the treatment budget.

  • QuadMesh — Quadrilaterals: nodes (n x 2), quads (e x 4, counter-clockwise), and the node sets of the outline (left, right, bottom, top edges of the mapped grid).

  • Replay — 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).

  • SheetCase — The choices of a study (see the module). beam: the beam of the upper face (and of both faces in the symmetric configuration unless bottom is given); pattern: the kind and parameters of make_pattern(); element: the size of the elements (mm); loading: the load case, kind tension (the default; the other keys are options of tensile_test()) or bending (three-point bending of the strip: span, deflection the reference deflection, sections along the span, the fibres across the width at about element; three_point_bending()) or cell (the periodic cell of the sheet treated all over by the pattern repeated: its lattice from the pattern or vectors, its elements of element mm; the other keys are options of cell_test(); the measures of the treatment over the cell, those of the path over the parallel part of the specimen); directions: angles (degrees) of the tensile axis from the x axis of the pattern (the rolling direction), a specimen for each (the pattern turned by the opposite angle; the cell is pulled in each direction instead): the measures are their means, each one’s with its suffix, and the anisotropies.

  • SheetMaterial — A sheet: its thermal properties, its metallurgical response to the cycles of the tracks, its strength against hardness, its elasticity (MPa), its density (kg/m³), its usual thickness (mm) and absorptivity, its rolling texture (anisotropy: the Lankford coefficients {"r0", "r45", "r90"} of Hill’s 1948 criterion, or with "criterion": "yld2000" the yield stresses "s0", "s45", "s90", "sb" and the coefficients "r0", "r45", "r90", "rb" of Barlat’s Yld2000-2d and its exponent "a"; the share "memory" of the texture the treated points keep; yield_criterion()), the fracture of its hard points ({"hardness": HV, "critical": plastic strain, "radius": mm}: the points at least that hard break at that plastic strain, averaged over the radius; Fracture) and the sources of the data.

  • SheetResult — The evaluation of a case: its path, the treated sheet at the Gauss points (or at the fibres of the bending sections), the tensile test or the bending test, the measures; with several directions, the result of each (directions, by angle), the others being those of the first.

  • Specimen — A specimen (see the module); lengths in mm.

  • StrengthTable — Tensile properties against hardness: rows (HV, R_p, R_m, A_g) (MPa, MPa, engineering fraction), interpolated linearly, extrapolated by Pavlina & Van Tyne’s slopes (see the module).

  • Tempering — Linear softening with the Hollomon–Jaffe parameter: hardness H0 up to P0, falling to floor (a fraction of H0, or an absolute minimum HV, the larger) at P1; constant C (hours); no tempering below t_min °C.

  • TensileResult — 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.

  • TensionCase — The tensile test of a specimen (tensile_test()): the cells over its parallel part, the tracks continuing to the grips.

  • ThermalProperties — Thermal properties of the sheet, in SI units: conductivity (W m⁻¹ K⁻¹), density (kg m⁻³), mean specific heat over the thermal cycle (J kg⁻¹ K⁻¹), convection coefficient of each face (W m⁻² K⁻¹) and emissivity (radiation linearized about radiation_temperature, °C).

  • Track — A polyline (n x 2, mm) followed by beam (upper face) and bottom (lower face, or None), then pause seconds lasers off.

  • TrackKernel — The thermal cycles that a long straight track imposes on the points of the sheet: temperature[i, j, k] at the distance distances[i] (mm) of its axis, the time times[j] (s; 0 when the beam passes the point’s abscissa) and the depth depths[k] (mm, the middles of the layers), with their peaks; bottom is the beam of the lower face, if any.

  • TransformationHardening — C–Mn or low-alloy steel (see the module): composition (wt%), Ac1/Ac3 (°C; Andrews’s by default) plus superheat for laser heating rates, solidus, the initial martensite fraction and the hardness of the initial microstructure’s martensite (martensite_hardness; Maynier’s at initial_rate by default) and of the rest (matrix_hardness; Maynier’s ferrite–pearlite after a slow cooling by default), the critical cooling time t8/5 up to which austenite turns into martensite (critical_time, s) and the time beyond which none does (slow_time), tempering.

  • TransientHeat — Finite volumes on a blank [x0, x0 + lx] x [y0, y0 + ly] of thickness thickness: cell in the plane (mm), layers cells through the thickness (1 for a thin sheet treated on both faces).

  • TreatmentResult — The treated sheet at its points: hardness, peak temperature (°C), treated share (of the transformed phases, or of the full gain), melted, carbon and nitrogen (wt%), all (points, layers); weights: the area (mm²) of each point; the path and its measures.

  • andrews_ac — Ac1 and Ac3 (°C) by Andrews’s (1965) formulas.

  • andrews_ms — Ms (°C) by Andrews’s (1965) linear formula, nitrogen counted as carbon.

  • band_fractions — The share (e, 4) of the region of each Gauss point within width / 2 of the polylines (tracks of constant width).

  • beso — The bidirectional evolutionary automaton on the cells (see the module), from a design (default: the central band of the budget) towards the budget (mean cost of the cells); the cells change by orbits of the symmetry and of the translation by period (the failure of a periodic pattern moves to the next period if one alone changes). moves:

  • case_volume — The volume of the periodic cell of a sheet treated all over by the pattern of a SheetCase (its lattice, or the vectors of its loading: two vectors at right angles, the axes of the image): the hardness that its laser path leaves on a grid of resolution mm (by default the element of the case) in each of its layers (the first under the beam, the last on the face of the beam bottom), then sheet_volume() with its options. A lattice that is not rectangular (honeycombs, tracks shifted from one to the next) has a rectangular cell of several of its cells: give its two vectors to the loading.

  • cell_test — The tensile test of the sheet in the direction at angle degrees from x (see the module) on the membrane of the cell: the engineering strain along it up to max_strain (the steps and stops of load_test()); the result’s stress is the mean nominal stress along the direction, its width and thickness strains give Lankford’s coefficient (r_value()). monitors: more functions of the unknowns recorded at each step, after the membrane has taken its new state (fields["monitors"]). ratio: biaxial stretching, the true strain across the direction prescribed at ratio times the true strain along it (see the module); until: the test stops when this function of the unknowns returns true (after the monitors of the step); free_shear: false holds the shear c at zero (see the module).

  • clip_path — The parts of the tracks inside the box [lo, hi] (a track that leaves and comes back splits into several).

  • contrast_phases — The matrix of wang_phases() and a reinforcement whose yield stress is contrast times the matrix’s, from 1 to the contrast c_M = 1300/280 of the as-quenched laser martensite (the hardest state of the steel): the Hollomon parameters σ0, K and n interpolated linearly between those of the matrix and of the martensite at the share a = (contrast − 1)/(c_M − 1), the states between the annealed steel and its martensite (partly transformed by an intercritical peak, or tempered), a harder state hardening less. The critical plastic strain of the reinforcement (FRACTURE_RULES): graded, critical / a² (the rule of a partial treatment, as in hca(): the martensite breaks at critical, a softer state later); brittle, critical whatever the contrast; ductile, none (the necking alone). The last two bound the first.

  • curve_measures — 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.

  • design_membrane — The membrane of a mesh whose Gauss points take the phase of their pixel of the design (from origin, repeated beyond it), with the flow law, the critical strain and Young’s modulus of the phase (phases: wang_phases() by default; young: one modulus, or one per phase).

  • design_tracks — The centre lines (polylines, mm) of the tracks that draw a design: the runs of treated cells of each column, linked to the runs they overlap in the next column (the straightest continuation first where a track splits), crossed at their midpoint — or, with cross, from end to end when longer than a spot of width cells (a square spot then covers every cell; a real track, wider than the spot, would treat too much) —; the tracks that reach the ends of the grid continue along x by margin (the blank is treated before the specimen is cut).

  • distance_to_polyline — Distance (mm) of points (n x 2) to a polyline (m x 2).

  • failure_measures — Measures of engineering curves stress (steps x m, or steps) on the common strain with the failure strains failure (m, infinite: none): the maximum (diffuse necking: the uniform elongation, a parabola through the points around the largest), the failure at the first of the necking and the fracture (failure_strain, alias ductility), the strength reached before it, the work up to it (MJ/m³) and the 0.2 % proof stress. cap: the strength of the weakest cross-section (m): a curve that reaches it necks there. Arrays of length m (or floats).

  • flow_parameters — Flow laws of tensile properties, vectorized: (kind, σ0, a, b) (kind 0: Ludwik, 1: Voce). The law gives the proof stress at a plastic strain of 0.2 %, σ(0.002) = R_p, and at the true plastic strain p_u = ln(1 + A_g) − σ_u/E of the uniform elongation σ(p_u) = σ_u = R_m (1 + A_g) and dσ/dp = σ_u (Considère). Ludwik: K = σ_u (p_u + δ)^(1−n)/n, n and σ0 by nested bisections; where no exponent fits (a large ratio R_m/R_p at a small elongation, martensite), Voce: x/(e^x − 1) = σ_u p_u/(σ_u − σ0) with x = b p_u and Q = (σ_u − σ0)/(1 − e^(−x)). strict: raise on properties that no law fits (else their parameters are NaN).

  • flow_plasticity — The von Mises plasticity of a flow law of the sheets (kind: its name, or its index in LAWS; sigma0, a, b: its parameters): exact for Voce’s law, fitted over the plastic strains up to strain for the power laws (see the module; the rates of the exponentials: those of RATES that leave the least error).

  • hca — The hybrid cellular automaton (see the module) on the treatment densities of two phases: each cell’s stimulus, the derivative of the value (from the replays) averaged over its neighbourhood, drives its density by kp (relative to the largest stimulus, at most move) towards the set point that meets the budget; finally rounded to levels (default: the two phases, at the budget).

  • hill48 — Hill’s 1948 criterion of a sheet from its Lankford coefficients at 0°, 45° and 90° ({direction: r}): F, G, H, N normalized by G + H = 1 (F = r0 / (r90 (1 + r0)), G = 1/(1 + r0), H = r0/(1 + r0), N = (r0 + r90)(1 + 2 r45) / (2 r90 (1 + r0)); isotropy: 0.5, 0.5, 0.5, 1.5), the normal anisotropy r̄ = (r0 + 2 r45 + r90)/4 and the planar Δr = (r0 − 2 r45 + r90)/2; NaN without the three directions.

  • hill_from_r — 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.

  • lattice — The lattice vectors (mm, reduced) of a pattern repeated over the sheet (see the module): straight (spacing across the tracks, along them: by default the spacing, 2 mm at most, the treatment being the same all along a track), corrugated and fourier (period along, spacing across, shifted by the phase between neighbours), crossed (along each family, from a track of the other family to the next: spacing2 / sin 2θ along the first, spacing / sin 2θ along the second), honeycomb (the centres of the hexagons), none (a square of 2 mm); all turned by the pattern’s rotation.

  • load_laser_config — Validate a configuration (file path or mapping).

  • load_test — Displacement control (see the module): the dofs moved follow δ direction (or a path: direction a function of δ giving their values and their derivatives, the force then the work-conjugate of δ), the dofs fixed are held; steps of step (then up to max_step) times max_disp; stops at max_disp, when the force falls by drop after its maximum, or failure_margin (nominal strain) beyond the first fracture. With erosion, the crack grows: after each step the elements whose ratio to fracture reaches one break (Membrane: a residual stiffness; the averages over the living elements), the specimen is brought back to equilibrium at the same displacement, again until none breaks (a crack that runs unstably at fixed displacement); fields["broken"]: the broken elements in their order and the strain at which each broke (at most max_breaks). The result’s strain is δ / length, its stress the force over section; monitors: functions of the displacements recorded at each step (fields["monitors"], kept with or without the fields). The membrane may be seen through a linear map of reduced unknowns (its full gives the nodal displacements: the periodic cell of periodic). until: a function of the displacements checked after each step (after the monitors): the test stops when it returns true.

  • make_pattern — A pattern of PATTERNS (or polylines) over the band (x0, x1, y0, y1) (mm), its tracks followed by beam and bottom. rotation (degrees) turns the pattern about the centre of the band: the specimen is then cut at -rotation from the axes of the pattern (the anisotropy of an architectured sheet, tested at 0°, 45° and 90°); the pattern is drawn on a square that covers the turned band, its families of tracks repeated at their spacing over it (the treated sheet), then clipped to the band and its margin — so is it unturned with cover (the periodic sheet around a cell, periodic).

  • maynier_hardness — Hardnesses (HV) of martensite, bainite and ferrite–pearlite formed at the cooling rate rate (K/s at about 700 °C) by Maynier, Jungmann & Dollet (1978), the carbon of the transforming austenite given (nitrogen counted as carbon).

  • moving_source — Quasi-steady temperature (°C) at the points (ξ, y, z) (mm) in the frame of a beam moving along +x on a plate of thickness thickness, its upper face at z = 0: one beam on the upper face (single), the same beam on both faces (symmetric), or bottom, another beam aligned with it on the lower face (a fibre laser above and a diode below, say).

  • moving_source_grid — moving_source() on the grid xi x y x z (1D arrays), shape (len(xi), len(y), len(z)): the plane kernel is separable, so that the integral over the delays is a product of matrices for each depth (no exponential per point).

  • optimize — Optimize the parameters of a case (see the module). parameters: a mapping of dotted names to [low, high] ([low, high, true] for integers) or Parameter s; constraints: a mapping of measures to [low, high] (None for no bound); target: the target measures of the objective target; evaluations: the budget of evaluations (grid: levels per parameter instead); initial: the first designs of the Bayesian optimization (Latin hypercube; default 2 d + 2); options: those of the SciPy methods.

  • periodic_lines — The polylines lines (mm) and their images by the lattice of a1 and a2 that come within reach of the box (x0, x1, y0, y1): the tracks of a pattern repeated over the sheet, as they cross a periodic cell.

  • pixelate — The phases (integer labels) of an image on a grid of shape = (ny, nx) pixels covering the same extent: the most frequent label of the image points whose centres fall in each pixel (the lowest label on a tie). An image coarser than the grid is sampled at the pixel centres.

  • reduce_basis — The Lagrange–Gauss reduction of a basis of a plane lattice: the shortest pair of vectors spanning it (at 60° to 120° from each other), counter-clockwise.

  • replay — 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).

  • rosenthal_line — The line source through a thin plate (Rosenthal 1946; with the surface losses of Rykalin): T0 + P/(2πkh) exp(−vξ/(2a)) K0(r √(v²/(4a²) + β/a)).

  • rosenthal_point — Rosenthal’s point source on the surface of a semi-infinite body (absorbed power power): T0 + P/(2πkR) exp(−v(R + ξ)/(2a)), R the distance to the source.

  • run_laser — Evaluate the designs of a configuration, optimize when asked, write the results; returns the summary and the folder.

  • sheet_material — A preset material (PRESETS).

  • sheet_tests — The sheet of a periodic design pulled in each direction of angles (degrees from x; see the module): {"directions": {angle: measures}, ...} with, for each direction, the yield and tensile strengths (MPa), the failure strain, the energy up to it (MJ/m³), Lankford’s coefficient, whether a brittle phase broke first, and the result of the test; and over the directions the means and spreads (max − min over the mean) of the yield strength, the failure strain and the energy.

  • sheet_volume — The volume of a treated sheet (see the module): hardness (HV; (n1, n2, layers), on a grid of the periodic cell of steps spacing (mm) along its two axes, its layers through the thickness (mm)) of a sheet of material (a SheetMaterial). Returns the image of its phases and their materials: phase 0, the void of the gap voxels above the sheet (its free faces); phases 1, 2, …: the classes of hardness present among classes of equal width, in increasing hardness, each with the elastic constants of the sheet and the plasticity of the flow law of the mean hardness of its voxels (strain: the range of the fit of power laws). depth: voxels through each layer (by default as many as make the voxels nearest cubes); the first layer is at z = 0. The hardness of each phase is in the metadata of the image ("hardness"), with the number of voxels through the sheet ("solid_voxels").

  • sieverts_nitrogen — Solubility of nitrogen (wt%) in liquid iron at temperature (°C) under a partial pressure pressure (atm): log[%N] = −188/T − 1.25 (Sieverts’s law), raised by chromium through log f_N = e_N^Cr [%Cr], e_N^Cr = −0.047.

  • spot_opening — The part of a design (treated: phase > 0) that a square spot of width cells draws, its morphological opening (periodic: through the edges of the cell; otherwise the spot may overhang them), the treated cells keeping their phase.

  • tensile_test — 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()).

  • three_point_bending — Three-point bending (see the module) of a strip whose sections, equally spaced over the span ((sections, ny, layers) flow laws, the first section at the left support, the last at the right one; an odd number puts one under the load), are given; deflection: the reference deflection of the load and the energy (default: a fiftieth of the span).

  • topology — Density-based topology optimization (see the module): the densities filtered over radius and projected (beta doubled every 10 iterations up to beta_max), the mixture w^q, the derivatives of the replays, MMA under the budget constraint; the result rounded to two phases at the budget.

  • track_kernel — Tabulate the thermal cycles of a long straight track (see TrackKernel): the distances up to where the peak falls to cutoff (°C; default: a tenth of the peak rise above ambient, at least 100 °C above it; at most max_reach mm), the times from ahead of the beam to a tail of cooling, layers layers through the thickness. The beams: as in moving_source().

  • track_membrane — The membrane of a mesh crossed by tracks along the polylines lines (their centre lines; see the module), width mm wide (one width, or one per line): the share w_k of the region of each Gauss point inside the tracks of each treated phase k (kinds: the phase of each line, 1 by default; phases: the untreated first, wang_phases() by default) mixes the flow stress of the untreated phase with that of the treated phase of the largest share as (1 − w) σ_0 + w σ_k (w the sum of the shares), and Young’s moduli (young: one modulus, or one per phase) by the shares; a point mostly inside a track takes the critical strain of that phase. Several kinds: a track whose treatment changes along it, tracks of several treatments.

  • treatable — Whether a design (two phases) can be drawn by a spot of width cells: every treated cell lies in a treated square of width cells (the design equals its morphological opening), and the squares join by sides or corners wherever the treated cells do (no neck thinner than the spot).

  • treatment_measures — The laser treatment of a design (see the module): treated share; length (m) of the raster lines one spot wide that treat it, time (min) at speed (mm/s), switches of the beam along the rows (per m² of sheet); whether the treated and the untreated phases span the design along x and along y (hard_spans, soft_spans: pairs of booleans); the shares of the untreated pixels with a treated neighbour (heat_affected) and with treated pixels on all four sides (enclosed), among the untreated ones.

  • volume_tension — The tensile test of the volume of a sheet along the axis axis of its cell (0 or 1), up to the macroscopic strain in increments steps, the other stresses of its plane free (homogenize(), with its options): the strain along the axis, the stress of the sheet (the mean stress of the cell over the fraction of its height that the sheet fills), the strain of its width and the path result (fields, phases). The strains of the cell across the sheet are those of its gap, which nothing holds (left free, they make the problem singular): they are prescribed, and the faces of the sheet stay free, its thickness changing in the gap. kinematics="finite": finite strains (the flow laws in the logarithmic strains); the strain is then the elongation over the initial length and the stress the force over the initial section, those of a tensile test and of the membrane of the sheets.

  • wang_phases — The phases of Wang et al. (2023, Table 3): the annealed 0.23 C steel (ferrite and pearlite, Hollomon σ0 280 MPa, K 986 MPa, n 0.24) and its laser martensite (1300, 1966, 0.06), brittle beyond critical.

  • yld2000_from_data — 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).

  • yld2000_profile — 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"}.

Modules