morphogen.fracture.ductile

Remeshed crack propagation in inelastic solids: the transfer of the state of a body between the meshes of successive cracks, and the ductile growth of kinked cracks.

Transfer (transfer_state()). A solved body (a CrackSolution whose bulk is the behaviours of morphoGen’s points, PointBulk: von Mises elasto-viscoplasticity, porous or crystal plasticity, MFront laws) hands its state to the mesh of the next crack: the internal variables of its points (one per linear tetrahedron), their work density and committed stress, and the displacement of its nodes, the initial guess of the next solution. Each point of the new mesh (an element centroid, or a node for the displacement) is located in an element of the old mesh (barycentric coordinates, among the elements whose centroids are nearest), the two lips of the old crack kept apart: behind the old front, a point only takes the values of the elements of its own side (the side of its element in the new mesh, or of the elements around a node). Then:

  • "nearest": the values of that element (one point per element: the identity onto the same mesh, exactly; a transfer that keeps the extreme values but carries the old elements’ facets into the new mesh);

  • "projection": the values projected on the nodes of the old mesh (the means of the elements around each node weighted by their volumes; the lips, whose nodes are duplicated, apart) interpolated at the point: smoother, at the price of some diffusion of the peaks of the fields.

In a polycrystal (meshes whose elements carry the grains of a tessellation, mesh.cell, and their orientations: crack_mesh() with grains), a point takes the values of its own grain only, located among its elements and projected on the nodes from them (the nodes of a grain boundary have a value per grain): the slips and the Fp⁻¹ of the slip systems of a grain, in the axes of its lattice, are never mixed with those of a neighbour. The displacement is interpolated linearly (exact for the old field), across the grain boundaries. On the crack meshes of a morphology (whose phases are those of its materials, the sides of the crack apart: crack_mesh() with morphology), the state moves material by material in the same way (the phases of one material alike; grains and materials both, when the meshes have both). The Fp⁻¹ of crystals, interpolated, is made isochoric again (det = 1); the plastic strains of the logarithmic space of finite strains, deviatoric, remain so. The strain measure committed with the transferred stress is that of the transferred displacement on the new mesh, and the work density is the dissipated part moved plus the free energy of the new state; the transferred state, not in equilibrium on the new mesh, is brought to it at the load of the transfer before the loading resumes (CohesiveProblem.run(initial=..., start=...): Newton’s method over a vanishing time, the plastic correction of the points included, in one step from the transferred state), which dissipates nothing: the dissipated energy moved is kept and the free energy is that of the equilibrium.

Ductile growth (propagate_ductile()): at each load step (a fraction of the load factor) the body is loaded further from its committed state; once the crack driving force at the tip, J_tip (release_rate() with energy="tip": the free energy and the configurational forces of the internal variables) reaches the toughness, or the porosity of the porous points near the tip reaches a critical value (the local approach of ductile fracture: Rousselier 1987; Pineau 2006), the front advances by an increment in the direction of kinking (the interaction integrals of the elastic estimates), the body is meshed again for the new crack (a front grown into a pore going through it), its state transferred and brought to equilibrium, and the criterion checked again before the load grows. With a toughness of the phases and of their interfaces (morphogen.fracture.toughness), J_tip is held against the toughness of the phase at the front and the advance is the candidate of the largest G(θ) / Γ(θ), the kink of the bulk or a deflection along an interface ahead, once that ratio reaches 1. The far driving force at each advance against the advance draws the resistance curve: J_ψ on a domain around the front (energy="free": the configurational force of the free energy on the domain, J_tip plus the shielding of the internal variables inside it, the J_far of Simha, Fischer, Shan, Chen & Kolednik 2008), which rises as the plastic wake of the growing crack shields its tip. The J of the deformation theory (energy="work"), the measure of the loading of a stationary crack, is kept too; once the wake unloads it depends on the domain.

morphogen.fracture.ductile.METHODS = ('nearest', 'projection')

Methods of transfer of the state of the points

morphogen.fracture.ductile.locate(points, mesh: TetMesh, point_labels=None, element_labels=None, k: int = 16, point_groups=None, element_groups=None)[source]

