Documentation

Oseledets.Multifractal.Defs

Coarse-grained multifractal analysis: core definitions #

This file lays the abstract, measure-free foundation for the coarse-grained multifractal analysis of a finite weight family p : ι → ℝ (think p i = μ(cell i) for the cells of a partition at scale ε). All quantities are defined on a bare family p; the hypotheses one needs for the theory (0 ≤ p i, ∑ i, p i = 1, 0 < ε < 1) are carried on the lemmas, never baked into the definitions, so the algebra stays clean and the same definitions specialize to any measure.

The exponent ^ throughout is Real.rpow (real-base, real-exponent power), which is the right notion for the continuous parameter q : ℝ.

Main definitions #

Main results #

noncomputable def Oseledets.Multifractal.partitionFunction {ι : Type u_1} [Fintype ι] (p : ι) (q : ) :

The generalized partition function Z_q = ∑_{i : p i > 0} (p i) ^ q of a finite weight family p : ι → ℝ, with exponent ^ interpreted as Real.rpow. The guard 0 < p i is load-bearing at q = 0: it ensures empty cells (p i = 0) contribute 0 rather than Real.rpow 0 0 = 1, so that Z_0 counts the number of occupied cells.

Equations
Instances For
    noncomputable def Oseledets.Multifractal.massExponent {ι : Type u_1} [Fintype ι] (p : ι) (ε q : ) :

    The mass exponent τ(q) = log Z_q / log ε of a finite weight family p at scale ε. This is defined for every q with no case split.

    Equations
    Instances For
      noncomputable def Oseledets.Multifractal.renyiDim {ι : Type u_1} [Fintype ι] (p : ι) (ε q : ) :

      The Rényi (generalized) dimension D_q of a finite weight family p at scale ε. For q ≠ 1 it is τ(q) / (q - 1). At q = 1 the general formula is the indeterminate 0 / 0, so the L'Hôpital value — the information dimension (∑ i, p i log p i) / log ε — is supplied directly. (By the Mathlib convention Real.log 0 = 0, the q = 1 numerator needs no guard: empty cells contribute 0 automatically.)

      Equations
      Instances For
        noncomputable def Oseledets.Multifractal.singularitySpectrum {ι : Type u_1} [Fintype ι] (p : ι) (ε α : ) :

        The singularity spectrum f(α) = ⨅ q, q α - τ(q) of a finite weight family p at scale ε, the Legendre transform of the mass exponent τ. This is an infimum: since τ is concave, the supremum of q α - τ(q) would be +∞.

        Equations
        Instances For
          theorem Oseledets.Multifractal.partitionFunction_nonneg {ι : Type u_1} [Fintype ι] {p : ι} (hp : ∀ (i : ι), 0 p i) (q : ) :

          The generalized partition function of a nonnegative weight family is nonnegative.

          theorem Oseledets.Multifractal.partitionFunction_eq_sum_rpow {ι : Type u_1} [Fintype ι] {p : ι} (hp : ∀ (i : ι), 0 p i) {q : } (hq : q 0) :
          partitionFunction p q = i : ι, p i ^ q

          For q ≠ 0 the positivity guard in the partition function is removable: empty cells (p i = 0) contribute Real.rpow 0 q = 0 anyway, so Z_q = ∑ i, (p i) ^ q.

          theorem Oseledets.Multifractal.partitionFunction_one_eq_one {ι : Type u_1} [Fintype ι] {p : ι} (hp : ∀ (i : ι), 0 p i) (hsum : i : ι, p i = 1) :

          For a probability weight family (0 ≤ p i and ∑ i, p i = 1), the partition function at q = 1 is 1. Occupied cells contribute (p i) ^ 1 = p i, empty cells contribute 0 either way.

          theorem Oseledets.Multifractal.massExponent_one_eq_zero {ι : Type u_1} [Fintype ι] {p : ι} (hp : ∀ (i : ι), 0 p i) (hsum : i : ι, p i = 1) (ε : ) :
          massExponent p ε 1 = 0

          For a probability weight family, the mass exponent at q = 1 vanishes, since Z_1 = 1 and log 1 = 0.

          theorem Oseledets.Multifractal.partitionFunction_pos {ι : Type u_1} [Fintype ι] {p : ι} (hpos : ∃ (i : ι), 0 < p i) (q : ) :

          If at least one weight is strictly positive, the partition function is strictly positive: the contributing cell i adds (p i) ^ q > 0 to a sum of nonnegative terms (each guarded summand is either a positive rpow of a positive base, or 0).