Struct MieCylResidual 

pub struct MieCylResidual {
    order: i32,
    kz: f64,
    k0: f64,
    radii: Vec<f64>,
    materials: Vec<Material>,
    interfaces: Vec<Interface>,
    inverse: Matrix2,
    value: Matrix2,
}

What mie_cyl saves for its pullback: the four-channel interface states and radial functions, so the pullback evaluates no Bessel functions.

Fields

order: i32

kz: f64

k0: f64

radii: Vec<f64>

materials: Vec<Material>

interfaces: Vec<Interface>

inverse: Matrix2

value: Matrix2

Implementations

impl MieCylResidual

pub fn state_size(boundaries: usize) -> Result<usize>

Byte count of the saved numerical state for boundaries layer boundaries.

pub(crate) fn write_state(&self, writer: &mut Writer)

pub(crate) fn read_state(reader: &mut Reader<'_>) -> Result<Self>

impl MieCylResidual

pub fn boundaries(&self) -> usize

The number of recorded layer boundaries.

pub const fn value(&self) -> &Matrix2

The coefficients in negative, positive helicity order, which the pullback reads.

pub fn pushforward( &self, kz: f64, k0: f64, radii: &[f64], materials: &[Material], ) -> Result<Matrix2>

The coefficient tangent along changes of kz, k0, the radii and the materials. Material entries store changes of epsilon, mu and kappa. Cached interface inverses and radial derivatives are reused for one forward pass, with no additional factorizations or Bessel evaluations.

pub fn pullback(&self, cotangent: &Matrix2) -> Result<MieCylGradient>

Gradients of kz, k0, the radii and the materials from cotangent, the gradient of a real loss with respect to the coefficient matrix.

The pullback runs on the calling thread and adds the boundaries in order, from the outermost in.

Trait Implementations

impl Clone for MieCylResidual

fn clone(&self) -> MieCylResidual

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for MieCylResidual

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl SavedState for MieCylResidual

fn save_state(&self) -> Result<Vec<u8>>

Copy the saved numerical state into its fixed byte layout.

fn from_state(bytes: &[u8]) -> Result<Self>

Restore numerical state from bytes produced by this extension.