A coherence tactic for monoidal categories

We provide a coherence tactic, which proves equations where the two sides differ by replacing strings of monoidal structural morphisms with other such strings. (The replacements are always equalities by the monoidal coherence theorem.)

A simpler version of this tactic is pure_coherence, which proves that any two morphisms (with the same source and target) in a monoidal category which are built out of associators and unitors are equal.

class Mathlib.Tactic.Coherence.LiftObj {C : Type u} (X : C) : Type u

A typeclass carrying a choice of lift of an object from C to FreeMonoidalCategory C. It must be the case that projectObj id (LiftObj.lift x) = x by defeq.

• lift : CategoryTheory.FreeMonoidalCategory C

@[implicit_reducible]

instance Mathlib.Tactic.Coherence.LiftObj_unit {C : Type u} [CategoryTheory.Category.{v, u} C] [CategoryTheory.MonoidalCategory C] : LiftObj (CategoryTheory.MonoidalCategoryStruct.tensorUnit C)

@[implicit_reducible]

instance Mathlib.Tactic.Coherence.LiftObj_tensor {C : Type u} [CategoryTheory.Category.{v, u} C] [CategoryTheory.MonoidalCategory C] (X Y : C) [LiftObj X] [LiftObj Y] : LiftObj (CategoryTheory.MonoidalCategoryStruct.tensorObj X Y)

@[implicit_reducible, instance 100]

instance Mathlib.Tactic.Coherence.LiftObj_of {C : Type u} (X : C) : LiftObj X

class Mathlib.Tactic.Coherence.LiftHom {C : Type u} [CategoryTheory.Category.{v, u} C] {X Y : C} [LiftObj X] [LiftObj Y] (f : X ⟶ Y) : Type u

A typeclass carrying a choice of lift of a morphism from C to FreeMonoidalCategory C. It must be the case that projectMap id _ _ (LiftHom.lift f) = f by defeq.

• lift : LiftObj.lift X ⟶ LiftObj.lift Y

@[implicit_reducible]

instance Mathlib.Tactic.Coherence.LiftHom_id {C : Type u} [CategoryTheory.Category.{v, u} C] (X : C) [LiftObj X] : LiftHom (CategoryTheory.CategoryStruct.id X)

@[implicit_reducible]

instance Mathlib.Tactic.Coherence.LiftHom_left_unitor_hom {C : Type u} [CategoryTheory.Category.{v, u} C] [CategoryTheory.MonoidalCategory C] (X : C) [LiftObj X] : LiftHom (CategoryTheory.MonoidalCategoryStruct.leftUnitor X).hom

@[implicit_reducible]

instance Mathlib.Tactic.Coherence.LiftHom_left_unitor_inv {C : Type u} [CategoryTheory.Category.{v, u} C] [CategoryTheory.MonoidalCategory C] (X : C) [LiftObj X] : LiftHom (CategoryTheory.MonoidalCategoryStruct.leftUnitor X).inv

@[implicit_reducible]

instance Mathlib.Tactic.Coherence.LiftHom_right_unitor_hom {C : Type u} [CategoryTheory.Category.{v, u} C] [CategoryTheory.MonoidalCategory C] (X : C) [LiftObj X] : LiftHom (CategoryTheory.MonoidalCategoryStruct.rightUnitor X).hom

@[implicit_reducible]

instance Mathlib.Tactic.Coherence.LiftHom_right_unitor_inv {C : Type u} [CategoryTheory.Category.{v, u} C] [CategoryTheory.MonoidalCategory C] (X : C) [LiftObj X] : LiftHom (CategoryTheory.MonoidalCategoryStruct.rightUnitor X).inv

@[implicit_reducible]

instance Mathlib.Tactic.Coherence.LiftHom_associator_hom {C : Type u} [CategoryTheory.Category.{v, u} C] [CategoryTheory.MonoidalCategory C] (X Y Z : C) [LiftObj X] [LiftObj Y] [LiftObj Z] : LiftHom (CategoryTheory.MonoidalCategoryStruct.associator X Y Z).hom

@[implicit_reducible]

instance Mathlib.Tactic.Coherence.LiftHom_associator_inv {C : Type u} [CategoryTheory.Category.{v, u} C] [CategoryTheory.MonoidalCategory C] (X Y Z : C) [LiftObj X] [LiftObj Y] [LiftObj Z] : LiftHom (CategoryTheory.MonoidalCategoryStruct.associator X Y Z).inv

@[implicit_reducible]

instance Mathlib.Tactic.Coherence.LiftHom_comp {C : Type u} [CategoryTheory.Category.{v, u} C] {X Y Z : C} [LiftObj X] [LiftObj Y] [LiftObj Z] (f : X ⟶ Y) (g : Y ⟶ Z) [LiftHom f] [LiftHom g] : LiftHom (CategoryTheory.CategoryStruct.comp f g)

@[implicit_reducible]

instance Mathlib.Tactic.Coherence.liftHom_WhiskerLeft {C : Type u} [CategoryTheory.Category.{v, u} C] [CategoryTheory.MonoidalCategory C] (X : C) [LiftObj X] {Y Z : C} [LiftObj Y] [LiftObj Z] (f : Y ⟶ Z) [LiftHom f] : LiftHom (CategoryTheory.MonoidalCategoryStruct.whiskerLeft X f)

@[implicit_reducible]

