Struct MatrixLogPlan 

pub struct MatrixLogPlan { /* private fields */ }

Execution plan for the matrix logarithm.

Uses inverse scaling and squaring:

1. Reduce A via repeated matrix square roots until ||A - I|| is small.
2. Apply Padé approximation of log(I + X) for the reduced matrix.
3. Scale the result back by 2^s.

Implementations

impl MatrixLogPlan

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

Creates a plan from a validated configuration.

pub fn max_sqrt_iters(&self) -> u32

Returns the maximum allowed square-root iterations.

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

Generates PTX source for the matrix logarithm kernels.

The generated code contains entry points for:

1. shift kernel — computes X = A - I.
2. square-root iteration kernel — Denman–Beavers step applied to A until ||A - I|| is below threshold.
3. Padé log kernel — evaluates the [m/m] Padé approximant to log(I + X) for small X.
4. scale-back kernel — multiplies the result by 2^s.

Trait Implementations

impl Clone for MatrixLogPlan

fn clone(&self) -> MatrixLogPlan

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for MatrixLogPlan

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

Formats the value using the given formatter.