Matrix functions and Jordan form
Matrix exponential, logarithm, trigonometric, hyperbolic, and Jordan operations are exact symbolic operations.
exponential#
UniffiMatrix method
func exponential() -> UniffiMatrixThe matrix exponential exp(M), evaluated through the certified Jordan
decomposition. Declines on inputs whose eigenvalues cannot be certified
exactly.
logarithm#
UniffiMatrix method
func logarithm() -> UniffiMatrixThe principal matrix logarithm log(M). Raises on a zero or negative-real
eigenvalue (principal branch cut).
square_root#
UniffiMatrix method
func 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
func 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
func cosine() -> UniffiMatrixThe primary matrix cosine cos(M), evaluated exactly through the certified
Jordan decomposition and the trigonometric identity certificate.
hyperbolic_sine#
UniffiMatrix method
func 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
func hyperbolicCosine() -> UniffiMatrixThe primary hyperbolic matrix cosine cosh(M), evaluated exactly through the
certified Jordan decomposition and the hyperbolic identity certificate.
jordan_decomposition#
UniffiMatrix method
func 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
func jordanDecomposition() -> UniffiJordanDecompositionsimilarity#
UniffiJordanDecomposition method
func similarity() -> UniffiMatrixjordan_form#
UniffiJordanDecomposition method
func jordanForm() -> UniffiMatrixThe Jordan form J of the decomposed matrix.
blocks#
UniffiJordanDecomposition method
func blocks() -> [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
func size() -> UInt64The size of this Jordan block.
Example#
Additional API#
JordanBlock#
JordanBlock.eigenvalue#
UniffiJordanBlock method
func eigenvalue() -> UniffiExpressionThe eigenvalue this Jordan block belongs to.