Documentation

LeanPool.HighContrastHomogenization.Setup.BlockAlgebra

High-contrast homogenization: Setup.BlockAlgebra #

Imported from the Apache-2.0 HighContrastHomogenization development at commit 7a13dbcd8d6609264a713373f5c69ceeac870472.

Doubled block algebra: Schur data, contrasts, and matrix square roots #

This file fixes the algebraic objects the reference text builds on a doubled block matrix: the Schur parametrization of e.annealed.schur, the scalar Loewner bound encoding the matrix norm |·|, the intrinsic contrast of the reference block, the reference aspect ratio of e.reference.aspect.ratio, and the positive semidefinite square root.

Scalar dilation of a doubled block matrix.

Equations
Instances For

    A skew-symmetric d × d matrix.

    Equations
    Instances For
      noncomputable def HCPolySupport.HighContrast.specBound {d : ℕ} (M : Mat d) :

      The scalar Loewner bound inf { t ≥ 0 : M ≤ t · I }; on symmetric positive semidefinite arguments this is the spectral norm |M|.

      Equations
      Instances For
        noncomputable def HCPolySupport.HighContrast.schurSigmaStar {d : ℕ} (H : BlockMat d) :
        Mat d

        The Schur σ_* block of a doubled block matrix in the parametrization e.annealed.schur: the lower-right block is σ_*⁻¹.

        Equations
        Instances For
          noncomputable def HCPolySupport.HighContrast.schurSkew {d : ℕ} (H : BlockMat d) :
          Mat d

          The Schur skew block k of a doubled block matrix: the lower-left block is -σ_*⁻¹ k.

          Equations
          Instances For
            noncomputable def HCPolySupport.HighContrast.schurSigma {d : ℕ} (H : BlockMat d) :
            Mat d

            The Schur symmetric block σ of a doubled block matrix: the upper-left block is σ + kᵗ σ_*⁻¹ k.

            Equations
            Instances For
              noncomputable def HCPolySupport.HighContrast.blockContrast {d : ℕ} (H : BlockMat d) :

              The intrinsic contrast of a doubled block matrix, in the Loewner-scaling form: inf of the t ≥ 0 for which some skew h gives σ + (k - h)ᵗ σ_*⁻¹ (k - h) ≤ t σ_*. On Schur-form positive blocks this is the paper's min_h |σ_*^{-1/2}(σ + (k-h)ᵗ σ_*⁻¹ (k-h)) σ_*^{-1/2}| (the intrinsic contrast of the reference block, e.Theta.m).

              Equations
              • One or more equations did not get rendered due to their size.
              Instances For
                noncomputable def HCPolySupport.HighContrast.lambdaRef {d : ℕ} (E : BlockMat d) :

                λ_0 of the reference block (e.reference.aspect.ratio): |σ_{*,0}^{-1}|⁻¹, where σ_{*,0}^{-1} is the lower-right block.

                Equations
                Instances For
                  noncomputable def HCPolySupport.HighContrast.bigLambdaRef {d : ℕ} (E : BlockMat d) :

                  Λ_0 of the reference block (e.reference.aspect.ratio): min_h |σ_0 + (k_0 - h)ᵗ σ_{*,0}^{-1} (k_0 - h)| in Loewner-scaling form.

                  Equations
                  • One or more equations did not get rendered due to their size.
                  Instances For
                    noncomputable def HCPolySupport.HighContrast.aspectRatio {d : ℕ} (E : BlockMat d) :

                    The reference aspect ratio Π := Λ_0 / λ_0 (e.reference.aspect.ratio).

                    Equations
                    Instances For
                      noncomputable def HCPolySupport.HighContrast.refContrast {d : ℕ} (E : BlockMat d) :

                      The reference intrinsic contrast Θ (the intrinsic contrast of the reference block).

                      Equations
                      Instances For
                        noncomputable def HCPolySupport.HighContrast.matSqrt {n : Type u_1} [Fintype n] [DecidableEq n] (M : Matrix n n ℝ) :

                        The positive-semidefinite square root, by canonical choice of the unique positive-semidefinite B with B * B = M; junk value 1 otherwise.

                        Equations
                        Instances For

                          Entrywise bookkeeping #

                          Entries of a scalar dilation of a doubled block matrix.

                          The sum of the absolute values of the entries of a doubled block matrix; a crude but uniform entrywise scale.

                          Equations
                          Instances For

                            Two-sided entrywise control of a symmetric doubled block matrix whose quadratic form is nonnegative on the diagonal and on the sums of two basis vectors, and is there dominated by that of a reference block.

                            The doubled quadratic form, expanded over the flattened basis.

                            The doubled quadratic form on the flux slot is the quadratic form of the lower-right block.