morphogen.homogenization.behaviours

Nonlinear behaviours of the phases: von Mises elasto-(visco)plasticity, and the integration of the behaviours of all the points (crystal plasticity: morphogen.homogenization.crystal; porous plasticity: morphogen.homogenization.porous).

The model of Lemaitre & Chaboche (1990), in small strains, with isotropic elasticity (sigma = D (eps - eps_th - eps_p)):

  • yield function f = J(sigma - X) - R(p) - R0, with J the von Mises norm sqrt(3/2 s : s) of the deviator;

  • isotropic hardening R(p) = H p + sum_i Q_i (1 - exp(-b_i p)) of the cumulated plastic strain p;

  • kinematic hardening X = sum_k X_k, dX_k = 2/3 C_k deps_p - D_k X_k dp (Armstrong-Frederick; D_k = 0: linear, Prager);

  • normality deps_p = dp n, n = 3/2 (s - X) / J(sigma - X);

  • Norton’s viscous flow dp/dt = <f / K>^N (viscoplasticity), or the consistency condition f = 0 when there is no viscosity (rate-independent plasticity).

The equations are integrated implicitly (backward Euler) over each time step. The Armstrong-Frederick backstresses then read X_k = theta_k (X_k^n + 2/3 C_k dp n) with theta_k = 1 / (1 + D_k dp); the relative stress s - X is parallel to xi* = s_tr - sum theta_k X_k^n (s_tr: the elastic trial deviator), and the whole update reduces to one scalar equation for the increment dp (or, for viscoplasticity, for the viscous stress, which is better conditioned near dp = 0), solved by Newton’s method safeguarded by bisection. Its linearization gives the consistent tangent operator d sigma / d eps of the step (Simo & Taylor 1985), symmetric but for the Armstrong-Frederick terms (the backstresses turn the direction of flow: about 1 % of its largest entries). The kernels symmetrize it for the conjugate gradient solvers (which only removes the round-off of the symmetric laws), or keep it whole for GMRES (symmetric=False: morphogen.homogenization.nonlinear decides by the laws of the phases).

Stresses and the internal tensors are stored by their Voigt components (11, 22, 33, 23, 31, 12); strains in the engineering convention of the solvers (shears doubled).

morphogen.homogenization.behaviours.MAX_ISOTROPIC = 3

Most nonlinear isotropic terms Q (1 - exp(-b p)) and kinematic terms (C, D).

morphogen.homogenization.behaviours.PARAMS_WIDTH = 26

those of von Mises, then the six coefficients of Hill

Type:

The rows of parameters of the GPU

morphogen.homogenization.behaviours.ROW_WIDTH = 62

those of von Mises and Hill, or of a porous point

Type:

Rows of parameters of the kernels of the GPU

morphogen.homogenization.behaviours.STATE_P = 6

plastic strain (6, tensor components), p, backstresses.

Type:

Internal variables of a point

morphogen.homogenization.behaviours.ELASTIC = 0

elastic, von Mises, crystal plasticity, an MFront behaviour (integrated by MGIS: morphogen.homogenization.mfront; the kernels skip them), porous plasticity

Type:

Behaviours of the points

morphogen.homogenization.behaviours.HILL_COMPONENTS = ('11', '22', '33', '12', '23', '31')

The components of Hill’s coefficients in the configurations (those of Z-set’s hill1 … hill6), and their places in the Voigt order of the kernels (11, 22, 33, 23, 31, 12)

morphogen.homogenization.behaviours.kernel_constants(ns: int, width: int) → dict[source]

The constants of the C ports of the kernels of the points (behaviours.cu, for the GPU and the MFront sources of crystals in finite strains): the slip systems of the arrays of the crystals (NS), the internal variables of a point (WIDTH) and the constants of the Python modules.

class morphogen.homogenization.behaviours.Plasticity(yield_stress: float, hardening: float = 0.0, isotropic: tuple[tuple[float, float], ...] = (), kinematic: tuple[tuple[float, float], ...] = (), viscosity: float | None = None, exponent: float | None = None, hill: tuple[float, ...] | None = None)[source]

Bases: object

Von Mises elasto-(visco)plasticity of an isotropic elastic material.

yield_stress (R0), linear isotropic hardening hardening (H), nonlinear isotropic terms isotropic (pairs Q, b), kinematic terms kinematic (pairs C, D), and Norton’s viscosity viscosity (K) and exponent exponent (N) for viscoplasticity (rate-independent plasticity without them). Stresses in the units of the elastic moduli, times in those of the loading paths.

property viscous: bool
yield_stresses() → dict[str, float][source]

The initial yield stresses in tension along the axes and in shear in their planes ("11" … "12"…): R0 and R0 / sqrt(3) for von Mises; for Hill’s criterion, R0 sqrt(6 / (4 h11 + h22 + h33)) along 1 (and its permutations) and R0 / sqrt(3 h12) in the plane 12.

params(lam: float, mu: float) → ndarray[source]

Row of parameters of the integration kernels (with Hill’s coefficients after those of von Mises, in the order of the kernels).

to_config() → dict[source]
classmethod from_config(spec) → Plasticity[source]

{yield: R0, hardening: H, isotropic: [{Q, b}...], kinematic: [{C, D}...], norton: {K, n}, hill: {11: h11, 22: h22, 33: h33, 12: h12, 23: h23, 31: h31}} (aliases R0 and H; the coefficients of Hill not given are 1).

morphogen.homogenization.behaviours.point_chunks(n)[source]

Number of the chunks of consecutive points that the threads integrate, each with work arrays of its own: 64 points or more per chunk, 128 chunks at most.

morphogen.homogenization.behaviours.update_points(kind, mat, pmat, data, eps, dtemp, dt, old, new, sigma, tangent, guess, ratio, symmetric=True)[source]

Stress, internal variables and tangent of every integration point for the strains eps (engineering) at the end of a step dt, from the internal variables old at its start, at the change of temperature dtemp.

data: the elasticity matrices of the materials (in the axes of the sample) and their thermal strains per unit change of temperature (engineering), the rows of the von Mises and porous parameters and the number of backstresses, and for crystal plasticity the slip systems of each material (slip direction, plane normal; axes of the sample), the parameters of each system, the interaction matrices and the numbers of systems (morphogen.homogenization.nonlinear.behaviour_table()). Points use the material mat and the row of parameters pmat of their behaviour kind. guess and ratio: initial slips of the crystal points (morphogen.homogenization. crystal.cp_small()). symmetric: the consistent tangents symmetrized (for the conjugate gradients), or kept whole (for a nonsymmetric solver). Returns the number of points whose integration failed.

morphogen.homogenization.behaviours.mises(stress) → ndarray[source]

Von Mises equivalent stress of Voigt stress components (…, 6).

morphogen.homogenization.behaviours.state_width(n_kinematic: int) → int[source]

Number of internal variables of a point with n_kinematic backstresses.