Operation on tuples

We interpret maps ∀ i : Fin n, α i as n-tuples of elements of possibly varying type α i, (α 0, …, α (n-1)). A particular case is Fin n → α of elements with all the same type. In this case when α i is a constant map, then tuples are isomorphic (but not definitionally equal) to Vectors.

Main declarations

There are three (main) ways to consider Fin n as a subtype of Fin (n + 1), hence three (main) ways to move between tuples of length n and of length n + 1 by adding/removing an entry.

Adding at the start

• Fin.succ: Send i : Fin n to i + 1 : Fin (n + 1). This is defined in Core.
• Fin.cases: Induction/recursion principle for Fin: To prove a property/define a function for all Fin (n + 1), it is enough to prove/define it for 0 and for i.succ for all i : Fin n. This is defined in Core.
• Fin.cons: Turn a tuple f : Fin n → α and an entry a : α into a tuple Fin.cons a f : Fin (n + 1) → α by adding a at the start. In general, tuples can be dependent functions, in which case f : ∀ i : Fin n, α i.succ and a : α 0. This is a special case of Fin.cases.
• Fin.tail: Turn a tuple f : Fin (n + 1) → α into a tuple Fin.tail f : Fin n → α by forgetting the start. In general, tuples can be dependent functions, in which case Fin.tail f : ∀ i : Fin n, α i.succ.

Adding at the end

• Fin.castSucc: Send i : Fin n to i : Fin (n + 1). This is defined in Core.
• Fin.lastCases: Induction/recursion principle for Fin: To prove a property/define a function for all Fin (n + 1), it is enough to prove/define it for last n and for i.castSucc for all i : Fin n. This is defined in Core.
• Fin.snoc: Turn a tuple f : Fin n → α and an entry a : α into a tuple Fin.snoc f a : Fin (n + 1) → α by adding a at the end. In general, tuples can be dependent functions, in which case f : ∀ i : Fin n, α i.castSucc and a : α (last n). This is a special case of Fin.lastCases.
• Fin.init: Turn a tuple f : Fin (n + 1) → α into a tuple Fin.init f : Fin n → α by forgetting the start. In general, tuples can be dependent functions, in which case Fin.init f : ∀ i : Fin n, α i.castSucc.

Adding in the middle

For a pivot p : Fin (n + 1),

• Fin.succAbove: Send i : Fin n to
  • i : Fin (n + 1) if i < p,
  • i + 1 : Fin (n + 1) if p ≤ i.
• Fin.succAboveCases: Induction/recursion principle for Fin: To prove a property/define a function for all Fin (n + 1), it is enough to prove/define it for p and for p.succAbove i for all i : Fin n.
• Fin.insertNth: Turn a tuple f : Fin n → α and an entry a : α into a tuple Fin.insertNth f a : Fin (n + 1) → α by adding a in position p. In general, tuples can be dependent functions, in which case f : ∀ i : Fin n, α (p.succAbove i) and a : α p. This is a special case of Fin.succAboveCases.
• Fin.removeNth: Turn a tuple f : Fin (n + 1) → α into a tuple Fin.removeNth p f : Fin n → α by forgetting the p-th value. In general, tuples can be dependent functions, in which case Fin.removeNth f : ∀ i : Fin n, α (succAbove p i).

p = 0 means we add at the start. p = last n means we add at the end.

Miscellaneous

• Fin.find p : returns the first index n where p n is satisfied, and none if it is never satisfied.
• Fin.append a b : append two tuples.
• Fin.repeat n a : repeat a tuple n times.

theorem Fin.tuple0_le {α : Fin 0 → Type u_1} [(i : Fin 0) → Preorder (α i)] (f g : (i : Fin 0) → α i) : f ≤ g

def Fin.tail {n : ℕ} {α : Fin (n + 1) → Sort u} (q : (i : Fin (n + 1)) → α i) (i : Fin n) : α i.succ

The tail of an n+1 tuple, i.e., its last n entries.

Equations

• Fin.tail q i = q i.succ

theorem Fin.tail_def {n : ℕ} {α : Fin (n + 1) → Sort u_1} {q : (i : Fin (n + 1)) → α i} : (Fin.tail fun (k : Fin (n + 1)) => q k) = fun (k : Fin n) => q k.succ

def Fin.cons {n : ℕ} {α : Fin (n + 1) → Sort u} (x : α 0) (p : (i : Fin n) → α i.succ) (i : Fin (n + 1)) : α i

Adding an element at the beginning of an n-tuple, to get an n+1-tuple.

Equations

• Fin.cons x p j = Fin.cases x p j

@[simp]

theorem Fin.tail_cons {n : ℕ} {α : Fin (n + 1) → Sort u} (x : α 0) (p : (i : Fin n) → α i.succ) : Fin.tail (Fin.cons x p) = p

@[simp]

theorem Fin.cons_succ {n : ℕ} {α : Fin (n + 1) → Sort u} (x : α 0) (p : (i : Fin n) → α i.succ) (i : Fin n) : Fin.cons x p i.succ = p i

@[simp]

theorem Fin.cons_zero {n : ℕ} {α : Fin (n + 1) → Sort u} (x : α 0) (p : (i : Fin n) → α i.succ) : Fin.cons x p 0 = x

@[simp]

theorem Fin.cons_one {n : ℕ} {α : Fin (n + 2) → Sort u_1} (x : α 0) (p : (i : Fin n.succ) → α i.succ) : Fin.cons x p 1 = p 0

@[simp]

theorem Fin.cons_update {n : ℕ} {α : Fin (n + 1) → Sort u} (x : α 0) (p : (i : Fin n) → α i.succ) (i : Fin n) (y : α i.succ) : Fin.cons x (Function.update p i y) = Function.update (Fin.cons x p) i.succ y

Updating a tuple and adding an element at the beginning commute.

theorem Fin.cons_injective2 {n : ℕ} {α : Fin (n + 1) → Sort u} : Function.Injective2 Fin.cons

As a binary function, Fin.cons is injective.

@[simp]

theorem Fin.cons_eq_cons {n : ℕ} {α : Fin (n + 1) → Sort u} {x₀ y₀ : α 0} {x y : (i : Fin n) → α i.succ} : Fin.cons x₀ x = Fin.cons y₀ y ↔ x₀ = y₀ ∧ x = y

