src/Pure/meta_simplifier.ML
author wenzelm
Thu Jul 05 20:01:35 2007 +0200 (2007-07-05)
changeset 23598 e03a43b8178c
parent 23584 9b5ba76de1c2
child 23938 977d14aeb4d5
permissions -rw-r--r--
tuned;
berghofe@10413
     1
(*  Title:      Pure/meta_simplifier.ML
berghofe@10413
     2
    ID:         $Id$
wenzelm@11672
     3
    Author:     Tobias Nipkow and Stefan Berghofer
berghofe@10413
     4
wenzelm@11672
     5
Meta-level Simplification.
berghofe@10413
     6
*)
berghofe@10413
     7
skalberg@15006
     8
infix 4
wenzelm@15023
     9
  addsimps delsimps addeqcongs deleqcongs addcongs delcongs addsimprocs delsimprocs
nipkow@15199
    10
  setmksimps setmkcong setmksym setmkeqTrue settermless setsubgoaler
wenzelm@17882
    11
  setloop' setloop addloop addloop' delloop setSSolver addSSolver setSolver addSolver;
skalberg@15006
    12
wenzelm@11672
    13
signature BASIC_META_SIMPLIFIER =
wenzelm@11672
    14
sig
wenzelm@15023
    15
  val debug_simp: bool ref
wenzelm@11672
    16
  val trace_simp: bool ref
nipkow@13828
    17
  val simp_depth_limit: int ref
nipkow@16042
    18
  val trace_simp_depth_limit: int ref
wenzelm@15023
    19
  type rrule
wenzelm@16807
    20
  val eq_rrule: rrule * rrule -> bool
wenzelm@15023
    21
  type cong
wenzelm@15023
    22
  type simpset
wenzelm@15023
    23
  type proc
wenzelm@17614
    24
  type solver
wenzelm@17614
    25
  val mk_solver': string -> (simpset -> int -> tactic) -> solver
wenzelm@17614
    26
  val mk_solver: string -> (thm list -> int -> tactic) -> solver
skalberg@15006
    27
  val rep_ss: simpset ->
wenzelm@15023
    28
   {rules: rrule Net.net,
wenzelm@15023
    29
    prems: thm list,
wenzelm@17882
    30
    bounds: int * ((string * typ) * string) list,
wenzelm@22892
    31
    depth: int * bool ref option,
wenzelm@20289
    32
    context: Proof.context option} *
wenzelm@15023
    33
   {congs: (string * cong) list * string list,
wenzelm@15023
    34
    procs: proc Net.net,
wenzelm@15023
    35
    mk_rews:
wenzelm@15023
    36
     {mk: thm -> thm list,
wenzelm@15023
    37
      mk_cong: thm -> thm,
wenzelm@15023
    38
      mk_sym: thm -> thm option,
wenzelm@18208
    39
      mk_eq_True: thm -> thm option,
wenzelm@18208
    40
      reorient: theory -> term list -> term -> term -> bool},
wenzelm@15023
    41
    termless: term * term -> bool,
skalberg@15006
    42
    subgoal_tac: simpset -> int -> tactic,
wenzelm@17882
    43
    loop_tacs: (string * (simpset -> int -> tactic)) list,
wenzelm@15023
    44
    solvers: solver list * solver list}
skalberg@15006
    45
  val print_ss: simpset -> unit
wenzelm@15023
    46
  val empty_ss: simpset
wenzelm@15023
    47
  val merge_ss: simpset * simpset -> simpset
wenzelm@15023
    48
  type simproc
wenzelm@22234
    49
  val eq_simproc: simproc * simproc -> bool
wenzelm@22234
    50
  val morph_simproc: morphism -> simproc -> simproc
wenzelm@22234
    51
  val make_simproc: {name: string, lhss: cterm list,
wenzelm@22234
    52
    proc: morphism -> simpset -> cterm -> thm option, identifier: thm list} -> simproc
wenzelm@22008
    53
  val mk_simproc: string -> cterm list -> (theory -> simpset -> term -> thm option) -> simproc
wenzelm@15023
    54
  val add_prems: thm list -> simpset -> simpset
wenzelm@15023
    55
  val prems_of_ss: simpset -> thm list
wenzelm@15023
    56
  val addsimps: simpset * thm list -> simpset
wenzelm@15023
    57
  val delsimps: simpset * thm list -> simpset
wenzelm@15023
    58
  val addeqcongs: simpset * thm list -> simpset
wenzelm@15023
    59
  val deleqcongs: simpset * thm list -> simpset
wenzelm@15023
    60
  val addcongs: simpset * thm list -> simpset
wenzelm@15023
    61
  val delcongs: simpset * thm list -> simpset
wenzelm@15023
    62
  val addsimprocs: simpset * simproc list -> simpset
wenzelm@15023
    63
  val delsimprocs: simpset * simproc list -> simpset
wenzelm@15023
    64
  val setmksimps: simpset * (thm -> thm list) -> simpset
wenzelm@15023
    65
  val setmkcong: simpset * (thm -> thm) -> simpset
wenzelm@15023
    66
  val setmksym: simpset * (thm -> thm option) -> simpset
wenzelm@15023
    67
  val setmkeqTrue: simpset * (thm -> thm option) -> simpset
wenzelm@15023
    68
  val settermless: simpset * (term * term -> bool) -> simpset
wenzelm@15023
    69
  val setsubgoaler: simpset * (simpset -> int -> tactic) -> simpset
wenzelm@17882
    70
  val setloop': simpset * (simpset -> int -> tactic) -> simpset
wenzelm@15023
    71
  val setloop: simpset * (int -> tactic) -> simpset
wenzelm@17882
    72
  val addloop': simpset * (string * (simpset -> int -> tactic)) -> simpset
wenzelm@15023
    73
  val addloop: simpset * (string * (int -> tactic)) -> simpset
wenzelm@15023
    74
  val delloop: simpset * string -> simpset
wenzelm@15023
    75
  val setSSolver: simpset * solver -> simpset
wenzelm@15023
    76
  val addSSolver: simpset * solver -> simpset
wenzelm@15023
    77
  val setSolver: simpset * solver -> simpset
wenzelm@15023
    78
  val addSolver: simpset * solver -> simpset
wenzelm@21708
    79
wenzelm@21708
    80
  val rewrite_rule: thm list -> thm -> thm
wenzelm@21708
    81
  val rewrite_goals_rule: thm list -> thm -> thm
wenzelm@21708
    82
  val rewrite_goals_tac: thm list -> tactic
wenzelm@21708
    83
  val rewrite_tac: thm list -> tactic
wenzelm@23536
    84
  val rewrite_goal_tac: thm list -> int -> tactic
wenzelm@21708
    85
  val rewtac: thm -> tactic
wenzelm@21708
    86
  val prune_params_tac: tactic
wenzelm@21708
    87
  val fold_rule: thm list -> thm -> thm
wenzelm@21708
    88
  val fold_tac: thm list -> tactic
wenzelm@21708
    89
  val fold_goals_tac: thm list -> tactic
skalberg@15006
    90
end;
skalberg@15006
    91
berghofe@10413
    92
signature META_SIMPLIFIER =
berghofe@10413
    93
sig
wenzelm@11672
    94
  include BASIC_META_SIMPLIFIER
berghofe@10413
    95
  exception SIMPLIFIER of string * thm
wenzelm@17966
    96
  val solver: simpset -> solver -> int -> tactic
wenzelm@15023
    97
  val clear_ss: simpset -> simpset
wenzelm@15023
    98
  exception SIMPROC_FAIL of string * exn
wenzelm@16458
    99
  val simproc_i: theory -> string -> term list
wenzelm@16458
   100
    -> (theory -> simpset -> term -> thm option) -> simproc
wenzelm@16458
   101
  val simproc: theory -> string -> string list
wenzelm@16458
   102
    -> (theory -> simpset -> term -> thm option) -> simproc
wenzelm@17882
   103
  val inherit_context: simpset -> simpset -> simpset
wenzelm@20289
   104
  val the_context: simpset -> Proof.context
wenzelm@20289
   105
  val context: Proof.context -> simpset -> simpset
wenzelm@17897
   106
  val theory_context: theory  -> simpset -> simpset
wenzelm@17723
   107
  val debug_bounds: bool ref
wenzelm@18208
   108
  val set_reorient: (theory -> term list -> term -> term -> bool) -> simpset -> simpset
wenzelm@17966
   109
  val set_solvers: solver list -> simpset -> simpset
wenzelm@23598
   110
  val rewrite_cterm: bool * bool * bool -> (simpset -> thm -> thm option) -> simpset -> conv
wenzelm@16458
   111
  val rewrite_term: theory -> thm list -> (term -> term option) list -> term -> term
wenzelm@15023
   112
  val rewrite_thm: bool * bool * bool ->
wenzelm@15023
   113
    (simpset -> thm -> thm option) -> simpset -> thm -> thm
wenzelm@15023
   114
  val rewrite_goal_rule: bool * bool * bool ->
wenzelm@15023
   115
    (simpset -> thm -> thm option) -> simpset -> int -> thm -> thm
wenzelm@23536
   116
  val asm_rewrite_goal_tac: bool * bool * bool ->
wenzelm@23536
   117
    (simpset -> tactic) -> simpset -> int -> tactic
wenzelm@21605
   118
  val norm_hhf: thm -> thm
wenzelm@21605
   119
  val norm_hhf_protect: thm -> thm
wenzelm@23598
   120
  val rewrite: bool -> thm list -> conv
wenzelm@21708
   121
  val simplify: bool -> thm list -> thm -> thm
berghofe@10413
   122
end;
berghofe@10413
   123
wenzelm@15023
   124
structure MetaSimplifier: META_SIMPLIFIER =
berghofe@10413
   125
struct
berghofe@10413
   126
wenzelm@15023
   127
(** datatype simpset **)
wenzelm@15023
   128
wenzelm@15023
   129
(* rewrite rules *)
berghofe@10413
   130
wenzelm@20546
   131
type rrule =
wenzelm@20546
   132
 {thm: thm,         (*the rewrite rule*)
wenzelm@20546
   133
  name: string,     (*name of theorem from which rewrite rule was extracted*)
wenzelm@20546
   134
  lhs: term,        (*the left-hand side*)
wenzelm@20546
   135
  elhs: cterm,      (*the etac-contracted lhs*)
wenzelm@20546
   136
  extra: bool,      (*extra variables outside of elhs*)
wenzelm@20546
   137
  fo: bool,         (*use first-order matching*)
wenzelm@20546
   138
  perm: bool};      (*the rewrite rule is permutative*)
wenzelm@15023
   139
wenzelm@20546
   140
(*
wenzelm@12603
   141
Remarks:
berghofe@10413
   142
  - elhs is used for matching,
wenzelm@15023
   143
    lhs only for preservation of bound variable names;
berghofe@10413
   144
  - fo is set iff
berghofe@10413
   145
    either elhs is first-order (no Var is applied),
wenzelm@15023
   146
      in which case fo-matching is complete,
berghofe@10413
   147
    or elhs is not a pattern,
wenzelm@20546
   148
      in which case there is nothing better to do;
wenzelm@20546
   149
*)
berghofe@10413
   150
berghofe@10413
   151
fun eq_rrule ({thm = thm1, ...}: rrule, {thm = thm2, ...}: rrule) =
wenzelm@22360
   152
  Thm.eq_thm_prop (thm1, thm2);
wenzelm@15023
   153
wenzelm@15023
   154
wenzelm@15023
   155
(* congruences *)
wenzelm@15023
   156
wenzelm@15023
   157
type cong = {thm: thm, lhs: cterm};
berghofe@10413
   158
wenzelm@12603
   159
fun eq_cong ({thm = thm1, ...}: cong, {thm = thm2, ...}: cong) =
wenzelm@22360
   160
  Thm.eq_thm_prop (thm1, thm2);
berghofe@10413
   161
berghofe@10413
   162
wenzelm@17614
   163
(* simplification sets, procedures, and solvers *)
wenzelm@15023
   164
wenzelm@15023
   165
(*A simpset contains data required during conversion:
berghofe@10413
   166
    rules: discrimination net of rewrite rules;
wenzelm@15023
   167
    prems: current premises;
berghofe@15249
   168
    bounds: maximal index of bound variables already used
wenzelm@15023
   169
      (for generating new names when rewriting under lambda abstractions);
wenzelm@22892
   170
    depth: simp_depth and exceeded flag;
berghofe@10413
   171
    congs: association list of congruence rules and
berghofe@10413
   172
           a list of `weak' congruence constants.
berghofe@10413
   173
           A congruence is `weak' if it avoids normalization of some argument.
berghofe@10413
   174
    procs: discrimination net of simplification procedures
berghofe@10413
   175
      (functions that prove rewrite rules on the fly);
wenzelm@15023
   176
    mk_rews:
wenzelm@15023
   177
      mk: turn simplification thms into rewrite rules;
wenzelm@15023
   178
      mk_cong: prepare congruence rules;
wenzelm@15023
   179
      mk_sym: turn == around;
wenzelm@15023
   180
      mk_eq_True: turn P into P == True;
wenzelm@15023
   181
    termless: relation for ordered rewriting;*)
