morphogen.homogenization

Computational homogenization: apparent properties of volume elements.

Two solvers, chosen by the representation of the sample:

  • finite elements on conforming tetrahedral meshes of the implicit morphologies (morphogen.mesh.conforming.conforming_mesh()), with kinematic (kubc), mixed, periodic or static (subc) boundary conditions;

  • an FFT-preconditioned solver on voxel images, with periodic conditions;

  • extended finite elements on a regular grid cut by the level set of the morphology (morphogen.homogenization.xfem), with periodic conditions: no mesher, no stairs.

All solve linear elasticity (with thermal expansion) and the transport phenomena of a scalar potential: heat and electrical conduction, dielectrics, magnetostatics and diffusion (TRANSPORT). The strong couplings between these physics (piezoelectricity, piezomagnetism, magneto-electro-elasticity, thermoelectricity) are solved field by field together on voxel images (morphogen.homogenization.coupled).

Materials may yield (von Mises elasto-(visco)plasticity, Plasticity), slip on the systems of their lattice (crystal plasticity of Méric and Cailletaud, CrystalPlasticity), relax (Viscoelasticity), stretch as rubbers (Hyperelasticity) or soften (Damage): loading paths (LoadingPath) are then followed in time, in small or finite strains, with the macroscopic strain components as degrees of freedom (the periodic element): by finite elements (NonlinearFEProblem) or by the FFT solver of voxel images (NonlinearFFTProblem); simulate_point() integrates a material point. The stresses of the points along a cycle of a path are judged by criteria of multiaxial fatigue (morphogen.homogenization.fatigue: Crossland, Sines, Dang Van, Findley, Matake), and those of a path by the criterion of cleavage of Beremin (morphogen.homogenization.beremin: the Weibull stress).

Typical use:

from morphogen.homogenization import Material, VOID, homogenize
from morphogen.mesh import conforming_mesh

mesh = conforming_mesh(micro, size=0.4, phases="solid")
materials = {0: VOID, 1: Material(young=210e3, poisson=0.3, conductivity=100)}
results = homogenize(mesh, materials, bcs=["kubc", "mixed"],
                     properties=["bulk_modulus", "shear_modulus", "conductivity"])
results["bulk_modulus.kubc"].value