theorem Fin.cons_left_injective {n : ℕ} {α : Fin (n + 1) → Sort u} (x : (i : Fin n) → α i.succ) : Function.Injective fun (x₀ : α 0) => Fin.cons x₀ x

theorem Fin.cons_right_injective {n : ℕ} {α : Fin (n + 1) → Sort u} (x₀ : α 0) : Function.Injective (Fin.cons x₀)

theorem Fin.update_cons_zero {n : ℕ} {α : Fin (n + 1) → Sort u} (x : α 0) (p : (i : Fin n) → α i.succ) (z : α 0) : Function.update (Fin.cons x p) 0 z = Fin.cons z p

Adding an element at the beginning of a tuple and then updating it amounts to adding it directly.

@[simp]

theorem Fin.cons_self_tail {n : ℕ} {α : Fin (n + 1) → Sort u} (q : (i : Fin (n + 1)) → α i) : Fin.cons (q 0) (Fin.tail q) = q

Concatenating the first element of a tuple with its tail gives back the original tuple

def Fin.consEquiv {n : ℕ} (α : Fin (n + 1) → Type u_1) : α 0 × ((i : Fin n) → α i.succ) ≃ ((i : Fin (n + 1)) → α i)

Equivalence between tuples of length n + 1 and pairs of an element and a tuple of length n given by separating out the first element of the tuple.

This is Fin.cons as an Equiv.

Equations

• Fin.consEquiv α = { toFun := fun (f : α 0 × ((i : Fin n) → α i.succ)) => Fin.cons f.1 f.2, invFun := fun (f : (i : Fin (n + 1)) → α i) => (f 0, Fin.tail f), left_inv := ⋯, right_inv := ⋯ }

@[simp]

theorem Fin.consEquiv_symm_apply {n : ℕ} (α : Fin (n + 1) → Type u_1) (f : (i : Fin (n + 1)) → α i) : (Fin.consEquiv α).symm f = (f 0, Fin.tail f)

@[simp]

theorem Fin.consEquiv_apply {n : ℕ} (α : Fin (n + 1) → Type u_1) (f : α 0 × ((i : Fin n) → α i.succ)) (i : Fin (n + 1)) : (Fin.consEquiv α) f i = Fin.cons f.1 f.2 i

def Fin.consCases {n : ℕ} {α : Fin (n + 1) → Sort u} {P : ((i : Fin n.succ) → α i) → Sort v} (h : (x₀ : α 0) → (x : (i : Fin n) → α i.succ) → P (Fin.cons x₀ x)) (x : (i : Fin n.succ) → α i) : P x

Recurse on an n+1-tuple by splitting it into a single element and an n-tuple.

Equations

• Fin.consCases h x = cast ⋯ (h (x 0) (Fin.tail x))

@[simp]

theorem Fin.consCases_cons {n : ℕ} {α : Fin (n + 1) → Sort u} {P : ((i : Fin n.succ) → α i) → Sort v} (h : (x₀ : α 0) → (x : (i : Fin n) → α i.succ) → P (Fin.cons x₀ x)) (x₀ : α 0) (x : (i : Fin n) → α i.succ) : Fin.consCases h (Fin.cons x₀ x) = h x₀ x

def Fin.consInduction {α : Sort u_1} {P : {n : ℕ} → (Fin n → α) → Sort v} (h0 : P Fin.elim0) (h : {n : ℕ} → (x₀ : α) → (x : Fin n → α) → P x → P (Fin.cons x₀ x)) {n : ℕ} (x : Fin n → α) : P x

Recurse on a tuple by splitting into Fin.elim0 and Fin.cons.

Equations

• Fin.consInduction h0 h x_2 = ⋯.mpr h0
• Fin.consInduction h0 h x_2 = Fin.consCases (fun (x : α) (x_1 : Fin n → α) => h x x_1 (Fin.consInduction h0 (fun {n : ℕ} => h) x_1)) x_2

theorem Fin.cons_injective_of_injective {n : ℕ} {α : Type u_1} {x₀ : α} {x : Fin n → α} (hx₀ : x₀ ∉ Set.range x) (hx : Function.Injective x) : Function.Injective (Fin.cons x₀ x)

theorem Fin.cons_injective_iff {n : ℕ} {α : Type u_1} {x₀ : α} {x : Fin n → α} : Function.Injective (Fin.cons x₀ x) ↔ x₀ ∉ Set.range x ∧ Function.Injective x

@[simp]

theorem Fin.forall_fin_zero_pi {α : Fin 0 → Sort u_1} {P : ((i : Fin 0) → α i) → Prop} : (∀ (x : (i : Fin 0) → α i), P x) ↔ P finZeroElim

@[simp]

theorem Fin.exists_fin_zero_pi {α : Fin 0 → Sort u_1} {P : ((i : Fin 0) → α i) → Prop} : (∃ (x : (i : Fin 0) → α i), P x) ↔ P finZeroElim

theorem Fin.forall_fin_succ_pi {n : ℕ} {α : Fin (n + 1) → Sort u} {P : ((i : Fin (n + 1)) → α i) → Prop} : (∀ (x : (i : Fin (n + 1)) → α i), P x) ↔ ∀ (a : α 0) (v : (i : Fin n) → α i.succ), P (Fin.cons a v)

theorem Fin.exists_fin_succ_pi {n : ℕ} {α : Fin (n + 1) → Sort u} {P : ((i : Fin (n + 1)) → α i) → Prop} : (∃ (x : (i : Fin (n + 1)) → α i), P x) ↔ ∃ (a : α 0) (v : (i : Fin n) → α i.succ), P (Fin.cons a v)

@[simp]

theorem Fin.tail_update_zero {n : ℕ} {α : Fin (n + 1) → Sort u} (q : (i : Fin (n + 1)) → α i) (z : α 0) : Fin.tail (Function.update q 0 z) = Fin.tail q

Updating the first element of a tuple does not change the tail.

@[simp]

theorem Fin.tail_update_succ {n : ℕ} {α : Fin (n + 1) → Sort u} (q : (i : Fin (n + 1)) → α i) (i : Fin n) (y : α i.succ) : Fin.tail (Function.update q i.succ y) = Function.update (Fin.tail q) i y

Updating a nonzero element and taking the tail commute.

