mathlib documentation

algebra.group.defs

Typeclasses for (semi)groups and monoids #

In this file we define typeclasses for algebraic structures with one binary operation. The classes are named (add_)?(comm_)?(semigroup|monoid|group), where add_ means that the class uses additive notation and comm_ means that the class assumes that the binary operation is commutative.

The file does not contain any lemmas except for

For basic lemmas about these classes see algebra.group.basic.

We also introduce notation classes has_scalar and has_vadd for multiplicative and additive actions and register the following instances:

Notation #

source
@[class]
structure has_vadd (G : Type u_1) (P : Type u_2) :
Type (max u_1 u_2)
  • vadd : G → P → P

Type class for the +ᵥ notation.

Instances
source
@[class]
structure has_scalar (M : Type u_1) (α : Type u_2) :
Type (max u_1 u_2)
  • smul : M → α → α

Typeclass for types with a scalar multiplication operation, denoted • (\bu)

Instances
source
def left_mul {G : Type u} [has_mul G] :
G → G → G

left_mul g denotes left multiplication by g

Equations
source
def left_add {G : Type u} [has_add G] :
G → G → G

left_add g denotes left addition by g

Equations
source
def right_add {G : Type u} [has_add G] :
G → G → G

right_add g denotes right addition by g

Equations
source
def right_mul {G : Type u} [has_mul G] :
G → G → G

right_mul g denotes right multiplication by g

Equations
source
theorem semigroup.ext_iff {G : Type u} (x y : semigroup G) :
x = y ↔ semigroup.mul = semigroup.mul
source
theorem semigroup.ext {G : Type u} (x y : semigroup G) (h : semigroup.mul = semigroup.mul) :
x = y
source
@[instance]
def semigroup.to_has_mul (G : Type u) [self : semigroup G] :
has_mul G
source
@[ext, class]
structure semigroup (G : Type u) :
Type u
  • mul : G → G → G
  • mul_assoc : ∀ (a b c : G), (a * b) * c = a * b * c

A semigroup is a type with an associative (*).

Instances
source
@[instance]
def add_semigroup.to_has_add (G : Type u) [self : add_semigroup G] :
has_add G
source
theorem add_semigroup.ext_iff {G : Type u} (x y : add_semigroup G) :
x = y ↔ add_semigroup.add = add_semigroup.add
source
theorem add_semigroup.ext {G : Type u} (x y : add_semigroup G) (h : add_semigroup.add = add_semigroup.add) :
x = y
source
@[ext, class]
structure add_semigroup (G : Type u) :
Type u
  • add : G → G → G
  • add_assoc : ∀ (a b c : G), a + b + c = a + (b + c)

An additive semigroup is a type with an associative (+).

Instances
source
theorem add_assoc {G : Type u} [add_semigroup G] (a b c : G) :
a + b + c = a + (b + c)
source
theorem mul_assoc {G : Type u} [semigroup G] (a b c : G) :
(a * b) * c = a * b * c
source
@[protected, instance]
def add_semigroup.to_is_associative {G : Type u} [add_semigroup G] :
is_associative G has_add.add
source
@[protected, instance]
def semigroup.to_is_associative {G : Type u} [semigroup G] :
is_associative G has_mul.mul
source
@[ext, class]
structure comm_semigroup (G : Type u) :
Type u
  • mul : G → G → G
  • mul_assoc : ∀ (a b c : G), (a * b) * c = a * b * c
  • mul_comm : ∀ (a b : G), a * b = b * a

A commutative semigroup is a type with an associative commutative (*).

Instances
source
@[instance]
def comm_semigroup.to_semigroup (G : Type u) [self : comm_semigroup G] :
semigroup G
source
theorem comm_semigroup.ext_iff {G : Type u} (x y : comm_semigroup G) :
x = y ↔ comm_semigroup.mul = comm_semigroup.mul
source
theorem comm_semigroup.ext {G : Type u} (x y : comm_semigroup G) (h : comm_semigroup.mul = comm_semigroup.mul) :
x = y
source
theorem add_comm_semigroup.ext_iff {G : Type u} (x y : add_comm_semigroup G) :
x = y ↔ add_comm_semigroup.add = add_comm_semigroup.add
source
@[instance]
def add_comm_semigroup.to_add_semigroup (G : Type u) [self : add_comm_semigroup G] :
add_semigroup G
source
theorem add_comm_semigroup.ext {G : Type u} (x y : add_comm_semigroup G) (h : add_comm_semigroup.add = add_comm_semigroup.add) :
x = y
source
@[ext, class]
structure add_comm_semigroup (G : Type u) :
Type u
  • add : G → G → G
  • add_assoc : ∀ (a b c : G), a + b + c = a + (b + c)
  • add_comm : ∀ (a b : G), a + b = b + a

