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 thewavevectors, theirdistancealong the path and the positions and names of its corners (labels).Beremin— The criterion of Beremin (1983): themodulusmof Weibull, thescalesigma_uof the cleavage stresses of the referencevolumeV_0.planes: the cleavage planes of the crystals of the points, whose largest normal stress drives the cleavage (none: the largest principal stress), withc_over_afor 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,meshis the analysed mesh andliftmaps the dofs of its master nodes to all its nodes.CoupledProblem— Periodic problem of the coupled fields of alayout(FIELDS) on a voxel image:laws[m]is the symmetric lawS = L Zof the materialm(the components of the layout),matthe material of each voxel (-1: none, a void) andeigen[m]its fluxlambdaper 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 epsat 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 fieldE = s grad Tat zero current, V/K) andpyroelectric(p, 3 components:D = p dTat 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, seePARAMS) and the interaction matrix ((): uniform;(h_self, h_latent); the six coefficients ofINTERACTIONSfor the octahedral family; or a full matrix).twins: families of twins (TWINS) with the same parameters, which shear in one sense until the fractiontwin_saturationof 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 ofHEXAGONAL). 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 strainthreshold(or at the uniaxial stressstrength: the threshold isstrength / E) and grows by thesofteninglaw (SOFTENINGS) up to the equivalent strainultimate(linear: no stress beyond it; exponential: the stress decays asexp(-(kappa - kappa_0) / (ultimate - kappa_0))), or so that a band of the widthlength(the size of the elements) dissipates thefracture_energyper unit area.equivalent: the equivalent strain (EQUIVALENT_STRAINS), withratiothe 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 withphysicsany 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 withphysicsany 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: beamkends atnodes[j] + lattice @ shifts[k]), thelatticeof the cell (vectors in the columns),EAandEIof 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κGAof 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 itsparameters—mu(neo-Hookean, Arruda-Boyce, eight chains, Gent, van der Waals, Fung, Holzapfel, Blatz-Ko), the coefficientscijof the polynomial of Rivlin (c10andc01of Mooney and Rivlin, withc11,c20,c02and the terms of the third order for their forms of five and nine parameters;c10,c20,c30of Yeoh; anycijup to the sixth order forpolynomial),lock(the locking stretch of Arruda and Boyce, of the eight chains and of van der Waals;Jmof Gent),aandbeta(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 issum_p mu_p alpha_p / 2for Ogden,sum_p mu_pfor the hyperfoam),k1,k2,kappaandfibres(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, andvolumetric(VOLUMETRIC:K/2 (J - 1)^2,K/2 (ln J)^2orK/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 nodeslower + (i, j, k) h(negative in the phaseinside, positive in the phaseoutside; the node of indexnalong 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 <= limiton 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 relationsSigma = L E + rho^T xiandtau = 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 xon the boundary,Elikewise), 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 aLevelSetSamplewith the nonlinear behaviours of its phases, by extended finite elements in small or finite strains (kinematics; see the module andNonlinearFEProblemfor the options of the iterations):run()follows aLoadingPath. The linear problems of the sample are those ofXFEMElasticProblem.PathBifurcation— The analysis of a cell along a nonlinear loading path (path_bifurcation()). Besides the fields ofBifurcation(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), thelatticeof the cell (vectors in the columns),EA,EI,GJandI_p / Aof 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):shearandbulk, 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; nobulkterm: 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 temperaturedTof the loading paths from their reference state; orarrhenius: the activation energy over the gas constant (K),ln a_T = arrhenius (1 / T - 1 / T_ref)withreference_temperature(K) that of the reference state.XFEMElasticProblem— Periodic linear (thermo-)elasticity of aLevelSetSampleby extended finite elements (see the module).XFEMThermalProblem— Periodic steady conduction of aLevelSetSampleby extended finite elements, or withphysicsany other transport phenomenon of a scalar potential (TRANSPORT).absorption— The sound absorption of a layer ofthickness(m) of a rigid porous frame on a rigid wall, at thefrequencies(Hz): itsabsorptioncoefficient,surface_impedanceandreflectioncoefficient, with the equivalent fluid ofequivalent_fluid()(itsparameters: those ofalong_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 ofmaterials, or the phasespores; 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 withfields.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 withfields. 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 withfields.band_structure— The lowestbandsBloch frequencies of a periodic cell (aTetMesh, or aVoxelImagecut into six tetrahedra per voxel, keepingphases) alongpath(corners of the Brillouin zone,pointsper 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 oforder1 or 2. The materials need adensity; 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 ofSCALAR_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 gridcoarsentimes coarser (electromagnetic_band_structure();orderandphasesdo 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 cornerspath(names ofPOINTSor points in units ofpi / L) of the Brillouin zone of a cell of edgessize,pointsper 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— TheCoupledProblemof a voxel image whose phases have thematerials, for a coupling ofCOUPLINGS(the laws ofcoupled_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 ofsplit_law()for its effective law ("tensor": the law itself), the iterations and the largest residual of the solver ("iterations","residual") and, withthermal(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). Seecoupled_problem()for the options.electromagnetic_band_structure— The lowestbandsfrequencies of the electromagnetic Bloch waves of a periodic cell (aVoxelImageof phases) alongpath(corners of the Brillouin zone,pointsper 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), andpermeability(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 aBandStructure; 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 thefrequencies(Hz), by the model of Johnson, Champoux, Allard and Lafarge (see the module; SI units: lengths in metres, permeabilities in square metres): its complexdensityandbulk_modulus(time dependenceexp(i omega t)), its characteristicimpedanceandwavenumber, and theresistivityeta / k0(Pa s/m²). Withoutthermal_permeability, that of circular pores,phi Lambda'^2 / 8.fatigue— The fatigue of points along a cycle of stresses (history: steps x … x 6): aFatigueResult.criterion: one criterion for all the points, or a mapping of the phases to their criteria (or to mappings of them:criterion_from_config()), withphasesthe phase of each point; the points of the other phases are not judged.fit_hyperelasticity— The parameters of a hyperelasticmodelfitted to tests of an incompressible rubber:testsmaps 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_rivlinwith the coefficients ofstart, by defaultc10andc01;yeoh;polynomial) are linear in their coefficients: one linear solve. The others start fromstart(by default from the slope of the first points) and keep the parametersfixed;ogden:termspairs. Returns the law (its bulk modulus, that of the material, is not fitted: the tests are those of an incompressible solid);optionsgo toscipy.optimize.least_squares().homogenize— Apparent properties ofsamplefor 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 tensora*of the coefficienta(a conduction problem: the FFT solver of a voxel image, finite elements on a mesh) and the mean ofb(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 ofmake_problem().make_problem— Boundary-value problem of a sample forphysics‘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, aPathResultthat kept its fields (fields="steps", or the times wanted);criterion: aBereminor 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 theorientationof 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, keepingphases; elements oforder1 or 2) ofcellsprimitive cells, itsmaterials(elastic, von Mises elasto-(visco)plastic, crystal or MFront behaviours), thepath(LoadingPathor its mapping) followed byNonlinearFEProblemwith periodic conditions inkinematics(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; theeigenvalueslowest 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, aPathResultthat kept its fields at the steps of the cycle (fields="steps");criterion: as forfatigue(), 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 ofaxes(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): aFrame(plane) orSpaceFrame, or a continuum given by its tetrahedral mesh or voxel image (six tetrahedra per voxel, keepingphases; elements oforder1 or 2) andmaterials.strainis the macroscopic loading (2 x 2 or 3 x 3) whose symmetry restricts the group and whose linear buckling orders the bifurcations;groupby default that of the frame’s generators, or that detected on the mesh ofcellsprimitive cells (mesh_symmetries()).bloch: split a cell of two primitive cells along some axes by its translations first (by default beyondDENSE_LIMITdofs);patterns: those of all the irreps present ("all", the default withoutbloch) or of the irreps of the first bifurcation ("critical", the default with it).scalar_band_structure— The lowestbandsBloch frequencies of the scalar wavesdiv(a grad u) + ω² b u = 0of a periodic cell (mesh or voxel image, asband_structure()):athestiffnesscoefficient of each phase andbitsmasscoefficient (the table of the module: acoustic, antiplane shear and electromagnetic waves). The phases whoseais 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, asZsim).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 theorientationof the lattice of a crystal at each step: its Bunge anglesg R_e^T, with the rotationR_eof the polar decomposition ofF_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 alongdirection(see the module).pores: the phases of the fluid (by default the void phases ofmaterials);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 timetau+(viscosity(tau+ - 1/2) / 3of 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 (normsqrt(s : s / 2); to the relative accuracytol), and its centre, the mean deviator (… x 6).surface_absorption— The absorption coefficient of a surface of normalimpedance(a number or an array; a locally reacting surface) for a plane wave at the angleincidencefrom 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 tolimit(by default π/2), normalized. For a real impedanceZ = ζ Z0it is8 / ζ² (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 theswellingof the materials (E = S : Sigma + B c).options: those ofmake_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 trainingpaths(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.
Modules¶
- morphogen.homogenization.acoustics
- morphogen.homogenization.amg
- morphogen.homogenization.apparent
- morphogen.homogenization.behaviours
- morphogen.homogenization.beremin
- morphogen.homogenization.bifurcation
- morphogen.homogenization.bloch
- morphogen.homogenization.bounds
- morphogen.homogenization.core
- morphogen.homogenization.coupled
- morphogen.homogenization.crystal
- morphogen.homogenization.dilatation
- morphogen.homogenization.elements
- morphogen.homogenization.fatigue
- morphogen.homogenization.fe
- morphogen.homogenization.fenicsx
- morphogen.homogenization.fft
- morphogen.homogenization.fft_nonlinear
- morphogen.homogenization.finite
- morphogen.homogenization.flow
- morphogen.homogenization.frames
- morphogen.homogenization.gpu
- morphogen.homogenization.harmonic
- morphogen.homogenization.identification
- morphogen.homogenization.kernels
- morphogen.homogenization.laws
- morphogen.homogenization.materials
- morphogen.homogenization.mfront
- morphogen.homogenization.networks
- morphogen.homogenization.nonlinear
- morphogen.homogenization.ntfa
- morphogen.homogenization.paths
- morphogen.homogenization.photonic
- morphogen.homogenization.poroelastic
- morphogen.homogenization.porous
- morphogen.homogenization.postprocess
- morphogen.homogenization.solvers
- morphogen.homogenization.tensors
- morphogen.homogenization.voxel_fe
- morphogen.homogenization.xfem
- morphogen.homogenization.zmat