theorem Fin.comp_cons {n : ℕ} {α : Sort u_1} {β : Sort u_2} (g : α → β) (y : α) (q : Fin n → α) : g ∘ Fin.cons y q = Fin.cons (g y) (g ∘ q)

theorem Fin.comp_tail {n : ℕ} {α : Sort u_1} {β : Sort u_2} (g : α → β) (q : Fin n.succ → α) : g ∘ Fin.tail q = Fin.tail (g ∘ q)

theorem Fin.le_cons {n : ℕ} {α : Fin (n + 1) → Type u_1} [(i : Fin (n + 1)) → Preorder (α i)] {x : α 0} {q : (i : Fin (n + 1)) → α i} {p : (i : Fin n) → α i.succ} : q ≤ Fin.cons x p ↔ q 0 ≤ x ∧ Fin.tail q ≤ p

theorem Fin.cons_le {n : ℕ} {α : Fin (n + 1) → Type u_1} [(i : Fin (n + 1)) → Preorder (α i)] {x : α 0} {q : (i : Fin (n + 1)) → α i} {p : (i : Fin n) → α i.succ} : Fin.cons x p ≤ q ↔ x ≤ q 0 ∧ p ≤ Fin.tail q

theorem Fin.cons_le_cons {n : ℕ} {α : Fin (n + 1) → Type u_1} [(i : Fin (n + 1)) → Preorder (α i)] {x₀ y₀ : α 0} {x y : (i : Fin n) → α i.succ} : Fin.cons x₀ x ≤ Fin.cons y₀ y ↔ x₀ ≤ y₀ ∧ x ≤ y

theorem Fin.range_fin_succ {n : ℕ} {α : Type u_1} (f : Fin (n + 1) → α) : Set.range f = insert (f 0) (Set.range (Fin.tail f))

@[simp]

theorem Fin.range_cons {α : Type u_1} {n : ℕ} (x : α) (b : Fin n → α) : Set.range (Fin.cons x b) = insert x (Set.range b)

def Fin.append {m n : ℕ} {α : Sort u_1} (a : Fin m → α) (b : Fin n → α) : Fin (m + n) → α

Append a tuple of length m to a tuple of length n to get a tuple of length m + n. This is a non-dependent version of Fin.add_cases.

Equations

• Fin.append a b = Fin.addCases a b

@[simp]

theorem Fin.append_left {m n : ℕ} {α : Sort u_1} (u : Fin m → α) (v : Fin n → α) (i : Fin m) : Fin.append u v (Fin.castAdd n i) = u i

@[simp]

theorem Fin.append_right {m n : ℕ} {α : Sort u_1} (u : Fin m → α) (v : Fin n → α) (i : Fin n) : Fin.append u v (Fin.natAdd m i) = v i

theorem Fin.append_right_nil {m n : ℕ} {α : Sort u_1} (u : Fin m → α) (v : Fin n → α) (hv : n = 0) : Fin.append u v = u ∘ Fin.cast ⋯

@[simp]

theorem Fin.append_elim0 {m : ℕ} {α : Sort u_1} (u : Fin m → α) : Fin.append u Fin.elim0 = u ∘ Fin.cast ⋯

theorem Fin.append_left_nil {m n : ℕ} {α : Sort u_1} (u : Fin m → α) (v : Fin n → α) (hu : m = 0) : Fin.append u v = v ∘ Fin.cast ⋯

@[simp]

theorem Fin.elim0_append {n : ℕ} {α : Sort u_1} (v : Fin n → α) : Fin.append Fin.elim0 v = v ∘ Fin.cast ⋯

theorem Fin.append_assoc {m n : ℕ} {α : Sort u_1} {p : ℕ} (a : Fin m → α) (b : Fin n → α) (c : Fin p → α) : Fin.append (Fin.append a b) c = Fin.append a (Fin.append b c) ∘ Fin.cast ⋯

theorem Fin.append_left_eq_cons {α : Sort u_1} {n : ℕ} (x₀ : Fin 1 → α) (x : Fin n → α) : Fin.append x₀ x = Fin.cons (x₀ 0) x ∘ Fin.cast ⋯

Appending a one-tuple to the left is the same as Fin.cons.

theorem Fin.cons_eq_append {n : ℕ} {α : Sort u_1} (x : α) (xs : Fin n → α) : Fin.cons x xs = Fin.append (Fin.cons x Fin.elim0) xs ∘ Fin.cast ⋯

Fin.cons is the same as appending a one-tuple to the left.

@[simp]

theorem Fin.append_cast_left {α : Sort u_1} {n m : ℕ} (xs : Fin n → α) (ys : Fin m → α) (n' : ℕ) (h : n' = n) : Fin.append (xs ∘ Fin.cast h) ys = Fin.append xs ys ∘ Fin.cast ⋯

@[simp]

theorem Fin.append_cast_right {α : Sort u_1} {n m : ℕ} (xs : Fin n → α) (ys : Fin m → α) (m' : ℕ) (h : m' = m) : Fin.append xs (ys ∘ Fin.cast h) = Fin.append xs ys ∘ Fin.cast ⋯

theorem Fin.append_rev {α : Sort u_1} {m n : ℕ} (xs : Fin m → α) (ys : Fin n → α) (i : Fin (m + n)) : Fin.append xs ys i.rev = Fin.append (ys ∘ Fin.rev) (xs ∘ Fin.rev) (Fin.cast ⋯ i)

theorem Fin.append_comp_rev {α : Sort u_1} {m n : ℕ} (xs : Fin m → α) (ys : Fin n → α) : Fin.append xs ys ∘ Fin.rev = Fin.append (ys ∘ Fin.rev) (xs ∘ Fin.rev) ∘ Fin.cast ⋯

theorem Fin.append_castAdd_natAdd {m n : ℕ} {α : Sort u_1} {f : Fin (m + n) → α} : (Fin.append (fun (i : Fin m) => f (Fin.castAdd n i)) fun (i : Fin n) => f (Fin.natAdd m i)) = f

def Fin.repeat {n : ℕ} {α : Sort u_1} (m : ℕ) (a : Fin n → α) : Fin (m * n) → α

Repeat a m times. For example Fin.repeat 2 ![0, 3, 7] = ![0, 3, 7, 0, 3, 7].

Equations

• Fin.repeat m a x = a x.modNat

@[simp]

theorem Fin.repeat_apply {m n : ℕ} {α : Sort u_1} (a : Fin n → α) (i : Fin (m * n)) : Fin.repeat m a i = a i.modNat