A commutative additive semigroup is a type with an associative commutative (+).

Instances
source
theorem add_comm {G : Type u} [add_comm_semigroup G] (a b : G) :
a + b = b + a
source
theorem mul_comm {G : Type u} [comm_semigroup G] (a b : G) :
a * b = b * a
source
@[protected, instance]
def comm_semigroup.to_is_commutative {G : Type u} [comm_semigroup G] :
is_commutative G has_mul.mul
source
@[protected, instance]
def add_comm_semigroup.to_is_commutative {G : Type u} [add_comm_semigroup G] :
is_commutative G has_add.add
source
theorem left_cancel_semigroup.ext {G : Type u} (x y : left_cancel_semigroup G) (h : left_cancel_semigroup.mul = left_cancel_semigroup.mul) :
x = y
source
@[instance]
def left_cancel_semigroup.to_semigroup (G : Type u) [self : left_cancel_semigroup G] :
semigroup G
source
@[ext, class]
structure left_cancel_semigroup (G : Type u) :
Type u
  • mul : G → G → G
  • mul_assoc : ∀ (a b c : G), (a * b) * c = a * b * c
  • mul_left_cancel : ∀ (a b c : G), a * b = a * c → b = c

A left_cancel_semigroup is a semigroup such that a * b = a * c implies b = c.

Instances
source
theorem left_cancel_semigroup.ext_iff {G : Type u} (x y : left_cancel_semigroup G) :
x = y ↔ left_cancel_semigroup.mul = left_cancel_semigroup.mul
source
@[ext, class]
structure add_left_cancel_semigroup (G : Type u) :
Type u
  • add : G → G → G
  • add_assoc : ∀ (a b c : G), a + b + c = a + (b + c)
  • add_left_cancel : ∀ (a b c : G), a + b = a + c → b = c

An add_left_cancel_semigroup is an additive semigroup such that a + b = a + c implies b = c.

Instances
source
theorem add_left_cancel_semigroup.ext_iff {G : Type u} (x y : add_left_cancel_semigroup G) :
x = y ↔ add_left_cancel_semigroup.add = add_left_cancel_semigroup.add
source
@[instance]
def add_left_cancel_semigroup.to_add_semigroup (G : Type u) [self : add_left_cancel_semigroup G] :
add_semigroup G
source
theorem add_left_cancel_semigroup.ext {G : Type u} (x y : add_left_cancel_semigroup G) (h : add_left_cancel_semigroup.add = add_left_cancel_semigroup.add) :
x = y
source
theorem mul_left_cancel {G : Type u} [left_cancel_semigroup G] {a b c : G} :
a * b = a * c → b = c
source
theorem add_left_cancel {G : Type u} [add_left_cancel_semigroup G] {a b c : G} :
a + b = a + c → b = c
source
theorem add_left_cancel_iff {G : Type u} [add_left_cancel_semigroup G] {a b c : G} :
a + b = a + c ↔ b = c
source
theorem mul_left_cancel_iff {G : Type u} [left_cancel_semigroup G] {a b c : G} :
a * b = a * c ↔ b = c
source
theorem add_right_injective {G : Type u} [add_left_cancel_semigroup G] (a : G) :
function.injective (has_add.add a)
source
theorem mul_right_injective {G : Type u} [left_cancel_semigroup G] (a : G) :
function.injective (has_mul.mul a)
source
@[simp]
theorem mul_right_inj {G : Type u} [left_cancel_semigroup G] (a : G) {b c : G} :
a * b = a * c ↔ b = c
source
@[simp]
theorem add_right_inj {G : Type u} [add_left_cancel_semigroup G] (a : G) {b c : G} :
a + b = a + c ↔ b = c
source
theorem mul_ne_mul_right {G : Type u} [left_cancel_semigroup G] (a : G) {b c : G} :
a * b ≠ a * c ↔ b ≠ c
source
theorem add_ne_add_right {G : Type u} [add_left_cancel_semigroup G] (a : G) {b c : G} :
a + b ≠ a + c ↔ b ≠ c
source
theorem right_cancel_semigroup.ext {G : Type u} (x y : right_cancel_semigroup G) (h : right_cancel_semigroup.mul = right_cancel_semigroup.mul) :
x = y
source
@[ext, class]
structure right_cancel_semigroup (G : Type u) :
Type u
  • mul : G → G → G
  • mul_assoc : ∀ (a b c : G), (a * b) * c = a * b * c
  • mul_right_cancel : ∀ (a b c : G), a * b = c * b → a = c

A right_cancel_semigroup is a semigroup such that a * b = c * b implies a = c.

