Struct MatrixSqrtPlan 

pub struct MatrixSqrtPlan { /* private fields */ }

Execution plan for the matrix square root using Denman–Beavers iteration.

The iteration produces sequences Y_k → sqrt(A) and Z_k → sqrt(A)^{-1}:

  Y_0 = A,       Z_0 = I
  Y_{k+1} = (Y_k * Z_k^{-1} + I) / 2
  Z_{k+1} = (Z_k * Y_k^{-1} + I) / 2

Convergence is detected when ||Y_{k+1} - Y_k||_F < tol.

Implementations

impl MatrixSqrtPlan

pub fn new(config: MatrixSqrtConfig) -> SolverResult<Self>

Creates a plan from a validated configuration.

pub fn tolerance(&self) -> f64

Returns the convergence tolerance.

pub fn max_iters(&self) -> u32

Returns the maximum number of iterations.

pub fn generate_ptx(&self) -> SolverResult<String>

Generates PTX source for the matrix square root kernels.

The generated code contains entry points for:

1. init kernel — sets Y_0 = A and Z_0 = I.
2. iteration kernel — computes the element-wise (M + I) / 2 step after the matrix product and inverse have been done by BLAS.
3. convergence kernel — computes ||Y_{k+1} - Y_k||_F² via parallel reduction.

Trait Implementations

impl Clone for MatrixSqrtPlan

fn clone(&self) -> MatrixSqrtPlan

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for MatrixSqrtPlan

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

Formats the value using the given formatter.