@[simp]

theorem Fin.repeat_zero {n : ℕ} {α : Sort u_1} (a : Fin n → α) : Fin.repeat 0 a = Fin.elim0 ∘ Fin.cast ⋯

@[simp]

theorem Fin.repeat_one {n : ℕ} {α : Sort u_1} (a : Fin n → α) : Fin.repeat 1 a = a ∘ Fin.cast ⋯

theorem Fin.repeat_succ {n : ℕ} {α : Sort u_1} (a : Fin n → α) (m : ℕ) : Fin.repeat m.succ a = Fin.append a (Fin.repeat m a) ∘ Fin.cast ⋯

@[simp]

theorem Fin.repeat_add {n : ℕ} {α : Sort u_1} (a : Fin n → α) (m₁ m₂ : ℕ) : Fin.repeat (m₁ + m₂) a = Fin.append (Fin.repeat m₁ a) (Fin.repeat m₂ a) ∘ Fin.cast ⋯

theorem Fin.repeat_rev {m n : ℕ} {α : Sort u_1} (a : Fin n → α) (k : Fin (m * n)) : Fin.repeat m a k.rev = Fin.repeat m (a ∘ Fin.rev) k

theorem Fin.repeat_comp_rev {m n : ℕ} {α : Sort u_1} (a : Fin n → α) : Fin.repeat m a ∘ Fin.rev = Fin.repeat m (a ∘ Fin.rev)

In the previous section, we have discussed inserting or removing elements on the left of a tuple. In this section, we do the same on the right. A difference is that Fin (n+1) is constructed inductively from Fin n starting from the left, not from the right. This implies that Lean needs more help to realize that elements belong to the right types, i.e., we need to insert casts at several places.

def Fin.init {n : ℕ} {α : Fin (n + 1) → Sort u_1} (q : (i : Fin (n + 1)) → α i) (i : Fin n) : α i.castSucc

The beginning of an n+1 tuple, i.e., its first n entries

Equations

• Fin.init q i = q i.castSucc

theorem Fin.init_def {n : ℕ} {α : Fin (n + 1) → Sort u_1} {q : (i : Fin (n + 1)) → α i} : (Fin.init fun (k : Fin (n + 1)) => q k) = fun (k : Fin n) => q k.castSucc

def Fin.snoc {n : ℕ} {α : Fin (n + 1) → Sort u_1} (p : (i : Fin n) → α i.castSucc) (x : α (Fin.last n)) (i : Fin (n + 1)) : α i

Adding an element at the end of an n-tuple, to get an n+1-tuple. The name snoc comes from cons (i.e., adding an element to the left of a tuple) read in reverse order.

Equations

• Fin.snoc p x i = if h : ↑i < n then cast ⋯ (p (i.castLT h)) else cast ⋯ x

@[simp]

theorem Fin.init_snoc {n : ℕ} {α : Fin (n + 1) → Sort u_1} (x : α (Fin.last n)) (p : (i : Fin n) → α i.castSucc) : Fin.init (Fin.snoc p x) = p

@[simp]

theorem Fin.snoc_castSucc {n : ℕ} {α : Fin (n + 1) → Sort u_1} (x : α (Fin.last n)) (p : (i : Fin n) → α i.castSucc) (i : Fin n) : Fin.snoc p x i.castSucc = p i

@[simp]

theorem Fin.snoc_comp_castSucc {n : ℕ} {α : Sort u_2} {a : α} {f : Fin n → α} : Fin.snoc f a ∘ Fin.castSucc = f

@[simp]

theorem Fin.snoc_last {n : ℕ} {α : Fin (n + 1) → Sort u_1} (x : α (Fin.last n)) (p : (i : Fin n) → α i.castSucc) : Fin.snoc p x (Fin.last n) = x

theorem Fin.snoc_zero {α : Sort u_2} (p : Fin 0 → α) (x : α) : Fin.snoc p x = fun (x_1 : Fin (0 + 1)) => x

@[simp]

theorem Fin.snoc_comp_nat_add {n m : ℕ} {α : Sort u_2} (f : Fin (m + n) → α) (a : α) : Fin.snoc f a ∘ Fin.natAdd m = Fin.snoc (f ∘ Fin.natAdd m) a

@[simp]

theorem Fin.snoc_cast_add {m n : ℕ} {α : Fin (n + m + 1) → Sort u_2} (f : (i : Fin (n + m)) → α i.castSucc) (a : α (Fin.last (n + m))) (i : Fin n) : Fin.snoc f a (Fin.castAdd (m + 1) i) = f (Fin.castAdd m i)

@[simp]

theorem Fin.snoc_comp_cast_add {n m : ℕ} {α : Sort u_2} (f : Fin (n + m) → α) (a : α) : Fin.snoc f a ∘ Fin.castAdd (m + 1) = f ∘ Fin.castAdd m

@[simp]

theorem Fin.snoc_update {n : ℕ} {α : Fin (n + 1) → Sort u_1} (x : α (Fin.last n)) (p : (i : Fin n) → α i.castSucc) (i : Fin n) (y : α i.castSucc) : Fin.snoc (Function.update p i y) x = Function.update (Fin.snoc p x) i.castSucc y

Updating a tuple and adding an element at the end commute.

theorem Fin.update_snoc_last {n : ℕ} {α : Fin (n + 1) → Sort u_1} (x : α (Fin.last n)) (p : (i : Fin n) → α i.castSucc) (z : α (Fin.last n)) : Function.update (Fin.snoc p x) (Fin.last n) z = Fin.snoc p z

Adding an element at the beginning of a tuple and then updating it amounts to adding it directly.

@[simp]

theorem Fin.snoc_init_self {n : ℕ} {α : Fin (n + 1) → Sort u_1} (q : (i : Fin (n + 1)) → α i) : Fin.snoc (Fin.init q) (q (Fin.last n)) = q

Concatenating the first element of a tuple with its tail gives back the original tuple

@[simp]

theorem Fin.init_update_last {n : ℕ} {α : Fin (n + 1) → Sort u_1} (q : (i : Fin (n + 1)) → α i) (z : α (Fin.last n)) : Fin.init (Function.update q (Fin.last n) z) = Fin.init q

Updating the last element of a tuple does not change the beginning.

@[simp]

