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 : (i : Fin 0) → α i) (g : (i : Fin 0) → α i) : f ≤ g

def Fin.tail {n : ℕ} {α : Fin (n + 1) → Type 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) → Type 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) → Type 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) → Type 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) → Type 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) → Type u} (x : α 0) (p : (i : Fin n) → α i.succ) : Fin.cons x p 0 = x

@[simp]

theorem Fin.cons_one {n : ℕ} {α : Fin (n + 2) → Type 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) → Type 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) → Type u} : Function.Injective2 Fin.cons

As a binary function, Fin.cons is injective.

@[simp]

theorem Fin.cons_eq_cons {n : ℕ} {α : Fin (n + 1) → Type u} {x₀ : α 0} {y₀ : α 0} {x : (i : Fin n) → α i.succ} {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) → Type 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) → Type u} (x₀ : α 0) : Function.Injective (Fin.cons x₀)

theorem Fin.update_cons_zero {n : ℕ} {α : Fin (n + 1) → Type 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) → Type 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.consCases {n : ℕ} {α : Fin (n + 1) → Type 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) → Type 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 {α : Type 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 : Fin n → α) => h x₀ x (Fin.consInduction h0 (fun {n : ℕ} => h) x)) 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) → Type 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) → Type 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) → Type 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) → Type 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 : ℕ} {α : Type u_1} {β : Type u_2} (g : α → β) (y : α) (q : Fin n → α) : g ∘ Fin.cons y q = Fin.cons (g y) (g ∘ q)

theorem Fin.comp_tail {n : ℕ} {α : Type u_1} {β : Type 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} [(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} [(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} [(i : Fin (n + 1)) → Preorder (α i)] {x₀ : α 0} {y₀ : α 0} {x : (i : Fin n) → α i.succ} {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 : ℕ} {α : Type 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 : ℕ} {α : Type 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 : ℕ} {α : Type 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 : ℕ} {α : Type u_1} (u : Fin m → α) (v : Fin n → α) (hv : n = 0) : Fin.append u v = u ∘ Fin.cast ⋯

@[simp]

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

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

@[simp]

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

theorem Fin.append_assoc {m : ℕ} {n : ℕ} {p : ℕ} {α : Type u_1} (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 {α : Type 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 : ℕ} {α : Type 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 {n : ℕ} {m : ℕ} {α : Type u_1} (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 {n : ℕ} {m : ℕ} {α : Type u_1} (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 {m : ℕ} {n : ℕ} {α : Type u_1} (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 {m : ℕ} {n : ℕ} {α : Type u_1} (xs : Fin m → α) (ys : Fin n → α) : Fin.append xs ys ∘ Fin.rev = Fin.append (ys ∘ Fin.rev) (xs ∘ Fin.rev) ∘ Fin.cast ⋯

def Fin.repeat {n : ℕ} {α : Type 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 : ℕ} {α : Type u_1} (a : Fin n → α) (i : Fin (m * n)) : Fin.repeat m a i = a i.modNat

@[simp]

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

@[simp]

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

theorem Fin.repeat_succ {n : ℕ} {α : Type 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 : ℕ} {α : Type 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 : ℕ} {α : Type 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 : ℕ} {α : Type 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) → Type u} (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) → Type 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) → Type u} (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) → Type u} (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) → Type u} (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 : ℕ} {α : Type u_1} {a : α} {f : Fin n → α} : Fin.snoc f a ∘ Fin.castSucc = f

@[simp]

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

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

@[simp]

theorem Fin.snoc_comp_nat_add {n : ℕ} {m : ℕ} {α : Type u_1} (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) → Type u_1} (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 : ℕ} {α : Type u_1} (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) → Type u} (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) → Type u} (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) → Type u} (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) → Type u} (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) → Type u} (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 : ℕ} {β : Type u_1} (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 : ℕ} {β : Type u_1} (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 : ℕ} {α : Type u_1} {β : Type u_2} (g : α → β) (q : Fin n → α) (y : α) : g ∘ Fin.snoc q y = Fin.snoc (g ∘ q) (g y)

theorem Fin.append_right_eq_snoc {α : Type u_1} {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 : ℕ} {α : Type u_1} (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 : ℕ} {α : Type u_1} (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 : ℕ} {α : Type u_1} (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 : ℕ} {α : Type u_1} (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 : ℕ} {α : Type u_1} (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 : ℕ} {α : Type u_1} {β : Type u_2} (g : α → β) (q : Fin n.succ → α) : g ∘ Fin.init q = Fin.init (g ∘ q)

@[inline]

def Fin.snocCases {n : ℕ} {α : Fin (n + 1) → Type u} {P : ((i : Fin n.succ) → α i) → Sort u_1} (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) → Type u} {P : ((i : Fin (n + 1)) → α i) → Sort u_1} (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 {α : Type u_1} {P : {n : ℕ} → (Fin n → α) → Sort u_2} (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 : α) => h x₀ x (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) → Type u} (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) → Type u} (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) → Type u} (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) → Type u} (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) → Type u} (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) → Type u} (f : (i : Fin (n + 1)) → α i) : Fin.removeNth 0 f = Fin.tail f

@[simp]

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

@[simp]

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

theorem Fin.insertNth_eq_iff {n : ℕ} {α : Fin (n + 1) → Type u} {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) → Type u} {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) → Type u} {i : Fin (n + 1)} {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) → Type u} {i : Fin (n + 1)} {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) → Type u} (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 : ℕ} {β : Type v} (x : β) (p : Fin n → β) : Fin.insertNth 0 x p = Fin.cons x p

theorem Fin.insertNth_last {n : ℕ} {α : Fin (n + 1) → Type u} (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 : ℕ} {β : Type v} (x : β) (p : Fin n → β) : (Fin.last n).insertNth x p = Fin.snoc p x

theorem Fin.insertNth_rev {n : ℕ} {α : Type u_1} (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 : ℕ} {α : Type u_1} (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 {α : Type u_1} {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 {α : Type u_1} {n : ℕ} (a : α) (f : Fin n → α) : Fin.cons a f ∘ Fin.rev = Fin.snoc (f ∘ Fin.rev) a

theorem Fin.snoc_rev {α : Type u_1} {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 {α : Type u_1} {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) → Type u} (op : (j : Fin (n + 1)) → α j → α j → α j) (i : Fin (n + 1)) (x : α i) (y : α i) (p : (j : Fin n) → α (i.succAbove j)) (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} [(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} [(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) → Type u} (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) → Type u} (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) → Type u} (p : Fin (n + 1)) (f : (j : Fin (n + 1)) → α j) : p.insertNth (f p) (p.removeNth f) = f

@[deprecated Fin.removeNth]

def Fin.extractNth {n : ℕ} {α : Fin (n + 1) → Type u} (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 : ℕ} {α : Type 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 : ℕ} {α : Type 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 : ℕ} {α : Type 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 : ℕ} {α : Type 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 : ℕ} {α : Type 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 : (ii : ℕ) × (Fin ii → α)} {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 : (ii : ℕ) × (Fin ii → α)} {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.