morphogen.laser.structures

Load cases of laser-architectured sheets beyond the tensile test of a dog-bone: the compact tension specimen (the blunting of a crack, the third application of SCOLASTIC) and the L-shaped plate (the strength at a re-entrant corner), and the tensile test itself as one of them.

Meshes. Structured blocks of quadrilaterals graded towards the singular points (graded(): elements of fine mm there, growing geometrically to element mm): the CT specimen of ASTM E399 proportions (width W from the load line, height 1.2 W, pin holes of diameter 0.25 W at 0.275 W from the crack plane, a crack of length a from the load line, its faces unconnected nodes; each pin a node joined by stiff bars to the half of its hole it bears on, so that the specimen turns about it: the elastic load-line compliance within 2.5 % of Saxena & Hudak 1978), the L-shaped plate (a square of side size without the quadrant beyond the arm).

Test (load_test()): displacement control of a set of degrees of freedom along a direction (the load-line displacement δ), others held, the force the reaction along that direction; the same Newton iterations and adaptive steps as tensile_test(), until a displacement, a drop of the force after its maximum, or a margin beyond the first fracture of a point (the critical plastic strains of the membrane, averaged over its fracture radius: the initiation of a crack, ductile in the matrix, brittle in a hard phase). The curve is nominal: the force over a section and the displacement over a length (MPa and strain), so that failure_measures() reads its maximum (the limit load), the first fracture (the initiation), the work up to it.

Cases (TensionCase, CompactTension, LPlate): a mesh, the conditions of the test, the nominal section and length, the region of the cells of a design (CellProblem takes a case).

morphogen.laser.structures.graded(a: float, b: float, element: float, *, focus=(), fine: float | None = None, growth: float = 1.2, box: tuple | None = None) → ndarray[source]

Coordinates from a to b: elements of fine at the focus points, growing by growth to element away from them (uniform without focus); or uniform elements of fine over box = (lo, hi) (on the grid of the first focus inside it), growing away from its ends.

class morphogen.laser.structures.Domain(mesh: QuadMesh, sets: dict = <factory>, points: dict = <factory>)[source]

Bases: object

A mesh and its named sets of nodes.

morphogen.laser.structures.ct_mesh(width: float = 20.0, crack: float = 0.5, *, element: float = 1.0, fine: float = 0.125, growth: float = 1.2, refine: tuple | None = None) → Domain[source]

The compact tension specimen (ASTM E399 proportions; the module): x from the load line, the crack along y = 0 from the front face x = −0.25 W to x = a = crack W; elements of fine at the tip, or over the box refine = (x0, x1, y1) (x0 ≤ x ≤ x1, |y| ≤ y1: the paths of a growing crack). Sets: upper_pin and lower_pin (the halves of the pin holes the pins bear on), mouth_upper and mouth_lower (the crack mouth); points: tip.

morphogen.laser.structures.pin_springs(domain: Domain, stiffness: float) → tuple[source]

Bars from each pin node to the rim nodes it bears on (see ct_mesh()): the specimen turns freely about its pins.

morphogen.laser.structures.l_mesh(size: float = 40.0, arm: float = 16.0, *, element: float = 1.0, fine: float = 0.25, growth: float = 1.2) → Domain[source]

The L-shaped plate: the square [0, size]² without [arm, size]², the re-entrant corner at (arm, arm). Sets: top (y = size, held), tip (x = size, loaded).

morphogen.laser.structures.load_test(membrane: Membrane, fixed, moved, direction, *, length: float, section: float, max_disp: float, step: float = 0.004, max_step: float = 0.02, drop: float = 0.05, tol: float = 1e-05, max_iterations: int = 20, max_steps: int = 400, failure_margin: float | None = None, record_history: bool = False, monitors: dict | None = None, keep_fields: bool = True, erosion: bool = False, max_breaks: int = 2000, until=None) → TensileResult[source]

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.

class morphogen.laser.structures.TensionCase(specimen: Specimen = <factory>, element: float = 0.5)[source]

Bases: object

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

run(membrane, *, max_strain=0.35, failure_margin=0.03, record_history=False, keep_fields=True)[source]
class morphogen.laser.structures.CompactTension(width: float = 20.0, crack: float = 0.5, thickness: float = 1.0, element: float = 1.0, fine: float = 0.125, growth: float = 1.2, region: tuple | None = None, max_disp: float | None = None, refine: tuple | None = None, propagate: bool = False)[source]

Bases: object

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.

run(membrane, *, max_strain=None, failure_margin=0.01, record_history=False, keep_fields=True)[source]
class morphogen.laser.structures.LPlate(size: float = 40.0, arm: float = 16.0, thickness: float = 1.0, element: float = 1.0, fine: float = 0.25, growth: float = 1.2, region: tuple | None = None, max_disp: float | None = None)[source]

Bases: object

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).

run(membrane, *, max_strain=None, failure_margin=0.005, record_history=False, keep_fields=True)[source]
morphogen.laser.structures.case_from_config(data)[source]

A case of CASES from a mapping (kind and its parameters).