theorem Fin.init_update_castSucc {n : ℕ} {α : Fin (n + 1) → Sort u_1} (q : (i : Fin (n + 1)) → α i) (i : Fin n) (y : α i.castSucc) : Fin.init (Function.update q i.castSucc y) = Function.update (Fin.init q) i y

Updating an element and taking the beginning commute.

theorem Fin.tail_init_eq_init_tail {n : ℕ} {β : Sort u_2} (q : Fin (n + 2) → β) : Fin.tail (Fin.init q) = Fin.init (Fin.tail q)

tail and init commute. We state this lemma in a non-dependent setting, as otherwise it would involve a cast to convince Lean that the two types are equal, making it harder to use.

theorem Fin.cons_snoc_eq_snoc_cons {n : ℕ} {β : Sort u_2} (a : β) (q : Fin n → β) (b : β) : Fin.cons a (Fin.snoc q b) = Fin.snoc (Fin.cons a q) b

cons and snoc commute. We state this lemma in a non-dependent setting, as otherwise it would involve a cast to convince Lean that the two types are equal, making it harder to use.

theorem Fin.comp_snoc {n : ℕ} {α : Sort u_2} {β : Sort u_3} (g : α → β) (q : Fin n → α) (y : α) : g ∘ Fin.snoc q y = Fin.snoc (g ∘ q) (g y)

theorem Fin.append_right_eq_snoc {α : Sort u_2} {n : ℕ} (x : Fin n → α) (x₀ : Fin 1 → α) : Fin.append x x₀ = Fin.snoc x (x₀ 0)

Appending a one-tuple to the right is the same as Fin.snoc.

theorem Fin.snoc_eq_append {n : ℕ} {α : Sort u_2} (xs : Fin n → α) (x : α) : Fin.snoc xs x = Fin.append xs (Fin.cons x Fin.elim0)

Fin.snoc is the same as appending a one-tuple

theorem Fin.append_left_snoc {n m : ℕ} {α : Sort u_2} (xs : Fin n → α) (x : α) (ys : Fin m → α) : Fin.append (Fin.snoc xs x) ys = Fin.append xs (Fin.cons x ys) ∘ Fin.cast ⋯

theorem Fin.append_right_cons {n m : ℕ} {α : Sort u_2} (xs : Fin n → α) (y : α) (ys : Fin m → α) : Fin.append xs (Fin.cons y ys) = Fin.append (Fin.snoc xs y) ys ∘ Fin.cast ⋯

theorem Fin.append_cons {m n : ℕ} {α : Sort u_2} (a : α) (as : Fin n → α) (bs : Fin m → α) : Fin.append (Fin.cons a as) bs = Fin.cons a (Fin.append as bs) ∘ Fin.cast ⋯

theorem Fin.append_snoc {m n : ℕ} {α : Sort u_2} (as : Fin n → α) (bs : Fin m → α) (b : α) : Fin.append as (Fin.snoc bs b) = Fin.snoc (Fin.append as bs) b

theorem Fin.comp_init {n : ℕ} {α : Sort u_2} {β : Sort u_3} (g : α → β) (q : Fin n.succ → α) : g ∘ Fin.init q = Fin.init (g ∘ q)

def Fin.snocEquiv {n : ℕ} (α : Fin (n + 1) → Type u_2) : α (Fin.last n) × ((i : Fin n) → α i.castSucc) ≃ ((i : Fin (n + 1)) → α i)

Equivalence between tuples of length n + 1 and pairs of an element and a tuple of length n given by separating out the last element of the tuple.

This is Fin.snoc as an Equiv.

Equations

• One or more equations did not get rendered due to their size.

@[simp]

theorem Fin.snocEquiv_symm_apply {n : ℕ} (α : Fin (n + 1) → Type u_2) (f : (i : Fin (n + 1)) → α i) : (Fin.snocEquiv α).symm f = (f (Fin.last n), Fin.init f)

@[simp]

theorem Fin.snocEquiv_apply {n : ℕ} (α : Fin (n + 1) → Type u_2) (f : α (Fin.last n) × ((i : Fin n) → α i.castSucc)) (x✝ : Fin (n + 1)) : (Fin.snocEquiv α) f x✝ = Fin.snoc f.2 f.1 x✝

@[inline]

def Fin.snocCases {n : ℕ} {α : Fin (n + 1) → Sort u_1} {P : ((i : Fin n.succ) → α i) → Sort u_2} (h : (xs : (i : Fin n) → α i.castSucc) → (x : α (Fin.last n)) → P (Fin.snoc xs x)) (x : (i : Fin n.succ) → α i) : P x

Recurse on an n+1-tuple by splitting it its initial n-tuple and its last element.

Equations

• Fin.snocCases h x = cast ⋯ (h (Fin.init x) (x (Fin.last n)))

@[simp]

theorem Fin.snocCases_snoc {n : ℕ} {α : Fin (n + 1) → Sort u_1} {P : ((i : Fin (n + 1)) → α i) → Sort u_2} (h : (x : (i : Fin n) → α i.castSucc) → (x₀ : α (Fin.last n)) → P (Fin.snoc x x₀)) (x : (i : Fin n) → Fin.init α i) (x₀ : α (Fin.last n)) : Fin.snocCases h (Fin.snoc x x₀) = h x x₀

def Fin.snocInduction {α : Sort u_2} {P : {n : ℕ} → (Fin n → α) → Sort u_3} (h0 : P Fin.elim0) (h : {n : ℕ} → (x : Fin n → α) → (x₀ : α) → P x → P (Fin.snoc x x₀)) {n : ℕ} (x : Fin n → α) : P x

Recurse on a tuple by splitting into Fin.elim0 and Fin.snoc.

Equations

• Fin.snocInduction h0 h x_2 = ⋯.mpr h0
• Fin.snocInduction h0 h x_2 = Fin.snocCases (fun (x : Fin n → α) (x_1 : α) => h x x_1 (Fin.snocInduction h0 (fun {n : ℕ} => h) x)) x_2

def Fin.succAboveCases {n : ℕ} {α : Fin (n + 1) → Sort u} (i : Fin (n + 1)) (x : α i) (p : (j : Fin n) → α (i.succAbove j)) (j : Fin (n + 1)) : α j

Define a function on Fin (n + 1) from a value on i : Fin (n + 1) and values on each Fin.succAbove i j, j : Fin n. This version is elaborated as eliminator and works for propositions, see also Fin.insertNth for a version without an @[elab_as_elim] attribute.

