Monoids with normalization functions, gcd
, and lcm
#
This file defines extra structures on CancelCommMonoidWithZero
s, including IsDomain
s.
Main Definitions #
NormalizationMonoid
GCDMonoid
NormalizedGCDMonoid
gcdMonoidOfGCD
,gcdMonoidOfExistsGCD
,normalizedGCDMonoidOfGCD
,normalizedGCDMonoidOfExistsGCD
gcdMonoidOfLCM
,gcdMonoidOfExistsLCM
,normalizedGCDMonoidOfLCM
,normalizedGCDMonoidOfExistsLCM
For the NormalizedGCDMonoid
instances on ℕ
and ℤ
, see Mathlib.Algebra.GCDMonoid.Nat
.
Implementation Notes #
NormalizationMonoid
is defined by assigning to each element anormUnit
such that multiplying by that unit normalizes the monoid, andnormalize
is an idempotent monoid homomorphism. This definition as currently implemented does casework on0
.GCDMonoid
contains the definitions ofgcd
andlcm
with the usual properties. They are both determined up to a unit.NormalizedGCDMonoid
extendsNormalizationMonoid
, so thegcd
andlcm
are always normalized. This makesgcd
s of polynomials easier to work with, but excludes Euclidean domains, and monoids without zero.gcdMonoidOfGCD
andnormalizedGCDMonoidOfGCD
noncomputably construct aGCDMonoid
(resp.NormalizedGCDMonoid
) structure just from thegcd
and its properties.gcdMonoidOfExistsGCD
andnormalizedGCDMonoidOfExistsGCD
noncomputably construct aGCDMonoid
(resp.NormalizedGCDMonoid
) structure just from a proof that any two elements have a (not necessarily normalized)gcd
.gcdMonoidOfLCM
andnormalizedGCDMonoidOfLCM
noncomputably construct aGCDMonoid
(resp.NormalizedGCDMonoid
) structure just from thelcm
and its properties.gcdMonoidOfExistsLCM
andnormalizedGCDMonoidOfExistsLCM
noncomputably construct aGCDMonoid
(resp.NormalizedGCDMonoid
) structure just from a proof that any two elements have a (not necessarily normalized)lcm
.
TODO #
- Port GCD facts about nats, definition of coprime
- Generalize normalization monoids to commutative (cancellative) monoids with or without zero
Tags #
divisibility, gcd, lcm, normalize
Normalization monoid: multiplying with normUnit
gives a normal form for associated
elements.
- normUnit : α → αˣ
normUnit
assigns to each element of the monoid a unit of the monoid. The proposition that
normUnit
maps0
to the identity.The proposition that
normUnit
respects multiplication of non-zero elements.The proposition that
normUnit
maps units to their inverses.
Instances
Maps an element of Associates
back to the normalized element of its associate class
Equations
- Associates.out = Quotient.lift ⇑normalize ⋯
Instances For
GCD monoid: a CancelCommMonoidWithZero
with gcd
(greatest common divisor) and
lcm
(least common multiple) operations, determined up to a unit. The type class focuses on gcd
and we derive the corresponding lcm
facts from gcd
.
- gcd : α → α → α
The greatest common divisor between two elements.
- lcm : α → α → α
The least common multiple between two elements.
The GCD is a divisor of the first element.
The GCD is a divisor of the second element.
Any common divisor of both elements is a divisor of the GCD.
- gcd_mul_lcm (a b : α) : Associated (gcd a b * lcm a b) (a * b)
The product of two elements is
Associated
with the product of their GCD and LCM. 0
is left-absorbing.0
is right-absorbing.
Instances
Normalized GCD monoid: a CancelCommMonoidWithZero
with normalization and gcd
(greatest common divisor) and lcm
(least common multiple) operations. In this setting gcd
and
lcm
form a bounded lattice on the associated elements where gcd
is the infimum, lcm
is the
supremum, 1
is bottom, and 0
is top. The type class focuses on gcd
and we derive the
corresponding lcm
facts from gcd
.
- normUnit_zero : normUnit 0 = 1
- gcd : α → α → α
- lcm : α → α → α
The GCD is normalized to itself.
The LCM is normalized to itself.
Instances
Represent a divisor of m * n
as a product of a divisor of m
and a divisor of n
.
Note: In general, this representation is highly non-unique.
See Nat.prodDvdAndDvdOfDvdProd
for a constructive version on ℕ
.
Alias of Irreducible.prime
.
Alias of irreducible_iff_prime
.
Equations
- normalizationMonoidOfUniqueUnits = { normUnit := fun (x : α) => 1, normUnit_zero := ⋯, normUnit_mul := ⋯, normUnit_coe_units := ⋯ }
Equations
- uniqueNormalizationMonoidOfUniqueUnits = { default := normalizationMonoidOfUniqueUnits, uniq := ⋯ }
If a monoid's only unit is 1
, then it is isomorphic to its associates.
Equations
- associatesEquivOfUniqueUnits = { toFun := Associates.out, invFun := Associates.mk, left_inv := ⋯, right_inv := ⋯, map_mul' := ⋯ }
Instances For
Define NormalizationMonoid
on a structure from a MonoidHom
inverse to Associates.mk
.
Equations
- normalizationMonoidOfMonoidHomRightInverse f hinv = { normUnit := fun (a : α) => if a = 0 then 1 else Classical.choose ⋯, normUnit_zero := ⋯, normUnit_mul := ⋯, normUnit_coe_units := ⋯ }
Instances For
Define GCDMonoid
on a structure just from the gcd
and its properties.
Equations
- One or more equations did not get rendered due to their size.
Instances For
Define NormalizedGCDMonoid
on a structure just from the gcd
and its properties.
Equations
- normalizedGCDMonoidOfGCD gcd gcd_dvd_left gcd_dvd_right dvd_gcd normalize_gcd = NormalizedGCDMonoid.mk normalize_gcd ⋯
Instances For
Define GCDMonoid
on a structure just from the lcm
and its properties.
Equations
- One or more equations did not get rendered due to their size.
Instances For
Define NormalizedGCDMonoid
on a structure just from the lcm
and its properties.
Equations
- normalizedGCDMonoidOfLCM lcm dvd_lcm_left dvd_lcm_right lcm_dvd normalize_lcm = NormalizedGCDMonoid.mk ⋯ normalize_lcm
Instances For
Define a GCDMonoid
structure on a monoid just from the existence of a gcd
.
Equations
- gcdMonoidOfExistsGCD h = gcdMonoidOfGCD (fun (a b : α) => Classical.choose ⋯) ⋯ ⋯ ⋯
Instances For
Define a NormalizedGCDMonoid
structure on a monoid just from the existence of a gcd
.
Equations
- normalizedGCDMonoidOfExistsGCD h = normalizedGCDMonoidOfGCD (fun (a b : α) => normalize (Classical.choose ⋯)) ⋯ ⋯ ⋯ ⋯
Instances For
Define a GCDMonoid
structure on a monoid just from the existence of an lcm
.
Equations
- gcdMonoidOfExistsLCM h = gcdMonoidOfLCM (fun (a b : α) => Classical.choose ⋯) ⋯ ⋯ ⋯
Instances For
Define a NormalizedGCDMonoid
structure on a monoid just from the existence of an lcm
.
Equations
- normalizedGCDMonoidOfExistsLCM h = normalizedGCDMonoidOfLCM (fun (a b : α) => normalize (Classical.choose ⋯)) ⋯ ⋯ ⋯ ⋯
Instances For
Equations
Equations
- One or more equations did not get rendered due to their size.