Struct SphereClusterResidual 

pub struct SphereClusterResidual {
    k0: f64,
    positions: Vec<[f64; 3]>,
    plan: TranslationPlan,
    spheres: Vec<SphereResidual>,
    interaction: InteractionResidual,
}

What sphere_cluster saves for its pullback: the Mie residual of each sphere, the translation plan between two spheres, the positions and the interaction solve.

Fields

k0: f64

positions: Vec<[f64; 3]>

plan: TranslationPlan

spheres: Vec<SphereResidual>

interaction: InteractionResidual

Implementations

impl SphereClusterResidual

pub fn state_size(lmax: usize, particles: usize) -> Result<usize>

Byte count for a cluster’s saved numerical state, from its static layout.

pub fn particles(&self) -> usize

Number of spheres in the recorded cluster.

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

Interacting T-matrix in the local multipole bases.

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

The shape of the interacting T-matrix.

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

Directional derivative for vacuum wavenumber, radii, permittivities and positions. Particle and translation tangents feed one solve with the saved LU.

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

Gradients of k0, the radii, the permittivities and the positions from cotangent, the gradient of a real loss with respect to the interacting T-matrix.

The spheres run in parallel; their gradients add in sphere order, so the Rayon pool does not change them. The LU solve and the matrix products of InteractionResidual::pullback_blocks run in faer with the worker count of linalg.

Trait Implementations

impl Clone for SphereClusterResidual

fn clone(&self) -> SphereClusterResidual

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for SphereClusterResidual

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

Formats the value using the given formatter.

impl SavedState for SphereClusterResidual

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.