morphogen.homogenization.ntfa

The nonuniform transformation field analysis (NTFA; Michel & Suquet 2003, 2004): a reduced model of the nonlinear response of a periodic voxel microstructure.

The plastic strain of each plastic phase r is sought as a combination of a few modes, eps_p(x) = sum_k xi_k mu_k(x) (k among the modes of r, zero outside it). Offline (train_ntfa()), full-field simulations along training paths (the voxel solver of NonlinearFFTProblem, full integration) give snapshots of the plastic strain fields, and the modes are their proper orthogonal decomposition phase by phase, orthogonal and normalized so that <mu_k : mu_k>_r = 3/2. Linear elastic solves on the same voxels give the strain fields A_j of the unit macroscopic strains and D_k of the modes taken as eigenstrains, so that eps(x) = A(x) E + sum_k D_k(x) xi_k and, with sigma = C (eps - eps_p), the macroscopic stress and the reduced (generalized) stresses tau_k = <sigma : mu_k>_r are affine in E and xi:

Sigma = L E + sum_k rho_k xi_k, tau = a E + d xi.

Online (NTFAModel.run()), the reduced variables follow the law of their phase written for them (the von Mises model of Lemaitre & Chaboche with isotropic hardening): f_r = ||tau_r|| - R0 - R(p_r), dxi_r = dp_r tau_r / ||tau_r||, p_r the cumulated reduced plastic strain, with the consistency condition f_r = 0 (rate-independent plasticity) or Norton’s flow dp_r/dt = <f_r / K>^N; for one uniform mode this is exactly the law of the phase. Each step is integrated implicitly (backward Euler) by Newton iterations on a few unknowns, with strain, stress or mixed control, without any field computation.

morphogen.homogenization.ntfa.SHEAR = array([1., 1., 1., 2., 2., 2.])

Tensor to engineering strain components (Voigt 11 22 33 23 31 12).

morphogen.homogenization.ntfa.WEIGHTS = array([1. , 1. , 1. , 0.5, 0.5, 0.5])

Weights of the double contraction of two engineering strains.

class morphogen.homogenization.ntfa.NTFAModel(stiffness: ndarray, rho: ndarray, a: ndarray, d: ndarray, mode_phase: ndarray, plasticity: dict, fractions: dict, energy: dict = <factory>, modes: ndarray | None = None, shape: tuple = (), phase_means: dict = <factory>, unit_fields: ndarray | None = None, mode_fields: ndarray | None = None, voxel_stiffness: ndarray | None = None)[source]

Bases: object

Reduced model of a microstructure: the modes of its plastic phases and the affine relations Sigma = L E + rho^T xi and tau = a E + d xi (Voigt, engineering strains).

phase_means: dict

the strain fields of the unit strains (6 x voxels x 6) and of the modes (modes x voxels x 6), the stiffness of each voxel the mean stress and strain of each phase: phase -> (stress of E (6 x 6), of xi (modes x 6), strain of E, of xi)

Type:

for the local fields

property n_modes: int
plastic_strain(xi) → ndarray[source]

The plastic strain field (voxels x 6, engineering) of the reduced variables.

run(path, *, name: str = 'ntfa') → PathResult[source]

Macroscopic response along a loading path (LoadingPath, or a mapping for LoadingPath.from_spec()); strain, stress or mixed control, no change of temperature.

local_fields(strain, xi) → dict[str, ndarray][source]

Strain and stress fields (voxels x 6; engineering strains, Voigt stresses) of the macroscopic strain strain and the reduced variables xi (trained with keep_fields=True).

save(path) → None[source]

The reduced model (without the modes) in a .npz file.

morphogen.homogenization.ntfa.train_ntfa(image: VoxelImage, materials: dict[int, Material], paths, *, modes=4, tol: float = 1e-08, newton_tol: float = 1e-06, keep_modes: bool = True, keep_fields: bool = False, snapshots: list | None = None, normalization: str = 'mean') → NTFAModel[source]

Reduced model of a periodic voxel image: snapshots of the plastic strain fields along the training paths (full-field simulations, NonlinearFFTProblem with full integration, at the end of every step), their POD in each plastic phase (modes: the number of modes, or a mapping phase -> number), and the elastic influence fields of the unit strains and of the modes (FFT solves). snapshots: plastic strain fields already computed (voxels x 6, tensor components), used instead of the paths.