Basic couplings of measures #
A coupling of two measures μ₁ and μ₂ is a measure on their product whose marginals are
μ₁ and μ₂. This file provides the carrier-independent coupling API used by the dense graph
limit theory: marginal projection rules, measure-preserving projections, integral transfer,
coordinate swapping, and the independent and diagonal constructions.
IsCoupling is deliberately a Prop, rather than a structure or typeclass. A coupling is
generally not canonical, and consumers such as the cut distance minimize over all witnesses. The
product and diagonal measures provide two standard constructions on a common probability carrier;
depending on the measure, they may or may not differ.
The declarations live in TauCeti.MeasureTheory because none depends on graphons or cut metrics.
Main definitions #
TauCeti.MeasureTheory.IsCoupling— the predicate that a measure has prescribed marginals;TauCeti.MeasureTheory.diagonalCoupling— the pushforward of a measure along the diagonal.
Main results #
isCoupling_prodandisCoupling_diagonalCouplingconstruct couplings;IsCoupling.isProbabilityMeasureandIsCoupling.isFiniteMeasurerecord that a coupling of probability measures is one;IsCoupling.measurePreserving_fstandIsCoupling.measurePreserving_sndexpose the marginal projections as measure-preserving maps;IsCoupling.integral_comp_fstandIsCoupling.integral_comp_sndtransfer integrals depending on one coordinate to the corresponding marginal;IsCoupling.swapswaps the coordinates of a coupling;isCoupling_map_prodMkbuilds the graph coupling of two measure-preserving maps out of a common carrier, of whichisCoupling_diagonalCouplingis the identity case;measurePreserving_diagonalrecords the diagonal itself as measure preserving.
References #
- Roadmap:
TauCetiRoadmap/DenseGraphLimits/README.md, Layer 1 — the coupling-primary, cross-carrier cut distance and itsIsCouplinginput. TauCeti/MeasureTheory/OptimalTransport/Gluing.lean— the existing gluing API whose formulation of marginal conditions viaMeasure.fstandMeasure.sndis followed here.
A coupling of μ₁ and μ₂: a measure on the product whose marginals are μ₁ and μ₂.
Deliberately a Prop rather than a structure or a class: a coupling of two given marginals is not
canonical, and the cut distance minimizes over all of them. Use isCoupling_iff to unfold.
Instances For
The defining conditions of IsCoupling. The definition's body is not exposed, so this is the
lemma downstream modules should rewrite with.
The first marginal of a coupling.
The second marginal of a coupling.
The first projection out of a coupling is measure preserving. This is the marginal condition in the form the integral transfer below consumes, and the form the measure-preserving-map picture of the cut distance is stated in.
The second projection out of a coupling is measure preserving.
A coupling of probability measures is itself a probability measure.
A coupling whose first marginal is finite is a finite measure.
This weakening is what an existentially quantified coupling has to supply by hand: a consumer such
as the cut norm asks for IsFiniteMeasure, and a witness bound by an existential cannot provide an
instance by unification, so it passes this term explicitly.
The independent coupling: the product measure couples its two factors.
Swapping the two coordinates of a coupling of μ₁ and μ₂ gives a coupling of μ₂ and μ₁.
A function of the first coordinate integrates against a coupling as it does against the first marginal.
A function of the second coordinate integrates against a coupling as it does against the second marginal.
The graph coupling of two measure-preserving maps out of a common carrier: pushing μ
forward along x ↦ (f x, g x) couples μ₁ and μ₂.
This is the coupling a common-carrier comparison of two objects contributes to a coupling
infimum, and it is where the measure-preserving-map picture enters the coupling-primary one. The
diagonal coupling below is the case f = g = id.
The diagonal coupling of a measure with itself: the pushforward of μ along x ↦ (x, x).
Equations
- TauCeti.MeasureTheory.diagonalCoupling μ = MeasureTheory.Measure.map (fun (x : Ω) => (x, x)) μ
Instances For
The diagonal coupling of a measurable set is the measure of its diagonal slice.
The diagonal is measure preserving onto the diagonal coupling.
This is the defining pushforward, packaged for the transport lemmas that ask for a
MeasurePreserving hypothesis. It is stated here because diagonalCoupling is not reducible
outside this module, so a caller cannot supply the pushforward identity by rfl.
The diagonal coupling is a coupling of μ with itself: the graph coupling of the identity
with itself.
The diagonal coupling of a probability measure is a probability measure.