Instances
source
theorem right_cancel_semigroup.ext_iff {G : Type u} (x y : right_cancel_semigroup G) :
x = y ↔ right_cancel_semigroup.mul = right_cancel_semigroup.mul
source
@[instance]
def right_cancel_semigroup.to_semigroup (G : Type u) [self : right_cancel_semigroup G] :
semigroup G
source
theorem add_right_cancel_semigroup.ext {G : Type u} (x y : add_right_cancel_semigroup G) (h : add_right_cancel_semigroup.add = add_right_cancel_semigroup.add) :
x = y
source
theorem add_right_cancel_semigroup.ext_iff {G : Type u} (x y : add_right_cancel_semigroup G) :
x = y ↔ add_right_cancel_semigroup.add = add_right_cancel_semigroup.add
source
@[ext, class]
structure add_right_cancel_semigroup (G : Type u) :
Type u
  • add : G → G → G
  • add_assoc : ∀ (a b c : G), a + b + c = a + (b + c)
  • add_right_cancel : ∀ (a b c : G), a + b = c + b → a = c

An add_right_cancel_semigroup is an additive semigroup such that a + b = c + b implies a = c.

Instances
source
@[instance]
def add_right_cancel_semigroup.to_add_semigroup (G : Type u) [self : add_right_cancel_semigroup G] :
add_semigroup G
source
theorem mul_right_cancel {G : Type u} [right_cancel_semigroup G] {a b c : G} :
a * b = c * b → a = c
source
theorem add_right_cancel {G : Type u} [add_right_cancel_semigroup G] {a b c : G} :
a + b = c + b → a = c
source
theorem mul_right_cancel_iff {G : Type u} [right_cancel_semigroup G] {a b c : G} :
b * a = c * a ↔ b = c
source
theorem add_right_cancel_iff {G : Type u} [add_right_cancel_semigroup G] {a b c : G} :
b + a = c + a ↔ b = c
source
theorem add_left_injective {G : Type u} [add_right_cancel_semigroup G] (a : G) :
function.injective (λ (x : G), x + a)
source
theorem mul_left_injective {G : Type u} [right_cancel_semigroup G] (a : G) :
function.injective (λ (x : G), x * a)
source
@[simp]
theorem add_left_inj {G : Type u} [add_right_cancel_semigroup G] (a : G) {b c : G} :
b + a = c + a ↔ b = c
source
@[simp]
theorem mul_left_inj {G : Type u} [right_cancel_semigroup G] (a : G) {b c : G} :
b * a = c * a ↔ b = c
source
theorem mul_ne_mul_left {G : Type u} [right_cancel_semigroup G] (a : G) {b c : G} :
b * a ≠ c * a ↔ b ≠ c
source
theorem add_ne_add_left {G : Type u} [add_right_cancel_semigroup G] (a : G) {b c : G} :
b + a ≠ c + a ↔ b ≠ c
source
@[class]
structure mul_one_class (M : Type u) :
Type u
  • one : M
  • mul : M → M → M
  • one_mul : ∀ (a : M), 1 * a = a
  • mul_one : ∀ (a : M), a * 1 = a

Typeclass for expressing that a type M with multiplication and a one satisfies 1 * a = a and a * 1 = a for all a : M.

Instances
source
@[instance]
def mul_one_class.to_has_one (M : Type u) [self : mul_one_class M] :
has_one M
source
@[instance]
def mul_one_class.to_has_mul (M : Type u) [self : mul_one_class M] :
has_mul M
source
@[instance]
def add_zero_class.to_has_add (M : Type u) [self : add_zero_class M] :
has_add M
source
@[instance]
def add_zero_class.to_has_zero (M : Type u) [self : add_zero_class M] :
has_zero M
source
@[class]
structure add_zero_class (M : Type u) :
Type u
  • zero : M
  • add : M → M → M
  • zero_add : ∀ (a : M), 0 + a = a
  • add_zero : ∀ (a : M), a + 0 = a

Typeclass for expressing that a type M with addition and a zero satisfies 0 + a = a and a + 0 = a for all a : M.

