Struct RotationResidual 

pub struct RotationResidual {
    rows: Vec<i32>,
    columns: Vec<i32>,
    entries: Vec<(usize, usize)>,
    spherical: Option<Spherical>,
    value: DMatrix<Complex>,
}

What sw_rotation and cw_rotation save for their pullback: the rotation matrix, its coupled entries and, for spherical bases, the angular blocks.

The pullback adds the entries in order on the calling thread, so its result does not depend on the thread count.

Fields

rows: Vec<i32>

columns: Vec<i32>

entries: Vec<(usize, usize)>

The coupled entries; all others vanish.

spherical: Option<Spherical>

value: DMatrix<Complex>

Implementations

impl RotationResidual

pub fn sw_state_size( destination: &[(usize, Mode)], source: &[(usize, Mode)], ) -> Result<usize>

Saved-state size from spherical mode labels, without evaluating a rotation.

pub fn cw_state_size( destination: &[(usize, Mode)], source: &[(usize, Mode)], ) -> Result<usize>

Saved-state size from cylindrical mode labels, without evaluating a rotation.

pub const fn value(&self) -> &DMatrix<Complex>

The rotation from the source to the destination multipole coefficients, which the pullback reads.

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

The shape of the rotation: destination and source mode counts.

pub fn pushforward(&self, angles: [f64; 3]) -> Result<DMatrix<Complex>>

Contract the Euler-angle derivatives with one real direction. Cylindrical theta remains a fixed zero constraint and contributes no derivative.

fn theta_derivative(&self, i: usize, j: usize) -> Complex

The shared ladder rule used by the JVP and VJP.

pub fn pullback(&self, cotangent: &DMatrix<Complex>) -> Result<[f64; 3]>

Euler-angle cotangents. Cylindrical theta is a fixed zero constraint.

Trait Implementations

impl Debug for RotationResidual

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

Formats the value using the given formatter.

impl SavedState for RotationResidual

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

Copy the saved numerical state into its fixed byte layout.

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

Restore numerical state from bytes produced by this extension.