Skip to main content

Module maxwell_emf

Module maxwell_emf 

Expand description

etalon_sim::maxwell_emf — 3D Continuum Maxwell Vector Calculus, Cartesian Yee FDTD, Dispersive ADE Media, Poynting Energy Balance, and C02 Electromagnetic Oracles.

Pure dependency-free (core/std + bytemuck) continuum electromagnetic simulation substrate consumed by qualia_core_db::q42::emf_operators.

Modules§

cpml_restart
3D Roden-Gedney Convolutional PML (CPML) Stretched-Coordinate Boundary & Multi-Pole Debye/Drude/Lorentz ADE Coupled Leapfrog Stepper with Bitwise Restart (Schema 103 Keys 26/29).
dispersion_ade
Debye, Drude, and Lorentz Auxiliary Differential Equation (ADE) Dispersive Media Operators (etalon-sim).
poynting_energy
Poynting Theorem, Spatiotemporal Collocation, and C02 Mode 0/1/3/4/5/6/7 Oracles (etalon-sim).
vector_calculus
3D Staggered & Collocated Electromagnetic Vector Calculus Operators (etalon-sim).
yee_fdtd
3D Cartesian Yee FDTD Solver, CFL Gate, and Discrete Dispersion Oracle (etalon-sim).

Structs§

AdePoleAuxiliaryState
CpmlAdeState
CpmlAxisCoeffs
CpmlGradingSpec
DebyePole
Single-pole Debye relaxation parameters: $$\tau_p \frac{d\mathbf{P}_p}{dt} + \mathbf{P}_p = \varepsilon_0 \Delta\varepsilon_p \mathbf{E}$$
DrudePole
Drude conduction / cold-plasma pole parameters: $$\frac{d\mathbf{J}_D}{dt} + \gamma_D \mathbf{J}_D = \varepsilon_0 \omega_p^2 \mathbf{E}$$
Grid3dSpec
3D structured Cartesian grid geometry ([nx, ny, nz] cells with spacings [dx, dy, dz] in metres).
LorentzPole
Lorentz second-order resonant oscillator pole parameters: $$\frac{d^2\mathbf{P}_L}{dt^2} + \gamma_L \frac{d\mathbf{P}_L}{dt} + \omega_0^2 \mathbf{P}_L = \varepsilon_0 \Delta\varepsilon_L \omega_0^2 \mathbf{E}$$
YeeMaterialParams
Homogeneous isotropic constitutive parameters for a 3D Yee grid domain.
YeePlaneWaveResult
Result of a periodic 3D Yee plane-wave propagation and exact-time phase evaluation at $T = L / c_0$.

Enums§

BoundaryCondition
Spatial boundary condition for 3D structured electromagnetic operators.
EmfOperatorError
Typed error enumeration for 3D electromagnetic operators, Yee FDTD, ADE, and C02 oracles.
YeeSolverProfile
Supported Mode 2 Yee solver profiles.

Constants§

C0_M_PER_S
Exact SI speed of light in vacuum $c_0 = 299,792,458\text{ m/s}$.
CPML_ADE_RESTART_MAGIC
ELEMENTARY_CHARGE_C
Exact SI elementary charge $e = 1.602,176,634 \times 10^{-19}\text{ C}$.
EPS0_REF_F_PER_M
Mutually consistent reference vacuum permittivity $\varepsilon_0 = \frac{1}{\mu_0 c_0^2}\text{ F/m}$.
MU0_REF_H_PER_M
CODATA 2022 reference vacuum magnetic permeability $\mu_0 = 1.256,637,061,27 \times 10^{-6}\text{ H/m}$.
PLANCK_H_J_S
Exact SI Planck constant $h = 6.626,070,15 \times 10^{-34}\text{ J}\cdot\text{s}$.
PSI_XY
PSI_XZ
PSI_YX
PSI_YZ
PSI_ZX
PSI_ZY
SCHEMA_103_KEY_ADE_AUXILIARY_STATE
SCHEMA_103_KEY_PML_AUXILIARY_STATE
YEE_CONDUCTIVE_PERIODIC_NO_PHI_URI
Canonical model URI for Mode 2 conductive periodic no-phi Yee profile.
YEE_LOSSLESS_PERIODIC_NO_PHI_URI
Canonical model URI for Mode 2 lossless periodic no-phi Yee profile.
Z0_REF_OHM
Mutually consistent reference characteristic impedance of vacuum $Z_0 = \mu_0 c_0\text{ }\Omega$.

