Documentation

TauCeti.NumberTheory.NumberField.Units.SUnit.FundamentalSystem

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 #

References #

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
      @[simp]

      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.

      Instances For

        A family of S-units is a fundamental system exactly when its classes modulo torsion form a basis of the S-units modulo torsion.