Documentation

TauCeti.LinearAlgebra.Matrix.Cholesky.Basic

Cholesky factors of positive-definite real matrices #

This file constructs the lower-triangular Cholesky factor of a positive-definite real matrix from Mathlib's LDL decomposition. The diagonal of the LDL factor is positive, so taking its entrywise square root and absorbing it into the lower factor gives S = L * Lᵀ, with L lower triangular and positive on the diagonal.

Main definitions #

References #

@[reducible, inline]

Lower-triangular real matrices of size p whose diagonal entries are positive.

Equations
Instances For
    noncomputable def TauCeti.cholesky {p : ℕ} (A : PosDefMatrix p) :

    The lower-triangular Cholesky factor of a positive-definite real symmetric matrix.

    Equations
    Instances For
      theorem TauCeti.cholesky_coe {p : ℕ} (A : PosDefMatrix p) :
      ↑(cholesky A) = LDL.lower ⋯ * Matrix.diagonal fun (i : Fin p) => √(LDL.diagEntries ⋯ i)

      The Cholesky factor of A in closed form: Mathlib's LDL lower factor of A, with the square roots of the LDL diagonal entries absorbed into its columns.

      @[simp]
      theorem TauCeti.cholesky_mul_transpose {p : ℕ} (A : PosDefMatrix p) :
      ↑(cholesky A) * (↑(cholesky A)).transpose = ↑↑A

      A positive-definite matrix is the product of its Cholesky factor and its transpose.

      A lower-triangular matrix with positive diagonal has linearly independent rows.

      Reconstruct a positive-definite symmetric matrix from a lower-triangular matrix with positive diagonal.

      Equations
      Instances For
        @[simp]

        The matrix underlying choleskyReconstruction L is L * Lᵀ.

        @[simp]

        Reconstructing a matrix from its Cholesky factor returns the original matrix.

        The Cholesky construction is injective.