Theory HOL-Combinatorics.List_Permutation

(*  Author:     Lawrence C Paulson and Thomas M Rasmussen and Norbert Voelker
*)

section ‹Permuted Lists›

theory List_Permutation
imports Permutations
begin

text ‹
  Note that multisets already provide the notion of permutated list and hence
  this theory mostly echoes material already logically present in theory
  text‹Permutations›; it should be seldom needed.
›

subsection ‹An existing notion›

abbreviation (input) perm :: 'a list  'a list  bool  (infixr <~~> 50)
  where xs <~~> ys  mset xs = mset ys


subsection ‹Nontrivial conclusions›

proposition perm_swap:
  xs[i := xs ! j, j := xs ! i] <~~> xs
  if i < length xs j < length xs
  using that by (simp add: mset_swap)

proposition mset_le_perm_append: "mset xs ⊆# mset ys  (zs. xs @ zs <~~> ys)"
  by (auto simp add: mset_subset_eq_exists_conv ex_mset dest: sym)

proposition perm_set_eq: "xs <~~> ys  set xs = set ys"
  by (rule mset_eq_setD) simp

proposition perm_distinct_iff: "xs <~~> ys  distinct xs  distinct ys"
  by (rule mset_eq_imp_distinct_iff) simp

theorem eq_set_perm_remdups: "set xs = set ys  remdups xs <~~> remdups ys"
  by (simp add: set_eq_iff_mset_remdups_eq)

proposition perm_remdups_iff_eq_set: "remdups x <~~> remdups y  set x = set y"
  by (simp add: set_eq_iff_mset_remdups_eq)

theorem permutation_Ex_bij:
  assumes "xs <~~> ys"
  shows "f. bij_betw f {..<length xs} {..<length ys}  (i<length xs. xs ! i = ys ! (f i))"
proof -
  from assms have mset xs = mset ys length xs = length ys
    by (auto simp add: dest: mset_eq_length)
  from mset xs = mset ys obtain p where p permutes {..<length ys} permute_list p ys = xs
    by (rule mset_eq_permutation)
  then have bij_betw p {..<length xs} {..<length ys}
    by (simp add: length xs = length ys permutes_imp_bij)
  moreover have i<length xs. xs ! i = ys ! (p i)
    using permute_list p ys = xs length xs = length ys p permutes {..<length ys} permute_list_nth
    by auto
  ultimately show ?thesis
    by blast
qed

proposition perm_finite: "finite {B. B <~~> A}"
  using mset_eq_finite by auto


subsection ‹Trivial conclusions:›

proposition perm_empty_imp: "[] <~~> ys  ys = []"
  by simp


text ‹\medskip This more general theorem is easier to understand!›

proposition perm_length: "xs <~~> ys  length xs = length ys"
  by (rule mset_eq_length) simp

proposition perm_sym: "xs <~~> ys  ys <~~> xs"
  by simp


text ‹We can insert the head anywhere in the list.›

proposition perm_append_Cons: "a # xs @ ys <~~> xs @ a # ys"
  by simp

proposition perm_append_swap: "xs @ ys <~~> ys @ xs"
  by simp

proposition perm_append_single: "a # xs <~~> xs @ [a]"
  by simp

proposition perm_rev: "rev xs <~~> xs"
  by simp

proposition perm_append1: "xs <~~> ys  l @ xs <~~> l @ ys"
  by simp

proposition perm_append2: "xs <~~> ys  xs @ l <~~> ys @ l"
  by simp

proposition perm_empty [iff]: "[] <~~> xs  xs = []"
  by simp

proposition perm_empty2 [iff]: "xs <~~> []  xs = []"
  by simp

proposition perm_sing_imp: "ys <~~> xs  xs = [y]  ys = [y]"
  by simp

proposition perm_sing_eq [iff]: "ys <~~> [y]  ys = [y]"
  by simp

proposition perm_sing_eq2 [iff]: "[y] <~~> ys  ys = [y]"
  by simp

proposition perm_remove: "x  set ys  ys <~~> x # remove1 x ys"
  by simp


text ‹\medskip Congruence rule›

proposition perm_remove_perm: "xs <~~> ys  remove1 z xs <~~> remove1 z ys"
  by simp

proposition remove_hd [simp]: "remove1 z (z # xs) = xs"
  by simp

proposition cons_perm_imp_perm: "z # xs <~~> z # ys  xs <~~> ys"
  by simp

proposition cons_perm_eq [simp]: "z#xs <~~> z#ys  xs <~~> ys"
  by simp

proposition append_perm_imp_perm: "zs @ xs <~~> zs @ ys  xs <~~> ys"
  by simp

proposition perm_append1_eq [iff]: "zs @ xs <~~> zs @ ys  xs <~~> ys"
  by simp

proposition perm_append2_eq [iff]: "xs @ zs <~~> ys @ zs  xs <~~> ys"
  by simp

end