Functions§

admit_stokes_vector
Admit a physical Stokes vector $[I, Q, U, V]$ per C02 Mode 1.
admit_yee_timestep
Admit a candidate solver timestep $\Delta t$ against the 3D Cartesian Yee CFL bound.
c02_preview_f32_budget
C02 derived f32 preview algebraic budget: $32 \times 2^{-23} \times Q$.
c02_reduction_f64_budget
C02 $N$-term matrix/DFT reduction budget: $16 \gamma_n \sum_i |t_i|$ with $\gamma_n = \frac{n u}{1 - n u}, u = 2^{-53}$.
c02_small_op_f64_budget
C02 small closed-form f64 algebraic budget: $64 \times 2^{-52} \times Q$.
collocate_yee_poynting_and_energy_cell_centers
Collocate staggered Yee fields $\mathbf{E}^n$ and $\mathbf{H}^{n\mp 1/2}$ to cell centers at time $t = n\Delta t$.
convert_iq_emf_to_qac_conjugated
Convert between EMF negative-carrier (I, Q) and QAC positive-carrier (I, Q) per C02-C08.
dft_forward_unscaled
Mode 0x0105 forward unnormalized DFT.
gauss_electric_residual
Compute the electric Gauss-law residual $r_D = \nabla \cdot \mathbf{D} - \rho_v$.
gauss_magnetic_residual
Compute the magnetic Gauss-law residual $r_B = \nabla \cdot \mathbf{B}$.
instantaneous_poynting_and_energy
Mode 0x0100 (instantaneous_E_B_v1) instantaneous Poynting vector and energy density.
jones_to_stokes_candidate_v1
Convert a complex transverse Jones vector $(E_1, E_2)$ to Stokes parameters $[I, Q, U, V]$.
mode0_carrier_wavelength_m
Evaluate vacuum wavelength $\lambda = c_0 / f$ for Mode 0x0100, strictly rejecting static/aperiodic records.
mode6_photon_attenuation_and_independent_dose
Mode 0x0106 monoenergetic uncollided Beer-Lambert photon fluence attenuation and independent dose.
mode7_quasi_static_dipole_potential_v
Mode 0x0107 synthetic infinite homogeneous isotropic quasi-static volume-conductor dipole potential.
mueller_apply
Mode 0x0104 $4 \times 4$ Mueller matrix multiplication $\mathbf{S}{\text{out}} = M \mathbf{S}{\text{in}}$.
mueller_ideal_linear_polarizer_x
Ideal horizontal ($+x$) linear polarizer $4 \times 4$ Mueller matrix.
peak_phasor_time_average_poynting
Time-averaged Poynting vector from peak complex phasors $(\hat{\mathbf{E}}{\text{peak}}, \hat{\mathbf{H}}{\text{peak}})$.
ray_geometric_delay_s
Geometric ray propagation delay $t = \text{path} / v$.
reconstruct_rf_emf_negative_carrier
Mode 0x0105 real RF waveform reconstruction under EMF negative-exponential carrier.
reconstruct_rf_qac_positive_carrier
Real RF waveform reconstruction under QAC positive-exponential carrier.
restore_cpml_ade_restart_from
rms_phasor_time_average_poynting
Time-averaged Poynting vector from RMS complex phasors $(\hat{\mathbf{E}}{\text{rms}}, \hat{\mathbf{H}}{\text{rms}})$.
rotate_eb_hamilton_xyzw
C02-C04 active local-to-parent Hamilton quaternion rotation (q = [x, y, z, w]) for $(\mathbf{E}, \mathbf{B})$.
rotate_mueller_matrix_passive
Rotate a $4 \times 4$ Mueller matrix by passive basis angle $\theta$.
rotate_stokes_basis_passive
Passive transverse basis rotation of a Stokes vector by angle $\theta$.
run_yee_periodic_plane_wave_fixture
Evaluate the C02 Mode 2 periodic plane-wave fixture on a 3D isotropic Yee lattice.
serialize_cpml_ade_restart_into
spectral_density_wavelength_midpoint_integral
Mode 0x0103 spectral density Jacobian conversion and $N$-bin midpoint integration.
spectral_plane_wave_curl
Exact spectral Fourier-mode curl oracle for a real plane wave $\mathbf{A}(\mathbf{r}) = \mathbf{A}_0 \cos(\mathbf{k}\cdot\mathbf{r} + \phi_0)$.
spectral_plane_wave_divergence
Exact spectral Fourier-mode divergence oracle for a real plane wave $\mathbf{A}(\mathbf{r}) = \mathbf{A}_0 \cos(\mathbf{k}\cdot\mathbf{r} + \phi_0)$.
verify_cpml_ade_restart_parity
verify_discrete_charge_conservation
Verify discrete charge conservation on the Yee lattice: $\frac{(\nabla \cdot \mathbf{D})^{n+1} - (\nabla \cdot \mathbf{D})^n}{\Delta t} + \nabla \cdot \mathbf{J}^{n+1/2} = 0$.
verify_discrete_poynting_power_balance
Evaluate the exact local staggered Poynting balance residual at each cell (i, j, k).
verify_div_curl_zero_2nd
Verify the exact staggered discrete vector identity $\nabla \cdot (\nabla \times \mathbf{A}) = 0$.
verify_stokes_circulation_cell
Verify integral Stokes theorem $\oint_{\partial S} \mathbf{E} \cdot d\mathbf{l} = \iint_S (\nabla \times \mathbf{E}) \cdot d\mathbf{A}$ on a single Yee cell (ix, iy, iz).
yee_cfl_limit_3d
Compute the exact 3D Cartesian Yee Courant-Friedrichs-Lewy (CFL) maximum stable timestep: $$\Delta t_{\text{CFL}} = \frac{1}{v \sqrt{\Delta x^{-2} + \Delta y^{-2} + \Delta z^{-2}}}$$
yee_curl_e_2nd
Second-order staggered Yee forward curl $\nabla \times \mathbf{E}$ mapping edge-staggered electric fields $(E_x, E_y, E_z)$ to face-staggered magnetic flux rates.
yee_curl_e_4th
Fourth-order staggered forward curl $\nabla^{(4)} \times \mathbf{E}$ (Fang-type 4th-order stencil with weights $c_1 = 9/8$ and $c_2 = -1/24$).
yee_curl_h_2nd
Second-order staggered Yee backward curl $\nabla \times \mathbf{H}$ mapping face-staggered magnetic fields $(H_x, H_y, H_z)$ to edge-staggered electric displacement rates.
yee_curl_h_4th
Fourth-order staggered backward curl $\nabla^{(4)} \times \mathbf{H}$.
yee_discrete_omega_rad_per_s
Evaluate the exact 3D Cartesian Yee discrete dispersion relation for wavevector $\mathbf{k}$: $$\sin^2\left(\frac{\omega_{\text{num}} \Delta t}{2}\right) = (v \Delta t)^2 \sum_{j \in {x,y,z}} \frac{\sin^2(k_j \Delta x_j / 2)}{\Delta x_j^2}$$
yee_div_b_2nd
Second-order staggered cell-center divergence $\nabla \cdot \mathbf{B}$ for face-staggered fields.
yee_div_d_2nd
Second-order staggered vertex divergence $\nabla \cdot \mathbf{D}$ for edge-staggered fields.
yee_double_curl_e_2nd
Evaluate the staggered double-curl operator $\nabla \times (\mu^{-1} \nabla \times \mathbf{E})$.
yee_step_leapfrog_in_place
Advance a 3D staggered Yee electromagnetic state by one full leapfrog step $\Delta t$.