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) and G*(omega) of the Prony series of each phase (Viscoelasticity) give the effective complex stiffness C*(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 eps of 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)^2 of 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 the layout of fields: 3 x 3 for a potential, 6 x 6 in the Voigt order for a displacement), mat the material of each voxel (-1: none); see the module. Returns the tensor and the CoupledProblem solved (its iterations).

class morphogen.homogenization.harmonic.HarmonicResponse(kind: str, frequencies: ndarray, tensors: ndarray, iterations: ndarray)[source]

Bases: object

The effective complex tensors of a sample at angular frequencies (rad per unit time; wavelengths for effective_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), the kind of 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*_ii of 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*) / omega of a complex conductivity; the complex tensors themselves for effective_index().

Type:

The effective permittivity tensors

property index: ndarray

The complex refractive indices n + i k along 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 / lambda along the three axes, for the wavelengths of effective_index() (the inverse of their unit).

to_dict() → dict[source]

The response as plain arrays (for JSON) and the scalar entries(): the frequencies (wavelengths of a permittivity), the storage and loss parts of the tensors, the iterations; of a conductivity, its conductivity and permittivity tensors; of a permittivity, the index, extinction and absorption along 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 conductivity conductivity_1, permittivity_1 (the means of their diagonals); of a permittivity index_1, extinction_1 (the means of n and k).

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) at count frequencies 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 a viscoelasticity have the complex moduli of their Prony series (at the change of temperature dtemp from their reference: their shifted times), the others their elasticity (crystals turned by the orientations of their grains). 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 angular frequencies: each phase has sigma* = sigma + i omega eps of its electrical_conductivity and permittivity (either may be missing or zero: a perfect insulator, a conductor without polarization). HarmonicResponse: the effective conductivity Re(sigma*) and permittivity Im(sigma*) / omega at 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: indices maps each phase to its complex refractive index n + i k (one value, or one per wavelength; k > 0: absorption; or a Material with a refractive_index) and the permittivity of each phase is (n + i k)^2. HarmonicResponse (its frequencies are the wavelengths): the complex permittivity tensors, the refractive indices along the axes and the absorption coefficients 4 pi k / lambda. Valid while the wavelengths are much longer than the microstructure; resonances of its size (photonic bands) are those of morphogen.homogenization. waves.