instance Mathlib.Tactic.Coherence.liftHom_WhiskerRight {C : Type u} [CategoryTheory.Category.{v, u} C] [CategoryTheory.MonoidalCategory C] {X Y : C} (f : X ⟶ Y) [LiftObj X] [LiftObj Y] [LiftHom f] {Z : C} [LiftObj Z] : LiftHom (CategoryTheory.MonoidalCategoryStruct.whiskerRight f Z)

@[implicit_reducible]

instance Mathlib.Tactic.Coherence.LiftHom_tensor {C : Type u} [CategoryTheory.Category.{v, u} C] [CategoryTheory.MonoidalCategory C] {W X Y Z : C} [LiftObj W] [LiftObj X] [LiftObj Y] [LiftObj Z] (f : W ⟶ X) (g : Y ⟶ Z) [LiftHom f] [LiftHom g] : LiftHom (CategoryTheory.MonoidalCategoryStruct.tensorHom f g)

def Mathlib.Tactic.Coherence.exception {α : Type} (g : Lean.MVarId) (msg : Lean.MessageData) : Lean.MetaM α

Helper function for throwing exceptions.

def Mathlib.Tactic.Coherence.exception' (msg : Lean.MessageData) : Lean.Elab.Tactic.TacticM Unit

Helper function for throwing exceptions with respect to the main goal.

def Mathlib.Tactic.Coherence.mkProjectMapExpr (e : Lean.Expr) : Lean.Elab.TermElabM Lean.Expr

Auxiliary definition for monoidal_coherence.

def Mathlib.Tactic.Coherence.monoidal_coherence (g : Lean.MVarId) : Lean.Elab.TermElabM Unit

Coherence tactic for monoidal categories.

opaque Mathlib.Tactic.Coherence.warn.refl_coherence : Lean.Option Bool

If set to false, the warning on the use of the deprecated coherence tactic is disabled.

def Mathlib.Tactic.Coherence.pure_coherence : Lean.ParserDescr

pure_coherence uses the coherence theorem for monoidal categories to prove the goal. It can prove any equality made up only of associators, unitors, and identities.

example {C : Type} [Category* C] [MonoidalCategory C] :
  (λ_ (𝟙_ C)).hom = (ρ_ (𝟙_ C)).hom := by
  pure_coherence

Users will typically just use the coherence tactic, which can also cope with identities of the form a ≫ f ≫ b ≫ g ≫ c = a' ≫ f ≫ b' ≫ g ≫ c' where a = a', b = b', and c = c' can be proved using pure_coherence

def Mathlib.Tactic.Coherence.pure_coherence_internal : Lean.ParserDescr

The same as pure_coherence, but used internally in coherence without the warning.

theorem Mathlib.Tactic.Coherence.assoc_liftHom {C : Type u} [CategoryTheory.Category.{v, u} C] {W X Y Z : C} [LiftObj W] [LiftObj X] [LiftObj Y] (f : W ⟶ X) (g : X ⟶ Y) (h : Y ⟶ Z) [LiftHom f] [LiftHom g] : CategoryTheory.CategoryStruct.comp f (CategoryTheory.CategoryStruct.comp g h) = CategoryTheory.CategoryStruct.comp (CategoryTheory.CategoryStruct.comp f g) h

Auxiliary simp lemma for the coherence tactic: this moves brackets to the left in order to expose a maximal prefix built out of unitors and associators.

def Mathlib.Tactic.Coherence.liftable_prefixes : Lean.ParserDescr

Internal tactic used in coherence.

Rewrites an equation f = g as f₀ ≫ f₁ = g₀ ≫ g₁, where f₀ and g₀ are maximal prefixes of f and g (possibly after reassociating) which are "liftable" (i.e. expressible as compositions of unitors and associators).

theorem Mathlib.Tactic.Coherence.insert_id_lhs {C : Type u_1} [CategoryTheory.Category.{v_1, u_1} C] {X Y : C} (f g : X ⟶ Y) (w : CategoryTheory.CategoryStruct.comp f (CategoryTheory.CategoryStruct.id Y) = g) : f = g

theorem Mathlib.Tactic.Coherence.insert_id_rhs {C : Type u_1} [CategoryTheory.Category.{v_1, u_1} C] {X Y : C} (f g : X ⟶ Y) (w : f = CategoryTheory.CategoryStruct.comp g (CategoryTheory.CategoryStruct.id Y)) : f = g

def Mathlib.Tactic.Coherence.insertTrailingIds (g : Lean.MVarId) : Lean.MetaM Lean.MVarId

If either the lhs or rhs is not a composition, compose it on the right with an identity.

def Mathlib.Tactic.Coherence.coherence_loop (maxSteps : ℕ := 37) : Lean.Elab.Tactic.TacticM Unit

The main part of coherence tactic.

def Mathlib.Tactic.Coherence.monoidal_simps : Lean.ParserDescr

Simp lemmas for rewriting a hom in monoidal categories into a normal form.

def Mathlib.Tactic.Coherence.coherence : Lean.ParserDescr

Use the coherence theorem for monoidal categories to solve equations in a monoidal equation, where the two sides only differ by replacing strings of monoidal structural morphisms (that is, associators, unitors, and identities) with different strings of structural morphisms with the same source and target.

That is, coherence can handle goals of the form a ≫ f ≫ b ≫ g ≫ c = a' ≫ f ≫ b' ≫ g ≫ c' where a = a', b = b', and c = c' can be proved using pure_coherence.

(If you have very large equations on which coherence is unexpectedly failing, you may need to increase the typeclass search depth, using e.g. set_option synthInstance.maxSize 500.)