Samplinglib
Lean gate not recorded for this source state main · 0e31a3cda412
Samplinglib · Current Progress

Seven routes, one collaboration board.

SampleWiki, Riemannian Optimization, Optimisation, Statistical Optimal Transport, Discrete Sampling, and higher-order sampling advance in parallel on one page. Each theorem-sized task is a Frontier Cell; lower-level mathematics is shared only after a reuse/compatibility audit, so collaborators can move independently without rebuilding the same Lean foundation.

Dependency-first frontier route

SampleWiki Route

Immediate priority: extend the verified Chewi spine until useful frontier sampling results can enter the same theorem graph with exact source fidelity.

Partially formalized · source fidelity separateOpen SampleWiki ↗

Route milestones

active01

Dependency-first Chewi spine

Continue the shortest prerequisite route through the Chewi textbook graph toward useful SampleWiki results.

active02

Source fidelity + theorem insertion

Audit frontier statements against primary papers, then attach verified declarations to the existing theorem graph.

planned03

Proximal / LMC / ULD / MALA foundations

Prioritize reusable analytic roots that unlock multiple frontier cases rather than isolated terminal proofs.

planned04

Frontier result closure

Advance the highest-value reachable SampleWiki cells once their shared parents are stable.

Boumal route

Riemannian Optimization

Formalize Boumal while sharing only mathematically identical geometry foundations with the sampling route. Convention differences stay explicit in adapters.

Route milestones

scaffold01

Boumal source map

The eleven-chapter public route and source boundaries are established.

planned02

Shared geometry floor

Audit Mathlib and Samplinglib first; Chewi sampling §2.5 is the first explicit cross-route checkpoint.

planned03

Boumal Chapters 1–4

Definitions, embedded first-order geometry, and first-order Riemannian algorithms.

planned04

Boumal Chapters 5–11

Second-order geometry/algorithms, general and quotient manifolds, additional tools, and geodesic convexity.

Sinho Chewi · arXiv:2605.07006

Optimisation

Formalize Chewi's public optimization notes section by section, reusing Mathlib/Optlib/CvxLean and exposing exact shared convex/proximal/mirror foundations with sampling.

Partially formalized · source fidelity separateOpen library ↗

Route milestones

scaffold01

Chewi Lectures on Optimization source map

The public formalization spine follows arXiv:2605.07006: §§1–13 plus Appendix A.

planned02

Convexity, flow, descent, acceleration

Formalize §§1–5 while reusing compatible Mathlib/Optlib declarations.

planned03

Non-smooth, Frank-Wolfe, proximal, duality

Formalize §§6–9 and expose exact shared foundations with sampling when statements coincide.

planned04

Mirror, alternating, stochastic, interior-point

Formalize §§10–13 and audit sampling intersections around mirror/proximal/stochastic structure.

Chewi · Niles-Weed · Rigollet

Statistical Optimal Transport Route

Eight chapters and two appendices share the same reader, source-fidelity protocol and canonical Lean floor as the existing libraries.

Partially formalized · source fidelity separateOpen library ↗

Route milestones

scaffold01

Source map and shared entry points

8 chapters + A/B; exact page anchors. Audit convexity, probability and existing coupling code before introducing anything new.

planned02

Chapter 1: transport foundation

Couplings, Wasserstein distance, Brenier and duality. Reuse shared convex/marginal/compactness ingredients.

planned03

Parallel branches after Chapter 1

2–3 statistical estimation; 4 entropic transport; 5→6 flows and sampling; 7→8 metric geometry and barycenters.

planned04

Source omissions and transport review

Use Villani / Santambrogio / AGS for missing analytic details. Separate conceptual correspondence from certified Lean reuse.

Optimisation × Sampling research route

Higher-Order Smoothness × Sampling

Determine when additional potential smoothness yields a real sampling advantage at a fixed oracle and total computational cost. Existing high-order sampling literature is the starting point, not a novelty claim.

Route milestones

planned01

Regime and oracle matrix

Separate potential smoothness p, derivative access q, dynamical order k and discretization order r; fix metric, starts and dimension-dependent constants.