The element of mesh (linear tetrahedra) containing each point (rows) and its barycentric coordinates there (points x 4), among the k elements whose centroids are nearest and whose labels agree with the point’s (a label 0 agrees with every one) and, with point_groups and element_groups (grains), of its group (always, unless no element of mesh is); points outside every candidate take the nearest one, their coordinates clipped.

morphogen.fracture.ductile.transfer_displacement(source: CrackSolution, mesh: TetMesh, crack) → ndarray[source]

The displacement (nodes x 3) of a solved body interpolated at the nodes of the mesh of another crack (see the module).

morphogen.fracture.ductile.transfer_state(source: CrackSolution, mesh: TetMesh, bulk, crack, method: str = 'projection')[source]

The state of a solved inelastic body (its PointBulk) transferred to the bulk of the opened mesh of crack (see the module): the internal variables, the work densities and the committed stresses of its points by method ("nearest" or "projection"), the strain measures of the transferred displacement, which it returns (nodes x 3).

morphogen.fracture.ductile.dissipation(solution: CrackSolution) → float[source]

The energy dissipated in the bulk of a solved body: its work less its free energy (stored elastically and by hardening).

class morphogen.fracture.ductile.DuctileGrowth(cracks: list, loads: ndarray, tip: ndarray, far: ndarray, work: ndarray, factors: ndarray, angles: ndarray, history: list, solutions: list = <factory>, advances: list = <factory>)[source]

Bases: object

A ductile growth (see the module): the cracks at each advance, the load factors of the advances, the driving forces at the tip (tip) and far from it (far, J_ψ on the domain; work, the J of the deformation theory), the stress intensity factors of the elastic estimates (advances x 3), the angles of the advances, every load step (history: rows of the advance, the load, the driving forces and the porosity near the tip), with keep the solutions of the advances, and with a toughness of the phases or of their interfaces the advances chosen (advances: the Advance of each crack; that of the last one is not taken).

rows() → list[dict][source]

One row per advance: the length, the advance, the load factor, the driving forces, the factors and the angle (and with a toughness of the phases or of their interfaces, the bulk or an interface, what it meets, its toughness and its ratio G(θ) / Γ(θ)).

resistance()[source]

The resistance curve: the advances of the crack and the far driving forces.

morphogen.fracture.ductile.propagate_ductile(mesh_of, crack, materials, prescribed, *, load_step: float, increment: float, steps: int, toughness=None, porosity: float | None = None, max_load: float = inf, kinematics: str = 'small', transfer: str = 'projection', solver_steps: int = 2, radius: float | None = None, domain: tuple | None = None, forces=None, contact: float | None = None, bulk: str = 'auto', kink: bool = True, keep: bool = False, **options) → DuctileGrowth[source]

Grow a crack in an inelastic body (see the module): mesh_of(crack) meshes the body conforming to it (crack_mesh()), prescribed (entries, or a function of the opened mesh) and forces (nodal forces, or a function of the opened mesh) are grown by load_step of the load factor in solver_steps steps between the checks of the criterion: J_tip >= toughness, or the porosity of the porous points within radius of the front (by default 1.5 element) >= porosity; each of the steps advances the front by increment in the direction of kinking (straight with kink=False), the state transferred by transfer ("nearest" or "projection"); the far driving forces on the domain (r_in, r_out) (by default that of release_rate: 1 to 4 elements); the loading stops at max_load; options those of run() (tol, max_newton…), but duration is the time of a unit of the load factor (by default 1: the load factor is the time of the viscous behaviours), the same over all the loadings.

toughness: one value, or a Toughness of the phases and of their interfaces (or a dict of the phases): the criterion is then, at each load step, the largest ratio G(θ) / Γ(θ) of the candidate advances reaching 1 (advance_candidates(), the bulk taking J_tip: J_tip against the toughness of the phase at the front, unless the advance enters a tougher phase within the increment or an interface ahead is more favourable), and the advance is that candidate (kink=False: the bulk straight ahead).