Struct InterfaceResidual 

pub struct InterfaceResidual {
    ks: [[Complex; 2]; 2],
    zs: [Complex; 2],
    q: [f64; 2],
    axis: usize,
    inverse: Option<SMatrix<Complex, 4, 4>>,
    result: SMatrix<Complex, 4, 4>,
    fixed_q: bool,
}

What interface() saves for its pullback: the media, the transverse wavevector, the axis, the inverse of the tangential-field matching matrix and the blocks.

Fields

ks: [[Complex; 2]; 2]

zs: [Complex; 2]

q: [f64; 2]

axis: usize

inverse: Option<SMatrix<Complex, 4, 4>>

result: SMatrix<Complex, 4, 4>

The scattering blocks as one matrix over (up, down) outputs and inputs.

fixed_q: bool

Implementations

impl InterfaceResidual

pub fn state_size() -> Result<usize>

Byte length including fixed storage for the optional 4-by-4 inverse.

impl InterfaceResidual

pub fn pushforward( &self, ks: [[Complex; 2]; 2], z: [Complex; 2], q: [f64; 2], ) -> Result<Blocks>

Differentiate the tangential-field solve using its saved inverse and one direction of local field derivatives.

pub fn pullback(&self, cotangent: &Blocks) -> Result<InterfaceGradient>

Reuse the 4-by-4 inverse for the implicit solve adjoint; recompute local field derivatives.

Trait Implementations

impl Debug for InterfaceResidual

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

Formats the value using the given formatter.

impl SavedState for InterfaceResidual

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.