planned02

Shared Taylor and stochastic local error

Search existing Taylor, moment and coupling APIs; prove one useful local-error/invariant-target interface before a full rate.

planned03

Mixing plus discretization

Couple an audited local error with a compatible contraction theorem; count derivative evaluations and matrix/tensor work, not iterations alone.

parallel04

Lower bounds remain an independent lane

SampleWiki studies hard instances and information transcripts. Compare the two lanes only after oracle, class, metric and costs match.

Chen · Štefankovič · Vigoda

Discrete Sampling Route

Finite-state Ising/Glauber, hard-core and matroid sampling. Same shared graph and source/mirror gates; not continuous-sampling time discretization.

Route milestones

scaffold01

Pinned source and Ising entry

12 sections, 72 anchors; read Ising definitions early. Section 12 mixing proofs must be recovered from cited original papers.

planned02

Shared finite probability and kernel floor

Reuse PMF, measures, kernels and finite linear algebra; fix support, feasible pinnings, reversibility and clock before mixing.

planned03

Dirichlet / entropy / local-to-global

Pull §3 forward; prove finite dissipation adapters, uniform conditional-influence bounds and factorization with the exact normalization.

candidate04

Cross-domain conceptual mirrors

PI/chi-square, modified LSI/KL, finite transport geometry and conditional covariance. Independent source review never substitutes for a Lean transport certificate.

Fearnhead · Nemeth · Oates · Sherlock

Markov Chain Monte Carlo Route

General-state kernel construction, scalable MCMC and estimation. Shared with continuous and discrete sampling without identifying a method family with a target class.

Route milestones

planned01

Kernel → invariance → convergence

§§1.3,2.1 and Roberts–Rosenthal §§2–4; no SDE/RKHS bottleneck for finite MH or Gibbs.

planned02

Diffusions / geometry / estimation branch separately

ULA and MALA reuse shared analysis with exact clock/bias adapters; HMC and PDMP need augmented-state contracts.

scaffold03

Six primary chapters and ten extensions

Every extension has a parent chapter and its own pinned source. No theorem-completion credit.

candidate04

Conceptual bridges with independent review

Metropolis correction, weak limits, lifting, perturbation and block conditionals. Candidate labels never certify formal transport.

All routes · shared prerequisite partial order

Share mathematical cores; keep transports explicit.

First satisfy the front-loaded four-textbook critical path, then select a dependency-ready theorem delta with the largest audited downstream reuse per realistic proof cost. Textbook order is a source order, not necessarily the optimal Lean dependency order.

Convexity, measure theory and calculus start in parallel after contract alignment. Their consumers branch, rather than waiting for every textbook chapter. These are planned reuse audits, not compiler-certified dependency edges.

planned-reuse-audit

Fix statements, spaces and access contracts

Parents: none — start here

Pin measures, spaces, norms, constants, metrics, input access, randomness, output error and source editions before comparing or sharing routes.

Reuse search: Samplinglib Registry; active Frontier Cells; source maps; frontloaded-shared-spine.json

Consumers: all, discrete-sampling, mcmc
planned-reuse-audit

Euclidean, inner-product and matrix floor

Parents: contracts

Coordinates, inner products, norms, symmetric/PSD matrices and quadratic-energy conventions used repeatedly in the first textbook window.

Reuse search: Mathlib inner-product/matrix APIs; TechnicalLemmas/Geometry/EuclideanSpaceCoordinates.lean

Consumers: log-concave-sampling, optimisation, riemannian-optimization, statistical-optimal-transport, discrete-sampling, mcmc
planned-reuse-audit

Measures, integration, maps and kernels floor

Parents: contracts

Probability normalization, pushforwards, products, marginal transfer, finite moments and deterministic-map versus kernel interfaces.

Reuse search: TechnicalLemmas/Measure; Mathlib MeasureTheory and Probability.Kernel

Consumers: log-concave-sampling, statistical-optimal-transport, samplewiki-route, higher-order-sampling, discrete-sampling, mcmc
planned-reuse-audit

Shared probability kernels and composition

Parents: measure

