toMathlib
toMathlib: Supporting Infrastructure
This page records the supporting algebra that sits behind the main BEI files. It is mainly for readers who want to know what general-purpose commutative algebra and monomial-ideal infrastructure had to be added locally in order to formalize the paper.
How to read this page
The toMathlib/ directory has three roles:
- local support for the equidimensional surrogate track;
- real Cohen–Macaulay foundations, partially adapted from Mathlib PR
#26218; - project-specific algebra and combinatorics needed for the BEI proofs.
If you only want the mathematical results from the paper, the section pages are the better starting point. This page is about the support layer behind them.
Equidimensional surrogate support
| File | Lean declarations | Status | Notes |
|---|---|---|---|
| toMathlib/Equidim/Defs.lean | IsEquidimRing |
formalized | Local working definition of equidimensionality used in the surrogate branch |
toMathlib/Equidim/Defs.lean provides the local equidimensional stand-in used
by the direct surrogate route. It is not the paper’s full
Cohen–Macaulay definition.
Real Cohen–Macaulay foundations
| File | Lean declarations | Status | Notes |
|---|---|---|---|
| toMathlib/CohenMacaulay/Defs.lean | ringDepth, IsCohenMacaulayLocalRing, IsCohenMacaulayRing, weaklyRegular_length_le_ringKrullDim, ringDepth_le_ringKrullDim |
formalized | First real CM definition layer in the repo |
| toMathlib/CohenMacaulay/Basic.lean | quotSMulTop_nontrivial, quotSMulTopLocalRing, ringDepth_quotSMulTop_succ_le, isCohenMacaulayLocalRing_of_regular_quotient |
formalized | Quotient-local-ring setup, the easy depth inequality, and the converse regular-quotient CM transfer |
| toMathlib/CohenMacaulay/Localization.lean | isCohenMacaulayLocalRing_quotient, associatedPrimes_subset_minimalPrimes_of_isCohenMacaulayLocalRing, isCohenMacaulayLocalRing_localization_atPrime, IsCohenMacaulayRing.of_isCohenMacaulayLocalRing |
formalized | Ext/Rees machinery, forward CM transfer, unmixedness, and localization/globalization for CM local rings |
These files build the real Cohen–Macaulay layer used by the Proposition 1.6 work:
Defs.leangives a local working CM definition via regular-sequence depth;Basic.leansets up the quotient-local-ring layer and the basic local criteria;Localization.leannow completes the local CM localization packet.
This still does not by itself finish the paper’s Proposition 1.6 route. The remaining work is in the project files, where these general theorems are applied to the Herzog–Hibi side and then transferred back to the original binomial edge ideal.
Monomial ideal infrastructure
| File | Lean declarations | Status | Notes |
|---|---|---|---|
| toMathlib/MonomialIdeal.lean | Ideal.not_mem_exists_monomial_notMem, Ideal.IsMonomial, MvPolynomial.isPrime_span_X_image_set, Ideal.exists_variable_mem_of_monomial_mem_prime, Ideal.IsMonomial.isPrime_iff_eq_span_X_image, Ideal.IsMonomial.isPrimary_iff |
formalized | Prime and primary theory for monomial ideals in MvPolynomial |
This file contains the main monomial-ideal tools used in the BEI proofs:
- support extraction for ideals in
MvPolynomial; - classification of prime monomial ideals as variable-generated ideals;
- characterization of primary monomial ideals.
Squarefree monomial primes and vertex covers
| File | Lean declarations | Status | Notes |
|---|---|---|---|
| toMathlib/SquarefreeMonomialPrimes.lean | MvPolynomial.variablePairIdeal, MvPolynomial.IsVertexCover, MvPolynomial.IsMinimalVertexCover, MvPolynomial.variablePairIdeal_le_span_X_iff, MvPolynomial.minimalPrime_variablePairIdeal_iff, MvPolynomial.variablePairIdeal_isRadical |
formalized | Edge-ideal / vertex-cover / minimal-prime support layer |
This file packages the squarefree monomial ideal facts needed on the Herzog–Hibi side of Proposition 1.6:
- variable-pair ideals for edge sets;
- minimal vertex covers;
- minimal prime classification;
- radicality of the variable-pair ideal.
Variable ideal quotient and dimension formulas
| File | Lean declarations | Status | Notes |
|---|---|---|---|
| toMathlib/HeightVariableIdeal.lean | ker_killS_eq_span_X_image, killS_surjective, quotientSpanXEquiv, MvPolynomial.ringKrullDim_quotient_span_X_image, MvPolynomial.ringKrullDim_quotient_span_X_eq_of_card_eq |
formalized | Quotient equivalences and dimension formulas for variable-generated ideals |
These theorems are used in Proposition 1.6 to compare quotient dimensions after reducing to variable-generated prime ideals.