morphogen.homogenization.harmonic¶
Harmonic (frequency-domain) homogenization of periodic voxel images: effective properties of phases whose laws are complex, in the quasi-static regime where the wavelengths are much longer than the microstructure.
A harmonic excitation exp(i omega t) of linear dissipative phases has complex laws:
viscoelastic solids (the correspondence principle): the complex moduli
K*(omega)andG*(omega)of the Prony series of each phase (Viscoelasticity) give the effective complex stiffnessC*(omega) = C' + i C'': storage and loss moduli, loss factors (dynamic_stiffness());conductors and dielectrics (quasi-static electromagnetism): the complex conductivity
sigma* = sigma + i omega epsof each phase gives the effective conductivity and permittivity of the composite at each frequency, with the interfacial polarization of Maxwell, Wagner and Sillars where conducting inclusions charge their interfaces (complex_conductivity());optics in the long-wavelength limit: the complex permittivities
(n + i k)^2of the phases at a wavelength give the effective permittivity tensor of the composite, its refractive indices and its absorption (form birefringence, effective media of nanocomposites:effective_index()).
All are the same problem (harmonic_tensor()): the periodic problem of a field with
a complex symmetric law L = L' + i L'', whose real form doubles the field,
[ L’ -L’’] [Z’] [ S’] [-L’’ -L’ ] [Z’’] = [-S’’],
a real symmetric law that is not definite, solved by the coupled solver of
morphogen.homogenization.coupled (MINRES preconditioned in Fourier space) for the
unit real loadings. The laws are first turned by a phase exp(i theta) that centres
them about the real axis, so that their real parts are positive definite whenever the
laws of the phases lie in an open half of the complex plane (dielectrics and metals of
negative permittivity together, lossy phases with lossless ones). The effective tensors
are complex symmetric; laminate() gives those of
layers exactly.
- morphogen.homogenization.harmonic.harmonic_tensor(image: VoxelImage, laws, mat, layout=('potential',), *, tol: float = 1e-08, maxiter: int | None = None)[source]¶
The effective complex symmetric tensor of a periodic voxel image whose materials have the complex symmetric laws
laws[m](the components of thelayoutof fields: 3 x 3 for a potential, 6 x 6 in the Voigt order for a displacement),matthe material of each voxel (-1: none); see the module. Returns the tensor and theCoupledProblemsolved (its iterations).
- class morphogen.homogenization.harmonic.HarmonicResponse(kind: str, frequencies: ndarray, tensors: ndarray, iterations: ndarray)[source]¶
Bases:
objectThe effective complex tensors of a sample at angular
frequencies(rad per unit time; wavelengths foreffective_index()):tensors(frequencies x d x d, complex symmetric; 6 x 6 in the Voigt order 11 22 33 23 31 12 with engineering shears for a stiffness, 3 x 3 for a transport), thekindof the law ("stiffness","conductivity"or"permittivity") and the iterations of the solver at each frequency.- property storage: ndarray¶
The real parts of the tensors (the storage moduli of a stiffness).
- property loss: ndarray¶
The imaginary parts of the tensors (the loss moduli of a stiffness).
- property bulk: ndarray¶
The complex bulk moduli of the isotropic parts of the stiffnesses.
- property shear: ndarray¶
The complex shear moduli of the isotropic parts of the stiffnesses.
- young(axis: int = 0) ndarray[source]¶
The complex Young’s moduli along an axis:
1 / S*_iiof the compliances.
- static loss_factor(modulus) ndarray[source]¶
tan delta: the loss over the storage of complex moduli.
- property conductivity: ndarray¶
The effective conductivity tensors (the real parts of
sigma*).
- property permittivity: ndarray¶
Im(sigma*) / omegaof a complex conductivity; the complex tensors themselves foreffective_index().- Type:
The effective permittivity tensors
- property index: ndarray¶
The complex refractive indices
n + i kalong the three axes (frequencies x 3): the square roots of the diagonal of the permittivity tensors (non-magnetic media;k >= 0: absorption).
- property absorption: ndarray¶
The absorption coefficients
4 pi k / lambdaalong the three axes, for the wavelengths ofeffective_index()(the inverse of their unit).
- to_dict() dict[source]¶
The response as plain arrays (for JSON) and the scalar
entries(): thefrequencies(wavelengthsof a permittivity), thestorageandlossparts of the tensors, theiterations; of a conductivity, itsconductivityandpermittivitytensors; of a permittivity, theindex,extinctionandabsorptionalong the axes.
- entries() dict[str, float][source]¶
Scalar entries for the tables of results, the frequencies numbered from 1: of a stiffness
bulk_storage_1,bulk_loss_1,shear_storage_1,shear_loss_1,shear_tan_delta_1,young_storage_1,young_loss_1(along x); of a conductivityconductivity_1,permittivity_1(the means of their diagonals); of a permittivityindex_1,extinction_1(the means ofnandk).
- morphogen.homogenization.harmonic.KINDS = {'complex_conductivity': 'conductivity', 'dynamic_stiffness': 'stiffness', 'refractive_index': 'permittivity'}¶
The kind of the tensors of each harmonic property
- morphogen.homogenization.harmonic.entry_names(prop: str, count: int) tuple[str, ...][source]¶
The names of the scalar entries (
HarmonicResponse.entries()) of a harmonic property (dynamic_stiffness,complex_conductivity,refractive_index) atcountfrequencies or wavelengths, numbered from 1: the columns of the tables of results and the quantities of the statistics of RVE studies.
- morphogen.homogenization.harmonic.dynamic_stiffness(image: VoxelImage, materials: dict[int, Material], frequencies, *, dtemp: float = 0.0, grains=None, orientations=None, tol: float = 1e-08, maxiter: int | None = None) HarmonicResponse[source]¶
The effective complex stiffness of a periodic voxel image at the angular
frequencies(rad per unit time): the phases with aviscoelasticityhave the complex moduli of their Prony series (at the change of temperaturedtempfrom their reference: their shifted times), the others their elasticity (crystals turned by the orientations of theirgrains).HarmonicResponse: the storage and loss stiffnesses, the complex bulk, shear and Young’s moduli, the loss factors.
- morphogen.homogenization.harmonic.complex_conductivity(image: VoxelImage, materials: dict[int, Material], frequencies, *, grains=None, orientations=None, tol: float = 1e-08, maxiter: int | None = None) HarmonicResponse[source]¶
The effective complex conductivity
sigma*(omega)of a periodic voxel image at the angularfrequencies: each phase hassigma* = sigma + i omega epsof itselectrical_conductivityandpermittivity(either may be missing or zero: a perfect insulator, a conductor without polarization).HarmonicResponse: the effective conductivityRe(sigma*)and permittivityIm(sigma*) / omegaat each frequency (the dispersion of Maxwell, Wagner and Sillars).
- morphogen.homogenization.harmonic.effective_index(image: VoxelImage, indices: dict, wavelengths=1.0, *, tol: float = 1e-08, maxiter: int | None = None) HarmonicResponse[source]¶
The effective permittivity of a periodic voxel image in the long-wavelength (quasi-static) limit of optics:
indicesmaps each phase to its complex refractive indexn + i k(one value, or one per wavelength;k > 0: absorption; or aMaterialwith arefractive_index) and the permittivity of each phase is(n + i k)^2.HarmonicResponse(itsfrequenciesare thewavelengths): the complex permittivity tensors, the refractive indices along the axes and the absorption coefficients4 pi k / lambda. Valid while the wavelengths are much longer than the microstructure; resonances of its size (photonic bands) are those ofmorphogen.homogenization. waves.