One measurable-kernel, composition and stationarity API with finite PMF adapters. No spatial differentiation is required.

Reuse search: Samplinglib Probability.ConditionalKernel; Mathlib Probability.Kernel and PMF

Consumers: discrete-sampling, log-concave-sampling, statistical-optimal-transport, mcmc
planned-reuse-audit

Scalar decay and contraction recurrence core

Parents: contracts

Scalar differential/recurrence comparison after the consumer proves its own dissipation identity. No manifold, OT, SDE or strong-convexity prerequisite.

Reuse search: Samplinglib FunctionalInequalities.SemigroupDecay; Mathlib scalar Gronwall and finite geometric sums

Consumers: discrete-sampling, log-concave-sampling, optimisation, riemannian-optimization, statistical-optimal-transport, mcmc
planned-reuse-audit

Differentiation, gradients, chain rules and Taylor bounds

Parents: contracts, linear-algebra

Source-neutral normed-space derivative/gradient/chain-rule interfaces; manifold and stochastic adapters remain explicit.

Reuse search: TechnicalLemmas/Analysis/Calculus; TechnicalLemmas/Analysis/Calculus/Taylor.lean; Mathlib calculus

Consumers: log-concave-sampling, optimisation, riemannian-optimization, statistical-optimal-transport, higher-order-sampling, mcmc
planned-reuse-audit

Convexity, strong convexity, subgradients and log-concavity adapters

Parents: contracts, linear-algebra

One Euclidean convex/subgradient/strong-convexity core; log-concavity, geodesic convexity, mixture convexity and displacement convexity are typed adapters or separate statements.

Reuse search: TechnicalLemmas/Analysis/ConvexSubgradient.lean; Geometry/{StrongConvexity,LogConcavity}.lean; Mathlib; Optlib; CvxLean

Consumers: log-concave-sampling, optimisation, statistical-optimal-transport, riemannian-optimization, samplewiki-route, mcmc
planned-reuse-audit

Couplings and minimal Wasserstein metric core

Parents: linear-algebra, measure

Shared coupling membership, marginal bookkeeping, p-moment costs, deterministic couplings and metric identities needed by OT Chapter 1 and Sampling §1.3 before route-local transport code is written.

Reuse search: TechnicalLemmas/Measure/{ProbabilityCouplingCompactness,TransportGluing,DisplacementInterpolationCoupling}.lean; pinned Mathlib Wasserstein audit

Consumers: log-concave-sampling, statistical-optimal-transport, discrete-sampling, mcmc
planned-reuse-audit

Convex conjugacy and duality pulled forward

Parents: measure, convex

Extract only the Fenchel/conjugacy core needed by OT §§1.5-1.6 from Optimization Chapter 9 without pretending Chapter 9 is complete.

Reuse search: Mathlib convex conjugacy; Optlib/CvxLean; Chewi Optimization Ch.9; OT Ch.1 exact hypotheses

Consumers: statistical-optimal-transport, optimisation
planned-reuse-audit

Finite reversible chain / variance / entropy adapters

Parents: kernel-algebra, linear-algebra, scalar-decay

Pull §3 forward: detailed balance, weighted L2 and Dirichlet identities; pair them with shared coercivity/decay without a diffusion chain rule. Fix P^k versus exp(t(P-I)), all rates and periodicity.

Reuse search: Mathlib PMF/Kernel/Matrix; Samplinglib Poincare, Generator, SemigroupDecay; primary §3

Consumers: discrete-sampling, log-concave-sampling, mcmc
planned-reuse-audit

Feasible pinnings and conditional influence/covariance

Parents: kernel-algebra, linear-algebra

Share finite conditional probability and covariance algebra, then prove uniform pinning bounds. Spectral independence is not Euclidean strong convexity.

Reuse search: Mathlib conditional probability, covariance, PSD matrices, SimpleGraph and Matroid; primary §§2,4.1

Consumers: discrete-sampling, optimisation
planned-reuse-audit

Diffusion generator and spatial-calculus adapter

Parents: kernel-algebra, calculus

