Skip to main content

Module dispersion

Module dispersion 

Source
Expand description

Kramers-Kronig causality & passivity verification, Brillouin dispersive energy density, complex wave propagation parameters, and instantaneous vs phasor Poynting/energy relations.

Structs§

EmWavePropagation
Wave propagation quantities at angular frequency $\omega > 0$ in a homogeneous isotropic medium.
InstantaneousOrPhasorFieldState
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).
KramersKronigReport
Summary report of Kramers-Kronig causality and passivity verification across a frequency grid.

Enums§

DispersionError
Errors detected during Kramers-Kronig causality, passivity, or dispersive energy checks.
EmAmplitudeConvention
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 model across interior test frequencies eval_omegas_rad_s using 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.