Instances
source
@[ext]
theorem mul_one_class.ext {M : Type u} ⦃m₁ m₂ : mul_one_class M⦄ :
mul_one_class.mul = mul_one_class.mul → m₁ = m₂
source
theorem add_zero_class.ext {M : Type u} ⦃m₁ m₂ : add_zero_class M⦄ :
add_zero_class.add = add_zero_class.add → m₁ = m₂
source
@[simp]
theorem one_mul {M : Type u} [mul_one_class M] (a : M) :
1 * a = a
source
@[simp]
theorem zero_add {M : Type u} [add_zero_class M] (a : M) :
0 + a = a
source
@[simp]
theorem add_zero {M : Type u} [add_zero_class M] (a : M) :
a + 0 = a
source
@[simp]
theorem mul_one {M : Type u} [mul_one_class M] (a : M) :
a * 1 = a
source
@[protected, instance]
def mul_one_class.to_is_left_id {M : Type u} [mul_one_class M] :
is_left_id M has_mul.mul 1
source
@[protected, instance]
def add_zero_class.to_is_left_id {M : Type u} [add_zero_class M] :
is_left_id M has_add.add 0
source
@[protected, instance]
def mul_one_class.to_is_right_id {M : Type u} [mul_one_class M] :
is_right_id M has_mul.mul 1
source
@[protected, instance]
def add_zero_class.to_is_right_id {M : Type u} [add_zero_class M] :
is_right_id M has_add.add 0
source
def npow_rec {M : Type u} [has_one M] [has_mul M] :
ℕ → M → M

The fundamental power operation in a monoid. npow_rec n a = a*a*...*a n times. Use instead a ^ n, which has better definitional behavior.

Equations
source
def nsmul_rec {M : Type u} [has_zero M] [has_add M] :
ℕ → M → M

The fundamental scalar multiplication in an additive monoid. nsmul_rec n a = a+a+...+a n times. Use instead n • a, which has better definitional behavior.

Equations
source
meta def try_refl_tac  :
tactic unit

try_refl_tac solves goals of the form ∀ a b, f a b = g a b, if they hold by definition.

Design note on add_monoid and monoid #

An add_monoid has a natural ℕ-action, defined by n • a = a + ... + a, that we want to declare as an instance as it makes it possible to use the language of linear algebra. However, there are often other natural ℕ-actions. For instance, for any semiring R, the space of polynomials polynomial R has a natural R-action defined by multiplication on the coefficients. This means that polynomial ℕ would have two natural ℕ-actions, which are equal but not defeq. The same goes for linear maps, tensor products, and so on (and even for ℕ itself).

To solve this issue, we embed an ℕ-action in the definition of an add_monoid (which is by default equal to the naive action a + ... + a, but can be adjusted when needed), and declare a has_scalar ℕ α instance using this action. See Note [forgetful inheritance] for more explanations on this pattern.

For example, when we define polynomial R, then we declare the ℕ-action to be by multiplication on each coefficient (using the ℕ-action on R that comes from the fact that R is an add_monoid). In this way, the two natural has_scalar ℕ (polynomial ℕ) instances are defeq.

The tactic to_additive transfers definitions and results from multiplicative monoids to additive monoids. To work, it has to map fields to fields. This means that we should also add corresponding fields to the multiplicative structure monoid, which could solve defeq problems for powers if needed. These problems do not come up in practice, so most of the time we will not need to adjust the npow field when defining multiplicative objects.

A basic theory for the power function on monoids and the ℕ-action on additive monoids is built in the file algebra.group_power.basic. For now, we only register the most basic properties that we need right away.

In the definition, we use n.succ instead of n + 1 in the nsmul_succ' and npow_succ' fields to make sure that to_additive is not confused (otherwise, it would try to convert 1 : ℕ to 0 : ℕ).

source
@[instance]
def add_monoid.to_add_semigroup (M : Type u) [self : add_monoid M] :
add_semigroup M
source
@[instance]
def add_monoid.to_add_zero_class (M : Type u) [self : add_monoid M] :
add_zero_class M
source
@[class]
structure add_monoid (M : Type u) :
Type u

An add_monoid is an add_semigroup with an element 0 such that 0 + a = a + 0 = a.

Instances
source
@[instance]
def monoid.to_mul_one_class (M : Type u) [self : monoid M] :
mul_one_class M
source
@[instance]
def monoid.to_semigroup (M : Type u) [self : monoid M] :
semigroup M
source
@[class]
structure monoid (M : Type u) :
Type u
  • mul : M → M → M
  • mul_assoc : ∀ (a b c : M), (a * b) * c = a * b * c
  • one : M
  • one_mul : ∀ (a : M), 1 * a = a
  • mul_one : ∀ (a : M), a * 1 = a
  • npow : ℕ → M → M
  • npow_zero' : (∀ (x : M), monoid.npow 0 x = 1) . "try_refl_tac"
  • npow_succ' : (∀ (n : ℕ) (x : M), monoid.npow n.succ x = x * monoid.npow n x) . "try_refl_tac"

A monoid is a semigroup with an element 1 such that 1 * a = a * 1 = a.