Consume shared kernel algebra, then prove diffusion generator domains and integration by parts. Finite chains use finite-dirichlet and never wait for this spatial-calculus branch.

Reuse search: Mathlib Probability.Kernel; TechnicalLemmas/StochasticProcesses; FunctionalInequalities

Consumers: log-concave-sampling, samplewiki-route, mcmc
planned-reuse-audit

Minimal first-order manifold adapter

Parents: linear-algebra, calculus

Tangent spaces, differential, Riemannian metric and gradient interfaces. Boumal Chapter 3 may be pulled forward to unblock Sampling §2.5, with exact source dependencies retained.

Reuse search: Mathlib manifold APIs; TechnicalLemmas/Geometry/GeodesicConvexity.lean; ATLAS geometry memory

Consumers: log-concave-sampling, riemannian-optimization
planned-reuse-audit

Empirical measures and concentration floor

Parents: measure, convex

Share empirical-measure bookkeeping, Lipschitz-observable and basic concentration interfaces between Sampling §2.4 and OT Chapter 2; keep chaining, isoperimetry and minimax lower bounds separate unless statements exactly match.

Reuse search: Mathlib probability/concentration; FunctionalInequalities; compatible lean-stat-learning-theory leaves

Consumers: log-concave-sampling, statistical-optimal-transport
planned-reuse-audit

Transport existence, Brenier/duality wrappers and displacement

Parents: convex, coupling-wasserstein, duality

Build source-facing OT theorems on the shared metric/convex floor. Sampling §1.3 consumes the canonical transport core rather than creating a second mini-library.

Reuse search: TechnicalLemmas/Measure transport files; OT Chapter 1; Sampling §1.3; source-specific Brenier/Kantorovich hypotheses

Consumers: log-concave-sampling, statistical-optimal-transport, samplewiki-route
planned-reuse-audit

Gibbs variational principle, KL and functional-inequality energy

Parents: measure, convex

Common entropy/KL/convex core supports Sampling Chapter 2, OT Chapter 4 and proximal/MFLD routes; invariant-law and semigroup claims remain separate.

Reuse search: TechnicalLemmas/InformationTheory; FunctionalInequalities; existing Fisher/entropy APIs; primary proofs

Consumers: log-concave-sampling, samplewiki-route, statistical-optimal-transport, discrete-sampling, mcmc
planned-reuse-audit

Energy-dissipation and geometry-to-flow interfaces

Parents: calculus, convex, transport, entropy

Share scalar energy-dissipation/Gronwall patterns first; connect Euclidean, Riemannian and Wasserstein flows only through explicit adapters whose hypotheses are proved.

Reuse search: Optimization Ch.2; Sampling §§1.4-1.5; existing weak FP/FisherTransport APIs; AGS metric gradient-flow contracts

Consumers: log-concave-sampling, optimisation, riemannian-optimization, statistical-optimal-transport, samplewiki-route, mcmc
planned-reuse-audit

Statistical OT and metric-geometry branches

Parents: transport, concentration

OT Chapters 2-3 empirical/statistical leaves and 7-8 metric geometry branch. Statistical observation count n is never identified with sampling oracle cost.

Reuse search: OT Chapter 2-3 assumptions; Mathlib probability; concentration sources; statistical rather than computational n

Consumers: statistical-optimal-transport, mcmc
planned-reuse-audit

Higher-smoothness sampling upper bounds

Parents: measure, calculus, convex

Fix one potential class and oracle, prove local remainder/moment bounds and invariant target, then combine with an existing compatible contraction theorem.

Reuse search: Nesterov high-order Taylor models; Mou et al.; Shen-Lee; pinned sampling contraction leaves

Consumers: higher-order-sampling
planned-reuse-audit

Sampling oracle lower bounds

Parents: contracts, measure

Separate hard-instance and information-transcript lane. Additional convexity or statistical-testing ingredients are task-specific, not every upper-bound lemma.

Reuse search: SampleWiki exact lower-bound papers; oracle transcript kernels; testing/data-processing APIs

Consumers: samplewiki-route, discrete-sampling
planned-reuse-audit

Compare matched upper and lower contracts

