morphogen.fracture.phasefield_finite

Brittle fracture of voxel images by the phase-field method in finite strains: the cell of morphogen.fracture.phasefield whose phases stretch much before they break (rubbers, foams, soft tissues).

The phases are hyperelastic (the strain energies of morphogen.homogenization.laws) or elastic (the energy of Hencky of the logarithmic strain, the elasticity of every finite-strain solver of the package), and the energy of the cell is that of the small strains with the energy of the deformation gradient, over the reference configuration,

E(u, d) = int g(d) psi(F) dV0 + int G_c gamma(d, grad0 d) dV0, g(d) = (1 - d)^2 + k:

the damage and its gradient are Lagrangian fields, and the toughness is an energy per unit area of the reference configuration (Miehe & Schänzel 2014). The crack densities (AT2, AT1), the regularization length and the irreversibility are those of the small strains (PhaseField).

A step of a loading path is solved by alternate minimization, as in small strains: until the damage no longer moves,

  1. the displacement at fixed damage: the periodic problem of the voxels of the nonlinear FFT solver (NonlinearFFTProblem: total Lagrangian, F-bar voxels, Newton’s method, the macroscopic components prescribed as stresses among its unknowns), the nominal stress and the tangent of each point times the degradation of its voxel (the stress is degraded as a whole, as in small strains: the hybrid formulation), the Fourier preconditioner of its Krylov solves scaled by the degradation of the nodes;

  2. the damage of the driving energy psi+ of the state reached: the problem of the small strains (the same equation, its bound or its history field).

The solver of the paths divides a step where Newton’s method fails (a cell that breaks at once): the damage then starts again from that of the last converged step. Where a crack runs at a fixed load, the F-bar voxels of its band, sheared far, may turn inside out under Newton’s corrections from an equilibrium where none is near it, and dividing the step only replays the run of the crack: the compressible solids, which do not lock, are better solved on fully integrated voxels (integration="full").

The energy that drives the damage (split) is all the energy ("none"); or its isochoric part and its volumetric part in expansion, J > 1 ("volumetric": the split of Amor et al. between the two terms of the strain energies, so that a hydrostatic compression does not break); or, for the elastic phases only, the tensile part of the energy of Hencky in the principal logarithmic strains ("spectral", as in small strains: lambda <tr e>+^2 / 2 + mu sum <e_i>+^2). The compressible energies that are not split (Blatz-Ko, hyperfoam) drive the damage as a whole.

morphogen.fracture.phasefield_finite.green_lagrange(grads: ndarray) → tuple[ndarray, ndarray][source]

The Green-Lagrange strains (n, 6; engineering shears) and the Jacobians det F of displacement gradients (n, 9; row by row).

class morphogen.fracture.phasefield_finite.FinitePhaseFieldProblem(image: VoxelImage, materials: dict[int, Material], fracture, *, initial=None, tol: float = 1e-07, staggered_tol: float = 0.001, max_staggered: int = 200, **nonlinear)[source]

Bases: object

The brittle fracture of a periodic voxel image in finite strains (see the module): materials of its phases, those that break hyperelastic or elastic (isotropic); fracture (PhaseField, or a mapping of its parameters); initial: the voxels broken from the start. tol: the relative residual of the linear solves; staggered_tol: the largest change of the damage that ends the alternate minimization of a step, of at most max_staggered iterations; nonlinear: the other options of NonlinearFFTProblem (newton_tol, max_newton, max_cuts, integration, tangent).

damage

the damage problem (that of the small strains) and the state of the damage

run(path, *, name: str = 'path', fields=False, monitor=None) → PhaseFieldResult[source]

Follow a loading path (LoadingPath, or a mapping for it; nominal strains and stresses, as for the loading paths in finite strains): PhaseFieldResult with the nominal and true measures of the path. fields: true for the damage, strain and stress of the voxels at the end of each segment of the path, "steps" at the end of each step, or a list of times of its steps. monitor(time, records so far) after each step; a true value ends the path there.