morphogen.homogenization.fft_nonlinear

Nonlinear homogenization of periodic voxel images along loading paths: the periodic element of morphogen.homogenization.nonlinear on the voxels of the FFT solver.

Each voxel is the trilinear hexahedron of morphogen.homogenization.fft, its 2 x 2 x 2 Gauss points the integration points of the behaviours. Fully integrated, these elements lock under isochoric plastic flow (the macroscopic flow stress of a composite with a plastic matrix converges from far above as the voxels are refined): by default the volumetric part of the measures is averaged over each voxel, the B-bar method in small strains (Hughes 1980) and the F-bar method in finite strains (de Souza Neto, Perić, Dutko & Owen 1996), in their variational form (the forces derive from the energy of these measures), so that the tangent stays symmetric. The unknowns of a step are the periodic nodal fluctuation w and the components of the macroscopic strain prescribed as stresses (the macroscopic degrees of freedom of the periodic element), solved by the Newton iterations of _PathSolver: the macroscopic block is condensed, the corrections are inexact, the steps are divided when they do not converge.

Each linearized equilibrium K_t dw = -R_w is solved by conjugate gradients preconditioned by the inverse of the stiffness of a homogeneous elastic reference medium, applied in Fourier space (FourierPreconditioner): a Newton-Krylov scheme (Gélébart & Mondon-Cancel 2013; Kabel, Böhlke & Schneider 2014) on the discretization of Schneider, Merkert & Kabel (2017). The tangent operator is applied matrix-free from the consistent tangents of the points: stress increments C_t : B v at the points, then nodal forces gathered node by node; nothing is assembled. The tangents are symmetrized, so that conjugate gradients apply, when the laws of all the phases have symmetric ones; otherwise (crystal and porous plasticity, the Armstrong-Frederick hardening, learned laws that are not potentials, MFront behaviours without a symmetric tangent) they are kept full, symmetrized again at the linearizations where their measured asymmetry is small (ASYMMETRY), and GMRES with deflated restarts and the same preconditioner solves the corrections of the others (gmres(); tangent chooses), recycling from a solve to the next of the path the space of the first one that restarts (GCRO-DR, Recycling) and stopping a solve that stagnates (an inexact correction). Pores have no integration points and, as in the linear solver, need no ersatz material.

The behaviours are those of the finite elements: von Mises elasto-(visco)plasticity, and crystal plasticity with the slip systems of each grain turned by its orientation, in small or finite strains (total Lagrangian, upper triangular macroscopic gradient).

Memory: per integration point, the measure of strain, the stress, the tangent (36 or 81 values) and the internal variables twice (a crystal with 12 slip systems: about 1 kB in small strains, 1.7 kB in finite strains), with 8 points per voxel: about 2 GB for a 64³ polycrystal in small strains.

morphogen.homogenization.fft_nonlinear.INTEGRATIONS = ('bbar', 'full')

B-bar (F-bar in finite strains), or full

Type:

Integration of the voxels

class morphogen.homogenization.fft_nonlinear.NonlinearFFTProblem(image: VoxelImage, materials: dict[int, Material], bc: str = 'periodic', *, tol: float = 1e-08, maxiter: int | None = None, reference: tuple[float, float] | None = None, grains=None, orientations=None, newton_tol: float = 1e-06, max_newton: int = 25, max_cuts: int = 10, kinematics: str = 'small', integration: str = 'bbar', device: str = 'cpu', tangent: str = 'auto')[source]

Bases: _PathSolver, FFTElasticProblem

Nonlinear behaviours of the phases (von Mises elasto-(visco)plasticity, crystal plasticity) on a periodic voxel image, loaded along paths: the periodic element on trilinear voxels, whose macroscopic strain components are degrees of freedom, each Newton correction solved by FFT-preconditioned conjugate gradients (GMRES with full tangents), in small or finite strains (kinematics). Crystals are turned by the orientations of their grains (grains: image or array of grain labels; orientations: Bunge angles of each grain).

integration: "bbar" (default) averages the volumetric part of the measures over each voxel (B-bar in small strains, F-bar in finite strains), so that the trilinear voxels do not lock under isochoric plastic flow; "full" integrates every component at the 8 Gauss points (the discretization of the linear FFT solver). device: "gpu" runs the iterations on the GPU, where the arrays of the points stay (the measures, the integration of the behaviours, the nodal forces and the conjugate gradients; see morphogen.homogenization.gpu), "auto" when there is one. tangent: the consistent tangents of the points symmetrized and solved by conjugate gradients ("symmetric"), full and solved by GMRES ("full"), or by default ("auto") symmetrized when the laws of all the phases have symmetric tangents (behaviour_table(): symmetrize tells which), and otherwise at each linearization where their asymmetry is below ASYMMETRY (measured; the outputs report the largest asymmetry and the linearizations solved with the full tangents). tol: relative residual of the conjugate gradients (the Newton corrections are solved inexactly above it); maxiter: their iterations; reference: Lamé coefficients of the reference medium of the preconditioner (default: the means of the extreme elastic moduli of the phases); newton_tol, max_newton and max_cuts: as for NonlinearFEProblem.