Instances
source
@[protected, instance]
def monoid.has_pow {M : Type u_1} [monoid M] :
has_pow M ℕ
Equations
source
@[protected, instance]
def add_monoid.has_scalar_nat {M : Type u_1} [add_monoid M] :
has_scalar ℕ M
Equations
source
@[simp]
theorem npow_eq_pow {M : Type u_1} [monoid M] (n : ℕ) (x : M) :
monoid.npow n x = x ^ n
source
@[simp]
theorem nsmul_eq_smul {M : Type u_1} [add_monoid M] (n : ℕ) (x : M) :
add_monoid.nsmul n x = n • x
source
theorem zero_nsmul {M : Type u_1} [add_monoid M] (a : M) :
0 • a = 0
source
@[simp]
theorem pow_zero {M : Type u_1} [monoid M] (a : M) :
a ^ 0 = 1
source
theorem succ_nsmul {M : Type u_1} [add_monoid M] (a : M) (n : ℕ) :
(n + 1) • a = a + n • a
source
theorem pow_succ {M : Type u_1} [monoid M] (a : M) (n : ℕ) :
a ^ (n + 1) = a * a ^ n
source
theorem left_inv_eq_right_inv {M : Type u} [monoid M] {a b c : M} (hba : b * a = 1) (hac : a * c = 1) :
b = c
source
theorem left_neg_eq_right_neg {M : Type u} [add_monoid M] {a b c : M} (hba : b + a = 0) (hac : a + c = 0) :
b = c
source
@[instance]
def add_comm_monoid.to_add_monoid (M : Type u) [self : add_comm_monoid M] :
add_monoid M
source
@[class]
structure add_comm_monoid (M : Type u) :
Type u

An additive commutative monoid is an additive monoid with commutative (+).

Instances
source
@[instance]
def add_comm_monoid.to_add_comm_semigroup (M : Type u) [self : add_comm_monoid M] :
add_comm_semigroup M
source
@[instance]
def comm_monoid.to_comm_semigroup (M : Type u) [self : comm_monoid M] :
comm_semigroup M
source
@[class]
structure comm_monoid (M : Type u) :
Type u
  • mul : M → M → M
  • mul_assoc : ∀ (a b c : M), (a * b) * c = a * b * c
  • one : M
  • one_mul : ∀ (a : M), 1 * a = a
  • mul_one : ∀ (a : M), a * 1 = a
  • npow : ℕ → M → M
  • npow_zero' : (∀ (x : M), comm_monoid.npow 0 x = 1) . "try_refl_tac"
  • npow_succ' : (∀ (n : ℕ) (x : M), comm_monoid.npow n.succ x = x * comm_monoid.npow n x) . "try_refl_tac"
  • mul_comm : ∀ (a b : M), a * b = b * a

A commutative monoid is a monoid with commutative (*).

Instances
source
@[instance]
def comm_monoid.to_monoid (M : Type u) [self : comm_monoid M] :
monoid M
source
@[instance]
def add_left_cancel_monoid.to_add_monoid (M : Type u) [self : add_left_cancel_monoid M] :
add_monoid M
source
@[class]
structure add_left_cancel_monoid (M : Type u) :
Type u

An additive monoid in which addition is left-cancellative. Main examples are ℕ and groups. This is the right typeclass for many sum lemmas, as having a zero is useful to define the sum over the empty set, so add_left_cancel_semigroup is not enough.

Instances
source
@[instance]
def add_left_cancel_monoid.to_add_left_cancel_semigroup (M : Type u) [self : add_left_cancel_monoid M] :
add_left_cancel_semigroup M
source
@[class]
structure left_cancel_monoid (M : Type u) :
Type u

A monoid in which multiplication is left-cancellative.

Instances
source
@[instance]
def left_cancel_monoid.to_left_cancel_semigroup (M : Type u) [self : left_cancel_monoid M] :
left_cancel_semigroup M
source
@[instance]
def left_cancel_monoid.to_monoid (M : Type u) [self : left_cancel_monoid M] :
monoid M
source
@[instance]
def add_right_cancel_monoid.to_add_right_cancel_semigroup (M : Type u) [self : add_right_cancel_monoid M] :
add_right_cancel_semigroup M
source
@[class]
structure add_right_cancel_monoid (M : Type u) :
Type u

An additive monoid in which addition is right-cancellative. Main examples are ℕ and groups. This is the right typeclass for many sum lemmas, as having a zero is useful to define the sum over the empty set, so add_right_cancel_semigroup is not enough.

Instances
source
@[instance]
def add_right_cancel_monoid.to_add_monoid (M : Type u) [self : add_right_cancel_monoid M] :
add_monoid M
source
@[instance]
def right_cancel_monoid.to_monoid (M : Type u) [self : right_cancel_monoid M] :
monoid M
source
@[class]
structure right_cancel_monoid (M : Type u) :
Type u

A monoid in which multiplication is right-cancellative.