Equations

• i.succAboveCases x p j = if hj : j = i then ⋯ ▸ x else if hlt : j < i then Eq.recOn ⋯ (p (j.castPred ⋯)) else Eq.recOn ⋯ (p (j.pred ⋯))

theorem Fin.forall_iff_succ {n : ℕ} {P : Fin (n + 1) → Prop} : (∀ (i : Fin (n + 1)), P i) ↔ P 0 ∧ ∀ (i : Fin n), P i.succ

Alias of Fin.forall_fin_succ.

theorem Fin.exists_iff_succ {n : ℕ} {P : Fin (n + 1) → Prop} : (∃ (i : Fin (n + 1)), P i) ↔ P 0 ∨ ∃ (i : Fin n), P i.succ

Alias of Fin.exists_fin_succ.

theorem Fin.forall_iff_castSucc {n : ℕ} {P : Fin (n + 1) → Prop} : (∀ (i : Fin (n + 1)), P i) ↔ P (Fin.last n) ∧ ∀ (i : Fin n), P i.castSucc

theorem Fin.exists_iff_castSucc {n : ℕ} {P : Fin (n + 1) → Prop} : (∃ (i : Fin (n + 1)), P i) ↔ P (Fin.last n) ∨ ∃ (i : Fin n), P i.castSucc

theorem Fin.forall_iff_succAbove {n : ℕ} {P : Fin (n + 1) → Prop} (p : Fin (n + 1)) : (∀ (i : Fin (n + 1)), P i) ↔ P p ∧ ∀ (i : Fin n), P (p.succAbove i)

theorem Fin.exists_iff_succAbove {n : ℕ} {P : Fin (n + 1) → Prop} (p : Fin (n + 1)) : (∃ (i : Fin (n + 1)), P i) ↔ P p ∨ ∃ (i : Fin n), P (p.succAbove i)

def Fin.removeNth {n : ℕ} {α : Fin (n + 1) → Sort u_1} (p : Fin (n + 1)) (f : (i : Fin (n + 1)) → α i) (i : Fin n) : α (p.succAbove i)

Remove the p-th entry of a tuple.

Equations

• p.removeNth f i = f (p.succAbove i)

def Fin.insertNth {n : ℕ} {α : Fin (n + 1) → Sort u_1} (i : Fin (n + 1)) (x : α i) (p : (j : Fin n) → α (i.succAbove j)) (j : Fin (n + 1)) : α j

Insert an element into a tuple at a given position. For i = 0 see Fin.cons, for i = Fin.last n see Fin.snoc. See also Fin.succAboveCases for a version elaborated as an eliminator.

Equations

• i.insertNth x p j = i.succAboveCases x p j

@[simp]

theorem Fin.insertNth_apply_same {n : ℕ} {α : Fin (n + 1) → Sort u_1} (i : Fin (n + 1)) (x : α i) (p : (j : Fin n) → α (i.succAbove j)) : i.insertNth x p i = x

@[simp]

theorem Fin.insertNth_apply_succAbove {n : ℕ} {α : Fin (n + 1) → Sort u_1} (i : Fin (n + 1)) (x : α i) (p : (j : Fin n) → α (i.succAbove j)) (j : Fin n) : i.insertNth x p (i.succAbove j) = p j

@[simp]

theorem Fin.succAbove_cases_eq_insertNth : @Fin.succAboveCases = @Fin.insertNth

@[simp]

theorem Fin.removeNth_insertNth {n : ℕ} {α : Fin (n + 1) → Sort u_1} (p : Fin (n + 1)) (a : α p) (f : (i : Fin n) → α (p.succAbove i)) : p.removeNth (p.insertNth a f) = f

@[simp]

theorem Fin.removeNth_zero {n : ℕ} {α : Fin (n + 1) → Sort u_1} (f : (i : Fin (n + 1)) → α i) : Fin.removeNth 0 f = Fin.tail f

@[simp]

theorem Fin.removeNth_last {n : ℕ} {α : Type u_3} (f : Fin (n + 1) → α) : (Fin.last n).removeNth f = Fin.init f

@[simp]

theorem Fin.insertNth_comp_succAbove {n : ℕ} {β : Sort u_2} (i : Fin (n + 1)) (x : β) (p : Fin n → β) : i.insertNth x p ∘ i.succAbove = p

theorem Fin.insertNth_eq_iff {n : ℕ} {α : Fin (n + 1) → Sort u_1} {p : Fin (n + 1)} {a : α p} {f : (i : Fin n) → α (p.succAbove i)} {g : (j : Fin (n + 1)) → α j} : p.insertNth a f = g ↔ a = g p ∧ f = p.removeNth g

theorem Fin.eq_insertNth_iff {n : ℕ} {α : Fin (n + 1) → Sort u_1} {p : Fin (n + 1)} {a : α p} {f : (i : Fin n) → α (p.succAbove i)} {g : (j : Fin (n + 1)) → α j} : g = p.insertNth a f ↔ g p = a ∧ p.removeNth g = f

theorem Fin.insertNth_apply_below {n : ℕ} {α : Fin (n + 1) → Sort u_1} {i j : Fin (n + 1)} (h : j < i) (x : α i) (p : (k : Fin n) → α (i.succAbove k)) : i.insertNth x p j = Eq.recOn ⋯ (p (j.castPred ⋯))

theorem Fin.insertNth_apply_above {n : ℕ} {α : Fin (n + 1) → Sort u_1} {i j : Fin (n + 1)} (h : i < j) (x : α i) (p : (k : Fin n) → α (i.succAbove k)) : i.insertNth x p j = Eq.recOn ⋯ (p (j.pred ⋯))

theorem Fin.insertNth_zero {n : ℕ} {α : Fin (n + 1) → Sort u_1} (x : α 0) (p : (j : Fin n) → α (Fin.succAbove 0 j)) : Fin.insertNth 0 x p = Fin.cons x fun (j : Fin n) => cast ⋯ (p j)

@[simp]

theorem Fin.insertNth_zero' {n : ℕ} {β : Sort u_2} (x : β) (p : Fin n → β) : Fin.insertNth 0 x p = Fin.cons x p

