Struct MieResidual 

pub struct MieResidual {
    sizes: Vec<f64>,
    materials: Vec<Material>,
    interfaces: Vec<Interface>,
    inverse: Matrix2,
    value: Matrix2,
}

What mie saves for its pullback: the interface matrices and radial functions of one degree l, so the pullback evaluates no Bessel functions.

Fields

sizes: Vec<f64>

materials: Vec<Material>

interfaces: Vec<Interface>

inverse: Matrix2

value: Matrix2

Implementations

impl MieResidual

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

Exact byte count of the saved Mie state for boundaries layers. The layout contains one count, the sizes, three material parameters, 62 complex entries per interface, and two coefficient matrices.

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

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

impl MieResidual

pub fn boundaries(&self) -> usize

The number of recorded layer boundaries.

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

The Mie coefficient matrix, which the pullback reads.

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

The coefficient tangent along changes of the sizes and materials. Each materials entry stores changes of epsilon, mu and kappa, including the embedding medium. One combined direction travels through the cached interfaces; no Bessel functions or parameter Jacobians are evaluated.

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

Gradients of the size parameters 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 MieResidual

fn clone(&self) -> MieResidual

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for MieResidual

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

Formats the value using the given formatter.

impl SavedState for MieResidual

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.