skalberg@15011
   182
wenzelm@15023
   183
type mk_rews =
wenzelm@15023
   184
 {mk: thm -> thm list,
wenzelm@15023
   185
  mk_cong: thm -> thm,
wenzelm@15023
   186
  mk_sym: thm -> thm option,
wenzelm@18208
   187
  mk_eq_True: thm -> thm option,
wenzelm@18208
   188
  reorient: theory -> term list -> term -> term -> bool};
wenzelm@15023
   189
wenzelm@15023
   190
datatype simpset =
wenzelm@15023
   191
  Simpset of
wenzelm@15023
   192
   {rules: rrule Net.net,
berghofe@10413
   193
    prems: thm list,
wenzelm@17882
   194
    bounds: int * ((string * typ) * string) list,
wenzelm@22892
   195
    depth: int * bool ref option,
wenzelm@20289
   196
    context: Proof.context option} *
wenzelm@15023
   197
   {congs: (string * cong) list * string list,
wenzelm@15023
   198
    procs: proc Net.net,
wenzelm@15023
   199
    mk_rews: mk_rews,
nipkow@11504
   200
    termless: term * term -> bool,
skalberg@15011
   201
    subgoal_tac: simpset -> int -> tactic,
wenzelm@17882
   202
    loop_tacs: (string * (simpset -> int -> tactic)) list,
wenzelm@15023
   203
    solvers: solver list * solver list}
wenzelm@15023
   204
and proc =
wenzelm@15023
   205
  Proc of
wenzelm@15023
   206
   {name: string,
wenzelm@15023
   207
    lhs: cterm,
wenzelm@22008
   208
    proc: simpset -> cterm -> thm option,
wenzelm@22234
   209
    id: stamp * thm list}
wenzelm@17614
   210
and solver =
wenzelm@17614
   211
  Solver of
wenzelm@17614
   212
   {name: string,
wenzelm@17614
   213
    solver: simpset -> int -> tactic,
wenzelm@15023
   214
    id: stamp};
wenzelm@15023
   215
wenzelm@15023
   216
wenzelm@15023
   217
fun rep_ss (Simpset args) = args;
berghofe@10413
   218
wenzelm@22892
   219
fun make_ss1 (rules, prems, bounds, depth, context) =
wenzelm@22892
   220
  {rules = rules, prems = prems, bounds = bounds, depth = depth, context = context};
wenzelm@15023
   221
wenzelm@22892
   222
fun map_ss1 f {rules, prems, bounds, depth, context} =
wenzelm@22892
   223
  make_ss1 (f (rules, prems, bounds, depth, context));
berghofe@10413
   224
wenzelm@15023
   225
fun make_ss2 (congs, procs, mk_rews, termless, subgoal_tac, loop_tacs, solvers) =
wenzelm@15023
   226
  {congs = congs, procs = procs, mk_rews = mk_rews, termless = termless,
wenzelm@15023
   227
    subgoal_tac = subgoal_tac, loop_tacs = loop_tacs, solvers = solvers};
wenzelm@15023
   228
wenzelm@15023
   229
fun map_ss2 f {congs, procs, mk_rews, termless, subgoal_tac, loop_tacs, solvers} =
wenzelm@15023
   230
  make_ss2 (f (congs, procs, mk_rews, termless, subgoal_tac, loop_tacs, solvers));
wenzelm@15023
   231
wenzelm@15023
   232
fun make_simpset (args1, args2) = Simpset (make_ss1 args1, make_ss2 args2);
berghofe@10413
   233
wenzelm@22892
   234
fun map_simpset f (Simpset ({rules, prems, bounds, depth, context},
wenzelm@15023
   235
    {congs, procs, mk_rews, termless, subgoal_tac, loop_tacs, solvers})) =
wenzelm@22892
   236
  make_simpset (f ((rules, prems, bounds, depth, context),
wenzelm@15023
   237
    (congs, procs, mk_rews, termless, subgoal_tac, loop_tacs, solvers)));
berghofe@10413
   238
wenzelm@15023
   239
fun map_simpset1 f (Simpset (r1, r2)) = Simpset (map_ss1 f r1, r2);
wenzelm@15023
   240
fun map_simpset2 f (Simpset (r1, r2)) = Simpset (r1, map_ss2 f r2);
wenzelm@15023
   241
wenzelm@17614
   242
fun prems_of_ss (Simpset ({prems, ...}, _)) = prems;
wenzelm@17614
   243
wenzelm@22234
   244
fun eq_procid ((s1: stamp, ths1: thm list), (s2, ths2)) =
wenzelm@22360
   245
  s1 = s2 andalso eq_list Thm.eq_thm (ths1, ths2);
wenzelm@22234
   246
fun eq_proc (Proc {id = id1, ...}, Proc {id = id2, ...}) = eq_procid (id1, id2);
wenzelm@17614
   247
wenzelm@17614
   248
fun mk_solver' name solver = Solver {name = name, solver = solver, id = stamp ()};
wenzelm@17614
   249
fun mk_solver name solver = mk_solver' name (solver o prems_of_ss);
wenzelm@17614
   250
wenzelm@17614
   251
fun solver_name (Solver {name, ...}) = name;
wenzelm@17966
   252
fun solver ss (Solver {solver = tac, ...}) = tac ss;
wenzelm@17614
   253
fun eq_solver (Solver {id = id1, ...}, Solver {id = id2, ...}) = (id1 = id2);
wenzelm@17614
   254
wenzelm@15023
   255
wenzelm@22892
   256
(* simp depth *)
wenzelm@22892
   257
wenzelm@22892
   258
val simp_depth_limit = ref 100;
wenzelm@22892
   259
val trace_simp_depth_limit = ref 1;
wenzelm@22892
   260
wenzelm@22892
   261
fun trace_depth (Simpset ({depth = (depth, exceeded), ...}, _)) msg =
wenzelm@22892
   262
  if depth > !trace_simp_depth_limit then
wenzelm@22892
   263
    (case exceeded of
wenzelm@22892
   264
      NONE => ()
wenzelm@22892
   265
    | SOME r => if !r then () else (tracing "trace_simp_depth_limit exceeded!"; r := true))
wenzelm@22892
   266
  else
wenzelm@22892
   267
    (tracing (enclose "[" "]" (string_of_int depth) ^ msg);
wenzelm@22892
   268
      (case exceeded of SOME r => r := false | _ => ()));
wenzelm@22892
   269
wenzelm@22892
   270
val inc_simp_depth = map_simpset1 (fn (rules, prems, bounds, (depth, exceeded), context) =>
wenzelm@22892
   271
  (rules, prems, bounds,
wenzelm@22892
   272
    (depth + 1, if depth = !trace_simp_depth_limit then SOME (ref false) else exceeded), context));
wenzelm@22892
   273
wenzelm@22892
   274
fun simp_depth (Simpset ({depth = (depth, _), ...}, _)) = depth;
wenzelm@22892
   275
wenzelm@22892
   276
wenzelm@16985
   277
(* diagnostics *)
wenzelm@16985
   278
wenzelm@16985
   279
exception SIMPLIFIER of string * thm;
wenzelm@16985
   280
wenzelm@16985
   281
val debug_simp = ref false;
wenzelm@16985
   282
val trace_simp = ref false;
wenzelm@22892
   283
wenzelm@16985
   284
local
wenzelm@16985
   285
wenzelm@22892
   286
fun prnt ss warn a = if warn then warning a else trace_depth ss a;
wenzelm@16985
   287
wenzelm@16985
   288
fun show_bounds (Simpset ({bounds = (_, bs), ...}, _)) t =
wenzelm@16985
   289
  let
wenzelm@20146
   290
    val names = Term.declare_term_names t Name.context;
wenzelm@20146
   291
    val xs = rev (#1 (Name.variants (rev (map #2 bs)) names));
wenzelm@17614
   292
    fun subst (((b, T), _), x') = (Free (b, T), Syntax.mark_boundT (x', T));
wenzelm@16985
   293
  in Term.subst_atomic (ListPair.map subst (bs, xs)) t end;
wenzelm@16985
   294
wenzelm@17705
   295
in
wenzelm@17705
   296
wenzelm@22892
   297
fun print_term ss warn a thy t = prnt ss warn (a ^ "\n" ^
wenzelm@16985
   298
  Sign.string_of_term thy (if ! debug_simp then t else show_bounds ss t));
wenzelm@16985
   299
wenzelm@22892
   300
fun debug warn a ss = if ! debug_simp then prnt ss warn (a ()) else ();
wenzelm@22892
   301
fun trace warn a ss = if ! trace_simp then prnt ss warn (a ()) else ();
wenzelm@16985
   302
wenzelm@22892
   303
fun debug_term warn a ss thy t = if ! debug_simp then print_term ss warn (a ()) thy t else ();
wenzelm@22892
   304
fun trace_term warn a ss thy t = if ! trace_simp then print_term ss warn (a ()) thy t else ();
wenzelm@16985
   305
wenzelm@16985
   306
fun trace_cterm warn a ss ct =
wenzelm@22892
   307
  if ! trace_simp then print_term ss warn (a ()) (Thm.theory_of_cterm ct) (Thm.term_of ct)
wenzelm@22254
   308
  else ();
wenzelm@16985
   309
wenzelm@16985
   310
fun trace_thm a ss th =
wenzelm@22892
   311
  if ! trace_simp then print_term ss false (a ()) (Thm.theory_of_thm th) (Thm.full_prop_of th)
wenzelm@22254
   312
  else ();
wenzelm@16985
   313
wenzelm@16985
   314
fun trace_named_thm a ss (th, name) =
wenzelm@16985
   315
  if ! trace_simp then
wenzelm@22892
   316
    print_term ss false (if name = "" then a () else a () ^ " " ^ quote name ^ ":")
wenzelm@16985
   317
      (Thm.theory_of_thm th) (Thm.full_prop_of th)
wenzelm@16985
   318
  else ();
wenzelm@16985
   319
wenzelm@22892
   320
fun warn_thm a ss th =
wenzelm@22892
   321
  print_term ss true a (Thm.theory_of_thm th) (Thm.full_prop_of th);
wenzelm@16985
   322
wenzelm@20028
   323
fun cond_warn_thm a (ss as Simpset ({context, ...}, _)) th =
wenzelm@20546
   324
  if is_some context then () else warn_thm a ss th;
wenzelm@20028
   325
wenzelm@16985
   326
end;
wenzelm@16985
   327
wenzelm@16985
   328
wenzelm@15023
   329
(* print simpsets *)
berghofe@10413
   330
wenzelm@15023
   331
fun print_ss ss =
wenzelm@15023
   332
  let
wenzelm@15034
   333
    val pretty_thms = map Display.pretty_thm;
wenzelm@15023
   334
haftmann@22221
   335
    fun pretty_cong (name, {thm, lhs}) =
haftmann@22221
   336
      Pretty.block [Pretty.str (name ^ ":"), Pretty.brk 1, Display.pretty_thm thm];
wenzelm@15023
   337
    fun pretty_proc (name, lhss) =
wenzelm@15023
   338
      Pretty.big_list (name ^ ":") (map Display.pretty_cterm lhss);
wenzelm@15034
   339
wenzelm@15034
   340
    val Simpset ({rules, ...}, {congs, procs, loop_tacs, solvers, ...}) = ss;
wenzelm@16807
   341
    val smps = map #thm (Net.entries rules);
wenzelm@16807
   342
    val prcs = Net.entries procs |>
wenzelm@16807
   343
      map (fn Proc {name, lhs, id, ...} => ((name, lhs), id))
wenzelm@22234
   344
      |> partition_eq (eq_snd eq_procid)
wenzelm@17756
   345
      |> map (fn ps => (fst (fst (hd ps)), map (snd o fst) ps))
wenzelm@17756
   346
      |> Library.sort_wrt fst;
wenzelm@15023
   347
  in