Parents: upper, lower

Only compare identical potential classes, derivative access, error metrics, starts and cost conventions. A cross-domain lower bound requires an explicit reduction.

Reuse search: Common contract schema; no theorem equivalence inferred from a shared label

Consumers: all
planned-reuse-audit

Factorization and model-specific discrete mixing

Parents: finite-dirichlet, conditional-influence, entropy

Separate variance and entropy factorization, gap and mLSI, then audited Ising/hard-core/matroid adapters. §12 cited results require external proof completion.

Reuse search: Primary §§4-12; LPW; Chen-Liu-Vigoda and Blanca et al.; exact graph/temperature/clock contracts

Consumers: discrete-sampling
planned-reuse-audit

MCMC kernel construction and target invariance

Parents: kernel-algebra

General measurable kernels, MH rejection mass/support and conditional-update invariance. Keep path existence and mixing separate.

Reuse search: Existing Probability/ConditionalKernel, StochasticProcesses; pinned Mathlib Kernel; RR §2

Consumers: mcmc, discrete-sampling, log-concave-sampling
planned-reuse-audit

General-state drift, minorisation and coupling

Parents: mcmc-invariance, scalar-decay

Source-specific geometric/uniform ergodicity; finite-state adapter does not require SDEs.

Reuse search: RR §§3–4; pinned Mathlib measures, stopping times and coupling APIs

Consumers: mcmc, discrete-sampling, log-concave-sampling
planned-reuse-audit

Correlated averages and Poisson/CLT layer

Parents: mcmc-ergodicity, linear-algebra

Prove covariance/Poisson/regeneration hypotheses for estimator error, not only marginal mixing.

Reuse search: RR §5; shared covariance and integral interfaces

Consumers: mcmc, statistical-optimal-transport

Explore the Functor Hypergraph · Higher-order sampling research contract

Shared Lean floor

Parallel above; canonical below.

Geometry checkpoint

Chewi sampling §2.5 ↔ Boumal

Riemannian manifolds, tangent-space/differential interfaces, gradients, metrics, and related analysis are candidates for one canonical shared foundation after convention compatibility is proved.

Optimisation checkpoints

Chewi sampling §4.3 / Ch. 8 / Ch. 10 ↔ Chewi Optimisation

Convex analysis, proximal structure, mirror geometry, and stochastic-gradient primitives may be shared. Sampler kernels, invariant-law arguments, and route-specific source theorems remain separate.

Collision rule

Reuse → adapt → shared cell

Exact match → reuse. Near match → canonical core plus explicit adapter. Missing theorem needed by multiple routes → one shared Frontier Cell. Different theorem → keep separate.

ASTIS Harness · collaborative contract

One state machine, one shared Lean floor.

claimedproved locallyindependently verifiedstabilizedmerged
blockedsmaller child theoremverifiedre-entry
Before proving

Search and classify

Search Samplinglib, Mathlib, active shared cells, and relevant formal upstreams. Record reuse, adapt, missing, or out_of_scope before adding a declaration.

Shared lemma collision

One canonical shared cell

If two routes need the same missing lower-level theorem, record decision: new_canonical_shared, keep the route-local cell at claimed, and open/depend on one route: shared Frontier Cell. Parallel duplicate implementations are rejected by the protocol validator.

Integration

Single stabilization lane

Shared aggregators, root registries, duplicate API resolution, graph regeneration, and final root builds are serialized after independent verification.

Shared-foundation Frontier Cells

ASTIS-SHARED-canonical-fisher-transport-pairingproved locally

Canonical relative score paired with an optimal coupling

For a coupling gamma of finite-second-moment measures mu and nu, the pairing of gradient(logRatio mu pi)(x) with y-x is integrable whenever the existing smooth finite score domain holds. If gamma is quadratic-optimal, the absolute pairing integral is at most sqrt(information mu pi hscore) times wassersteinDistance mu nu toReal. Measurability, integrability and finite real cost identification are proved, not added as pairing premises.

ASTIS-SHARED-conditional-resampling-lawindependently verified

Recover a joint law from a marginal and conditional distribution