Public names

  • Apparent — Apparent property of one volume element for one boundary condition.

  • BandStructure — The angular frequencies (frequencies: wave vectors x bands, increasing) of the Bloch waves at the wavevectors, their distance along the path and the positions and names of its corners (labels).

  • Beremin — The criterion of Beremin (1983): the modulus m of Weibull, the scale sigma_u of the cleavage stresses of the reference volume V_0. planes: the cleavage planes of the crystals of the points, whose largest normal stress drives the cleavage (none: the largest principal stress), with c_over_a for hexagonal crystals; plastic: the cumulated plastic strain beyond which a point belongs to the plastic zone (none: every point counts).

  • Bifurcation — The group-theoretic analysis of a cell: its symmetry group (restricted to the loading), irreps, the multiplicity of each among the fluctuations, the patterns, the lowest critical load factor of each irrep (NaN without loading), the first critical load, its irrep and multiplicity, and the norms of the projections of the first critical modes of the whole cell (unit norm) on the isotypic subspaces (rows: irreps; small cells only): 1 in the irrep of the bifurcation, 0 elsewhere (several irreps when their loads coincide, the multiplicity then counting all their modes). For a continuum, mesh is the analysed mesh and lift maps the dofs of its master nodes to all its nodes.

  • CoupledProblem — Periodic problem of the coupled fields of a layout (FIELDS) on a voxel image: laws[m] is the symmetric law S = L Z of the material m (the components of the layout), mat the material of each voxel (-1: none, a void) and eigen[m] its flux lambda per unit change of temperature (S = L Z - lambda dT; zero if not given). Each diagonal block of the laws must be definite, positive or negative, alike in all the materials that have it (a block may vanish in some: the stiffness of a pore filled by a dielectric).

  • Coupling — The coupling coefficients of a material, in the axes of its crystal (those of the sample without an orientation): piezoelectric (e, 3 x 6: D = e eps at zero field, C/m^2), piezomagnetic (q, 3 x 6: B = q eps, N/(A m)), magnetoelectric (alpha, 3 x 3 or one value: D = alpha H), seebeck (s, one value or a 3 x 3 tensor: the field E = s grad T at zero current, V/K) and pyroelectric (p, 3 components: D = p dT at constant strain and field, C/(m^2 K)). Matrices follow morphoGen’s Voigt order 11 22 33 23 31 12 with engineering shears, which is that of the IEEE standard on piezoelectricity (e15: the entry of the row 1 and the column 31).

  • Crossland — Crossland’s criterion (see the module): sqrt(J2)_a + alpha σ_H,max <= beta.

  • CrystalPlasticity — Méric-Cailletaud crystal plasticity: families of slip systems with their parameters (tau0, Q, b, C, D, K, n, see PARAMS) and the interaction matrix ((): uniform; (h_self, h_latent); the six coefficients of INTERACTIONS for the octahedral family; or a full matrix). twins: families of twins (TWINS) with the same parameters, which shear in one sense until the fraction twin_saturation of the crystal has twinned; cleavage: families of cleavage planes (CLEAVAGE) with their parameters (CLEAVAGE_PARAMS), which open under a normal stress; c_over_a: the ratio of a hexagonal lattice (its families are those of HEXAGONAL). The systems of a crystal are its slip systems, then its twins, then those of its cleavage planes.

  • Damage — An isotropic damage law (see the module): the damage starts at the equivalent strain threshold (or at the uniaxial stress strength: the threshold is strength / E) and grows by the softening law (SOFTENINGS) up to the equivalent strain ultimate (linear: no stress beyond it; exponential: the stress decays as exp(-(kappa - kappa_0) / (ultimate - kappa_0))), or so that a band of the width length (the size of the elements) dissipates the fracture_energy per unit area. equivalent: the equivalent strain (EQUIVALENT_STRAINS), with ratio the compressive strength over the tensile one of the modified von Mises strain; split (SPLITS); viscosity: the time of the delayed damage (0: none); residual: the fraction of the stiffness that the damage leaves.

  • DangVan — Dang Van’s criterion (see the module): max_t [τ(t) + alpha σ_H(t)] <= beta.

  • FEElasticProblem — Linear (thermo-)elasticity on a tetrahedral mesh (small strains); crystals are turned by the orientations of the grains of polycrystal meshes.

  • FEThermalProblem — Steady linear heat conduction on a tetrahedral mesh, or with physics any other transport phenomenon of a scalar potential (TRANSPORT: "electrical", "dielectric", "magnetic", "diffusion"), with the coefficient of the materials for it; the phases whose coefficient is zero (insulators) are left out as pores.

  • FFTElasticProblem — Periodic linear elasticity of a voxel image (FFT-preconditioned CG); crystals are turned by the orientations of their grains (grains: label image).

  • FFTThermalProblem — Periodic steady heat conduction of a voxel image (FFT-preconditioned CG), or with physics any other transport phenomenon of a scalar potential (TRANSPORT: "electrical", "dielectric", "magnetic", "diffusion"), with the coefficient of the materials for it; the phases whose coefficient is zero (insulators) are voids.

  • Findley — Findley’s criterion (see the module): max_n [τ_a(n) + k σ_n,max(n)] <= limit; planes: the normals of the first search.

  • Frame — A periodic frame: nodes (positions in the cell), beams (node pairs), shifts (periods between the ends: beam k ends at nodes[j] + lattice @ shifts[k]), the lattice of the cell (vectors in the columns), EA and EI of each beam, the centre and generators (R, t) of its symmetry group, the area of the section of each beam (for the fibre volume per unit area), the transverse shear stiffness κGA of each beam: Timoshenko beams (None, the default: Euler–Bernoulli beams, rigid in shear) and the lengths of the rigid ends of each beam at its first and second node (m x 2; None, the default: none), which the effective stiffness alone takes.

  • Hyperelasticity — A hyperelastic law (see the module): model (HYPERELASTIC_MODELS) and its parameters — mu (neo-Hookean, Arruda-Boyce, eight chains, Gent, van der Waals, Fung, Holzapfel, Blatz-Ko), the coefficients cij of the polynomial of Rivlin (c10 and c01 of Mooney and Rivlin, with c11, c20, c02 and the terms of the third order for their forms of five and nine parameters; c10, c20, c30 of Yeoh; any cij up to the sixth order for polynomial), lock (the locking stretch of Arruda and Boyce, of the eight chains and of van der Waals; Jm of Gent), a and beta (van der Waals: the interaction of the chains, the share of the second invariant), b (Fung: the rate of the exponential), terms (Ogden and the hyperfoam: the pairs (mu_p, alpha_p); the shear modulus is sum_p mu_p alpha_p / 2 for Ogden, sum_p mu_p for the hyperfoam), k1, k2, kappa and fibres (Holzapfel: the stiffness and the rate of the families of fibres, their dispersion, their directions in the axes of the sample), f (Blatz-Ko: the share of the first invariant) — bulk, the bulk modulus of the volumetric energy, and volumetric (VOLUMETRIC: K/2 (J - 1)^2, K/2 (ln J)^2 or K/4 (J^2 - 1 - 2 ln J); the compressible laws, Blatz-Ko and the hyperfoam, take their Poisson’s ratio from the bulk modulus). mullins: the softening of Ogden and Roxburgh, (r, m, beta). The shear and bulk moduli not given are those of the material (young, poisson); given, they must agree with them (initial_moduli()), or the material takes those of the law.

  • LevelSetSample — A two-phase morphology on the nodes of a regular grid of a periodic box: values (nx x ny x nz), its level set at the nodes lower + (i, j, k) h (negative in the phase inside, positive in the phase outside; the node of index n along an axis is that of index 0, one period further).

  • Loading — Macroscopic loading.

  • LoadingPath — History of a macroscopic loading of elasticity.

  • Matake — Matake’s criterion (see the module): τ_a + k σ_n,max <= limit on the plane of the largest shear amplitude; planes: the normals of the first search.

  • Material — Linear material of a phase, or a void.

  • NTFAModel — 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).

  • NonlinearFEProblem — Nonlinear behaviours of the phases (von Mises elasto-(visco)plasticity, crystal plasticity) on a tetrahedral mesh, loaded along paths: periodic conditions (the periodic element, whose macroscopic strain components are degrees of freedom) or kinematic ones (kubc: u = E x on the boundary, E likewise), in small or finite strains (kinematics).

  • NonlinearFFTProblem — 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).

  • NonlinearXFEMProblem — Loading paths of a LevelSetSample with the nonlinear behaviours of its phases, by extended finite elements in small or finite strains (kinematics; see the module and NonlinearFEProblem for the options of the iterations): run() follows a LoadingPath. The linear problems of the sample are those of XFEMElasticProblem.

  • PathBifurcation — The analysis of a cell along a nonlinear loading path (path_bifurcation()). Besides the fields of Bifurcation (loads: the time at which the tangent of each irrep loses its positive definiteness, NaN when it does not; first: the earliest, its irrep and the number of modes that cross within that step; the patterns: the softest modes of the axial classes at that point): the times of the converged steps (from the natural state) and their macroscopic strains (the six components of the path), the lowest eigenvalues of the tangent in each isotypic subspace (steps x irreps x k, relative to the largest diagonal entry of its block in the natural state; NaN for the irreps absent from the fluctuations), the macroscopic strain at the first bifurcation, the response along the principal path (PathResult) and, after a switch of branch, the response of the cell perturbed along the critical pattern, with the times of its steps and the amplitude of that pattern in its fluctuation.

  • PathResult — Macroscopic response of a volume element (or of a material point) along a path.

  • PhaseStatistics — Volume fraction, means and standard deviations of the fields in one phase.

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

  • Response — Macroscopic response of a volume element to a named loading for one boundary condition: the macroscopic strain and stress (gradient and flux), prescribed or solved for.

  • Sines — Sines’ criterion (see the module): sqrt(J2)_a + alpha σ_H,mean <= beta, the mean of the hydrostatic stress being that of its extremes over the cycle.

  • Solution — Volume averages over the box of one solved problem.

  • SpaceFrame — A periodic frame of struts in space: nodes (positions in the cell), beams (node pairs), shifts (periods between the ends), the lattice of the cell (vectors in the columns), EA, EI, GJ and I_p / A of each strut, and the centre and generators (R, t) of its symmetry group, the area of the section of each strut (for the relative density), its transverse shear stiffness κGA: Timoshenko beams (None, the default: Euler–Bernoulli beams) and the lengths of its rigid ends at its first and second node (m x 2; None, the default: none), which the effective stiffness alone takes.

  • Viscoelasticity — A generalized Maxwell model (see the module): shear and bulk, the terms (g_i, tau_i) and (k_j, tau_j) of the Prony series of the shear and bulk relaxation moduli, relative to the instantaneous moduli of the material (each sum below 1; no bulk term: an elastic bulk response). wlf: the constants (C1, C2) of Williams, Landel and Ferry, log10 a_T = -C1 dT / (C2 + dT) for the change of temperature dT of the loading paths from their reference state; or arrhenius: the activation energy over the gas constant (K), ln a_T = arrhenius (1 / T - 1 / T_ref) with reference_temperature (K) that of the reference state.

  • XFEMElasticProblem — Periodic linear (thermo-)elasticity of a LevelSetSample by extended finite elements (see the module).

  • XFEMThermalProblem — Periodic steady conduction of a LevelSetSample by extended finite elements, or with physics any other transport phenomenon of a scalar potential (TRANSPORT).

  • absorption — The sound absorption of a layer of thickness (m) of a rigid porous frame on a rigid wall, at the frequencies (Hz): its absorption coefficient, surface_impedance and reflection coefficient, with the equivalent fluid of equivalent_fluid() (its parameters: those of along_axis() across the layer).

  • acoustic_parameters — The parameters of the equivalent fluid of a porous image (see the module): the pores are the void phases of materials, or the phases pores; the frame is rigid and motionless. Periodic images of cubic voxels.

  • apparent_bulk_modulus — The apparent bulk modulus of a problem under its boundary conditions (Apparent): under a hydrostatic strain, or a hydrostatic stress with static uniform conditions (subc); the fields of the solution with fields.

  • apparent_conductivity — The apparent conductivity of a problem along an axis (Apparent): under a gradient along it, or a flux with static uniform conditions (subc); the fields of the solution with fields. The problem of another transport phenomenon gives its property (TRANSPORT_PROPERTIES: the apparent electrical conductivity, permittivity, permeability or diffusivity).

  • apparent_shear_modulus — The apparent shear modulus of a problem in a plane (its two axes; Apparent): under a shear strain in it, or a shear stress with static uniform conditions (subc); the fields of the solution with fields.

  • band_structure — The lowest bands Bloch frequencies of a periodic cell (a TetMesh, or a VoxelImage cut into six tetrahedra per voxel, keeping phases) along path (corners of the Brillouin zone, points per segment; or an array of wave vectors; by default Γ–X–M–Γ–R, Γ–X–M–Γ in the plane of an image one voxel thick), with elements of order 1 or 2. The materials need a density; void phases are left out, as the clusters of elements that touch no face of the box. waves: "elastic" (the vector waves of the solid); the scalar waves of SCALAR_WAVES ("acoustic", and "shear", "tm", "te" in the plane of a cell invariant along z) with the coefficients of the materials (wave_coefficients(), scalar_band_structure()); or "electromagnetic", the vector waves of light in a voxel image of any morphology, by plane waves on its voxels or on a grid coarsen times coarser ( electromagnetic_band_structure(); order and phases do not apply).

  • boundary_condition — Canonical name of a boundary condition (accepts aliases such as ‘pbc’, ‘utg’).

  • bounds — All bounds for the phases present, keyed by property then bound name.

  • brillouin_path — Wave vectors along the segments between the corners path (names of POINTS or points in units of pi / L) of the Brillouin zone of a cell of edges size, points per segment: the wave vectors (n x 3), their distance along the path and the positions and names of the corners.

  • conductivity_tensor — Apparent conductivity tensor (3 x 3) from three gradient (or flux) loadings; that of the transport phenomenon of the problem (TRANSPORT_PROPERTIES).

  • coupled_problem — The CoupledProblem of a voxel image whose phases have the materials, for a coupling of COUPLINGS (the laws of coupled_law()). The crystals are turned by the orientations of their grains (grains: the label of each voxel, orientations: their Bunge angles), as in the other problems; temperature: the mean temperature of a thermoelectric law (K).

  • coupled_tensors — The effective tensors of a coupling (COUPLINGS) of a periodic voxel image: those of split_law() for its effective law ("tensor": the law itself), the iterations and the largest residual of the solver ("iterations", "residual") and, with thermal (by default: when a phase expands or is pyroelectric), the effective thermal flux ("thermal_stress": beta* = C* alpha*, Voigt; "thermal_expansion": alpha* at constant field, 3 x 3; "pyroelectric": p* at constant strain and field). See coupled_problem() for the options.

  • electromagnetic_band_structure — The lowest bands frequencies of the electromagnetic Bloch waves of a periodic cell (a VoxelImage of phases) along path (corners of the Brillouin zone, points per segment; or an array of wave vectors), by plane waves (see the module): permittivity, that of each phase (a number, three principal values or a 3 x 3 tensor in the axes of the cell), and permeability (a number for the whole cell, or those of the phases likewise). coarsen: the plane waves on a grid that many times coarser than the voxels, whose cells cut by the interfaces take the averaged tensor of Meade et al. (isotropic phases). tol: the residual of the bands, in units of the square of the first reciprocal vector (the squares of the frequencies are then within about its square). Returns a BandStructure; at the centre of the zone the first two frequencies are zero (the uniform fields).

  • equivalent_fluid — The equivalent fluid of a rigid porous frame at the frequencies (Hz), by the model of Johnson, Champoux, Allard and Lafarge (see the module; SI units: lengths in metres, permeabilities in square metres): its complex density and bulk_modulus (time dependence exp(i omega t)), its characteristic impedance and wavenumber, and the resistivity eta / k0 (Pa s/m²). Without thermal_permeability, that of circular pores, phi Lambda'^2 / 8.

  • fatigue — The fatigue of points along a cycle of stresses (history: steps x … x 6): a FatigueResult. criterion: one criterion for all the points, or a mapping of the phases to their criteria (or to mappings of them: criterion_from_config()), with phases the phase of each point; the points of the other phases are not judged.

  • fit_hyperelasticity — The parameters of a hyperelastic model fitted to tests of an incompressible rubber: tests maps the modes (TESTS) to their (stretches, nominal stresses) (shear: the amounts of shear and the shear stresses), fitted together by least squares on the stresses (relative: on their ratios to the measures, which weighs the small strains as the large ones). The polynomials of Rivlin (mooney_rivlin with the coefficients of start, by default c10 and c01; yeoh; polynomial) are linear in their coefficients: one linear solve. The others start from start (by default from the slope of the first points) and keep the parameters fixed; ogden: terms pairs. Returns the law (its bulk modulus, that of the material, is not fitted: the tests are those of an incompressible solid); options go to scipy.optimize.least_squares().

  • homogenize — Apparent properties of sample for every pair (property, boundary condition).

  • isotropic_projection — Bulk and shear moduli of the isotropic part of a Voigt stiffness matrix.

  • isotropy_errors — Relative deviations from isotropy of a Voigt stiffness (Dirrenberger 2014, 5.1.4).

  • long_wavelength_speeds — The speeds of the scalar waves of a periodic cell at long wavelengths, those of the homogenized medium: c_i = sqrt(a*_ii / <b>) along each axis, with the effective tensor a* of the coefficient a (a conduction problem: the FFT solver of a voxel image, finite elements on a mesh) and the mean of b (over the whole cell, the phases left out included: they hold no wave). Returns "tensor" (a*, 3 x 3), "mass" (<b>) and "speeds" (3,). For the sound of a mixture of fluids this is Wood’s law (1 / K* = <1 / K>) with the effective density (a*)^-1; for light, c / n*. options: those of make_problem().

  • make_problem — Boundary-value problem of a sample for physics ‘elastic’, ‘thermal’ or another transport phenomenon of a scalar potential ( TRANSPORT: ‘electrical’, ‘dielectric’, ‘magnetic’, ‘diffusion’), which the thermal problems solve with the coefficient of the materials for it.

  • materials_from_config — Phase -> material mapping from a configuration mapping (keys may be strings).

  • path_beremin — The criterion of Beremin along a loading path: result, a PathResult that kept its fields (fields="steps", or the times wanted); criterion: a Beremin or its mapping; orientations: the Bunge angles of the crystals of the points of the fields (those of the grains of the elements of a mesh, of the voxels of an image), for the normal stress of their cleavage planes (none: crystals in the axes of the sample). Where the fields of the path have the orientation of the lattices at each time (those that their twins turn; finite strains), the planes are those of the lattices as they are then. The stresses are those of the fields (Cauchy’s in finite strains), the volumes those of the elements of a mesh (the points of an image weigh the same).

  • path_bifurcation — The bifurcations of a periodic cell along a nonlinear loading path (see the module): a tetrahedral mesh or a voxel image (six tetrahedra per voxel, keeping phases; elements of order 1 or 2) of cells primitive cells, its materials (elastic, von Mises elasto-(visco)plastic, crystal or MFront behaviours), the path (LoadingPath or its mapping) followed by NonlinearFEProblem with periodic conditions in kinematics (options: its options; the tangents of the points symmetrized unless they say otherwise, tangent="symmetric": the analysis is that of the symmetric part). The tangent of each converged step is block-diagonalized in the isotypic subspaces of the group of the cell restricted to the path; the eigenvalues lowest eigenvalues of each block (times the dimension of its irrep) are followed, and the first that changes sign marks a bifurcation. stop: the principal path ends at the first bifurcation. branch: the amplitude (a fraction of the smallest edge of the box; about 0.01 to 0.02, a smaller one making the transition so abrupt that Newton’s method may fall back onto the principal branch) of an imperfection of the nodes along the critical pattern, with which the path is followed again onto the bifurcated branch.

  • path_fatigue — The fatigue of the points of a cell along a cycle of a loading path: result, a PathResult that kept its fields at the steps of the cycle (fields="steps"); criterion: as for fatigue(), the phases being those of the support of the fields; cycle: the times of its start and of its end (by default the whole path). The stresses are those of the fields (Cauchy’s in finite strains).

  • permeability_tensor — The permeability tensor of a periodic voxel image (see the module): one flow per axis of axes (the others are left out: their rows and columns zero), symmetrized.

  • poroelastic_tensors — The poroelastic law of a porous sample (voxel image, conforming mesh or level set; its pores: the void phases), under periodic or kinematic uniform (kubc) conditions.

  • post_bifurcation — The post-bifurcated patterns of a periodic cell (see the module): a Frame (plane) or SpaceFrame, or a continuum given by its tetrahedral mesh or voxel image (six tetrahedra per voxel, keeping phases; elements of order 1 or 2) and materials. strain is the macroscopic loading (2 x 2 or 3 x 3) whose symmetry restricts the group and whose linear buckling orders the bifurcations; group by default that of the frame’s generators, or that detected on the mesh of cells primitive cells (mesh_symmetries()). bloch: split a cell of two primitive cells along some axes by its translations first (by default beyond DENSE_LIMIT dofs); patterns: those of all the irreps present ("all", the default without bloch) or of the irreps of the first bifurcation ("critical", the default with it).

  • scalar_band_structure — The lowest bands Bloch frequencies of the scalar waves div(a grad u) + ω² b u = 0 of a periodic cell (mesh or voxel image, as band_structure()): a the stiffness coefficient of each phase and b its mass coefficient (the table of the module: acoustic, antiplane shear and electromagnetic waves). The phases whose a is zero are left out (rigid scatterers), their boundaries free of flux.

  • simulate_point — Response of one material point (homogeneous strain and stress) to a loading path: the components prescribed as stresses are solved for by Newton’s method with the consistent tangent (a material point simulator, as Zsim). orientation: Bunge angles (degrees) of a crystal; kinematics: "small" or "finite" strains (the strain then holds the components of the upper triangular displacement gradient, the stress those of the first Piola-Kirchhoff stress). In finite strains, and where its twins turn it, the result has the orientation of the lattice of a crystal at each step: its Bunge angles g R_e^T, with the rotation R_e of the polar decomposition of F_e (the material lines along the first axis stay along it, and the planes normal to the third stay normal to it: the grips of a tension along the first axis, the platens of a compression along the third). tangent (TANGENTS): Newton’s method solves a dense system, with by default ("auto") the exact tangents of the laws that are not symmetric (those of the learned laws and of the MFront behaviours too) and the symmetrized ones of the others (which only lose their round-off); "symmetric" symmetrizes them all, "full" keeps them all exact.

  • stiffness_tensor — Apparent stiffness (6 x 6, Voigt order 11 22 33 23 31 12) from six loadings.

  • stokes_flow — The creeping flow through the pores of a periodic image driven along direction (see the module). pores: the phases of the fluid (by default the void phases of materials); tol: the relative error of the mean velocity at which the march to the steady state stops; max_steps: at most that many steps (by default 200 times the largest size of the image in voxels, at least 20000); relaxation: the time tau+ (viscosity (tau+ - 1/2) / 3 of the lattice: the steady flow does not depend on it, the number of steps does); fields: keep the velocity field.

  • stress_amplitude — The amplitude and the mean of the deviator of a cycle of stresses (history: steps x … x 6): sqrt(J2)_a, the radius of the smallest hypersphere that holds the path of the deviator (norm sqrt(s : s / 2); to the relative accuracy tol), and its centre, the mean deviator (… x 6).

  • surface_absorption — The absorption coefficient of a surface of normal impedance (a number or an array; a locally reacting surface) for a plane wave at the angle incidence from its normal (radians), 1 - |(Z cos θ - Z0) / (Z cos θ + Z0)|², or in a diffuse field (incidence="diffuse"): Paris’ average ∫ α(θ) sin 2θ dθ over the angles up to limit (by default π/2), normalized. For a real impedance Z = ζ Z0 it is 8 / ζ² (1 + ζ - 1 / (1 + ζ) - 2 ln(1 + ζ)).

  • swelling_tensor — Apparent swelling tensor (3 x 3) of a sample and the solution that gives it: the macroscopic strain of a unit content of the absorbed species under zero macroscopic stress, with the swelling of the materials (E = S : Sigma + B c). options: those of make_problem() (solver, tol, maxiter, grains, orientations, device).

  • thermal_expansion — Apparent thermal expansion tensor (3 x 3): the macroscopic strain of a unit change of temperature under zero macroscopic stress (E = S : Sigma + A dT).

  • train_ntfa — 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.

Modules