Expand description
Kramers-Kronig causality & passivity verification, Brillouin dispersive energy density, complex wave propagation parameters, and instantaneous vs phasor Poynting/energy relations.
Structs§
- EmWave
Propagation - Wave propagation quantities at angular frequency $\omega > 0$ in a homogeneous isotropic medium.
- Instantaneous
OrPhasor Field State - Instantaneous or cycle-averaged Poynting flux $\mathbf{S}$ ($\text{W}\cdot\text{m}^{-2}$) and
nondispersive energy density $u$ ($\text{J}\cdot\text{m}^{-3}$) for EMF Mode 0 (
0x0100). - Kramers
Kronig Report - Summary report of Kramers-Kronig causality and passivity verification across a frequency grid.
Enums§
- Dispersion
Error - Errors detected during Kramers-Kronig causality, passivity, or dispersive energy checks.
- EmAmplitude
Convention - Representation profile for harmonic or instantaneous field observations (C02-C02 / Mode 0).
Functions§
- evaluate_
brillouin_ energy_ density_ j_ per_ m3 - Evaluate Brillouin time-averaged stored dispersive electromagnetic energy density (in $\text{J}\cdot\text{m}^{-3}$) for peak-phasor electric field amplitude $|\mathbf{E}{\text{peak}}|$ ($\text{V}\cdot\text{m}^{-1}$) and magnetic field amplitude $|\mathbf{H}{\text{peak}}|$ ($\text{A}\cdot\text{m}^{-1}$): $$u_{\text{Brillouin}}(\omega) = \frac{1}{4}\frac{\partial(\omega\operatorname{Re}\varepsilon(\omega))}{\partial\omega}|\mathbf{E}{\text{peak}}|^2 + \frac{1}{4}\frac{\partial(\omega\operatorname{Re}\mu(\omega))}{\partial\omega}|\mathbf{H}{\text{peak}}|^2$$
- evaluate_
isotropic_ eb_ state - Evaluate $\mathbf{H} = \mathbf{B}/\mu$, Poynting flux $\mathbf{S}$, and energy density $u$
from $\mathbf{E}$ ($\text{V}\cdot\text{m}^{-1}$) and $\mathbf{B}$ ($\text{T}$) under an explicit
EmAmplitudeConvention(PeakPhasor includes $1/2$, RmsPhasor and InstantaneousSnapshot do not). - evaluate_
wave_ propagation - Compute wave impedance, refractive index, wavenumber, phase speed, attenuation, and wavelength. Rejects zero or negative frequency per C02-C02 (“never evaluate $c/f$ at zero”).
- kramers_
kronig_ im_ from_ re - Reconstruct $\operatorname{Im}\chi(\omega)$ from $\operatorname{Re}\chi(\omega’)$ via the inverse Kramers-Kronig Cauchy principal value integral over $[\omega_{\min}, \omega_{\max}]$: $$\operatorname{Im}\chi(\omega) = -\frac{2\omega}{\pi}\mathcal{P}\int_{\omega_{\min}}^{\omega_{\max}} \frac{\operatorname{Re}\chi(\omega’) - \operatorname{Re}\chi(\omega)}{\omega’^2 - \omega^2},d\omega’ - \frac{\operatorname{Re}\chi(\omega)}{\pi}\ln\left|\frac{\omega_{\max}-\omega}{\omega_{\max}+\omega}\cdot\frac{\omega_{\min}+\omega}{\omega_{\min}-\omega}\right|$$
- kramers_
kronig_ re_ from_ im - Reconstruct $\operatorname{Re}\chi(\omega)$ from $\operatorname{Im}\chi(\omega’)$ via the Kramers-Kronig Cauchy principal value integral over $[\omega_{\min}, \omega_{\max}]$ using analytical singularity subtraction: $$\operatorname{Re}\chi(\omega) = \frac{2}{\pi}\int_{\omega_{\min}}^{\omega_{\max}} \frac{\omega’\operatorname{Im}\chi(\omega’) - \omega\operatorname{Im}\chi(\omega)}{\omega’^2 - \omega^2},d\omega’ + \frac{\operatorname{Im}\chi(\omega)}{\pi}\ln\left|\frac{\omega_{\max}-\omega}{\omega_{\max}+\omega}\cdot\frac{\omega_{\min}+\omega}{\omega_{\min}-\omega}\right|$$
- verify_
kramers_ kronig_ consistency - Perform a full Kramers-Kronig causality and passivity verification on
modelacross interior test frequencieseval_omegas_rad_susing integration domain[omega_min, omega_max]. - verify_
passivity_ on_ grid - Verify thermodynamic passivity ($\omega\operatorname{Im}\varepsilon(\omega) \ge 0$ and $\omega\operatorname{Im}\mu(\omega) \ge 0$) at every point on a strictly positive frequency grid.