Module tmatrix

Module tmatrix 

Source
Expand description

T-matrices of single spheres and cylinders, and three helicity measures of a T-matrix.

Upstream: treams.TMatrix and treams.TMatrixC.

treams-rstreamsDifferences
sphere()TMatrix.spherehelicity convention only; the Python layer converts to parity
cylinder()TMatrixC.cylindera block (kz, m) reuses the boundary solve of its mirror (-kz, -m) when both are requested; the two solves agree to rounding
metric() with Metric::CircularDichroismTMatrix.cdrequires positive real wavenumbers instead of a real material
metric() with Metric::DualityBreakingTMatrix.dbscales the matrix to a largest entry of 1 first, so tiny or huge matrices do not underflow or overflow
metric() with Metric::ChiralityTMatrix.chithe same scaling; the gradient is an error where the helicity contrast is zero

sphere() and cylinder() list the modes as treams does: within each degree and order (or axial wavenumber and order), polarization index 1 (positive helicity) comes before 0. The Mie coefficients of coeffs use the reverse order (negative, positive), so both axes of every 2 x 2 block swap when it is placed. metric() takes the polarization index of each row in pol.

Modulesยง

cylinder ๐Ÿ”’
T-matrices of multilayer chiral cylinders from their Mie coefficients.
metric ๐Ÿ”’
Circular dichroism, duality breaking and electromagnetic chirality of helicity T-matrices.
sphere ๐Ÿ”’
T-matrices of multilayer chiral spheres from their Mie coefficients.

Structsยง

CylinderGradient
Gradients of the inputs of cylinder, in the order of its arguments.
CylinderResidual
What cylinder saves for its pullback: one boundary solve per (kz, m) pair, shared with the mirror pair (-kz, -m) when both are requested.
MetricGradient
Gradients of the inputs of metric, in the order of its arguments.
MetricResidual
What metric saves for its pullback: the gradient itself, since the value is a real scalar; no singular vectors are kept.
SphereGradient
Gradients of the inputs of sphere, in the order of its arguments.
SphereResidual
What sphere saves for its pullback: the Mie residual of each degree.

Enumsยง

Metric
Normalized measures of a global helicity T-matrix.

Functionsยง

cylinder
The T-matrix of concentric multilayer chiral cylinders, ordered by kzs, then ascending order m from -mmax to mmax, then positive and negative helicity.
metric
One Metric of a global helicity T-matrix.
sphere
The T-matrix of a concentric multilayer chiral sphere, in the order of sw::modes.