Multi-marginal couplings #
This file defines a multi-marginal coupling as a probability measure on a dependent product with prescribed one-coordinate marginals. It provides coordinate and pair projections, coordinatewise maps, reindexing, and, over a finite index type, the independent product coupling.
These constructions form the finite multi-marginal part of Layer 0 of the optimal-transport roadmap. The definitions allow heterogeneous coordinate spaces; repeated-coordinate projections are also allowed, which is useful for forming diagonal marginals. Finiteness of the index type is assumed only where the independent product measure is involved, since the marginal, projection, reindexing and coordinatewise-map API needs nothing beyond measurable pushforwards.
A measure on a dependent product is a multi-marginal coupling of μ when its
pushforward by every coordinate evaluation is the corresponding measure μ i.
Instances For
Projecting a multi-marginal coupling along a family of coordinates gives another multi-marginal coupling. The coordinate family need not be injective.
Applying measurable maps coordinatewise to a multi-marginal coupling pushes each marginal forward by the corresponding map.
The pair projection of a multi-marginal coupling has the prescribed first marginal.
The pair projection of a multi-marginal coupling has the prescribed second marginal.
The finite product of probability measures is a multi-marginal coupling of its factors.
Probability measures on a dependent product with prescribed coordinate marginals. The
index type carries no finiteness assumption: it is MultiCoupling.pi and
MultiCoupling.instNonempty, not the bundle itself, that need ι to be finite.
Equations
- TauCeti.MultiCoupling μ = { π : MeasureTheory.ProbabilityMeasure ((i : ι) → X i) // TauCeti.Measure.IsMultiCoupling ↑π fun (i : ι) => ↑(μ i) }
Instances For
The independent product probability measure, regarded as a multi-marginal coupling.
Equations
Instances For
Every family of probability measures indexed by a finite type has a multi-marginal coupling.
The underlying probability measure of the independent multi-coupling is the product probability measure.
The ith marginal of a bundled multi-marginal coupling.
Instances For
The underlying measure of a coordinate marginal is the corresponding pushforward. This is
not a simp lemma: simp rewrites π.marginal i to μ i via marginal_eq instead.
Every coordinate marginal of a bundled multi-marginal coupling is its prescribed endpoint.
Two bundled multi-marginal couplings are equal when their underlying measures are equal.
Project a coupling to a family of coordinates. The coordinate family need not be injective.
Instances For
The underlying probability measure of a coordinate projection is the corresponding pushforward.
Projecting along the identity coordinate family leaves a multi-marginal coupling unchanged.
Projecting successively agrees with projecting along the composite coordinate family.
Reindex a multi-marginal coupling along an equivalence of index types.
Instances For
Reindexing is the pushforward by precomposition with the index equivalence.
Reindexing by the identity equivalence leaves a multi-marginal coupling unchanged.
Reindexing successively agrees with reindexing by the composite equivalence.
Applying measurable maps coordinatewise to a multi-marginal coupling.
Instances For
The underlying probability measure of a coordinatewise map is the corresponding pushforward.
Mapping every coordinate by the identity leaves the underlying probability measure
unchanged. This is not a simp lemma: simp unfolds the left-hand side through coe_map.
Coordinatewise mapping preserves the independent product coupling.
The joint law of coordinates i and j of a multi-marginal coupling.
Instances For
The underlying measure of a pair projection is the corresponding pushforward. This is not a
simp lemma: simp rewrites the marginals of a pair projection through fst_projectPair and
snd_projectPair instead.
The first marginal of a pair projection is its first selected coordinate.
The second marginal of a pair projection is its second selected coordinate.
Selecting the same coordinate twice gives its diagonal law.