Struct PeriodicResidual 

pub struct PeriodicResidual {
    top: DMatrix<Complex>,
    reflection: DMatrix<Complex>,
    solve: SolveResidual,
}

What periodic() saves for its pullback: the upper rows of the transfer matrix, the reflection block S10 and the solve with S11.

Fields

top: DMatrix<Complex>

reflection: DMatrix<Complex>

solve: SolveResidual

Implementations

impl PeriodicResidual

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

Byte count for saved transfer-matrix state with n modes per direction.

impl PeriodicResidual

pub fn shape(&self) -> (usize, usize)

The shape of the transfer matrix: both propagation directions of every plane-wave mode, 2 n by 2 n.

pub fn pushforward(&self, blocks: &Blocks) -> Result<DMatrix<Complex>>

Transfer-matrix tangent from the four scattering-block tangents, reusing LU.

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

Pull back a transfer-matrix cotangent into all four scattering blocks.

Trait Implementations

impl Debug for PeriodicResidual

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

Formats the value using the given formatter.

impl SavedState for PeriodicResidual

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.