For measurable spaces α and nonempty Standard-Borel β, a finite measure μ on α × β is recovered exactly by the composition-product of its first marginal and the regular conditional law of the second coordinate given the first.

ASTIS-SHARED-coordinate-heat-bathindependently verified

Operational finite-coordinate heat-bath retention

For X : Fin(n+1) -> Type with measurable coordinates, finite mu including zero, and selected i with nonempty StandardBorel X i, define heatBath X mu i by inverse-map/comap conjugation of heatBathSnd through piFinSuccAbove then prodComm. It is Markov and invariant. For each retained j != i with MeasurableSingletonClass (X j), every input x has almost every output y satisfying y j = x j.

ASTIS-SHARED-coordinate-heat-bath-positive-fiberindependently verified

Actual coordinate heat-bath law on positive retained fibers

For dependent finite coordinates X, finite mu, selected i with Nonempty and StandardBorelSpace (X i), and MeasurableSingletonClass on the native retained product, heatBath X mu i x equals cond mu {y | retained_i y = retained_i x} whenever that fiber has nonzero mu mass.

ASTIS-SHARED-finite-kernel-mixtureindependently verified

Fixed finite convex mixtures preserve a common invariant law

For finite ι, fixed w : ι → ℝ≥0 with sum w = 1 and kernels κ i preserving the same arbitrary measure μ, construct the finite mixture and prove μ invariant. Markov components give a Markov mixture. The selected withDensity implementation requires s-finite component kernels, automatically supplied by Markovness; μ requires no finiteness or s-finiteness.

ASTIS-SHARED-gaussian-rgo-conditional-kernelindependently verified

Explicit Gaussian RGO kernel and actual joint-law disintegration

For any probability law μ on finite-dimensional real inner-product Borel E and η>0, construct an actual measurable Markov kernel R with R(y)=μ.tilted(x↦−‖x−y‖²/(2η)) at every y, and prove that R disintegrates the swapped actual law of (X,X+sqrt(η)G), with independent X~μ and standard Gaussian G.

ASTIS-SHARED-heat-bath-snd-invarianceindependently verified

Second-coordinate heat-bath kernel preserves its finite joint law

For finite μ on α × β with measurable α and nonempty Standard-Borel β, construct heatBathSnd μ by retaining the first coordinate and drawing the second from condDistrib snd fst μ; show the kernel is Markov, has pointwise law dirac x.1 × condDistrib snd fst μ x.1, and leaves μ invariant. Exercise its finite powers through the existing invariant_pow interface.

ASTIS-SHARED-hessian-strong-convexityindependently verified

A genuine second-derivative lower bound implies strong convexity

For a real normed space E, a C² real potential V and any real α, if α*‖v‖² ≤ D²V(x)[v,v] for every x,v, then StrongConvexOn univ α V. The second derivative is the derivative of the genuine first derivative supplied by C².

ASTIS-SHARED-isotropic-gaussian-densityindependently verified

Explicit volume density of isotropic Gaussian noise

For every finite-dimensional real inner-product Borel space E and eta>0, the map of stdGaussian E by z -> sqrt(eta) z is volume.withDensity of ofReal((sqrt(2*pi*eta))^(-finrank R E) * exp(-norm(z)^2/(2*eta))). The natural-power inverse normalizer includes dimension zero. This is only the isotropic-noise density dependency; the augmentation identity is a separate next edge.

ASTIS-SHARED-kernel-invariant-transportindependently verified

Invariant-kernel transport through a measurable equivalence

For arbitrary measurable spaces alpha and beta, arbitrary kernel kappa : Kernel alpha alpha and measure mu, and measurable equivalence e : alpha equiv beta, kappa.Invariant mu implies ((kappa.comap e.symm e.symm.measurable).map e).Invariant (mu.map e). No Markov, finite, s-finite, Standard Borel or nonempty hypotheses.

+ 50 additional registered cells.

Open ASTIS Harness Protocol docs ↗ Claim a Frontier Cell ↗

Read the supporting proofs

Mathematical derivations with optional Lean and source details.

Complete declaration-by-declaration teaching coverage