wenzelm@15034
   348
    [Pretty.big_list "simplification rules:" (pretty_thms smps),
wenzelm@15034
   349
      Pretty.big_list "simplification procedures:" (map pretty_proc prcs),
haftmann@22221
   350
      Pretty.big_list "congruences:" (map pretty_cong (fst congs)),
haftmann@21286
   351
      Pretty.strs ("loopers:" :: map (quote o fst) loop_tacs),
wenzelm@15088
   352
      Pretty.strs ("unsafe solvers:" :: map (quote o solver_name) (#1 solvers)),
wenzelm@15088
   353
      Pretty.strs ("safe solvers:" :: map (quote o solver_name) (#2 solvers))]
wenzelm@15023
   354
    |> Pretty.chunks |> Pretty.writeln
nipkow@13828
   355
  end;
berghofe@10413
   356
wenzelm@15023
   357
berghofe@10413
   358
berghofe@10413
   359
(** simpset operations **)
berghofe@10413
   360
wenzelm@17882
   361
(* context *)
berghofe@10413
   362
wenzelm@17614
   363
fun eq_bound (x: string, (y, _)) = x = y;
wenzelm@17614
   364
wenzelm@22892
   365
fun add_bound bound = map_simpset1 (fn (rules, prems, (count, bounds), depth, context) =>
wenzelm@22892
   366
  (rules, prems, (count + 1, bound :: bounds), depth, context));
wenzelm@17882
   367
wenzelm@22892
   368
fun add_prems ths = map_simpset1 (fn (rules, prems, bounds, depth, context) =>
wenzelm@22892
   369
  (rules, ths @ prems, bounds, depth, context));
wenzelm@17882
   370
wenzelm@22892
   371
fun inherit_context (Simpset ({bounds, depth, context, ...}, _)) =
wenzelm@22892
   372
  map_simpset1 (fn (rules, prems, _, _, _) => (rules, prems, bounds, depth, context));
wenzelm@16985
   373
wenzelm@17882
   374
fun the_context (Simpset ({context = SOME ctxt, ...}, _)) = ctxt
wenzelm@17882
   375
  | the_context _ = raise Fail "Simplifier: no proof context in simpset";
berghofe@10413
   376
wenzelm@17897
   377
fun context ctxt =
wenzelm@22892
   378
  map_simpset1 (fn (rules, prems, bounds, depth, _) => (rules, prems, bounds, depth, SOME ctxt));
wenzelm@17882
   379
wenzelm@21516
   380
val theory_context = context o ProofContext.init;
wenzelm@17897
   381
wenzelm@22008
   382
fun activate_context thy (ss as Simpset ({context = SOME ctxt, ...}, _)) =
wenzelm@22008
   383
      context (Context.transfer_proof (Theory.merge (thy, ProofContext.theory_of ctxt)) ctxt) ss
wenzelm@22008
   384
  | activate_context thy ss =
wenzelm@17882
   385
     (warning "Simplifier: no proof context in simpset -- fallback to theory context!";
wenzelm@17897
   386
      theory_context thy ss);
wenzelm@17897
   387
wenzelm@17897
   388
wenzelm@20028
   389
(* maintain simp rules *)
berghofe@10413
   390
wenzelm@20546
   391
(* FIXME: it seems that the conditions on extra variables are too liberal if
wenzelm@20546
   392
prems are nonempty: does solving the prems really guarantee instantiation of
wenzelm@20546
   393
all its Vars? Better: a dynamic check each time a rule is applied.
wenzelm@20546
   394
*)
wenzelm@20546
   395
fun rewrite_rule_extra_vars prems elhs erhs =
wenzelm@20546
   396
  let
wenzelm@20546
   397
    val elhss = elhs :: prems;
wenzelm@20546
   398
    val tvars = fold Term.add_tvars elhss [];
wenzelm@20546
   399
    val vars = fold Term.add_vars elhss [];
wenzelm@20546
   400
  in
wenzelm@20546
   401
    erhs |> Term.exists_type (Term.exists_subtype
wenzelm@20546
   402
      (fn TVar v => not (member (op =) tvars v) | _ => false)) orelse
wenzelm@20546
   403
    erhs |> Term.exists_subterm
wenzelm@20546
   404
      (fn Var v => not (member (op =) vars v) | _ => false)
wenzelm@20546
   405
  end;
wenzelm@20546
   406
wenzelm@20546
   407
fun rrule_extra_vars elhs thm =
wenzelm@20546
   408
  rewrite_rule_extra_vars [] (term_of elhs) (Thm.full_prop_of thm);
wenzelm@20546
   409
wenzelm@15023
   410
fun mk_rrule2 {thm, name, lhs, elhs, perm} =
wenzelm@15023
   411
  let
wenzelm@20546
   412
    val t = term_of elhs;
wenzelm@20546
   413
    val fo = Pattern.first_order t orelse not (Pattern.pattern t);
wenzelm@20546
   414
    val extra = rrule_extra_vars elhs thm;
wenzelm@20546
   415
  in {thm = thm, name = name, lhs = lhs, elhs = elhs, extra = extra, fo = fo, perm = perm} end;
berghofe@10413
   416
wenzelm@20028
   417
fun del_rrule (rrule as {thm, elhs, ...}) ss =
wenzelm@22892
   418
  ss |> map_simpset1 (fn (rules, prems, bounds, depth, context) =>
wenzelm@22892
   419
    (Net.delete_term eq_rrule (term_of elhs, rrule) rules, prems, bounds, depth, context))
wenzelm@20028
   420
  handle Net.DELETE => (cond_warn_thm "Rewrite rule not in simpset:" ss thm; ss);
wenzelm@20028
   421
wenzelm@20546
   422
fun insert_rrule (rrule as {thm, name, elhs, ...}) ss =
wenzelm@22254
   423
 (trace_named_thm (fn () => "Adding rewrite rule") ss (thm, name);
wenzelm@22892
   424
  ss |> map_simpset1 (fn (rules, prems, bounds, depth, context) =>
wenzelm@15023
   425
    let
wenzelm@15023
   426
      val rrule2 as {elhs, ...} = mk_rrule2 rrule;
wenzelm@16807
   427
      val rules' = Net.insert_term eq_rrule (term_of elhs, rrule2) rules;
wenzelm@22892
   428
    in (rules', prems, bounds, depth, context) end)
wenzelm@20028
   429
  handle Net.INSERT => (cond_warn_thm "Ignoring duplicate rewrite rule:" ss thm; ss));
berghofe@10413
   430
berghofe@10413
   431
fun vperm (Var _, Var _) = true
berghofe@10413
   432
  | vperm (Abs (_, _, s), Abs (_, _, t)) = vperm (s, t)
berghofe@10413
   433
  | vperm (t1 $ t2, u1 $ u2) = vperm (t1, u1) andalso vperm (t2, u2)
berghofe@10413
   434
  | vperm (t, u) = (t = u);
berghofe@10413
   435
berghofe@10413
   436
fun var_perm (t, u) =
wenzelm@20197
   437
  vperm (t, u) andalso gen_eq_set (op =) (Term.add_vars t [], Term.add_vars u []);
berghofe@10413
   438
wenzelm@15023
   439
(*simple test for looping rewrite rules and stupid orientations*)
wenzelm@18208
   440
fun default_reorient thy prems lhs rhs =
wenzelm@15023
   441
  rewrite_rule_extra_vars prems lhs rhs
wenzelm@15023
   442
    orelse
wenzelm@15023
   443
  is_Var (head_of lhs)
wenzelm@15023
   444
    orelse
nipkow@16305
   445
(* turns t = x around, which causes a headache if x is a local variable -
nipkow@16305
   446
   usually it is very useful :-(
nipkow@16305
   447
  is_Free rhs andalso not(is_Free lhs) andalso not(Logic.occs(rhs,lhs))
nipkow@16305
   448
  andalso not(exists_subterm is_Var lhs)
nipkow@16305
   449
    orelse
nipkow@16305
   450
*)
wenzelm@16842
   451
  exists (fn t => Logic.occs (lhs, t)) (rhs :: prems)
wenzelm@15023
   452
    orelse
wenzelm@17203
   453
  null prems andalso Pattern.matches thy (lhs, rhs)
berghofe@10413
   454
    (*the condition "null prems" is necessary because conditional rewrites
berghofe@10413
   455
      with extra variables in the conditions may terminate although
wenzelm@15023
   456
      the rhs is an instance of the lhs; example: ?m < ?n ==> f(?n) == f(?m)*)
wenzelm@15023
   457
    orelse
wenzelm@15023
   458
  is_Const lhs andalso not (is_Const rhs);
berghofe@10413
   459
berghofe@10413
   460
fun decomp_simp thm =
wenzelm@15023
   461
  let
wenzelm@16458
   462
    val {thy, prop, ...} = Thm.rep_thm thm;
wenzelm@15023
   463
    val prems = Logic.strip_imp_prems prop;
wenzelm@15023
   464
    val concl = Drule.strip_imp_concl (Thm.cprop_of thm);
wenzelm@22902
   465
    val (lhs, rhs) = Thm.dest_equals concl handle TERM _ =>
wenzelm@15023
   466
      raise SIMPLIFIER ("Rewrite rule not a meta-equality", thm);
wenzelm@20579
   467
    val elhs = Thm.dest_arg (Thm.cprop_of (Thm.eta_conversion lhs));
wenzelm@16665
   468
    val elhs = if term_of elhs aconv term_of lhs then lhs else elhs;  (*share identical copies*)
wenzelm@18929
   469
    val erhs = Envir.eta_contract (term_of rhs);
wenzelm@15023
   470
    val perm =
wenzelm@15023
   471
      var_perm (term_of elhs, erhs) andalso
wenzelm@15023
   472
      not (term_of elhs aconv erhs) andalso
wenzelm@15023
   473
      not (is_Var (term_of elhs));
wenzelm@16458
   474
  in (thy, prems, term_of lhs, elhs, term_of rhs, perm) end;
berghofe@10413
   475
wenzelm@12783
   476
fun decomp_simp' thm =
wenzelm@12979
   477
  let val (_, _, lhs, _, rhs, _) = decomp_simp thm in
wenzelm@12783
   478
    if Thm.nprems_of thm > 0 then raise SIMPLIFIER ("Bad conditional rewrite rule", thm)
wenzelm@12979
   479
    else (lhs, rhs)
wenzelm@12783
   480
  end;
wenzelm@12783
   481
wenzelm@15023
   482
fun mk_eq_True (Simpset (_, {mk_rews = {mk_eq_True, ...}, ...})) (thm, name) =
wenzelm@15023
   483
  (case mk_eq_True thm of
skalberg@15531
   484
    NONE => []
skalberg@15531
   485
  | SOME eq_True =>
wenzelm@20546
   486
      let
wenzelm@20546
   487
        val (_, _, lhs, elhs, _, _) = decomp_simp eq_True;
wenzelm@20546
   488
        val extra = rrule_extra_vars elhs eq_True;
wenzelm@15023
   489
      in [{thm = eq_True, name = name, lhs = lhs, elhs = elhs, perm = false}] end);
berghofe@10413
   490
wenzelm@15023
   491
(*create the rewrite rule and possibly also the eq_True variant,
wenzelm@15023
   492
  in case there are extra vars on the rhs*)
wenzelm@15023
   493
fun rrule_eq_True (thm, name, lhs, elhs, rhs, ss, thm2) =
wenzelm@15023
   494
  let val rrule = {thm = thm, name = name, lhs = lhs, elhs = elhs, perm = false} in
wenzelm@20546
   495
    if rewrite_rule_extra_vars [] lhs rhs then
wenzelm@20546
   496
      mk_eq_True ss (thm2, name) @ [rrule]
wenzelm@20546
   497
    else [rrule]
berghofe@10413
   498
  end;
berghofe@10413
   499
wenzelm@15023
   500
fun mk_rrule ss (thm, name) =
wenzelm@15023
   501
  let val (_, prems, lhs, elhs, rhs, perm) = decomp_simp thm in
wenzelm@15023
   502
    if perm then [{thm = thm, name = name, lhs = lhs, elhs = elhs, perm = true}]
wenzelm@15023
   503
    else
wenzelm@15023
   504
      (*weak test for loops*)
wenzelm@15023
   505
      if rewrite_rule_extra_vars prems lhs rhs orelse is_Var (term_of elhs)
wenzelm@15023
   506
      then mk_eq_True ss (thm, name)
wenzelm@15023
   507
      else rrule_eq_True (thm, name, lhs, elhs, rhs, ss, thm)
berghofe@10413
   508
  end;
berghofe@10413
   509
wenzelm@15023
   510
fun orient_rrule ss (thm, name) =
wenzelm@18208
   511
  let
wenzelm@18208
   512
    val (thy, prems, lhs, elhs, rhs, perm) = decomp_simp thm;
wenzelm@18208
   513
    val Simpset (_, {mk_rews = {reorient, mk_sym, ...}, ...}) = ss;
wenzelm@18208
   514
  in
wenzelm@15023
   515
    if perm then [{thm = thm, name = name, lhs = lhs, elhs = elhs, perm = true}]
wenzelm@16458
   516
    else if reorient thy prems lhs rhs then
wenzelm@16458
   517
      if reorient thy prems rhs lhs
wenzelm@15023
   518
      then mk_eq_True ss (thm, name)
wenzelm@15023
   519
      else
wenzelm@18208
   520
        (case mk_sym thm of
wenzelm@18208
   521
          NONE => []
wenzelm@18208
   522
        | SOME thm' =>
wenzelm@18208
   523
            let val (_, _, lhs', elhs', rhs', _) = decomp_simp thm'
wenzelm@18208
   524
            in rrule_eq_True (thm', name, lhs', elhs', rhs', ss, thm) end)
wenzelm@15023
   525
    else rrule_eq_True (thm, name, lhs, elhs, rhs, ss, thm)
berghofe@10413
   526
  end;
berghofe@10413
   527
nipkow@15199
   528
fun extract_rews (Simpset (_, {mk_rews = {mk, ...}, ...}), thms) =
wenzelm@21646
   529
  maps (fn thm => map (rpair (PureThy.get_name_hint thm)) (mk thm)) thms;
berghofe@10413
   530
wenzelm@15023
   531
fun extract_safe_rrules (ss, thm) =
wenzelm@19482
   532
  maps (orient_rrule ss) (extract_rews (ss, [thm]));
berghofe@10413
   533
berghofe@10413
   534
wenzelm@20028
   535
(* add/del rules explicitly *)
berghofe@10413
   536
wenzelm@20028
   537
fun comb_simps comb mk_rrule (ss, thms) =
wenzelm@20028
   538
  let
wenzelm@20028
   539
    val rews = extract_rews (ss, thms);
wenzelm@20028
   540
  in fold (fold comb o mk_rrule) rews ss end;
berghofe@10413
   541
wenzelm@20028
   542
fun ss addsimps thms =
wenzelm@20028
   543
  comb_simps insert_rrule (mk_rrule ss) (ss, thms);
berghofe@10413
   544
wenzelm@15023
   545
fun ss delsimps thms =
wenzelm@20028
   546
  comb_simps del_rrule (map mk_rrule2 o mk_rrule ss) (ss, thms);
wenzelm@15023
   547
wenzelm@15023
   548
wenzelm@15023
   549
(* congs *)
berghofe@10413
   550
skalberg@15531
   551
fun cong_name (Const (a, _)) = SOME a
skalberg@15531
   552
  | cong_name (Free (a, _)) = SOME ("Free: " ^ a)
skalberg@15531
   553
  | cong_name _ = NONE;
ballarin@13835
   554
wenzelm@15023
   555
local
wenzelm@15023
   556
wenzelm@15023
   557
fun is_full_cong_prems [] [] = true
wenzelm@15023
   558
  | is_full_cong_prems [] _ = false
wenzelm@15023
   559
  | is_full_cong_prems (p :: prems) varpairs =
wenzelm@15023
   560
      (case Logic.strip_assums_concl p of
wenzelm@15023
   561
        Const ("==", _) $ lhs $ rhs =>
wenzelm@15023
   562
          let val (x, xs) = strip_comb lhs and (y, ys) = strip_comb rhs in
wenzelm@15023
   563
            is_Var x andalso forall is_Bound xs andalso
haftmann@20972
   564
            not (has_duplicates (op =) xs) andalso xs = ys andalso
wenzelm@20671
   565
            member (op =) varpairs (x, y) andalso
wenzelm@19303
   566
            is_full_cong_prems prems (remove (op =) (x, y) varpairs)
wenzelm@15023
   567
          end
wenzelm@15023
   568
      | _ => false);
wenzelm@15023
   569
wenzelm@15023
   570
fun is_full_cong thm =
berghofe@10413
   571
  let
wenzelm@15023
   572
    val prems = prems_of thm and concl = concl_of thm;
wenzelm@15023
   573
    val (lhs, rhs) = Logic.dest_equals concl;
wenzelm@15023
   574
    val (f, xs) = strip_comb lhs and (g, ys) = strip_comb rhs;
berghofe@10413
   575
  in
haftmann@20972
   576
    f = g andalso not (has_duplicates (op =) (xs @ ys)) andalso length xs = length ys andalso
wenzelm@15023
   577
    is_full_cong_prems prems (xs ~~ ys)
berghofe@10413
   578
  end;
berghofe@10413
   579
wenzelm@15023
   580
fun add_cong (ss, thm) = ss |>
wenzelm@15023
   581
  map_simpset2 (fn (congs, procs, mk_rews, termless, subgoal_tac, loop_tacs, solvers) =>
wenzelm@15023
   582
    let
wenzelm@22902
   583
      val (lhs, _) = Thm.dest_equals (Drule.strip_imp_concl (Thm.cprop_of thm))
wenzelm@15023
   584
        handle TERM _ => raise SIMPLIFIER ("Congruence not a meta-equality", thm);
wenzelm@18929
   585
    (*val lhs = Envir.eta_contract lhs;*)
wenzelm@20057
   586
      val a = the (cong_name (head_of (term_of lhs))) handle Option.Option =>
wenzelm@15023
   587
        raise SIMPLIFIER ("Congruence must start with a constant or free variable", thm);
haftmann@22221
   588
      val (xs, weak) = congs;
haftmann@22221
   589
      val _ =  if AList.defined (op =) xs a
haftmann@22221
   590
        then warning ("Overwriting congruence rule for " ^ quote a)
haftmann@22221
   591
        else ();
haftmann@22221
   592
      val xs' = AList.update (op =) (a, {lhs = lhs, thm = thm}) xs;
haftmann@22221
   593
      val weak' = if is_full_cong thm then weak else a :: weak;
haftmann@22221
   594
    in ((xs', weak'), procs, mk_rews, termless, subgoal_tac, loop_tacs, solvers) end);
berghofe@10413
   595
wenzelm@15023
   596
fun del_cong (ss, thm) = ss |>
wenzelm@15023
   597
  map_simpset2 (fn (congs, procs, mk_rews, termless, subgoal_tac, loop_tacs, solvers) =>
wenzelm@15023
   598
    let
wenzelm@15023
   599
      val (lhs, _) = Logic.dest_equals (Thm.concl_of thm) handle TERM _ =>
wenzelm@15023
   600
        raise SIMPLIFIER ("Congruence not a meta-equality", thm);
wenzelm@18929
   601
    (*val lhs = Envir.eta_contract lhs;*)
wenzelm@20057
   602
      val a = the (cong_name (head_of lhs)) handle Option.Option =>
wenzelm@15023
   603
        raise SIMPLIFIER ("Congruence must start with a constant", thm);
haftmann@22221
   604
      val (xs, _) = congs;
haftmann@22221
   605
      val xs' = filter_out (fn (x : string, _) => x = a) xs;
haftmann@22221
   606
      val weak' = xs' |> map_filter (fn (a, {thm, ...}: cong) =>
skalberg@15531
   607
        if is_full_cong thm then NONE else SOME a);
haftmann@22221
   608
    in ((xs', weak'), procs, mk_rews, termless, subgoal_tac, loop_tacs, solvers) end);
berghofe@10413
   609
wenzelm@15023
   610
fun mk_cong (Simpset (_, {mk_rews = {mk_cong = f, ...}, ...})) = f;
wenzelm@15023
   611
wenzelm@15023
   612
in
wenzelm@15023
   613
skalberg@15570
   614
val (op addeqcongs) = Library.foldl add_cong;
skalberg@15570
   615
val (op deleqcongs) = Library.foldl del_cong;
wenzelm@15023
   616
wenzelm@15023
   617
fun ss addcongs congs = ss addeqcongs map (mk_cong ss) congs;
wenzelm@15023
   618
fun ss delcongs congs = ss deleqcongs map (mk_cong ss) congs;
wenzelm@15023
   619
wenzelm@15023
   620
end;
berghofe@10413
   621
berghofe@10413
   622
wenzelm@15023
   623
(* simprocs *)
wenzelm@15023
   624
wenzelm@22008
   625
exception SIMPROC_FAIL of string * exn;
wenzelm@22008
   626
wenzelm@22234
   627
datatype simproc =
wenzelm@22234
   628
  Simproc of
wenzelm@22234
   629
    {name: string,
wenzelm@22234
   630
     lhss: cterm list,
wenzelm@22234
   631
     proc: morphism -> simpset -> cterm -> thm option,
wenzelm@22234
   632
     id: stamp * thm list};
wenzelm@22234
   633
wenzelm@22234
   634
fun eq_simproc (Simproc {id = id1, ...}, Simproc {id = id2, ...}) = eq_procid (id1, id2);
wenzelm@22008
   635
wenzelm@22234
   636
fun morph_simproc phi (Simproc {name, lhss, proc, id = (s, ths)}) =
wenzelm@22234
   637
  Simproc
wenzelm@22234
   638
   {name = name,
wenzelm@22234
   639
    lhss = map (Morphism.cterm phi) lhss,
wenzelm@22669
   640
    proc = Morphism.transform phi proc,
wenzelm@22234
   641
    id = (s, Morphism.fact phi ths)};
wenzelm@22234
   642
wenzelm@22234
   643
fun make_simproc {name, lhss, proc, identifier} =
wenzelm@22234
   644
  Simproc {name = name, lhss = lhss, proc = proc, id = (stamp (), identifier)};
wenzelm@22008
   645
wenzelm@22008
   646
fun mk_simproc name lhss proc =
wenzelm@22234
   647
  make_simproc {name = name, lhss = lhss, proc = fn _ => fn ss => fn ct =>
wenzelm@22234
   648
    proc (ProofContext.theory_of (the_context ss)) ss (Thm.term_of ct), identifier = []};
wenzelm@22008
   649
wenzelm@22008
   650
(* FIXME avoid global thy and Logic.varify *)
wenzelm@22008
   651
fun simproc_i thy name = mk_simproc name o map (Thm.cterm_of thy o Logic.varify);
wenzelm@22008
   652
fun simproc thy name = simproc_i thy name o map (Sign.read_term thy);
wenzelm@22008
   653
wenzelm@22008
   654
wenzelm@15023
   655
local
berghofe@10413
   656
wenzelm@16985
   657
fun add_proc (proc as Proc {name, lhs, ...}) ss =
wenzelm@22254
   658
 (trace_cterm false (fn () => "Adding simplification procedure " ^ quote name ^ " for") ss lhs;
wenzelm@15023
   659
  map_simpset2 (fn (congs, procs, mk_rews, termless, subgoal_tac, loop_tacs, solvers) =>
wenzelm@16807
   660
    (congs, Net.insert_term eq_proc (term_of lhs, proc) procs,
wenzelm@15023
   661
      mk_rews, termless, subgoal_tac, loop_tacs, solvers)) ss
wenzelm@15023
   662
  handle Net.INSERT =>
wenzelm@15023
   663
    (warning ("Ignoring duplicate simplification procedure " ^ quote name); ss));
berghofe@10413
   664
wenzelm@16985
   665
fun del_proc (proc as Proc {name, lhs, ...}) ss =
wenzelm@15023
   666
  map_simpset2 (fn (congs, procs, mk_rews, termless, subgoal_tac, loop_tacs, solvers) =>
wenzelm@16807
   667
    (congs, Net.delete_term eq_proc (term_of lhs, proc) procs,
wenzelm@15023
   668
      mk_rews, termless, subgoal_tac, loop_tacs, solvers)) ss
wenzelm@15023
   669
  handle Net.DELETE =>
wenzelm@15023
   670
    (warning ("Simplification procedure " ^ quote name ^ " not in simpset"); ss);
berghofe@10413
   671
wenzelm@22234
   672
fun prep_procs (Simproc {name, lhss, proc, id}) =
wenzelm@22669
   673
  lhss |> map (fn lhs => Proc {name = name, lhs = lhs, proc = Morphism.form proc, id = id});
wenzelm@22234
   674
wenzelm@15023
   675
in
berghofe@10413
   676
wenzelm@22234
   677
fun ss addsimprocs ps = fold (fold add_proc o prep_procs) ps ss;
wenzelm@22234
   678
fun ss delsimprocs ps = fold (fold del_proc o prep_procs) ps ss;
berghofe@10413
   679
wenzelm@15023
   680
end;
berghofe@10413
   681
berghofe@10413
   682
berghofe@10413
   683
(* mk_rews *)
berghofe@10413
   684
wenzelm@15023
   685
local
wenzelm@15023
   686
wenzelm@18208
   687
fun map_mk_rews f = map_simpset2 (fn (congs, procs, {mk, mk_cong, mk_sym, mk_eq_True, reorient},
wenzelm@15023
   688
      termless, subgoal_tac, loop_tacs, solvers) =>
wenzelm@18208
   689
  let
wenzelm@18208
   690
    val (mk', mk_cong', mk_sym', mk_eq_True', reorient') =
wenzelm@18208
   691
      f (mk, mk_cong, mk_sym, mk_eq_True, reorient);
wenzelm@18208
   692
    val mk_rews' = {mk = mk', mk_cong = mk_cong', mk_sym = mk_sym', mk_eq_True = mk_eq_True',
wenzelm@18208
   693
      reorient = reorient'};
wenzelm@18208
   694
  in (congs, procs, mk_rews', termless, subgoal_tac, loop_tacs, solvers) end);
wenzelm@15023
   695
wenzelm@15023
   696
in
berghofe@10413
   697
wenzelm@18208
   698
fun ss setmksimps mk = ss |> map_mk_rews (fn (_, mk_cong, mk_sym, mk_eq_True, reorient) =>
wenzelm@18208
   699
  (mk, mk_cong, mk_sym, mk_eq_True, reorient));
wenzelm@15023
   700
wenzelm@18208
   701
fun ss setmkcong mk_cong = ss |> map_mk_rews (fn (mk, _, mk_sym, mk_eq_True, reorient) =>
wenzelm@18208
   702
  (mk, mk_cong, mk_sym, mk_eq_True, reorient));
berghofe@10413
   703
wenzelm@18208
   704
fun ss setmksym mk_sym = ss |> map_mk_rews (fn (mk, mk_cong, _, mk_eq_True, reorient) =>
wenzelm@18208
   705
  (mk, mk_cong, mk_sym, mk_eq_True, reorient));
berghofe@10413
   706
wenzelm@18208
   707
fun ss setmkeqTrue mk_eq_True = ss |> map_mk_rews (fn (mk, mk_cong, mk_sym, _, reorient) =>
wenzelm@18208
   708
  (mk, mk_cong, mk_sym, mk_eq_True, reorient));
wenzelm@18208
   709
wenzelm@18208
   710
fun set_reorient reorient = map_mk_rews (fn (mk, mk_cong, mk_sym, mk_eq_True, _) =>
wenzelm@18208
   711
  (mk, mk_cong, mk_sym, mk_eq_True, reorient));
wenzelm@15023
   712
wenzelm@15023
   713
end;
wenzelm@15023
   714
skalberg@14242
   715
berghofe@10413
   716
(* termless *)
berghofe@10413
   717
wenzelm@15023
   718
fun ss settermless termless = ss |>
wenzelm@15023
   719
  map_simpset2 (fn (congs, procs, mk_rews, _, subgoal_tac, loop_tacs, solvers) =>
wenzelm@15023
   720
   (congs, procs, mk_rews, termless, subgoal_tac, loop_tacs, solvers));
skalberg@15006
   721
skalberg@15006
   722
wenzelm@15023
   723
(* tactics *)
skalberg@15006
   724
wenzelm@15023
   725
fun ss setsubgoaler subgoal_tac = ss |>
wenzelm@15023
   726
  map_simpset2 (fn (congs, procs, mk_rews, termless, _, loop_tacs, solvers) =>
wenzelm@15023
   727
   (congs, procs, mk_rews, termless, subgoal_tac, loop_tacs, solvers));
skalberg@15006
   728
wenzelm@17882
   729
fun ss setloop' tac = ss |>
wenzelm@15023
   730
  map_simpset2 (fn (congs, procs, mk_rews, termless, subgoal_tac, _, solvers) =>
wenzelm@15023
   731
   (congs, procs, mk_rews, termless, subgoal_tac, [("", tac)], solvers));
skalberg@15006
   732
wenzelm@17882
   733
fun ss setloop tac = ss setloop' (K tac);
wenzelm@17882
   734
wenzelm@17882
   735
fun ss addloop' (name, tac) = ss |>
wenzelm@15023
   736
  map_simpset2 (fn (congs, procs, mk_rews, termless, subgoal_tac, loop_tacs, solvers) =>
wenzelm@15023
   737
    (congs, procs, mk_rews, termless, subgoal_tac,
haftmann@21286
   738
      (if AList.defined (op =) loop_tacs name
haftmann@21286
   739
        then warning ("Overwriting looper " ^ quote name)
haftmann@21286
   740
        else (); AList.update (op =) (name, tac) loop_tacs),
wenzelm@15023
   741
      solvers));
skalberg@15006
   742
wenzelm@17882
   743
fun ss addloop (name, tac) = ss addloop' (name, K tac);
wenzelm@17882
   744
wenzelm@15023
   745
fun ss delloop name = ss |>
wenzelm@15023
   746
  map_simpset2 (fn (congs, procs, mk_rews, termless, subgoal_tac, loop_tacs, solvers) =>
haftmann@21286
   747
    (congs, procs, mk_rews, termless, subgoal_tac,
haftmann@21286
   748
      (if AList.defined (op =) loop_tacs name
haftmann@21286
   749
        then ()
haftmann@21286
   750
        else warning ("No such looper in simpset: " ^ quote name);
haftmann@21286
   751
       AList.delete (op =) name loop_tacs), solvers));
skalberg@15006
   752
wenzelm@15023
   753
fun ss setSSolver solver = ss |> map_simpset2 (fn (congs, procs, mk_rews, termless,
wenzelm@15023
   754
  subgoal_tac, loop_tacs, (unsafe_solvers, _)) =>
wenzelm@15023
   755
    (congs, procs, mk_rews, termless, subgoal_tac, loop_tacs, (unsafe_solvers, [solver])));
skalberg@15006
   756
wenzelm@15023
   757
fun ss addSSolver solver = ss |> map_simpset2 (fn (congs, procs, mk_rews, termless,
wenzelm@15023
   758
  subgoal_tac, loop_tacs, (unsafe_solvers, solvers)) => (congs, procs, mk_rews, termless,
haftmann@22717
   759
    subgoal_tac, loop_tacs, (unsafe_solvers, insert eq_solver solver solvers)));
skalberg@15006
   760
wenzelm@15023
   761
fun ss setSolver solver = ss |> map_simpset2 (fn (congs, procs, mk_rews, termless,
wenzelm@15023
   762
  subgoal_tac, loop_tacs, (_, solvers)) => (congs, procs, mk_rews, termless,
wenzelm@15023
   763
    subgoal_tac, loop_tacs, ([solver], solvers)));
skalberg@15006
   764
wenzelm@15023
   765
fun ss addSolver solver = ss |> map_simpset2 (fn (congs, procs, mk_rews, termless,
wenzelm@15023
   766
  subgoal_tac, loop_tacs, (unsafe_solvers, solvers)) => (congs, procs, mk_rews, termless,
haftmann@22717
   767
    subgoal_tac, loop_tacs, (insert eq_solver solver unsafe_solvers, solvers)));
skalberg@15006
   768
wenzelm@15023
   769
fun set_solvers solvers = map_simpset2 (fn (congs, procs, mk_rews, termless,
wenzelm@15023
   770
  subgoal_tac, loop_tacs, _) => (congs, procs, mk_rews, termless,
wenzelm@15023
   771
  subgoal_tac, loop_tacs, (solvers, solvers)));
skalberg@15006
   772
skalberg@15006
   773
wenzelm@18208
   774
(* empty *)
wenzelm@18208
   775
wenzelm@18208
   776
fun init_ss mk_rews termless subgoal_tac solvers =
wenzelm@22892
   777
  make_simpset ((Net.empty, [], (0, []), (0, NONE), NONE),
wenzelm@18208
   778
    (([], []), Net.empty, mk_rews, termless, subgoal_tac, [], solvers));
wenzelm@18208
   779
wenzelm@18208
   780
fun clear_ss (ss as Simpset (_, {mk_rews, termless, subgoal_tac, solvers, ...})) =
wenzelm@18208
   781
  init_ss mk_rews termless subgoal_tac solvers
wenzelm@18208
   782
  |> inherit_context ss;
wenzelm@18208
   783
wenzelm@18208
   784
val basic_mk_rews: mk_rews =
wenzelm@18208
   785
 {mk = fn th => if can Logic.dest_equals (Thm.concl_of th) then [th] else [],
wenzelm@18208
   786
  mk_cong = I,
wenzelm@18208
   787
  mk_sym = SOME o Drule.symmetric_fun,
wenzelm@18208
   788
  mk_eq_True = K NONE,
wenzelm@18208
   789
  reorient = default_reorient};
wenzelm@18208
   790
wenzelm@18208
   791
val empty_ss = init_ss basic_mk_rews Term.termless (K (K no_tac)) ([], []);
wenzelm@18208
   792
wenzelm@18208
   793
wenzelm@18208
   794
(* merge *)  (*NOTE: ignores some fields of 2nd simpset*)
wenzelm@18208
   795
wenzelm@18208
   796
fun merge_ss (ss1, ss2) =
wenzelm@18208
   797
  let
wenzelm@22892
   798
    val Simpset ({rules = rules1, prems = prems1, bounds = bounds1, depth = depth1, context = _},
wenzelm@18208
   799
     {congs = (congs1, weak1), procs = procs1, mk_rews, termless, subgoal_tac,
wenzelm@18208
   800
      loop_tacs = loop_tacs1, solvers = (unsafe_solvers1, solvers1)}) = ss1;
wenzelm@22892
   801
    val Simpset ({rules = rules2, prems = prems2, bounds = bounds2, depth = depth2, context = _},
wenzelm@18208
   802
     {congs = (congs2, weak2), procs = procs2, mk_rews = _, termless = _, subgoal_tac = _,
wenzelm@18208
   803
      loop_tacs = loop_tacs2, solvers = (unsafe_solvers2, solvers2)}) = ss2;
wenzelm@18208
   804
wenzelm@18208
   805
    val rules' = Net.merge eq_rrule (rules1, rules2);
wenzelm@23221
   806
    val prems' = merge Thm.eq_thm_prop (prems1, prems2);
wenzelm@18208
   807
    val bounds' = if #1 bounds1 < #1 bounds2 then bounds2 else bounds1;
wenzelm@22892
   808
    val depth' = if #1 depth1 < #1 depth2 then depth2 else depth1;
haftmann@22221
   809
    val congs' = merge (eq_cong o pairself #2) (congs1, congs2);
haftmann@22221
   810
    val weak' = merge (op =) (weak1, weak2);
wenzelm@18208
   811
    val procs' = Net.merge eq_proc (procs1, procs2);
haftmann@21286
   812
    val loop_tacs' = AList.merge (op =) (K true) (loop_tacs1, loop_tacs2);
haftmann@22717
   813
    val unsafe_solvers' = merge eq_solver (unsafe_solvers1, unsafe_solvers2);
haftmann@22717
   814
    val solvers' = merge eq_solver (solvers1, solvers2);
wenzelm@18208
   815
  in
wenzelm@22892
   816
    make_simpset ((rules', prems', bounds', depth', NONE), ((congs', weak'), procs',
wenzelm@18208
   817
      mk_rews, termless, subgoal_tac, loop_tacs', (unsafe_solvers', solvers')))
wenzelm@18208
   818
  end;
wenzelm@18208
   819
wenzelm@18208
   820
skalberg@15006
   821
berghofe@10413
   822
(** rewriting **)
berghofe@10413
   823
berghofe@10413
   824
(*
berghofe@10413
   825
  Uses conversions, see:
berghofe@10413
   826
    L C Paulson, A higher-order implementation of rewriting,
berghofe@10413
   827
    Science of Computer Programming 3 (1983), pages 119-149.
berghofe@10413
   828
*)
berghofe@10413
   829
wenzelm@16985
   830
fun check_conv msg ss thm thm' =
berghofe@10413
   831
  let
berghofe@10413
   832
    val thm'' = transitive thm (transitive
wenzelm@22902
   833
      (symmetric (Drule.beta_eta_conversion (Thm.lhs_of thm'))) thm')
wenzelm@22254
   834
  in if msg then trace_thm (fn () => "SUCCEEDED") ss thm' else (); SOME thm'' end
berghofe@10413
   835
  handle THM _ =>
wenzelm@16458
   836
    let val {thy, prop = _ $ _ $ prop0, ...} = Thm.rep_thm thm in
wenzelm@22254
   837
      trace_thm (fn () => "Proved wrong thm (Check subgoaler?)") ss thm';
wenzelm@22254
   838
      trace_term false (fn () => "Should have proved:") ss thy prop0;
skalberg@15531
   839
      NONE
berghofe@10413
   840
    end;
berghofe@10413
   841
berghofe@10413
   842
berghofe@10413
   843
(* mk_procrule *)
berghofe@10413
   844
wenzelm@16985
   845
fun mk_procrule ss thm =
wenzelm@15023
   846
  let val (_, prems, lhs, elhs, rhs, _) = decomp_simp thm in
wenzelm@15023
   847
    if rewrite_rule_extra_vars prems lhs rhs
wenzelm@16985
   848
    then (warn_thm "Extra vars on rhs:" ss thm; [])
wenzelm@15023
   849
    else [mk_rrule2 {thm = thm, name = "", lhs = lhs, elhs = elhs, perm = false}]
berghofe@10413
   850
  end;
berghofe@10413
   851
berghofe@10413
   852
wenzelm@15023
   853
(* rewritec: conversion to apply the meta simpset to a term *)
berghofe@10413
   854
wenzelm@15023
   855
(*Since the rewriting strategy is bottom-up, we avoid re-normalizing already
wenzelm@15023
   856
  normalized terms by carrying around the rhs of the rewrite rule just
wenzelm@15023
   857
  applied. This is called the `skeleton'. It is decomposed in parallel
wenzelm@15023
   858
  with the term. Once a Var is encountered, the corresponding term is
wenzelm@15023
   859
  already in normal form.
wenzelm@15023
   860
  skel0 is a dummy skeleton that is to enforce complete normalization.*)
wenzelm@15023
   861
berghofe@10413
   862
val skel0 = Bound 0;
berghofe@10413
   863
wenzelm@15023
   864
(*Use rhs as skeleton only if the lhs does not contain unnormalized bits.
wenzelm@15023
   865
  The latter may happen iff there are weak congruence rules for constants
wenzelm@15023
   866
  in the lhs.*)
berghofe@10413
   867
wenzelm@15023
   868
fun uncond_skel ((_, weak), (lhs, rhs)) =
wenzelm@15023
   869
  if null weak then rhs  (*optimization*)
wenzelm@20671
   870
  else if exists_Const (member (op =) weak o #1) lhs then skel0
wenzelm@15023
   871
  else rhs;
wenzelm@15023
   872
wenzelm@15023
   873
(*Behaves like unconditional rule if rhs does not contain vars not in the lhs.
wenzelm@15023
   874
  Otherwise those vars may become instantiated with unnormalized terms
wenzelm@15023
   875
  while the premises are solved.*)
wenzelm@15023
   876
wenzelm@15023
   877
fun cond_skel (args as (congs, (lhs, rhs))) =
wenzelm@20197
   878
  if Term.add_vars rhs [] subset Term.add_vars lhs [] then uncond_skel args
berghofe@10413
   879
  else skel0;
berghofe@10413
   880
berghofe@10413
   881
(*
wenzelm@15023
   882
  Rewriting -- we try in order:
berghofe@10413
   883
    (1) beta reduction
berghofe@10413
   884
    (2) unconditional rewrite rules
berghofe@10413
   885
    (3) conditional rewrite rules
berghofe@10413
   886
    (4) simplification procedures
berghofe@10413
   887
berghofe@10413
   888
  IMPORTANT: rewrite rules must not introduce new Vars or TVars!
berghofe@10413
   889
*)
berghofe@10413
   890
wenzelm@16458
   891
fun rewritec (prover, thyt, maxt) ss t =
berghofe@10413
   892
  let
wenzelm@15023
   893
    val Simpset ({rules, ...}, {congs, procs, termless, ...}) = ss;
berghofe@10413
   894
    val eta_thm = Thm.eta_conversion t;
wenzelm@22902
   895
    val eta_t' = Thm.rhs_of eta_thm;
berghofe@10413
   896
    val eta_t = term_of eta_t';
wenzelm@20546
   897
    fun rew {thm, name, lhs, elhs, extra, fo, perm} =
berghofe@10413
   898
      let
wenzelm@16458
   899
        val {thy, prop, maxidx, ...} = rep_thm thm;
wenzelm@20546
   900
        val (rthm, elhs') =
wenzelm@20546
   901
          if maxt = ~1 orelse not extra then (thm, elhs)
wenzelm@22902
   902
          else (Thm.incr_indexes (maxt + 1) thm, Thm.incr_indexes_cterm (maxt + 1) elhs);
wenzelm@22902
   903
        val insts =
wenzelm@22902
   904
          if fo then Thm.first_order_match (elhs', eta_t')
wenzelm@22902
   905
          else Thm.match (elhs', eta_t');
berghofe@10413
   906
        val thm' = Thm.instantiate insts (Thm.rename_boundvars lhs eta_t rthm);
wenzelm@14643
   907
        val prop' = Thm.prop_of thm';
wenzelm@21576
   908
        val unconditional = (Logic.count_prems prop' = 0);
berghofe@10413
   909
        val (lhs', rhs') = Logic.dest_equals (Logic.strip_imp_concl prop')
berghofe@10413
   910
      in
nipkow@11295
   911
        if perm andalso not (termless (rhs', lhs'))
wenzelm@22254
   912
        then (trace_named_thm (fn () => "Cannot apply permutative rewrite rule") ss (thm, name);
wenzelm@22254
   913
              trace_thm (fn () => "Term does not become smaller:") ss thm'; NONE)
wenzelm@22254
   914
        else (trace_named_thm (fn () => "Applying instance of rewrite rule") ss (thm, name);
berghofe@10413
   915
           if unconditional
berghofe@10413
   916
           then
wenzelm@22254
   917
             (trace_thm (fn () => "Rewriting:") ss thm';
berghofe@10413
   918
              let val lr = Logic.dest_equals prop;
wenzelm@16985
   919
                  val SOME thm'' = check_conv false ss eta_thm thm'
skalberg@15531
   920
              in SOME (thm'', uncond_skel (congs, lr)) end)
berghofe@10413
   921
           else
wenzelm@22254
   922
             (trace_thm (fn () => "Trying to rewrite:") ss thm';
wenzelm@22892
   923
              if simp_depth ss > ! simp_depth_limit
nipkow@16042
   924
              then let val s = "simp_depth_limit exceeded - giving up"
wenzelm@22892
   925
                   in trace false (fn () => s) ss; warning s; NONE end
nipkow@16042
   926
              else
nipkow@16042
   927
              case prover ss thm' of
wenzelm@22254
   928
                NONE => (trace_thm (fn () => "FAILED") ss thm'; NONE)
skalberg@15531
   929
              | SOME thm2 =>
wenzelm@16985
   930
                  (case check_conv true ss eta_thm thm2 of
skalberg@15531
   931
                     NONE => NONE |
skalberg@15531
   932
                     SOME thm2' =>
berghofe@10413
   933
                       let val concl = Logic.strip_imp_concl prop
berghofe@10413
   934
                           val lr = Logic.dest_equals concl
nipkow@16042
   935
                       in SOME (thm2', cond_skel (congs, lr)) end)))
berghofe@10413
   936
      end
berghofe@10413
   937
skalberg@15531
   938
    fun rews [] = NONE
berghofe@10413
   939
      | rews (rrule :: rrules) =
skalberg@15531
   940
          let val opt = rew rrule handle Pattern.MATCH => NONE
skalberg@15531
   941
          in case opt of NONE => rews rrules | some => some end;
berghofe@10413
   942
berghofe@10413
   943
    fun sort_rrules rrs = let
wenzelm@14643
   944
      fun is_simple({thm, ...}:rrule) = case Thm.prop_of thm of
berghofe@10413
   945
                                      Const("==",_) $ _ $ _ => true
wenzelm@12603
   946
                                      | _                   => false
berghofe@10413
   947
      fun sort []        (re1,re2) = re1 @ re2
wenzelm@12603
   948
        | sort (rr::rrs) (re1,re2) = if is_simple rr
berghofe@10413
   949
                                     then sort rrs (rr::re1,re2)
berghofe@10413
   950
                                     else sort rrs (re1,rr::re2)
berghofe@10413
   951
    in sort rrs ([],[]) end
berghofe@10413
   952
skalberg@15531
   953
    fun proc_rews [] = NONE
wenzelm@15023
   954
      | proc_rews (Proc {name, proc, lhs, ...} :: ps) =
wenzelm@17203
   955
          if Pattern.matches thyt (Thm.term_of lhs, Thm.term_of t) then
wenzelm@22254
   956
            (debug_term false (fn () => "Trying procedure " ^ quote name ^ " on:") ss thyt eta_t;
wenzelm@13486
   957
             case transform_failure (curry SIMPROC_FAIL name)
wenzelm@22008
   958
                 (fn () => proc ss eta_t') () of
wenzelm@22892
   959
               NONE => (debug false (fn () => "FAILED") ss; proc_rews ps)
skalberg@15531
   960
             | SOME raw_thm =>
wenzelm@22254
   961
                 (trace_thm (fn () => "Procedure " ^ quote name ^ " produced rewrite rule:")
wenzelm@22254
   962
                   ss raw_thm;
wenzelm@16985
   963
                  (case rews (mk_procrule ss raw_thm) of
wenzelm@22254
   964
                    NONE => (trace_cterm true (fn () => "IGNORED result of simproc " ^ quote name ^
wenzelm@16985
   965
                      " -- does not match") ss t; proc_rews ps)
berghofe@10413
   966
                  | some => some)))
berghofe@10413
   967
          else proc_rews ps;
berghofe@10413
   968
  in case eta_t of
skalberg@15531
   969
       Abs _ $ _ => SOME (transitive eta_thm
berghofe@12155
   970
         (beta_conversion false eta_t'), skel0)
berghofe@10413
   971
     | _ => (case rews (sort_rrules (Net.match_term rules eta_t)) of
skalberg@15531
   972
               NONE => proc_rews (Net.match_term procs eta_t)
berghofe@10413
   973
             | some => some)
berghofe@10413
   974
  end;
berghofe@10413
   975
berghofe@10413
   976
berghofe@10413
   977
(* conversion to apply a congruence rule to a term *)
berghofe@10413
   978
wenzelm@16985
   979
fun congc prover ss maxt {thm=cong,lhs=lhs} t =
wenzelm@22902
   980
  let val rthm = Thm.incr_indexes (maxt + 1) cong;
wenzelm@22902
   981
      val rlhs = fst (Thm.dest_equals (Drule.strip_imp_concl (cprop_of rthm)));
wenzelm@22902
   982
      val insts = Thm.match (rlhs, t)
wenzelm@22902
   983
      (* Thm.match can raise Pattern.MATCH;
berghofe@10413
   984
         is handled when congc is called *)
berghofe@10413
   985
      val thm' = Thm.instantiate insts (Thm.rename_boundvars (term_of rlhs) (term_of t) rthm);
wenzelm@22254
   986
      val unit = trace_thm (fn () => "Applying congruence rule:") ss thm';
wenzelm@22254
   987
      fun err (msg, thm) = (trace_thm (fn () => msg) ss thm; NONE)
berghofe@10413
   988
  in case prover thm' of
skalberg@15531
   989
       NONE => err ("Congruence proof failed.  Could not prove", thm')
wenzelm@16985
   990
     | SOME thm2 => (case check_conv true ss (Drule.beta_eta_conversion t) thm2 of
skalberg@15531
   991
          NONE => err ("Congruence proof failed.  Should not have proved", thm2)
skalberg@15531
   992
        | SOME thm2' =>
wenzelm@22902
   993
            if op aconv (pairself term_of (Thm.dest_equals (cprop_of thm2')))
skalberg@15531
   994
            then NONE else SOME thm2')
berghofe@10413
   995
  end;
berghofe@10413
   996
berghofe@10413
   997
val (cA, (cB, cC)) =
wenzelm@22902
   998
  apsnd Thm.dest_equals (Thm.dest_implies (hd (cprems_of Drule.imp_cong)));
berghofe@10413
   999
skalberg@15531
  1000
fun transitive1 NONE NONE = NONE
skalberg@15531
  1001
  | transitive1 (SOME thm1) NONE = SOME thm1
skalberg@15531
  1002
  | transitive1 NONE (SOME thm2) = SOME thm2
skalberg@15531
  1003
  | transitive1 (SOME thm1) (SOME thm2) = SOME (transitive thm1 thm2)
berghofe@10413
  1004
skalberg@15531
  1005
fun transitive2 thm = transitive1 (SOME thm);
skalberg@15531
  1006
fun transitive3 thm = transitive1 thm o SOME;
berghofe@13607
  1007
wenzelm@16458
  1008
fun bottomc ((simprem, useprem, mutsimp), prover, thy, maxidx) =
berghofe@10413
  1009
  let
wenzelm@15023
  1010
    fun botc skel ss t =
skalberg@15531
  1011
          if is_Var skel then NONE
berghofe@10413
  1012
          else
wenzelm@15023
  1013
          (case subc skel ss t of
skalberg@15531
  1014
             some as SOME thm1 =>
wenzelm@22902
  1015
               (case rewritec (prover, thy, maxidx) ss (Thm.rhs_of thm1) of
skalberg@15531
  1016
                  SOME (thm2, skel2) =>
berghofe@13607
  1017
                    transitive2 (transitive thm1 thm2)
wenzelm@22902
  1018
                      (botc skel2 ss (Thm.rhs_of thm2))
skalberg@15531
  1019
                | NONE => some)
skalberg@15531
  1020
           | NONE =>
wenzelm@16458
  1021
               (case rewritec (prover, thy, maxidx) ss t of
skalberg@15531
  1022
                  SOME (thm2, skel2) => transitive2 thm2
wenzelm@22902
  1023
                    (botc skel2 ss (Thm.rhs_of thm2))
skalberg@15531
  1024
                | NONE => NONE))
berghofe@10413
  1025
wenzelm@15023
  1026
    and try_botc ss t =
wenzelm@15023
  1027
          (case botc skel0 ss t of
skalberg@15531
  1028
             SOME trec1 => trec1 | NONE => (reflexive t))
berghofe@10413
  1029
wenzelm@15023
  1030
    and subc skel (ss as Simpset ({bounds, ...}, {congs, ...})) t0 =
berghofe@10413
  1031
       (case term_of t0 of
berghofe@10413
  1032
           Abs (a, T, t) =>
wenzelm@15023
  1033
             let
wenzelm@20079
  1034
                 val b = Name.bound (#1 bounds);
wenzelm@16985
  1035
                 val (v, t') = Thm.dest_abs (SOME b) t0;
wenzelm@16985
  1036
                 val b' = #1 (Term.dest_Free (Thm.term_of v));
wenzelm@21962
  1037
                 val _ =
wenzelm@21962
  1038
                   if b <> b' then
wenzelm@21962
  1039
                     warning ("Simplifier: renamed bound variable " ^ quote b ^ " to " ^ quote b')
wenzelm@21962
  1040
                   else ();
wenzelm@17614
  1041
                 val ss' = add_bound ((b', T), a) ss;
wenzelm@15023
  1042
                 val skel' = case skel of Abs (_, _, sk) => sk | _ => skel0;
wenzelm@15023
  1043
             in case botc skel' ss' t' of
skalberg@15531
  1044
                  SOME thm => SOME (abstract_rule a v thm)
skalberg@15531
  1045
                | NONE => NONE
berghofe@10413
  1046
             end
berghofe@10413
  1047
         | t $ _ => (case t of
wenzelm@15023
  1048
             Const ("==>", _) $ _  => impc t0 ss
berghofe@10413
  1049
           | Abs _ =>
berghofe@10413
  1050
               let val thm = beta_conversion false t0
wenzelm@22902
  1051
               in case subc skel0 ss (Thm.rhs_of thm) of
skalberg@15531
  1052
                    NONE => SOME thm
skalberg@15531
  1053
                  | SOME thm' => SOME (transitive thm thm')
berghofe@10413
  1054
               end
berghofe@10413
  1055
           | _  =>
berghofe@10413
  1056
               let fun appc () =
berghofe@10413
  1057
                     let
berghofe@10413
  1058
                       val (tskel, uskel) = case skel of
berghofe@10413
  1059
                           tskel $ uskel => (tskel, uskel)
berghofe@10413
  1060
                         | _ => (skel0, skel0);
wenzelm@10767
  1061
                       val (ct, cu) = Thm.dest_comb t0
berghofe@10413
  1062
                     in
wenzelm@15023
  1063
                     (case botc tskel ss ct of
skalberg@15531
  1064
                        SOME thm1 =>
wenzelm@15023
  1065
                          (case botc uskel ss cu of
skalberg@15531
  1066
                             SOME thm2 => SOME (combination thm1 thm2)
skalberg@15531
  1067
                           | NONE => SOME (combination thm1 (reflexive cu)))
skalberg@15531
  1068
                      | NONE =>
wenzelm@15023
  1069
                          (case botc uskel ss cu of
skalberg@15531
  1070
                             SOME thm1 => SOME (combination (reflexive ct) thm1)
skalberg@15531
  1071
                           | NONE => NONE))
berghofe@10413
  1072
                     end
berghofe@10413
  1073
                   val (h, ts) = strip_comb t
ballarin@13835
  1074
               in case cong_name h of
skalberg@15531
  1075
                    SOME a =>
haftmann@17232
  1076
                      (case AList.lookup (op =) (fst congs) a of
skalberg@15531
  1077
                         NONE => appc ()
skalberg@15531
  1078
                       | SOME cong =>
wenzelm@15023
  1079
  (*post processing: some partial applications h t1 ... tj, j <= length ts,
wenzelm@15023
  1080
    may be a redex. Example: map (%x. x) = (%xs. xs) wrt map_cong*)
berghofe@10413
  1081
                          (let
wenzelm@16985
  1082
                             val thm = congc (prover ss) ss maxidx cong t0;
wenzelm@22902
  1083
                             val t = the_default t0 (Option.map Thm.rhs_of thm);
wenzelm@10767
  1084
                             val (cl, cr) = Thm.dest_comb t
berghofe@10413
  1085
                             val dVar = Var(("", 0), dummyT)
berghofe@10413
  1086
                             val skel =
berghofe@10413
  1087
                               list_comb (h, replicate (length ts) dVar)
wenzelm@15023
  1088
                           in case botc skel ss cl of
skalberg@15531
  1089
                                NONE => thm
skalberg@15531
  1090
                              | SOME thm' => transitive3 thm
berghofe@12155
  1091
                                  (combination thm' (reflexive cr))
wenzelm@20057
  1092
                           end handle Pattern.MATCH => appc ()))
berghofe@10413
  1093
                  | _ => appc ()
berghofe@10413
  1094
               end)
skalberg@15531
  1095
         | _ => NONE)
berghofe@10413
  1096
wenzelm@15023
  1097
    and impc ct ss =
wenzelm@15023
  1098
      if mutsimp then mut_impc0 [] ct [] [] ss else nonmut_impc ct ss
berghofe@10413
  1099
wenzelm@15023
  1100
    and rules_of_prem ss prem =
berghofe@13607
  1101
      if maxidx_of_term (term_of prem) <> ~1
berghofe@13607
  1102
      then (trace_cterm true
wenzelm@22254
  1103
        (fn () => "Cannot add premise as rewrite rule because it contains (type) unknowns:")
wenzelm@22254
  1104
          ss prem; ([], NONE))
berghofe@13607
  1105
      else
berghofe@13607
  1106
        let val asm = assume prem
skalberg@15531
  1107
        in (extract_safe_rrules (ss, asm), SOME asm) end
berghofe@10413
  1108
wenzelm@15023
  1109
    and add_rrules (rrss, asms) ss =
wenzelm@20028
  1110
      (fold o fold) insert_rrule rrss ss |> add_prems (map_filter I asms)
berghofe@10413
  1111
wenzelm@23178
  1112
    and disch r prem eq =
berghofe@13607
  1113
      let
wenzelm@22902
  1114
        val (lhs, rhs) = Thm.dest_equals (Thm.cprop_of eq);
berghofe@13607
  1115
        val eq' = implies_elim (Thm.instantiate
berghofe@13607
  1116
          ([], [(cA, prem), (cB, lhs), (cC, rhs)]) Drule.imp_cong)
berghofe@13607
  1117
          (implies_intr prem eq)
berghofe@13607
  1118
      in if not r then eq' else
berghofe@10413
  1119
        let
wenzelm@22902
  1120
          val (prem', concl) = Thm.dest_implies lhs;
wenzelm@22902
  1121
          val (prem'', _) = Thm.dest_implies rhs
berghofe@13607
  1122
        in transitive (transitive
berghofe@13607
  1123
          (Thm.instantiate ([], [(cA, prem'), (cB, prem), (cC, concl)])
berghofe@13607
  1124
             Drule.swap_prems_eq) eq')
berghofe@13607
  1125
          (Thm.instantiate ([], [(cA, prem), (cB, prem''), (cC, concl)])
berghofe@13607
  1126
             Drule.swap_prems_eq)
berghofe@10413
  1127
        end
berghofe@10413
  1128
      end
berghofe@10413
  1129
berghofe@13607
  1130
    and rebuild [] _ _ _ _ eq = eq
wenzelm@15023
  1131
      | rebuild (prem :: prems) concl (rrs :: rrss) (asm :: asms) ss eq =
berghofe@13607
  1132
          let
wenzelm@15023
  1133
            val ss' = add_rrules (rev rrss, rev asms) ss;
berghofe@13607
  1134
            val concl' =
wenzelm@22902
  1135
              Drule.mk_implies (prem, the_default concl (Option.map Thm.rhs_of eq));
wenzelm@23178
  1136
            val dprem = Option.map (disch false prem)
wenzelm@16458
  1137
          in case rewritec (prover, thy, maxidx) ss' concl' of
skalberg@15531
  1138
              NONE => rebuild prems concl' rrss asms ss (dprem eq)
wenzelm@23178
  1139
            | SOME (eq', _) => transitive2 (fold (disch false)
wenzelm@23178
  1140
                  prems (the (transitive3 (dprem eq) eq')))
wenzelm@22902
  1141
                (mut_impc0 (rev prems) (Thm.rhs_of eq') (rev rrss) (rev asms) ss)
berghofe@13607
  1142
          end
wenzelm@15023
  1143
wenzelm@15023
  1144
    and mut_impc0 prems concl rrss asms ss =
berghofe@13607
  1145
      let
berghofe@13607
  1146
        val prems' = strip_imp_prems concl;
wenzelm@15023
  1147
        val (rrss', asms') = split_list (map (rules_of_prem ss) prems')
berghofe@13607
  1148
      in mut_impc (prems @ prems') (strip_imp_concl concl) (rrss @ rrss')
wenzelm@15023
  1149
        (asms @ asms') [] [] [] [] ss ~1 ~1
berghofe@13607
  1150
      end
wenzelm@15023
  1151
wenzelm@15023
  1152
    and mut_impc [] concl [] [] prems' rrss' asms' eqns ss changed k =
skalberg@15570
  1153
        transitive1 (Library.foldl (fn (eq2, (eq1, prem)) => transitive1 eq1
wenzelm@23178
  1154
            (Option.map (disch false prem) eq2)) (NONE, eqns ~~ prems'))
berghofe@13607
  1155
          (if changed > 0 then
berghofe@13607
  1156
             mut_impc (rev prems') concl (rev rrss') (rev asms')
wenzelm@15023
  1157
               [] [] [] [] ss ~1 changed
wenzelm@15023
  1158
           else rebuild prems' concl rrss' asms' ss
wenzelm@15023
  1159
             (botc skel0 (add_rrules (rev rrss', rev asms') ss) concl))
berghofe@13607
  1160
berghofe@13607
  1161
      | mut_impc (prem :: prems) concl (rrs :: rrss) (asm :: asms)
wenzelm@15023
  1162
          prems' rrss' asms' eqns ss changed k =
skalberg@15531
  1163
        case (if k = 0 then NONE else botc skel0 (add_rrules
wenzelm@15023
  1164
          (rev rrss' @ rrss, rev asms' @ asms) ss) prem) of
skalberg@15531
  1165
            NONE => mut_impc prems concl rrss asms (prem :: prems')
skalberg@15531
  1166
              (rrs :: rrss') (asm :: asms') (NONE :: eqns) ss changed
berghofe@13607
  1167
              (if k = 0 then 0 else k - 1)
skalberg@15531
  1168
          | SOME eqn =>
berghofe@13607
  1169
            let
wenzelm@22902
  1170
              val prem' = Thm.rhs_of eqn;
berghofe@13607
  1171
              val tprems = map term_of prems;
skalberg@15570
  1172
              val i = 1 + Library.foldl Int.max (~1, map (fn p =>
wenzelm@19618
  1173
                find_index (fn q => q aconv p) tprems) (#hyps (rep_thm eqn)));
wenzelm@15023
  1174
              val (rrs', asm') = rules_of_prem ss prem'
berghofe@13607
  1175
            in mut_impc prems concl rrss asms (prem' :: prems')
wenzelm@23178
  1176
              (rrs' :: rrss') (asm' :: asms') (SOME (fold_rev (disch true)
wenzelm@23178
  1177
                (Library.take (i, prems))
wenzelm@18470
  1178
                (Drule.imp_cong_rule eqn (reflexive (Drule.list_implies
wenzelm@23178
  1179
                  (Library.drop (i, prems), concl))))) :: eqns)
wenzelm@20671
  1180
                  ss (length prems') ~1
berghofe@13607
  1181
            end
berghofe@13607
  1182
wenzelm@15023
  1183
     (*legacy code - only for backwards compatibility*)
wenzelm@15023
  1184
     and nonmut_impc ct ss =
wenzelm@22902
  1185
       let val (prem, conc) = Thm.dest_implies ct;
skalberg@15531
  1186
           val thm1 = if simprem then botc skel0 ss prem else NONE;
wenzelm@22902
  1187
           val prem1 = the_default prem (Option.map Thm.rhs_of thm1);
wenzelm@15023
  1188
           val ss1 = if not useprem then ss else add_rrules
wenzelm@15023
  1189
             (apsnd single (apfst single (rules_of_prem ss prem1))) ss
wenzelm@15023
  1190
       in (case botc skel0 ss1 conc of
skalberg@15531
  1191
           NONE => (case thm1 of
skalberg@15531
  1192
               NONE => NONE
wenzelm@18470
  1193
             | SOME thm1' => SOME (Drule.imp_cong_rule thm1' (reflexive conc)))
skalberg@15531
  1194
         | SOME thm2 =>
wenzelm@23178
  1195
           let val thm2' = disch false prem1 thm2
berghofe@10413
  1196
           in (case thm1 of
skalberg@15531
  1197
               NONE => SOME thm2'
skalberg@15531
  1198
             | SOME thm1' =>
wenzelm@18470
  1199
                 SOME (transitive (Drule.imp_cong_rule thm1' (reflexive conc)) thm2'))
berghofe@10413
  1200
           end)
berghofe@10413
  1201
       end
berghofe@10413
  1202
wenzelm@15023
  1203
 in try_botc end;
berghofe@10413
  1204
berghofe@10413
  1205
wenzelm@15023
  1206
(* Meta-rewriting: rewrites t to u and returns the theorem t==u *)
berghofe@10413
  1207
berghofe@10413
  1208
(*
berghofe@10413
  1209
  Parameters:
berghofe@10413
  1210
    mode = (simplify A,
berghofe@10413
  1211
            use A in simplifying B,
berghofe@10413
  1212
            use prems of B (if B is again a meta-impl.) to simplify A)
berghofe@10413
  1213
           when simplifying A ==> B
berghofe@10413
  1214
    prover: how to solve premises in conditional rewrites and congruences
berghofe@10413
  1215
*)
berghofe@10413
  1216
wenzelm@17705
  1217
val debug_bounds = ref false;
wenzelm@17705
  1218
wenzelm@21962
  1219
fun check_bounds ss ct =
wenzelm@21962
  1220
  if ! debug_bounds then
wenzelm@21962
  1221
    let
wenzelm@21962
  1222
      val Simpset ({bounds = (_, bounds), ...}, _) = ss;
wenzelm@21962
  1223
      val bs = fold_aterms (fn Free (x, _) =>
wenzelm@21962
  1224
          if Name.is_bound x andalso not (AList.defined eq_bound bounds x)
wenzelm@21962
  1225
          then insert (op =) x else I
wenzelm@21962
  1226
        | _ => I) (term_of ct) [];
wenzelm@21962
  1227
    in
wenzelm@21962
  1228
      if null bs then ()
wenzelm@22892
  1229
      else print_term ss true ("Simplifier: term contains loose bounds: " ^ commas_quote bs)
wenzelm@21962
  1230
        (Thm.theory_of_cterm ct) (Thm.term_of ct)
wenzelm@21962
  1231
    end
wenzelm@21962
  1232
  else ();
wenzelm@17614
  1233
wenzelm@19052
  1234
fun rewrite_cterm mode prover raw_ss raw_ct =
wenzelm@17882
  1235
  let
wenzelm@20260
  1236
    val ct = Thm.adjust_maxidx_cterm ~1 raw_ct;
wenzelm@17882
  1237
    val {thy, t, maxidx, ...} = Thm.rep_cterm ct;
wenzelm@22892
  1238
    val ss = inc_simp_depth (activate_context thy raw_ss);
wenzelm@22892
  1239
    val depth = simp_depth ss;
wenzelm@21962
  1240
    val _ =
wenzelm@22892
  1241
      if depth mod 20 = 0 then
wenzelm@22892
  1242
        warning ("Simplification depth " ^ string_of_int depth)
wenzelm@21962
  1243
      else ();
wenzelm@22254
  1244
    val _ = trace_cterm false (fn () => "SIMPLIFIER INVOKED ON THE FOLLOWING TERM:") ss ct;
wenzelm@17882
  1245
    val _ = check_bounds ss ct;
wenzelm@22892
  1246
  in bottomc (mode, Option.map Drule.flexflex_unique oo prover, thy, maxidx) ss ct end;
berghofe@10413
  1247
wenzelm@21708
  1248
val simple_prover =
wenzelm@21708
  1249
  SINGLE o (fn ss => ALLGOALS (resolve_tac (prems_of_ss ss)));
wenzelm@21708
  1250
wenzelm@11760
  1251
(*Rewrite a cterm*)
wenzelm@21708
  1252
fun rewrite _ [] ct = Thm.reflexive ct
wenzelm@21708
  1253
  | rewrite full thms ct =
wenzelm@21708
  1254
      rewrite_cterm (full, false, false) simple_prover
wenzelm@21708
  1255
        (theory_context (Thm.theory_of_cterm ct) empty_ss addsimps thms) ct;
wenzelm@11672
  1256
berghofe@10413
  1257
(*Rewrite a theorem*)
wenzelm@23598
  1258
fun simplify full thms = Conv.fconv_rule (rewrite full thms);
wenzelm@21708
  1259
val rewrite_rule = simplify true;
wenzelm@21708
  1260
wenzelm@15023
  1261
(*simple term rewriting -- no proof*)
wenzelm@16458
  1262
fun rewrite_term thy rules procs =
wenzelm@17203
  1263
  Pattern.rewrite_term thy (map decomp_simp' rules) procs;
wenzelm@15023
  1264
wenzelm@22902
  1265
fun rewrite_thm mode prover ss = Conv.fconv_rule (rewrite_cterm mode prover ss);
berghofe@10413
  1266
wenzelm@23536
  1267
(*Rewrite the subgoals of a proof state (represented by a theorem)*)
wenzelm@21708
  1268
fun rewrite_goals_rule thms th =
wenzelm@23584
  1269
  Conv.fconv_rule (Conv.prems_conv ~1 (rewrite_cterm (true, true, true) simple_prover
wenzelm@23584
  1270
    (theory_context (Thm.theory_of_thm th) empty_ss addsimps thms))) th;
berghofe@10413
  1271
wenzelm@15023
  1272
(*Rewrite the subgoal of a proof state (represented by a theorem)*)
skalberg@15011
  1273
fun rewrite_goal_rule mode prover ss i thm =
wenzelm@23536
  1274
  if 0 < i andalso i <= Thm.nprems_of thm
wenzelm@23584
  1275
  then Conv.gconv_rule (rewrite_cterm mode prover ss) i thm
wenzelm@23536
  1276
  else raise THM ("rewrite_goal_rule", i, [thm]);
berghofe@10413
  1277
wenzelm@20228
  1278
wenzelm@21708
  1279
(** meta-rewriting tactics **)
wenzelm@21708
  1280
wenzelm@21708
  1281
(*Rewrite throughout proof state. *)
wenzelm@23536
  1282
fun rewrite_tac defs = PRIMITIVE (rewrite_rule defs);
wenzelm@21708
  1283
wenzelm@21708
  1284
(*Rewrite subgoals only, not main goal. *)
wenzelm@21708
  1285
fun rewrite_goals_tac defs = PRIMITIVE (rewrite_goals_rule defs);
wenzelm@21708
  1286
fun rewtac def = rewrite_goals_tac [def];
wenzelm@21708
  1287
wenzelm@23536
  1288
(*Rewrite subgoal i only.*)
wenzelm@23536
  1289
fun asm_rewrite_goal_tac mode prover_tac ss i =
wenzelm@23536
  1290
  PRIMITIVE (rewrite_goal_rule mode (SINGLE o prover_tac) ss i);
wenzelm@23536
  1291
wenzelm@23536
  1292
fun rewrite_goal_tac rews =
wenzelm@23536
  1293
  let val ss = empty_ss addsimps rews in
wenzelm@23536
  1294
    fn i => fn st => asm_rewrite_goal_tac (true, false, false) (K no_tac)
wenzelm@23536
  1295
      (theory_context (Thm.theory_of_thm st) ss) i st
wenzelm@23536
  1296
  end;
wenzelm@23536
  1297
wenzelm@21708
  1298
(*Prunes all redundant parameters from the proof state by rewriting.
wenzelm@21708
  1299
  DOES NOT rewrite main goal, where quantification over an unused bound
wenzelm@21708
  1300
    variable is sometimes done to avoid the need for cut_facts_tac.*)
wenzelm@21708
  1301
val prune_params_tac = rewrite_goals_tac [triv_forall_equality];
wenzelm@21708
  1302
wenzelm@21708
  1303
wenzelm@21708
  1304
(* for folding definitions, handling critical pairs *)
wenzelm@21708
  1305
wenzelm@21708
  1306
(*The depth of nesting in a term*)
wenzelm@21708
  1307
fun term_depth (Abs(a,T,t)) = 1 + term_depth t
wenzelm@21708
  1308
  | term_depth (f$t) = 1 + Int.max(term_depth f, term_depth t)
wenzelm@21708
  1309
  | term_depth _ = 0;
wenzelm@21708
  1310
wenzelm@21708
  1311
val lhs_of_thm = #1 o Logic.dest_equals o prop_of;
wenzelm@21708
  1312
wenzelm@21708
  1313
(*folding should handle critical pairs!  E.g. K == Inl(0),  S == Inr(Inl(0))
wenzelm@21708
  1314
  Returns longest lhs first to avoid folding its subexpressions.*)
wenzelm@21708
  1315
fun sort_lhs_depths defs =
wenzelm@21708
  1316
  let val keylist = AList.make (term_depth o lhs_of_thm) defs
wenzelm@21708
  1317
      val keys = sort_distinct (rev_order o int_ord) (map #2 keylist)
wenzelm@21708
  1318
  in map (AList.find (op =) keylist) keys end;
wenzelm@21708
  1319
wenzelm@21708
  1320
val rev_defs = sort_lhs_depths o map symmetric;
wenzelm@21708
  1321
wenzelm@21708
  1322
fun fold_rule defs = fold rewrite_rule (rev_defs defs);
wenzelm@21708
  1323
fun fold_tac defs = EVERY (map rewrite_tac (rev_defs defs));
wenzelm@21708
  1324
fun fold_goals_tac defs = EVERY (map rewrite_goals_tac (rev_defs defs));
wenzelm@21708
  1325
wenzelm@21708
  1326
wenzelm@20228
  1327
(* HHF normal form: !! before ==>, outermost !! generalized *)
wenzelm@20228
  1328
wenzelm@20228
  1329
local
wenzelm@20228
  1330
wenzelm@21565
  1331
fun gen_norm_hhf ss th =
wenzelm@21565
  1332
  (if Drule.is_norm_hhf (Thm.prop_of th) then th
wenzelm@22902
  1333
   else Conv.fconv_rule (rewrite_cterm (true, false, false) (K (K NONE)) ss) th)
wenzelm@21565
  1334
  |> Thm.adjust_maxidx_thm ~1
wenzelm@21565
  1335
  |> Drule.gen_all;
wenzelm@20228
  1336
wenzelm@20228
  1337
val ss = theory_context ProtoPure.thy empty_ss addsimps [Drule.norm_hhf_eq];
wenzelm@20228
  1338
wenzelm@20228
  1339
in
wenzelm@20228
  1340
wenzelm@20228
  1341
val norm_hhf = gen_norm_hhf ss;
wenzelm@20228
  1342
val norm_hhf_protect = gen_norm_hhf (ss addeqcongs [Drule.protect_cong]);
wenzelm@20228
  1343
wenzelm@20228
  1344
end;
wenzelm@20228
  1345
berghofe@10413
  1346
end;
berghofe@10413
  1347
wenzelm@11672
  1348
structure BasicMetaSimplifier: BASIC_META_SIMPLIFIER = MetaSimplifier;
wenzelm@11672
  1349
open BasicMetaSimplifier;