Instances
source
@[instance]
def right_cancel_monoid.to_right_cancel_semigroup (M : Type u) [self : right_cancel_monoid M] :
right_cancel_semigroup M
source
@[instance]
def add_cancel_monoid.to_add_right_cancel_monoid (M : Type u) [self : add_cancel_monoid M] :
add_right_cancel_monoid M
source
@[class]
structure add_cancel_monoid (M : Type u) :
Type u

An additive monoid in which addition is cancellative on both sides. Main examples are ℕ and groups. This is the right typeclass for many sum lemmas, as having a zero is useful to define the sum over the empty set, so add_right_cancel_semigroup is not enough.

Instances
source
@[instance]
def add_cancel_monoid.to_add_left_cancel_monoid (M : Type u) [self : add_cancel_monoid M] :
add_left_cancel_monoid M
source
@[instance]
def cancel_monoid.to_right_cancel_monoid (M : Type u) [self : cancel_monoid M] :
right_cancel_monoid M
source
@[class]
structure cancel_monoid (M : Type u) :
Type u
  • mul : M → M → M
  • mul_assoc : ∀ (a b c : M), (a * b) * c = a * b * c
  • mul_left_cancel : ∀ (a b c : M), a * b = a * c → b = c
  • one : M
  • one_mul : ∀ (a : M), 1 * a = a
  • mul_one : ∀ (a : M), a * 1 = a
  • npow : ℕ → M → M
  • npow_zero' : (∀ (x : M), cancel_monoid.npow 0 x = 1) . "try_refl_tac"
  • npow_succ' : (∀ (n : ℕ) (x : M), cancel_monoid.npow n.succ x = x * cancel_monoid.npow n x) . "try_refl_tac"
  • mul_right_cancel : ∀ (a b c : M), a * b = c * b → a = c

A monoid in which multiplication is cancellative.

Instances
source
@[instance]
def cancel_monoid.to_left_cancel_monoid (M : Type u) [self : cancel_monoid M] :
left_cancel_monoid M
source
@[instance]
def add_cancel_comm_monoid.to_add_left_cancel_monoid (M : Type u) [self : add_cancel_comm_monoid M] :
add_left_cancel_monoid M
source
@[class]
structure add_cancel_comm_monoid (M : Type u) :
Type u

Commutative version of add_cancel_monoid.

Instances
source
@[instance]
def add_cancel_comm_monoid.to_add_comm_monoid (M : Type u) [self : add_cancel_comm_monoid M] :
add_comm_monoid M
source
@[instance]
def cancel_comm_monoid.to_comm_monoid (M : Type u) [self : cancel_comm_monoid M] :
comm_monoid M
source
@[class]
structure cancel_comm_monoid (M : Type u) :
Type u

Commutative version of cancel_monoid.

Instances
source
@[instance]
def cancel_comm_monoid.to_left_cancel_monoid (M : Type u) [self : cancel_comm_monoid M] :
left_cancel_monoid M
source
@[protected, instance]
def cancel_comm_monoid.to_cancel_monoid (M : Type u) [cancel_comm_monoid M] :
cancel_monoid M
Equations
source
@[protected, instance]
def add_cancel_comm_monoid.to_cancel_add_monoid (M : Type u) [add_cancel_comm_monoid M] :
add_cancel_monoid M
Equations
source
def zpow_rec {M : Type u_1} [has_one M] [has_mul M] [has_inv M] :
ℤ → M → M

The fundamental power operation in a group. zpow_rec n a = a*a*...*a n times, for integer n. Use instead a ^ n, which has better definitional behavior.

Equations
source
def zsmul_rec {M : Type u_1} [has_zero M] [has_add M] [has_neg M] :
ℤ → M → M

The fundamental scalar multiplication in an additive group. zsmul_rec n a = a+a+...+a n times, for integer n. Use instead n • a, which has better definitional behavior.

Equations
source
@[instance]
def div_inv_monoid.to_monoid (G : Type u) [self : div_inv_monoid G] :
monoid G
source
@[instance]
def div_inv_monoid.to_has_div (G : Type u) [self : div_inv_monoid G] :
has_div G
source
@[class]
structure div_inv_monoid (G : Type u) :
Type u

A div_inv_monoid is a monoid with operations / and ⁻¹ satisfying div_eq_mul_inv : ∀ a b, a / b = a * b⁻¹.

This is the immediate common ancestor of group and group_with_zero, in order to deduplicate the name div_eq_mul_inv. The default for div is such that a / b = a * b⁻¹ holds by definition.

Adding div as a field rather than defining a / b := a * b⁻¹ allows us to avoid certain classes of unification failures, for example: Let foo X be a type with a ∀ X, has_div (foo X) instance but no ∀ X, has_inv (foo X), e.g. when foo X is a euclidean_domain. Suppose we also have an instance ∀ X [cromulent X], group_with_zero (foo X). Then the (/) coming from group_with_zero_has_div cannot be definitionally equal to the (/) coming from foo.has_div.