theorem Fin.insertNth_last {n : ℕ} {α : Fin (n + 1) → Sort u_1} (x : α (Fin.last n)) (p : (j : Fin n) → α ((Fin.last n).succAbove j)) : (Fin.last n).insertNth x p = Fin.snoc (fun (j : Fin n) => cast ⋯ (p j)) x

@[simp]

theorem Fin.insertNth_last' {n : ℕ} {β : Sort u_2} (x : β) (p : Fin n → β) : (Fin.last n).insertNth x p = Fin.snoc p x

theorem Fin.insertNth_rev {n : ℕ} {α : Sort u_3} (i : Fin (n + 1)) (a : α) (f : Fin n → α) (j : Fin (n + 1)) : i.insertNth a f j.rev = i.rev.insertNth a (f ∘ Fin.rev) j

theorem Fin.insertNth_comp_rev {n : ℕ} {α : Sort u_3} (i : Fin (n + 1)) (x : α) (p : Fin n → α) : i.insertNth x p ∘ Fin.rev = i.rev.insertNth x (p ∘ Fin.rev)

theorem Fin.cons_rev {α : Sort u_3} {n : ℕ} (a : α) (f : Fin n → α) (i : Fin (n + 1)) : Fin.cons a f i.rev = Fin.snoc (f ∘ Fin.rev) a i

theorem Fin.cons_comp_rev {α : Sort u_3} {n : ℕ} (a : α) (f : Fin n → α) : Fin.cons a f ∘ Fin.rev = Fin.snoc (f ∘ Fin.rev) a

theorem Fin.snoc_rev {α : Sort u_3} {n : ℕ} (a : α) (f : Fin n → α) (i : Fin (n + 1)) : Fin.snoc f a i.rev = Fin.cons a (f ∘ Fin.rev) i

theorem Fin.snoc_comp_rev {α : Sort u_3} {n : ℕ} (a : α) (f : Fin n → α) : Fin.snoc f a ∘ Fin.rev = Fin.cons a (f ∘ Fin.rev)

theorem Fin.insertNth_binop {n : ℕ} {α : Fin (n + 1) → Sort u_1} (op : (j : Fin (n + 1)) → α j → α j → α j) (i : Fin (n + 1)) (x y : α i) (p q : (j : Fin n) → α (i.succAbove j)) : (i.insertNth (op i x y) fun (j : Fin n) => op (i.succAbove j) (p j) (q j)) = fun (j : Fin (n + 1)) => op j (i.insertNth x p j) (i.insertNth y q j)

theorem Fin.insertNth_le_iff {n : ℕ} {α : Fin (n + 1) → Type u_3} [(i : Fin (n + 1)) → Preorder (α i)] {i : Fin (n + 1)} {x : α i} {p : (j : Fin n) → α (i.succAbove j)} {q : (j : Fin (n + 1)) → α j} : i.insertNth x p ≤ q ↔ x ≤ q i ∧ p ≤ fun (j : Fin n) => q (i.succAbove j)

theorem Fin.le_insertNth_iff {n : ℕ} {α : Fin (n + 1) → Type u_3} [(i : Fin (n + 1)) → Preorder (α i)] {i : Fin (n + 1)} {x : α i} {p : (j : Fin n) → α (i.succAbove j)} {q : (j : Fin (n + 1)) → α j} : q ≤ i.insertNth x p ↔ q i ≤ x ∧ (fun (j : Fin n) => q (i.succAbove j)) ≤ p

@[simp]

theorem Fin.removeNth_update {n : ℕ} {α : Fin (n + 1) → Sort u_1} (p : Fin (n + 1)) (x : α p) (f : (j : Fin (n + 1)) → α j) : p.removeNth (Function.update f p x) = p.removeNth f

@[simp]

theorem Fin.insertNth_removeNth {n : ℕ} {α : Fin (n + 1) → Sort u_1} (p : Fin (n + 1)) (x : α p) (f : (j : Fin (n + 1)) → α j) : p.insertNth x (p.removeNth f) = Function.update f p x

theorem Fin.insertNth_self_removeNth {n : ℕ} {α : Fin (n + 1) → Sort u_1} (p : Fin (n + 1)) (f : (j : Fin (n + 1)) → α j) : p.insertNth (f p) (p.removeNth f) = f

@[simp]

theorem Fin.update_insertNth {n : ℕ} {α : Fin (n + 1) → Sort u_1} (p : Fin (n + 1)) (x y : α p) (f : (i : Fin n) → α (p.succAbove i)) : Function.update (p.insertNth x f) p y = p.insertNth y f

def Fin.insertNthEquiv {n : ℕ} (α : Fin (n + 1) → Type u) (p : Fin (n + 1)) : α p × ((i : Fin n) → α (p.succAbove i)) ≃ ((i : Fin (n + 1)) → α i)

Equivalence between tuples of length n + 1 and pairs of an element and a tuple of length n given by separating out the p-th element of the tuple.

This is Fin.insertNth as an Equiv.

Equations

• One or more equations did not get rendered due to their size.

@[simp]

theorem Fin.insertNthEquiv_symm_apply {n : ℕ} (α : Fin (n + 1) → Type u) (p : Fin (n + 1)) (f : (i : Fin (n + 1)) → α i) : (Fin.insertNthEquiv α p).symm f = (f p, p.removeNth f)

@[simp]

theorem Fin.insertNthEquiv_apply {n : ℕ} (α : Fin (n + 1) → Type u) (p : Fin (n + 1)) (f : α p × ((i : Fin n) → α (p.succAbove i))) (j : Fin (n + 1)) : (Fin.insertNthEquiv α p) f j = p.insertNth f.1 f.2 j

@[simp]

theorem Fin.insertNthEquiv_zero {n : ℕ} (α : Fin (n + 1) → Type u_3) : Fin.insertNthEquiv α 0 = Fin.consEquiv α

@[simp]

theorem Fin.insertNthEquiv_last (n : ℕ) (α : Type u_3) : Fin.insertNthEquiv (fun (x : Fin (n + 1)) => α) (Fin.last n) = Fin.snocEquiv fun (x : Fin (n + 1)) => α

Note this lemma can only be written about non-dependent tuples as insertNth (last n) = snoc is not a definitional equality.

@[deprecated Fin.removeNth]

def Fin.extractNth {n : ℕ} {α : Fin (n + 1) → Type u_3} (i : Fin (n + 1)) (f : (j : Fin (n + 1)) → α j) : α i × ((j : Fin n) → α (i.succAbove j))

