Struct LatticeExpansionFromTableResidual 

pub struct LatticeExpansionFromTableResidual {
    destination: Basis,
    source: Basis,
    helicity: bool,
    blocks: Vec<Block>,
    table_shape: [usize; 4],
    shape: (usize, usize),
}

What lattice_expansion_from_table saves for its pullback: the sparse angular weights, never the table values. The pullback runs in block order and gives the same result every run.

Fields

destination: Basis

source: Basis

helicity: bool

blocks: Vec<Block>

table_shape: [usize; 4]

shape: (usize, usize)

Implementations

impl LatticeExpansionFromTableResidual

pub fn state_size( destination_modes: usize, destination_positions: usize, source_modes: usize, source_positions: usize, ) -> Result<usize>

Fixed byte count from the destination and source basis shapes.

impl LatticeExpansionFromTableResidual

pub fn pushforward(&self, tangent: &[Complex]) -> Result<DMatrix<Complex>>

The same sparse linear angular map applied to the table direction.

fn apply_table(&self, tangent: &[Complex]) -> Result<DMatrix<Complex>>

Values and directions use one sparse linear contraction.

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

Destination and source mode counts: the shape of the coupling matrix.

pub const fn table_shape(&self) -> [usize; 4]

The shape of the normalized harmonic table, which is also the shape of the table gradient.

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

The table gradient: the conjugate transpose of the fixed angular weights applied to cotangent.

Trait Implementations

impl Debug for LatticeExpansionFromTableResidual

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

Formats the value using the given formatter.

impl SavedState for LatticeExpansionFromTableResidual

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.