Fundamental systems of S-units #
For a finite set S of finite places of a number field, the group of S-units modulo its
torsion subgroup is free of rank NumberField.Units.rank K + Nat.card S. Choosing a basis and
lifting it gives a fundamental system of S-units. Every S-unit then has a unique expression
as a torsion element times a product of integral powers of the fundamental system.
This is the decomposition form of Dirichlet's S-unit theorem. It supplies the generators whose logarithms form a basis of the S-unit lattice and on which the S-regulator is evaluated.
The construction follows Mathlib's ordinary-unit API in
Mathlib.NumberTheory.NumberField.Units.DirichletTheorem, especially
NumberField.Units.basisModTorsion, NumberField.Units.fundSystem, and
NumberField.Units.exist_unique_eq_mul_prod. The corresponding S-unit formalization also appears
in Ralf Stephan's ArithmeticHeights/SUnitTheorem.lean in rwst/Subspace-Theorems, commit
e443c2479e19f7665b31d8e94e2317c8ced1ca06, released under Apache 2.0.
Main definitions and results #
TauCeti.NumberField.SUnit.basisModTorsion: a basis of the S-units modulo torsion.TauCeti.NumberField.SUnit.fundSystem: arbitrary lifts of that basis to S-units.TauCeti.NumberField.SUnit.exist_unique_eq_mul_prod: unique decomposition of an S-unit into its torsion and free parts.TauCeti.NumberField.SUnit.closure_fundSystem_sup_torsion_eq_top: the fundamental system and torsion generate all S-units.TauCeti.NumberField.SUnit.IsFundSystem: an arbitrary family of S-units is a fundamental system: it has the right number of members and generates the S-units modulo torsion.TauCeti.NumberField.SUnit.isFundSystem_iff: a family is a fundamental system exactly when its classes form a basis of the S-units modulo torsion.
References #
- E. Bombieri and W. Gubler, Heights in Diophantine Geometry, Theorem 1.5.13.
A basis of the group of S-units modulo its torsion submodule.
Instances For
A fundamental system of S-units, obtained by lifting basisModTorsion through the quotient
by torsion.
Instances For
The image of a fundamental S-unit in the quotient by torsion is the corresponding basis vector.
The exponents in any torsion-times-fundamental-system expression are the basis coordinates of the S-unit modulo torsion.
Every S-unit has a unique expression as a torsion S-unit times a product of integral powers of the fundamental system.
The fundamental system and the torsion subgroup generate the full group of S-units.
Arbitrary fundamental systems #
A family ε of S-units is a fundamental system if it is indexed by a finite type with
NumberField.Units.rank K + Nat.card S elements and, together with the torsion subgroup,
generates the group of S-units.
- finite : Finite ι
The family is finite.
The family has
NumberField.Units.rank K + Nat.card Smembers.The family and the torsion subgroup generate the group of S-units.
Instances For
The chosen family TauCeti.NumberField.SUnit.fundSystem is a fundamental system.
A family of S-units is a fundamental system exactly when its classes modulo torsion form a basis of the S-units modulo torsion.