Separates an n+1-tuple, returning a selected index and then the rest of the tuple. Functional form of Equiv.piFinSuccAbove.

Equations

• i.extractNth f = (f i, i.removeNth f)

def Fin.find {n : ℕ} (p : Fin n → Prop) [DecidablePred p] : Option (Fin n)

find p returns the first index n where p n is satisfied, and none if it is never satisfied.

Equations

• Fin.find _p = none
• Fin.find p = Option.casesOn (Fin.find fun (i : Fin n) => p (i.castLT ⋯)) (if x : p (Fin.last n) then some (Fin.last n) else none) fun (i : Fin n) => some (i.castLT ⋯)

theorem Fin.find_spec {n : ℕ} (p : Fin n → Prop) [DecidablePred p] {i : Fin n} : i ∈ Fin.find p → p i

If find p = some i, then p i holds

theorem Fin.isSome_find_iff {n : ℕ} {p : Fin n → Prop} [DecidablePred p] : (Fin.find p).isSome = true ↔ ∃ (i : Fin n), p i

find p does not return none if and only if p i holds at some index i.

theorem Fin.find_eq_none_iff {n : ℕ} {p : Fin n → Prop} [DecidablePred p] : Fin.find p = none ↔ ∀ (i : Fin n), ¬p i

find p returns none if and only if p i never holds.

theorem Fin.find_min {n : ℕ} {p : Fin n → Prop} [DecidablePred p] {i : Fin n} : i ∈ Fin.find p → ∀ {j : Fin n}, j < i → ¬p j

If find p returns some i, then p j does not hold for j < i, i.e., i is minimal among the indices where p holds.

theorem Fin.find_min' {n : ℕ} {p : Fin n → Prop} [DecidablePred p] {i : Fin n} (h : i ∈ Fin.find p) {j : Fin n} (hj : p j) : i ≤ j

theorem Fin.nat_find_mem_find {n : ℕ} {p : Fin n → Prop} [DecidablePred p] (h : ∃ (i : ℕ) (hin : i < n), p ⟨i, hin⟩) : ⟨Nat.find h, ⋯⟩ ∈ Fin.find p

theorem Fin.mem_find_iff {n : ℕ} {p : Fin n → Prop} [DecidablePred p] {i : Fin n} : i ∈ Fin.find p ↔ p i ∧ ∀ (j : Fin n), p j → i ≤ j

theorem Fin.find_eq_some_iff {n : ℕ} {p : Fin n → Prop} [DecidablePred p] {i : Fin n} : Fin.find p = some i ↔ p i ∧ ∀ (j : Fin n), p j → i ≤ j

theorem Fin.mem_find_of_unique {n : ℕ} {p : Fin n → Prop} [DecidablePred p] (h : ∀ (i j : Fin n), p i → p j → i = j) {i : Fin n} (hi : p i) : i ∈ Fin.find p

def Fin.contractNth {n : ℕ} {α : Sort u_1} (j : Fin (n + 1)) (op : α → α → α) (g : Fin (n + 1) → α) (k : Fin n) : α

Sends (g₀, ..., gₙ) to (g₀, ..., op gⱼ gⱼ₊₁, ..., gₙ).

Equations

• j.contractNth op g k = if ↑k < ↑j then g k.castSucc else if ↑k = ↑j then op (g k.castSucc) (g k.succ) else g k.succ

theorem Fin.contractNth_apply_of_lt {n : ℕ} {α : Sort u_1} (j : Fin (n + 1)) (op : α → α → α) (g : Fin (n + 1) → α) (k : Fin n) (h : ↑k < ↑j) : j.contractNth op g k = g k.castSucc

theorem Fin.contractNth_apply_of_eq {n : ℕ} {α : Sort u_1} (j : Fin (n + 1)) (op : α → α → α) (g : Fin (n + 1) → α) (k : Fin n) (h : ↑k = ↑j) : j.contractNth op g k = op (g k.castSucc) (g k.succ)

theorem Fin.contractNth_apply_of_gt {n : ℕ} {α : Sort u_1} (j : Fin (n + 1)) (op : α → α → α) (g : Fin (n + 1) → α) (k : Fin n) (h : ↑j < ↑k) : j.contractNth op g k = g k.succ

theorem Fin.contractNth_apply_of_ne {n : ℕ} {α : Sort u_1} (j : Fin (n + 1)) (op : α → α → α) (g : Fin (n + 1) → α) (k : Fin n) (hjk : ↑j ≠ ↑k) : j.contractNth op g k = g (j.succAbove k)

theorem Fin.sigma_eq_of_eq_comp_cast {α : Type u_1} {a b : (ii : ℕ) × (Fin ii → α)} (h : a.fst = b.fst) : a.snd = b.snd ∘ Fin.cast h → a = b

To show two sigma pairs of tuples agree, it to show the second elements are related via Fin.cast.

theorem Fin.sigma_eq_iff_eq_comp_cast {α : Type u_1} {a b : (ii : ℕ) × (Fin ii → α)} : a = b ↔ ∃ (h : a.fst = b.fst), a.snd = b.snd ∘ Fin.cast h

Fin.sigma_eq_of_eq_comp_cast as an iff.

def piFinTwoEquiv (α : Fin 2 → Type u) : ((i : Fin 2) → α i) ≃ α 0 × α 1

Π i : Fin 2, α i is equivalent to α 0 × α 1. See also finTwoArrowEquiv for a non-dependent version and prodEquivPiFinTwo for a version with inputs α β : Type u.

Equations

• piFinTwoEquiv α = { toFun := fun (f : (i : Fin 2) → α i) => (f 0, f 1), invFun := fun (p : α 0 × α 1) => Fin.cons p.1 (Fin.cons p.2 finZeroElim), left_inv := ⋯, right_inv := ⋯ }

@[simp]

theorem piFinTwoEquiv_apply (α : Fin 2 → Type u) : ⇑(piFinTwoEquiv α) = fun (f : (i : Fin 2) → α i) => (f 0, f 1)

@[simp]

theorem piFinTwoEquiv_symm_apply (α : Fin 2 → Type u) : ⇑(piFinTwoEquiv α).symm = fun (p : α 0 × α 1) => Fin.cons p.1 (Fin.cons p.2 finZeroElim)