In the same way, adding a zpow field makes it possible to avoid definitional failures in diamonds. See the definition of monoid and Note [forgetful inheritance] for more explanations on this.

Instances
source
@[instance]
def div_inv_monoid.to_has_inv (G : Type u) [self : div_inv_monoid G] :
has_inv G
source
@[instance]
def sub_neg_monoid.to_has_sub (G : Type u) [self : sub_neg_monoid G] :
has_sub G
source
@[instance]
def sub_neg_monoid.to_add_monoid (G : Type u) [self : sub_neg_monoid G] :
add_monoid G
source
@[class]
structure sub_neg_monoid (G : Type u) :
Type u

A sub_neg_monoid is an add_monoid with unary - and binary - operations satisfying sub_eq_add_neg : ∀ a b, a - b = a + -b.

The default for sub is such that a - b = a + -b holds by definition.

Adding sub as a field rather than defining a - b := a + -b allows us to avoid certain classes of unification failures, for example: Let foo X be a type with a ∀ X, has_sub (foo X) instance but no ∀ X, has_neg (foo X). Suppose we also have an instance ∀ X [cromulent X], add_group (foo X). Then the (-) coming from add_group.has_sub cannot be definitionally equal to the (-) coming from foo.has_sub.

In the same way, adding a zsmul field makes it possible to avoid definitional failures in diamonds. See the definition of add_monoid and Note [forgetful inheritance] for more explanations on this.

Instances
source
@[instance]
def sub_neg_monoid.to_has_neg (G : Type u) [self : sub_neg_monoid G] :
has_neg G
source
@[protected, instance]
def div_inv_monoid.has_pow {M : Type u_1} [div_inv_monoid M] :
has_pow M ℤ
Equations
source
@[protected, instance]
def sub_neg_monoid.has_scalar_int {M : Type u_1} [sub_neg_monoid M] :
has_scalar ℤ M
Equations
source
@[simp]
theorem zsmul_eq_smul {G : Type u_1} [sub_neg_monoid G] (n : ℤ) (x : G) :
sub_neg_monoid.zsmul n x = n • x
source
@[simp]
theorem zpow_eq_pow {G : Type u_1} [div_inv_monoid G] (n : ℤ) (x : G) :
div_inv_monoid.zpow n x = x ^ n
source
@[simp]
theorem zero_zsmul {G : Type u_1} [sub_neg_monoid G] (a : G) :
0 • a = 0
source
@[simp]
theorem zpow_zero {G : Type u_1} [div_inv_monoid G] (a : G) :
a ^ 0 = 1
source
@[simp, norm_cast]
theorem coe_nat_zsmul {G : Type u_1} [sub_neg_monoid G] (a : G) (n : ℕ) :
↑n • a = n • a
source
@[simp, norm_cast]
theorem zpow_coe_nat {G : Type u_1} [div_inv_monoid G] (a : G) (n : ℕ) :
a ^ ↑n = a ^ n
source
theorem of_nat_zsmul {G : Type u_1} [sub_neg_monoid G] (a : G) (n : ℕ) :
int.of_nat n • a = n • a
source
theorem zpow_of_nat {G : Type u_1} [div_inv_monoid G] (a : G) (n : ℕ) :
a ^ int.of_nat n = a ^ n
source
@[simp]
theorem zsmul_neg_succ_of_nat {G : Type u_1} [sub_neg_monoid G] (a : G) (n : ℕ) :
-[1+ n] • a = -((n + 1) • a)
source
@[simp]
theorem zpow_neg_succ_of_nat {G : Type u_1} [div_inv_monoid G] (a : G) (n : ℕ) :
a ^ -[1+ n] = (a ^ (n + 1))⁻¹
source
theorem div_eq_mul_inv {G : Type u} [div_inv_monoid G] (a b : G) :
a / b = a * b⁻¹
source
theorem sub_eq_add_neg {G : Type u} [sub_neg_monoid G] (a b : G) :
a - b = a + -b
source
@[class]
structure group (G : Type u) :
Type u

A group is a monoid with an operation ⁻¹ satisfying a⁻¹ * a = 1.

There is also a division operation / such that a / b = a * b⁻¹, with a default so that a / b = a * b⁻¹ holds by definition.

Instances
source
@[instance]
def group.to_div_inv_monoid (G : Type u) [self : group G] :
div_inv_monoid G
source
@[class]
structure add_group (A : Type u) :
Type u

An add_group is an add_monoid with a unary - satisfying -a + a = 0.

There is also a binary operation - such that a - b = a + -b, with a default so that a - b = a + -b holds by definition.

