Documentation

Oseledets.Examples.CatMapPerPartition

The per-partition Ruelle bound for the genuine Arnold cat map #

This module instantiates the unconditional arithmetic backbone of the Margulis–Ruelle inequality Oseledets.Entropy.ksEntropyPartition_le_of_atomCount_growth on the genuine Arnold cat map catTorus : 𝕋² → 𝕋² (Oseledets/Examples/CatMapToral.lean, the hyperbolic toral automorphism with matrix M = !![2,1;1,1]), at the exact rate log λ₊ = log((3 + √5)/2).

It is the cat-map analogue of the already-shipped doubling-map per-partition theorem Oseledets.doublingMap_ksEntropyPartition_le_sumPosExp (Oseledets/Examples/RuelleDoubling.lean): same base-space-polymorphic backbone, same honest status for the single genuinely-geometric input (the Ruelle atom-count growth), here over the genuine toral dynamics instead of the doubling map.

What is the rate, and why it is the genuine top exponent #

The rate log((3 + √5)/2) is the genuine top Lyapunov exponent λ₊ of the cat map: (3 + √5)/2 is the larger eigenvalue of M = !![2,1;1,1], and the sibling module Oseledets/Examples/CatMapDerivativeCocycle.lean proves — fully sorry-free — that the top Lyapunov exponent of the genuine Fréchet-derivative cocycle of the cat map's ℝ²-linear lift catLift, realized over the genuine ergodic base catTorus, is exactly log((3 + √5)/2) > 0 (Oseledets.CatMapToral.catLift_derivativeCocycle_topExponent_pos). So the rate appearing here is not an abstract constant: it is the actual Lyapunov datum of the cat map, with an independent honest proof in the repo.

What is discharged here, and what stays an honest input #

catTorus_ksEntropyPartition_le_logLambda is a thin specialization of the unconditional backbone Oseledets.Entropy.ksEntropyPartition_le_of_atomCount_growth at the rate R = log((3 + √5)/2), over the genuine ergodic toral base via Oseledets.CatMapToral.measurePreserving_catTorus. There is no hidden geometric content beyond the two explicit, named hypotheses:

The conclusion is the per-partition bound h(α, catTorus) ≤ log λ₊ for a single partition α, not the system Margulis–Ruelle inequality h(catTorus) ≤ λ₊.

The system-level sharp equality is a documented wall #

The sharp system equality h_μ(catTorus) = log λ₊ (the cat-map Pesin/Ledrappier–Young formula) is not proved here and is a genuine wall:

Main results #

References #

@[implicit_reducible]

Normalise the circle measure to total mass 1 (AddCircle.haarAddCircle), matching the MeasureSpace UnitAddCircle convention of Oseledets/Examples/CatMapToral.lean so that the ambient volume : Measure T2 here is the same product Haar probability measure for which measurePreserving_catTorus is stated. (Importing Oseledets/Examples/Elementary.lean, which uses the default AddCircle.measureSpace 1, would make volume : Measure T2 ambiguous — hence we re-establish exactly these instances and route everything through measurePreserving_catTorus.)

Equations
Instances For

    The cat-map rate is positive: 0 < log((3 + √5)/2). This is the hyperbolicity of the Arnold cat map: the larger eigenvalue (3 + √5)/2 of M = !![2,1;1,1] exceeds 1 (since √5 ≥ 0), so its logarithm is positive. It is log λ₊, the genuine top Lyapunov exponent (catLift_derivativeCocycle_topExponent_pos).

    The per-partition Ruelle bound for the genuine Arnold cat map.

    For any finite measurable partition P of the 2-torus 𝕋² whose n-fold refinement ⋁ₖ₌₀ⁿ⁻¹ catTorus⁻ᵏ P under the genuine cat map has eventually at most C · exp(n · log λ₊) non-empty atoms (hgrow, with C ≥ 1), the Kolmogorov–Sinai entropy relative to that single partition is bounded by the top Lyapunov exponent log λ₊ = log((3 + √5)/2):

    h(α, catTorus) ≤ log((3 + √5)/2).

    This is the per-partition Ruelle bound, not the system inequality h(catTorus) ≤ log λ₊ (the bridge to the system entropy is the generator identity Oseledets.Entropy.ksEntropy_eq_ksEntropyPartition_of_generating, fully proved in the repo, applied under an IsGenerating volume catTorus P hypothesis — the deferred Adler–Weiss Markov-partition datum). The rate log((3 + √5)/2) is the genuine top Lyapunov exponent of the cat map (Oseledets.CatMapToral.catLift_derivativeCocycle_topExponent_pos), not an abstract constant.

    The atom-count growth hgrow is the genuinely geometric Ruelle input, left as an honest named hypothesis exactly as in Oseledets.Entropy.Ruelle.Crude and in the doubling-map theorem Oseledets.doublingMap_ksEntropyPartition_le_sumPosExp. The reduction itself is the unconditional arithmetic backbone Oseledets.Entropy.ksEntropyPartition_le_of_atomCount_growth; this theorem adds no hidden content beyond hC and hgrow.