Quivers

This module defines quivers. A quiver on a type V of vertices assigns to every pair a b : V of vertices a type a ⟶ b of arrows from a to b. This is a very permissive notion of directed graph.

Implementation notes

Currently Quiver is defined with Hom : V → V → Sort v. This is different from the category theory setup, where we insist that morphisms live in some Type. There's some balance here: it's nice to allow Prop to ensure there are no multiple arrows, but it is also results in error-prone universe signatures when constraints require a Type.

class Quiver (V : Type u) : Type (max u v)

A quiver G on a type V of vertices assigns to every pair a b : V of vertices a type a ⟶ b of arrows from a to b.

For graphs with no repeated edges, one can use Quiver.{0} V, which ensures a ⟶ b : Prop. For multigraphs, one can use Quiver.{v+1} V, which ensures a ⟶ b : Type v.

Because Category will later extend this class, we call the field Hom. Except when constructing instances, you should rarely see this, and use the ⟶ notation instead.

• Hom : V → V → Sort v

  The type of edges/arrows/morphisms between a given source and target.

Instances

• CategoryTheory.Center.instQuiver
• CategoryTheory.Quiv.str'
• Quiver.emptyQuiver
• Quiver.instPush
• Quiver.opposite
• Quiver.symmetrifyQuiver

def «term_⟶_» : Lean.TrailingParserDescr

Notation for the type of edges/arrows/morphisms between a given source and target in a quiver or category.

Equations

• «term_⟶_» = Lean.ParserDescr.trailingNode `«term_⟶_» 10 11 (Lean.ParserDescr.binary `andthen (Lean.ParserDescr.symbol " ⟶ ") (Lean.ParserDescr.cat `term 10))

instance Quiver.opposite {V : Type u_1} [Quiver V] : Quiver Vᵒᵖ

Vᵒᵖ reverses the direction of all arrows of V.

Equations

• Quiver.opposite = { Hom := fun (a b : Vᵒᵖ) => (Opposite.unop b ⟶ Opposite.unop a)ᵒᵖ }

def Quiver.Hom.op {V : Type u_1} [Quiver V] {X Y : V} (f : X ⟶ Y) : Opposite.op Y ⟶ Opposite.op X

The opposite of an arrow in V.

Equations

• f.op = Opposite.op f

Instances For

• CategoryTheory.isIso_op
• CategoryTheory.op_epi_of_mono
• CategoryTheory.op_mono_of_epi

def Quiver.Hom.unop {V : Type u_1} [Quiver V] {X Y : Vᵒᵖ} (f : X ⟶ Y) : Opposite.unop Y ⟶ Opposite.unop X

Given an arrow in Vᵒᵖ, we can take the "unopposite" back in V.

Equations

• f.unop = Opposite.unop f

Instances For

• CategoryTheory.isIso_unop
• CategoryTheory.unop_epi_of_mono
• CategoryTheory.unop_mono_of_epi

def Quiver.Hom.opEquiv {V : Type u_1} [Quiver V] {X Y : V} : (X ⟶ Y) ≃ (Opposite.op Y ⟶ Opposite.op X)

The bijection (X ⟶ Y) ≃ (op Y ⟶ op X).

Equations

• Quiver.Hom.opEquiv = { toFun := Opposite.op, invFun := Opposite.unop, left_inv := ⋯, right_inv := ⋯ }

@[simp]

theorem Quiver.Hom.opEquiv_apply {V : Type u_1} [Quiver V] {X Y : V} (unop : X ⟶ Y) : opEquiv unop = Opposite.op unop

@[simp]

theorem Quiver.Hom.opEquiv_symm_apply {V : Type u_1} [Quiver V] {X Y : V} (self : (Opposite.unop (Opposite.op X) ⟶ Opposite.unop (Opposite.op Y))ᵒᵖ) : opEquiv.symm self = Opposite.unop self

def Quiver.Empty (V : Type u) : Type u

A type synonym for a quiver with no arrows.

Equations

• Quiver.Empty V = V

Instances For

• Quiver.emptyQuiver

instance Quiver.emptyQuiver (V : Type u) : Quiver (Empty V)

Equations

• Quiver.emptyQuiver V = { Hom := fun (x x : Quiver.Empty V) => PEmpty.{?u.14} }

@[simp]

theorem Quiver.empty_arrow {V : Type u} (a b : Empty V) : (a ⟶ b) = PEmpty.{u}

@[reducible, inline]

abbrev Quiver.IsThin (V : Type u) [Quiver V] : Prop

A quiver is thin if it has no parallel arrows.

Equations

• Quiver.IsThin V = ∀ (a b : V), Subsingleton (a ⟶ b)

def Quiver.homOfEq {V : Type u_1} [Quiver V] {X Y : V} (f : X ⟶ Y) {X' Y' : V} (hX : X = X') (hY : Y = Y') : X' ⟶ Y'

An arrow in a quiver can be transported across equalities between the source and target objects.

Equations

• Quiver.homOfEq f hX hY = hX ▸ hY ▸ f

@[simp]

theorem Quiver.homOfEq_trans {V : Type u_1} [Quiver V] {X Y : V} (f : X ⟶ Y) {X' Y' : V} (hX : X = X') (hY : Y = Y') {X'' Y'' : V} (hX' : X' = X'') (hY' : Y' = Y'') : homOfEq (homOfEq f hX hY) hX' hY' = homOfEq f ⋯ ⋯

theorem Quiver.homOfEq_injective {V : Type u_1} [Quiver V] {X X' Y Y' : V} (hX : X = X') (hY : Y = Y') {f g : X ⟶ Y} (h : homOfEq f hX hY = homOfEq g hX hY) : f = g

@[simp]

theorem Quiver.homOfEq_rfl {V : Type u_1} [Quiver V] {X Y : V} (f : X ⟶ Y) : homOfEq f ⋯ ⋯ = f

theorem Quiver.heq_of_homOfEq_ext {V : Type u_1} [Quiver V] {X Y X' Y' : V} (hX : X = X') (hY : Y = Y') {f : X ⟶ Y} {f' : X' ⟶ Y'} (e : homOfEq f hX hY = f') : HEq f f'