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:
objectReduced model of a microstructure: the modes of its plastic phases and the affine relations
Sigma = L E + rho^T xiandtau = 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 forLoadingPath.from_spec()); strain, stress or mixed control, no change of temperature.
- 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,NonlinearFFTProblemwith 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.