Instances
source
@[instance]
def add_group.to_sub_neg_monoid (A : Type u) [self : add_group A] :
sub_neg_monoid A
source
def add_group.to_add_monoid (G : Type u) [add_group G] :
add_monoid G

Abbreviation for @sub_neg_monoid.to_add_monoid _ (@add_group.to_sub_neg_monoid _ _).

Useful because it corresponds to the fact that AddGroup is a subcategory of AddMon. Not an instance since it duplicates @sub_neg_monoid.to_add_monoid _ (@add_group.to_sub_neg_monoid _ _).

Equations
source
def group.to_monoid (G : Type u) [group G] :
monoid G

Abbreviation for @div_inv_monoid.to_monoid _ (@group.to_div_inv_monoid _ _).

Useful because it corresponds to the fact that Grp is a subcategory of Mon. Not an instance since it duplicates @div_inv_monoid.to_monoid _ (@group.to_div_inv_monoid _ _). See note [reducible non-instances].

Equations
source
@[simp]
theorem add_left_neg {G : Type u} [add_group G] (a : G) :
-a + a = 0
source
@[simp]
theorem mul_left_inv {G : Type u} [group G] (a : G) :
a⁻¹ * a = 1
source
theorem neg_add_self {G : Type u} [add_group G] (a : G) :
-a + a = 0
source
theorem inv_mul_self {G : Type u} [group G] (a : G) :
a⁻¹ * a = 1
source
@[simp]
theorem inv_mul_cancel_left {G : Type u} [group G] (a b : G) :
a⁻¹ * a * b = b
source
@[simp]
theorem neg_add_cancel_left {G : Type u} [add_group G] (a b : G) :
-a + (a + b) = b
source
@[simp]
theorem inv_eq_of_mul_eq_one {G : Type u} [group G] {a b : G} (h : a * b = 1) :
a⁻¹ = b
source
@[simp]
theorem neg_eq_of_add_eq_zero {G : Type u} [add_group G] {a b : G} (h : a + b = 0) :
-a = b
source
@[simp]
theorem inv_inv {G : Type u} [group G] (a : G) :
a⁻¹⁻¹ = a
source
@[simp]
theorem neg_neg {G : Type u} [add_group G] (a : G) :
--a = a
source
@[simp]
theorem mul_right_inv {G : Type u} [group G] (a : G) :
a * a⁻¹ = 1
source
@[simp]
theorem add_right_neg {G : Type u} [add_group G] (a : G) :
a + -a = 0
source
theorem add_neg_self {G : Type u} [add_group G] (a : G) :
a + -a = 0
source
theorem mul_inv_self {G : Type u} [group G] (a : G) :
a * a⁻¹ = 1
source
@[simp]
theorem add_neg_cancel_right {G : Type u} [add_group G] (a b : G) :
a + b + -b = a
source
@[simp]
theorem mul_inv_cancel_right {G : Type u} [group G] (a b : G) :
(a * b) * b⁻¹ = a
source
@[protected, instance]
def group.to_cancel_monoid {G : Type u} [group G] :
cancel_monoid G
Equations
source
@[protected, instance]
def add_group.to_cancel_add_monoid {G : Type u} [add_group G] :
add_cancel_monoid G
Equations
source
theorem group.to_div_inv_monoid_injective {G : Type u_1} :
function.injective (group.to_div_inv_monoid G)
source
theorem add_group.to_sub_neg_add_monoid_injective {G : Type u_1} :
function.injective (add_group.to_sub_neg_monoid G)
source
@[instance]
def comm_group.to_group (G : Type u) [self : comm_group G] :
group G
source
@[class]
structure comm_group (G : Type u) :
Type u

A commutative group is a group with commutative (*).

Instances
source
@[instance]
def comm_group.to_comm_monoid (G : Type u) [self : comm_group G] :
comm_monoid G
source
@[class]
structure add_comm_group (G : Type u) :
Type u

An additive commutative group is an additive group with commutative (+).

Instances
source
@[instance]
def add_comm_group.to_add_comm_monoid (G : Type u) [self : add_comm_group G] :
add_comm_monoid G
source
@[instance]
def add_comm_group.to_add_group (G : Type u) [self : add_comm_group G] :
add_group G
source
theorem add_comm_group.to_add_group_injective {G : Type u} :
function.injective (add_comm_group.to_add_group G)
source
theorem comm_group.to_group_injective {G : Type u} :
function.injective (comm_group.to_group G)
source
@[protected, instance]
def comm_group.to_cancel_comm_monoid {G : Type u} [comm_group G] :
cancel_comm_monoid G
Equations
source
@[protected, instance]
def add_comm_group.to_cancel_add_comm_monoid {G : Type u} [add_comm_group G] :
add_cancel_comm_monoid G
Equations