Documentation

TauCeti.LinearAlgebra.Matrix.Cholesky.Jacobian

The Jacobian of Cholesky reconstruction #

Cholesky reconstruction sends a lower-triangular matrix L to the symmetric matrix L * Lᵀ. Both sides are determined by their on-or-below-diagonal entries, so in the coordinates of TauCeti.lowerTriangle the reconstruction becomes a quadratic self-map TauCeti.choleskyReconstructionCoordinates of a Euclidean space. This file computes its derivative and the determinant 2 ^ p * ∏ i, (L i i) ^ (p - i) of that derivative.

This determinant is the Jacobian factor of the change of variables S = L * Lᵀ, which runs from the positive-diagonal lower-triangular matrices to the positive-definite cone carrying Lebesgue measure in symmetric coordinates. Substituting it into an integral over the cone — the multivariate Gamma integral, and through it the Wishart normalizing constant — turns that integral into a product of independent one-dimensional integrals.

The determinant is computed by ordering the lower-triangular positions by column and then by row. In that order the derivative is triangular, and its diagonal entry at position (i, j) is L j j, doubled when i = j.

Main declarations #

References #

Cholesky reconstruction L ↦ L * Lᵀ read in lower-triangular coordinates on both sides: the input lists the on-or-below-diagonal entries of L, and the output lists those of L * Lᵀ, which determine that symmetric matrix.

Equations
Instances For

    The derivative of TauCeti.choleskyReconstructionCoordinates at x: writing L for the lower-triangular matrix of x, it sends the lower-triangular matrix H of an increment to the on-or-below-diagonal entries of L * Hᵀ + H * Lᵀ.

    Equations
    • One or more equations did not get rendered due to their size.
    Instances For
      @[simp]

      On the coordinates of a positive-diagonal lower-triangular matrix, the coordinate form of Cholesky reconstruction reads off TauCeti.choleskyReconstruction.

      Cholesky reconstruction is quadratic in the triangular coordinates, hence differentiable, with the derivative computed entrywise from the product rule.

      The determinant of the derivative #

      The Jacobian determinant of Cholesky reconstruction. In lower-triangular coordinates the derivative of L ↦ L * Lᵀ has determinant 2 ^ p * ∏ i, (L i i) ^ (p - i).

      theorem TauCeti.abs_det_fderiv_choleskyReconstructionCoordinates {p : ℕ} (x : lowerTriangle p → ℝ) (hx : ∀ (i : Fin p), 0 < x ⟨(i, i), ⋯⟩) :
      |(fderiv ℝ (choleskyReconstructionCoordinates p) x).det| = 2 ^ p * ∏ i : Fin p, x ⟨(i, i), ⋯⟩ ^ (p - ↑i)

      The absolute Jacobian factor of Cholesky reconstruction. On the positive-diagonal region, which is where the Cholesky factors live, the determinant above is positive and is therefore the density appearing in the change-of-variables formula.