Skip to content

feat(NumberTheory/MulChar): the Teichmüller character - #45940

Open
xroblot wants to merge 6 commits into
leanprover-community:masterfrom
xroblot:teichmuller-character
Open

xroblot wants to merge 6 commits into
leanprover-community:masterfrom
xroblot:teichmuller-character

Conversation

@xroblot

@xroblot xroblot commented Nov 12, 2026 •

Copy link
Copy Markdown
Collaborator

This PR adds the Teichmüller character. The class Ideal.HasTeichmullerLift I n states that every unit of R ⧸ I is the reduction of a unique n-th root of unity of R; this holds for instance when R is a domain with enough n-th roots of unity, I is prime and (R ⧸ I)ˣ has order n. Under this class, inverting the reduction and extending by zero gives a multiplicative character of R ⧸ I with values in R, the so-called Teichmüller character.

The main results are that this character has order n, that its values at units are powers of a primitive n-th root of unity, and that it is compatible with Galois automorphisms, the key input for Gauss sums and Stickelberger's theorem.

🤖 This PR was extracted from the SKW project by Claude.


@github-actions

github-actions Bot commented Nov 12, 2026 •

Copy link
Copy Markdown

PR summary 8dc73c3842

Import changes for modified files

No significant changes to the import graph

Import changes for all files
Files Import difference
Mathlib.NumberTheory.NumberField.Cyclotomic.Galois Mathlib.NumberTheory.NumberField.Ideal.Basic 1
Mathlib.RingTheory.RootsOfUnity.Quotient (new file) 2014
Mathlib.NumberTheory.MulChar.Teichmuller (new file) 2017

Declarations diff (regex)

+ Ideal.HasTeichmullerLift
+ Ideal.HasTeichmullerLift.equiv
+ Ideal.HasTeichmullerLift.equiv_apply
+ Ideal.HasTeichmullerLift.equiv_symm_rootsOfUnityMapQuot
+ Ideal.HasTeichmullerLift.of_card
+ Ideal.HasTeichmullerLift.of_card_of_isPrime
+ Ideal.HasTeichmullerLift.rootsOfUnityMapQuot_equiv_symm
+ IsPrimitiveRoot.not_coprime_absNorm_of_mk_eq_one
+ exists_teichmuller_zpow_apply_eq_pow
+ map_ringHomComp_teichmuller_zpow_apply
+ mk_teichmuller_apply
+ mk_teichmuller_apply_coe
+ orderOf_teichmuller
+ rootsOfUnityMapQuot
+ rootsOfUnityMapQuot_apply
+ rootsOfUnityMapQuot_coe_apply
+ rootsOfUnityMapQuot_inj
+ rootsOfUnityMapQuot_injective
+ rootsOfUnityMapQuot_injective_of_notMem
+ teichmuller
+ teichmuller_apply_coe
+ teichmuller_apply_coe_pow_eq_one
+ teichmuller_mk_coe
+ teichmuller_ne_one_iff
+ teichmuller_pow_eq_one
+ teichmuller_zpow_eq_one_of_dvd
- Ideal.rootsOfUnityMapQuot
- Ideal.rootsOfUnityMapQuot_apply
- Ideal.rootsOfUnityMapQuot_inj
- Ideal.rootsOfUnityMapQuot_injective

You can run this locally as follows
## from your `mathlib4` directory:
git clone https://github.com/leanprover-community/mathlib-ci.git ../mathlib-ci

## summary with just the declaration names:
../mathlib-ci/scripts/pr_summary/declarations_diff.sh <optional_commit>

## more verbose report:
../mathlib-ci/scripts/pr_summary/declarations_diff.sh long <optional_commit>

The doc-module for scripts/pr_summary/declarations_diff.sh in the mathlib-ci repository contains some details about this script.

Declarations diff (Lean)

✅ Lean-aware diff — post-build, computed from the Lean environment (commit 8dc73c3).

  • +30 new declarations
  • −0 removed declarations
+Ideal.HasTeichmullerLift
+Ideal.HasTeichmullerLift.bijective_rootsOfUnityMapQuot
+Ideal.HasTeichmullerLift.casesOn
+Ideal.HasTeichmullerLift.equiv
+Ideal.HasTeichmullerLift.equiv.congr_simp
+Ideal.HasTeichmullerLift.equiv_apply
+Ideal.HasTeichmullerLift.equiv_symm_rootsOfUnityMapQuot
+Ideal.HasTeichmullerLift.mk
+Ideal.HasTeichmullerLift.of_card
+Ideal.HasTeichmullerLift.of_card_of_isPrime
+Ideal.HasTeichmullerLift.rec
+Ideal.HasTeichmullerLift.recOn
+Ideal.HasTeichmullerLift.rootsOfUnityMapQuot_equiv_symm
+Ideal.rootsOfUnityMapQuot_coe_apply
+Ideal.rootsOfUnityMapQuot_injective_of_notMem
+Ideal.torsionMapQuot.congr_simp
+IsPrimitiveRoot.not_coprime_absNorm_of_mk_eq_one
+MulChar.exists_teichmuller_zpow_apply_eq_pow
+MulChar.map_ringHomComp_teichmuller_zpow_apply
+MulChar.mk_teichmuller_apply
+MulChar.mk_teichmuller_apply_coe
+MulChar.orderOf_teichmuller
+MulChar.teichmuller
+MulChar.teichmuller.congr_simp
+MulChar.teichmuller_apply_coe
+MulChar.teichmuller_apply_coe_pow_eq_one
+MulChar.teichmuller_mk_coe
+MulChar.teichmuller_ne_one_iff
+MulChar.teichmuller_pow_eq_one
+MulChar.teichmuller_zpow_eq_one_of_dvd

No changes to strong technical debt.
No changes to weak technical debt.

Current commit 8dc73c3842
Reference commit e1545ebed9

This script lives in the mathlib-ci repository. To run it locally, from your mathlib4 directory:

git clone https://github.com/leanprover-community/mathlib-ci.git ../mathlib-ci
../mathlib-ci/scripts/reporting/technical-debt-metrics.py pr_summary
  • The relative value is the weighted sum of the differences with weight given by the inverse of the current value of the statistic.
  • The absolute value is the relative value divided by the total sum of the inverses of the current values (i.e. the weighted average of the differences).

@xroblot xroblot added the WIP Work in progress label Nov 12, 2026
@mathlib-dependent-issues mathlib-dependent-issues Bot added the blocked-by-other-PR This PR depends on another PR (this label is automatically managed by a bot) label Nov 12, 2026
@mathlib-dependent-issues

Copy link
Copy Markdown

This branch has not been deployed

No deployments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

blocked-by-other-PR This PR depends on another PR (this label is automatically managed by a bot)

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant