Matrix functions and Jordan form
Matrix exponential, logarithm, trigonometric, hyperbolic, and Jordan operations are exact symbolic operations.
exponential#
UniffiMatrix method
fun exponential(): UniffiMatrixThe matrix exponential exp(M), evaluated through the certified Jordan
decomposition. Declines on inputs whose eigenvalues cannot be certified
exactly.
logarithm#
UniffiMatrix method
fun logarithm(): UniffiMatrixThe principal matrix logarithm log(M). Raises on a zero or negative-real
eigenvalue (principal branch cut).
square_root#
UniffiMatrix method
fun squareRoot(): UniffiMatrixThe principal matrix square root sqrt(M); the result is verified to square
back to M. Raises on a negative-real eigenvalue, or on a nontrivial zero
eigenblock (non-analytic).
sine#
UniffiMatrix method
fun sine(): UniffiMatrixThe primary matrix sine sin(M), evaluated exactly through the certified
Jordan decomposition. The result is certified together with the matrix cosine
by sin(M)^2 + cos(M)^2 = I.
cosine#
UniffiMatrix method
fun cosine(): UniffiMatrixThe primary matrix cosine cos(M), evaluated exactly through the certified
Jordan decomposition and the trigonometric identity certificate.
hyperbolic_sine#
UniffiMatrix method
fun hyperbolicSine(): UniffiMatrixThe primary hyperbolic matrix sine sinh(M), evaluated exactly through the
certified Jordan decomposition. The result is certified together with the
hyperbolic matrix cosine by cosh(M)^2 - sinh(M)^2 = I.
hyperbolic_cosine#
UniffiMatrix method
fun hyperbolicCosine(): UniffiMatrixThe primary hyperbolic matrix cosine cosh(M), evaluated exactly through the
certified Jordan decomposition and the hyperbolic identity certificate.
jordan_decomposition#
UniffiMatrix method
fun jordanDecomposition(): UniffiJordanDecompositionThe Jordan decomposition returned as (similarity, jordan_form, blocks) with
, where blocks lists each
Jordan block as an (eigenvalue, size) pair. Every root is certified over an
exact algebraic field. Notes: WASM returns a JordanDecomposition
result class with similarity/jordan_form/blocks getters, each block a
JordanBlock with eigenvalue/size getters.
jordan_decomposition (WASM result class)#
UniffiMatrix method
fun jordanDecomposition(): UniffiJordanDecompositionsimilarity#
UniffiJordanDecomposition method
fun similarity(): UniffiMatrixjordan_form#
UniffiJordanDecomposition method
fun jordanForm(): UniffiMatrixThe Jordan form J of the decomposed matrix.
blocks#
UniffiJordanDecomposition method
fun blocks(): List<UniffiJordanBlock>The Jordan blocks, in the order they appear on the diagonal.
jordan_block (WASM result class)#
size#
The jordan_block.eigenvalue -> Expression getter reuses the shared
eigenvalue heading documented above.
UniffiJordanBlock method
fun size(): kotlin.ULongThe size of this Jordan block.
Example#
Additional API#
JordanBlock#
JordanBlock.eigenvalue#
UniffiJordanBlock method
fun eigenvalue(): UniffiExpressionThe eigenvalue this Jordan block belongs to.