src/HOL/Tools/Sledgehammer/sledgehammer_mash.ML
author blanchet
Fri, 20 Jul 2012 22:19:46 +0200
changeset 49416 e740216ca28d
parent 49415 f08425165cca
child 49418 1f214c653c80
permissions -rw-r--r--
cached ancestor computation
blanchet@49395
     1
(*  Title:      HOL/Tools/Sledgehammer/sledgehammer_mash.ML
blanchet@49263
     2
    Author:     Jasmin Blanchette, TU Muenchen
blanchet@49263
     3
blanchet@49263
     4
Sledgehammer's machine-learning-based relevance filter (MaSh).
blanchet@49263
     5
*)
blanchet@49263
     6
blanchet@49396
     7
signature SLEDGEHAMMER_MASH =
blanchet@49263
     8
sig
blanchet@49266
     9
  type stature = ATP_Problem_Generate.stature
blanchet@49311
    10
  type fact = Sledgehammer_Fact.fact
blanchet@49311
    11
  type fact_override = Sledgehammer_Fact.fact_override
blanchet@49266
    12
  type params = Sledgehammer_Provers.params
blanchet@49303
    13
  type relevance_fudge = Sledgehammer_Provers.relevance_fudge
blanchet@49266
    14
  type prover_result = Sledgehammer_Provers.prover_result
blanchet@49266
    15
blanchet@49323
    16
  val trace : bool Config.T
blanchet@49334
    17
  val MaShN : string
blanchet@49394
    18
  val mepoN : string
blanchet@49394
    19
  val mashN : string
blanchet@49329
    20
  val meshN : string
blanchet@49407
    21
  val unlearnN : string
blanchet@49407
    22
  val learn_isarN : string
blanchet@49407
    23
  val learn_atpN : string
blanchet@49407
    24
  val relearn_isarN : string
blanchet@49407
    25
  val relearn_atpN : string
blanchet@49329
    26
  val fact_filters : string list
blanchet@49318
    27
  val escape_meta : string -> string
blanchet@49318
    28
  val escape_metas : string list -> string
blanchet@49323
    29
  val unescape_meta : string -> string
blanchet@49323
    30
  val unescape_metas : string -> string list
blanchet@49326
    31
  val extract_query : string -> string * string list
blanchet@49393
    32
  val nickname_of : thm -> string
blanchet@49336
    33
  val suggested_facts : string list -> ('a * thm) list -> ('a * thm) list
blanchet@49336
    34
  val mesh_facts :
blanchet@49336
    35
    int -> (('a * thm) list * ('a * thm) list) list -> ('a * thm) list
blanchet@49339
    36
  val is_likely_tautology_or_too_meta : thm -> bool
blanchet@49266
    37
  val theory_ord : theory * theory -> order
blanchet@49266
    38
  val thm_ord : thm * thm -> order
blanchet@49266
    39
  val goal_of_thm : theory -> thm -> thm
blanchet@49336
    40
  val run_prover_for_mash :
blanchet@49333
    41
    Proof.context -> params -> string -> fact list -> thm -> prover_result
blanchet@49407
    42
  val features_of :
blanchet@49407
    43
    Proof.context -> string -> theory -> stature -> term list -> string list
blanchet@49407
    44
  val isar_dependencies_of : unit Symtab.table -> thm -> string list
blanchet@49407
    45
  val atp_dependencies_of :
blanchet@49407
    46
    Proof.context -> params -> string -> bool -> fact list -> unit Symtab.table
blanchet@49407
    47
    -> thm -> string list
blanchet@49347
    48
  val mash_CLEAR : Proof.context -> unit
blanchet@49323
    49
  val mash_ADD :
blanchet@49331
    50
    Proof.context -> bool
blanchet@49331
    51
    -> (string * string list * string list * string list) list -> unit
blanchet@49331
    52
  val mash_QUERY :
blanchet@49333
    53
    Proof.context -> bool -> int -> string list * string list -> string list
blanchet@49347
    54
  val mash_unlearn : Proof.context -> unit
blanchet@49333
    55
  val mash_could_suggest_facts : unit -> bool
blanchet@49336
    56
  val mash_can_suggest_facts : Proof.context -> bool
blanchet@49313
    57
  val mash_suggest_facts :
blanchet@49336
    58
    Proof.context -> params -> string -> int -> term list -> term
blanchet@49336
    59
    -> ('a * thm) list -> ('a * thm) list * ('a * thm) list
blanchet@49398
    60
  val mash_learn_proof :
blanchet@49399
    61
    Proof.context -> params -> string -> term -> ('a * thm) list -> thm list
blanchet@49399
    62
    -> unit
blanchet@49405
    63
  val mash_learn_facts :
blanchet@49407
    64
    Proof.context -> params -> string -> bool -> bool -> Time.time -> fact list
blanchet@49407
    65
    -> string
blanchet@49410
    66
  val mash_learn :
blanchet@49410
    67
    Proof.context -> params -> fact_override -> thm list -> bool -> unit
blanchet@49303
    68
  val relevant_facts :
blanchet@49307
    69
    Proof.context -> params -> string -> int -> fact_override -> term list
blanchet@49311
    70
    -> term -> fact list -> fact list
blanchet@49334
    71
  val kill_learners : unit -> unit
blanchet@49334
    72
  val running_learners : unit -> unit
blanchet@49263
    73
end;
blanchet@49263
    74
blanchet@49396
    75
structure Sledgehammer_MaSh : SLEDGEHAMMER_MASH =
blanchet@49263
    76
struct
blanchet@49264
    77
blanchet@49266
    78
open ATP_Util
blanchet@49266
    79
open ATP_Problem_Generate
blanchet@49266
    80
open Sledgehammer_Util
blanchet@49266
    81
open Sledgehammer_Fact
blanchet@49266
    82
open Sledgehammer_Provers
blanchet@49333
    83
open Sledgehammer_Minimize
blanchet@49396
    84
open Sledgehammer_MePo
blanchet@49266
    85
blanchet@49323
    86
val trace =
blanchet@49395
    87
  Attrib.setup_config_bool @{binding sledgehammer_mash_trace} (K false)
blanchet@49323
    88
fun trace_msg ctxt msg = if Config.get ctxt trace then tracing (msg ()) else ()
blanchet@49323
    89
blanchet@49334
    90
val MaShN = "MaSh"
blanchet@49334
    91
blanchet@49394
    92
val mepoN = "mepo"
blanchet@49394
    93
val mashN = "mash"
blanchet@49329
    94
val meshN = "mesh"
blanchet@49329
    95
blanchet@49394
    96
val fact_filters = [meshN, mepoN, mashN]
blanchet@49329
    97
blanchet@49407
    98
val unlearnN = "unlearn"
blanchet@49407
    99
val learn_isarN = "learn_isar"
blanchet@49407
   100
val learn_atpN = "learn_atp"
blanchet@49407
   101
val relearn_isarN = "relearn_isar"
blanchet@49407
   102
val relearn_atpN = "relearn_atp"
blanchet@49407
   103
blanchet@49329
   104
fun mash_home () = getenv "MASH_HOME"
blanchet@49409
   105
fun mash_model_dir () =
blanchet@49324
   106
  getenv "ISABELLE_HOME_USER" ^ "/mash"
blanchet@49331
   107
  |> tap (Isabelle_System.mkdir o Path.explode)
blanchet@49409
   108
val mash_state_dir = mash_model_dir
blanchet@49329
   109
fun mash_state_path () = mash_state_dir () ^ "/state" |> Path.explode
blanchet@49266
   110
blanchet@49345
   111
blanchet@49266
   112
(*** Isabelle helpers ***)
blanchet@49266
   113
blanchet@49323
   114
fun meta_char c =
blanchet@49266
   115
  if Char.isAlphaNum c orelse c = #"_" orelse c = #"." orelse c = #"(" orelse
blanchet@49266
   116
     c = #")" orelse c = #"," then
blanchet@49266
   117
    String.str c
blanchet@49266
   118
  else
blanchet@49266
   119
    (* fixed width, in case more digits follow *)
blanchet@49410
   120
    "%" ^ stringN_of_int 3 (Char.ord c)
blanchet@49266
   121
blanchet@49323
   122
fun unmeta_chars accum [] = String.implode (rev accum)
blanchet@49410
   123
  | unmeta_chars accum (#"%" :: d1 :: d2 :: d3 :: cs) =
blanchet@49323
   124
    (case Int.fromString (String.implode [d1, d2, d3]) of
blanchet@49323
   125
       SOME n => unmeta_chars (Char.chr n :: accum) cs
blanchet@49323
   126
     | NONE => "" (* error *))
blanchet@49410
   127
  | unmeta_chars _ (#"%" :: _) = "" (* error *)
blanchet@49323
   128
  | unmeta_chars accum (c :: cs) = unmeta_chars (c :: accum) cs
blanchet@49323
   129
blanchet@49323
   130
val escape_meta = String.translate meta_char
blanchet@49318
   131
val escape_metas = map escape_meta #> space_implode " "
blanchet@49330
   132
val unescape_meta = String.explode #> unmeta_chars []
blanchet@49330
   133
val unescape_metas =
blanchet@49330
   134
  space_explode " " #> filter_out (curry (op =) "") #> map unescape_meta
blanchet@49266
   135
blanchet@49326
   136
fun extract_query line =
blanchet@49326
   137
  case space_explode ":" line of
blanchet@49330
   138
    [goal_name, suggs] => (unescape_meta goal_name, unescape_metas suggs)
blanchet@49327
   139
  | _ => ("", [])
blanchet@49326
   140
blanchet@49393
   141
fun parent_of_local_thm th =
blanchet@49393
   142
  let
blanchet@49393
   143
    val thy = th |> Thm.theory_of_thm
blanchet@49393
   144
    val facts = thy |> Global_Theory.facts_of
blanchet@49393
   145
    val space = facts |> Facts.space_of
blanchet@49393
   146
    fun id_of s = #id (Name_Space.the_entry space s)
blanchet@49393
   147
    fun max_id (s', _) (s, id) =
blanchet@49393
   148
      let val id' = id_of s' in if id > id' then (s, id) else (s', id') end
blanchet@49393
   149
  in ("", ~1) |> Facts.fold_static max_id facts |> fst end
blanchet@49393
   150
blanchet@49393
   151
val local_prefix = "local" ^ Long_Name.separator
blanchet@49393
   152
blanchet@49393
   153
fun nickname_of th =
blanchet@49409
   154
  if Thm.has_name_hint th then
blanchet@49409
   155
    let val hint = Thm.get_name_hint th in
blanchet@49409
   156
      (* FIXME: There must be a better way to detect local facts. *)
blanchet@49409
   157
      case try (unprefix local_prefix) hint of
blanchet@49409
   158
        SOME suf =>
blanchet@49409
   159
        parent_of_local_thm th ^ Long_Name.separator ^ Long_Name.separator ^ suf
blanchet@49409
   160
      | NONE => hint
blanchet@49409
   161
    end
blanchet@49409
   162
  else
blanchet@49409
   163
    backquote_thm th
blanchet@49393
   164
blanchet@49345
   165
fun suggested_facts suggs facts =
blanchet@49345
   166
  let
blanchet@49393
   167
    fun add_fact (fact as (_, th)) = Symtab.default (nickname_of th, fact)
blanchet@49345
   168
    val tab = Symtab.empty |> fold add_fact facts
blanchet@49345
   169
  in map_filter (Symtab.lookup tab) suggs end
blanchet@49326
   170
blanchet@49344
   171
(* Ad hoc score function roughly based on Blanchette's Ringberg 2011 data. *)
blanchet@49344
   172
fun score x = Math.pow (1.5, 15.5 - 0.05 * Real.fromInt x) + 15.0
blanchet@49343
   173
blanchet@49343
   174
fun sum_sq_avg [] = 0
blanchet@49344
   175
  | sum_sq_avg xs =
blanchet@49344
   176
    Real.ceil (100000.0 * fold (curry (op +) o score) xs 0.0) div length xs
blanchet@49328
   177
blanchet@49335
   178
fun mesh_facts max_facts [(selected, unknown)] =
blanchet@49335
   179
    take max_facts selected @ take (max_facts - length selected) unknown
blanchet@49329
   180
  | mesh_facts max_facts mess =
blanchet@49329
   181
    let
blanchet@49335
   182
      val mess = mess |> map (apfst (`length))
blanchet@49329
   183
      val fact_eq = Thm.eq_thm o pairself snd
blanchet@49335
   184
      fun score_in fact ((sel_len, sels), unks) =
blanchet@49335
   185
        case find_index (curry fact_eq fact) sels of
blanchet@49335
   186
          ~1 => (case find_index (curry fact_eq fact) unks of
blanchet@49344
   187
                   ~1 => SOME sel_len
blanchet@49335
   188
                 | _ => NONE)
blanchet@49344
   189
        | j => SOME j
blanchet@49343
   190
      fun score_of fact = mess |> map_filter (score_in fact) |> sum_sq_avg
blanchet@49335
   191
      val facts = fold (union fact_eq o take max_facts o snd o fst) mess []
blanchet@49329
   192
    in
blanchet@49343
   193
      facts |> map (`score_of) |> sort (int_ord o swap o pairself fst)
blanchet@49343
   194
            |> map snd |> take max_facts
blanchet@49329
   195
    end
blanchet@49327
   196
blanchet@49410
   197
val thy_feature_name_of = prefix "y"
blanchet@49410
   198
val const_name_of = prefix "c"
blanchet@49410
   199
val type_name_of = prefix "t"
blanchet@49410
   200
val class_name_of = prefix "s"
blanchet@49266
   201
blanchet@49339
   202
fun is_likely_tautology_or_too_meta th =
blanchet@49339
   203
  let
blanchet@49339
   204
    val is_boring_const = member (op =) atp_widely_irrelevant_consts
blanchet@49339
   205
    fun is_boring_bool t =
blanchet@49339
   206
      not (exists_Const (not o is_boring_const o fst) t) orelse
blanchet@49339
   207
      exists_type (exists_subtype (curry (op =) @{typ prop})) t
blanchet@49339
   208
    fun is_boring_prop (@{const Trueprop} $ t) = is_boring_bool t
blanchet@49339
   209
      | is_boring_prop (@{const "==>"} $ t $ u) =
blanchet@49339
   210
        is_boring_prop t andalso is_boring_prop u
blanchet@49339
   211
      | is_boring_prop (Const (@{const_name all}, _) $ (Abs (_, _, t)) $ u) =
blanchet@49339
   212
        is_boring_prop t andalso is_boring_prop u
blanchet@49339
   213
      | is_boring_prop (Const (@{const_name "=="}, _) $ t $ u) =
blanchet@49339
   214
        is_boring_bool t andalso is_boring_bool u
blanchet@49339
   215
      | is_boring_prop _ = true
blanchet@49339
   216
  in
blanchet@49339
   217
    is_boring_prop (prop_of th) andalso not (Thm.eq_thm_prop (@{thm ext}, th))
blanchet@49339
   218
  end
blanchet@49339
   219
blanchet@49339
   220
fun theory_ord p =
blanchet@49339
   221
  if Theory.eq_thy p then
blanchet@49339
   222
    EQUAL
blanchet@49339
   223
  else if Theory.subthy p then
blanchet@49339
   224
    LESS
blanchet@49339
   225
  else if Theory.subthy (swap p) then
blanchet@49339
   226
    GREATER
blanchet@49339
   227
  else case int_ord (pairself (length o Theory.ancestors_of) p) of
blanchet@49339
   228
    EQUAL => string_ord (pairself Context.theory_name p)
blanchet@49339
   229
  | order => order
blanchet@49339
   230
blanchet@49339
   231
val thm_ord = theory_ord o pairself theory_of_thm
blanchet@49339
   232
blanchet@49407
   233
val freezeT = Type.legacy_freeze_type
blanchet@49407
   234
blanchet@49407
   235
fun freeze (t $ u) = freeze t $ freeze u
blanchet@49407
   236
  | freeze (Abs (s, T, t)) = Abs (s, freezeT T, freeze t)
blanchet@49407
   237
  | freeze (Var ((s, _), T)) = Free (s, freezeT T)
blanchet@49407
   238
  | freeze (Const (s, T)) = Const (s, freezeT T)
blanchet@49407
   239
  | freeze (Free (s, T)) = Free (s, freezeT T)
blanchet@49407
   240
  | freeze t = t
blanchet@49407
   241
blanchet@49407
   242
fun goal_of_thm thy = prop_of #> freeze #> cterm_of thy #> Goal.init
blanchet@49407
   243
blanchet@49407
   244
fun run_prover_for_mash ctxt params prover facts goal =
blanchet@49407
   245
  let
blanchet@49407
   246
    val problem =
blanchet@49407
   247
      {state = Proof.init ctxt, goal = goal, subgoal = 1, subgoal_count = 1,
blanchet@49407
   248
       facts = facts |> map (apfst (apfst (fn name => name ())))
blanchet@49407
   249
                     |> map Untranslated_Fact}
blanchet@49407
   250
  in
blanchet@49414
   251
    get_minimizing_prover ctxt MaSh (K (K ())) prover params (K (K (K "")))
blanchet@49407
   252
                          problem
blanchet@49407
   253
  end
blanchet@49407
   254
blanchet@49341
   255
val bad_types = [@{type_name prop}, @{type_name bool}, @{type_name fun}]
blanchet@49341
   256
blanchet@49413
   257
val logical_consts =
blanchet@49413
   258
  [@{const_name prop}, @{const_name Pure.conjunction}] @ atp_logical_consts
blanchet@49413
   259
blanchet@49333
   260
fun interesting_terms_types_and_classes ctxt prover term_max_depth
blanchet@49333
   261
                                        type_max_depth ts =
blanchet@49266
   262
  let
blanchet@49333
   263
    fun is_bad_const (x as (s, _)) args =
blanchet@49413
   264
      member (op =) logical_consts s orelse
blanchet@49333
   265
      fst (is_built_in_const_for_prover ctxt prover x args)
blanchet@49319
   266
    fun add_classes @{sort type} = I
blanchet@49319
   267
      | add_classes S = union (op =) (map class_name_of S)
blanchet@49266
   268
    fun do_add_type (Type (s, Ts)) =
blanchet@49266
   269
        (not (member (op =) bad_types s) ? insert (op =) (type_name_of s))
blanchet@49266
   270
        #> fold do_add_type Ts
blanchet@49319
   271
      | do_add_type (TFree (_, S)) = add_classes S
blanchet@49319
   272
      | do_add_type (TVar (_, S)) = add_classes S
blanchet@49266
   273
    fun add_type T = type_max_depth >= 0 ? do_add_type T
blanchet@49266
   274
    fun mk_app s args =
blanchet@49266
   275
      if member (op <>) args "" then s ^ "(" ^ space_implode "," args ^ ")"
blanchet@49266
   276
      else s
blanchet@49266
   277
    fun patternify ~1 _ = ""
blanchet@49266
   278
      | patternify depth t =
blanchet@49266
   279
        case strip_comb t of
blanchet@49413
   280
          (Const (x as (s, _)), args) =>
blanchet@49413
   281
          if is_bad_const x args then ""
blanchet@49413
   282
          else mk_app (const_name_of s) (map (patternify (depth - 1)) args)
blanchet@49266
   283
        | _ => ""
blanchet@49266
   284
    fun add_term_patterns ~1 _ = I
blanchet@49266
   285
      | add_term_patterns depth t =
blanchet@49266
   286
        insert (op =) (patternify depth t)
blanchet@49266
   287
        #> add_term_patterns (depth - 1) t
blanchet@49266
   288
    val add_term = add_term_patterns term_max_depth
blanchet@49266
   289
    fun add_patterns t =
blanchet@49266
   290
      let val (head, args) = strip_comb t in
blanchet@49266
   291
        (case head of
blanchet@49413
   292
           Const (_, T) => add_term t #> add_type T
blanchet@49266
   293
         | Free (_, T) => add_type T
blanchet@49266
   294
         | Var (_, T) => add_type T
blanchet@49266
   295
         | Abs (_, T, body) => add_type T #> add_patterns body
blanchet@49266
   296
         | _ => I)
blanchet@49266
   297
        #> fold add_patterns args
blanchet@49266
   298
      end
blanchet@49341
   299
  in [] |> fold add_patterns ts end
blanchet@49266
   300
blanchet@49266
   301
fun is_exists (s, _) = (s = @{const_name Ex} orelse s = @{const_name Ex1})
blanchet@49266
   302
blanchet@49312
   303
val term_max_depth = 1
blanchet@49312
   304
val type_max_depth = 1
blanchet@49266
   305
blanchet@49266
   306
(* TODO: Generate type classes for types? *)
blanchet@49400
   307
fun features_of ctxt prover thy (scope, status) ts =
blanchet@49318
   308
  thy_feature_name_of (Context.theory_name thy) ::
blanchet@49333
   309
  interesting_terms_types_and_classes ctxt prover term_max_depth type_max_depth
blanchet@49333
   310
                                      ts
blanchet@49347
   311
  |> forall is_lambda_free ts ? cons "no_lams"
blanchet@49347
   312
  |> forall (not o exists_Const is_exists) ts ? cons "no_skos"
blanchet@49400
   313
  |> scope <> Global ? cons "local"
blanchet@49317
   314
  |> (case status of
blanchet@49317
   315
        General => I
blanchet@49317
   316
      | Induction => cons "induction"
blanchet@49317
   317
      | Intro => cons "intro"
blanchet@49317
   318
      | Inductive => cons "inductive"
blanchet@49317
   319
      | Elim => cons "elim"
blanchet@49317
   320
      | Simp => cons "simp"
blanchet@49317
   321
      | Def => cons "def")
blanchet@49266
   322
blanchet@49407
   323
fun isar_dependencies_of all_facts = thms_in_proof (SOME all_facts)
blanchet@49266
   324
blanchet@49407
   325
val atp_dep_default_max_fact = 50
blanchet@49266
   326
blanchet@49407
   327
fun atp_dependencies_of ctxt (params as {verbose, max_facts, ...}) prover auto
blanchet@49407
   328
                        facts all_names th =
blanchet@49407
   329
  case isar_dependencies_of all_names th of
blanchet@49407
   330
    [] => []
blanchet@49407
   331
  | isar_deps =>
blanchet@49407
   332
    let
blanchet@49407
   333
      val thy = Proof_Context.theory_of ctxt
blanchet@49407
   334
      val goal = goal_of_thm thy th
blanchet@49407
   335
      val (_, hyp_ts, concl_t) = ATP_Util.strip_subgoal ctxt goal 1
blanchet@49407
   336
      val facts = facts |> filter (fn (_, th') => thm_ord (th', th) = LESS)
blanchet@49407
   337
      fun fix_name ((_, stature), th) = ((fn () => nickname_of th, stature), th)
blanchet@49407
   338
      fun is_dep dep (_, th) = nickname_of th = dep
blanchet@49407
   339
      fun add_isar_dep facts dep accum =
blanchet@49407
   340
        if exists (is_dep dep) accum then
blanchet@49407
   341
          accum
blanchet@49407
   342
        else case find_first (is_dep dep) facts of
blanchet@49407
   343
          SOME ((name, status), th) => accum @ [((name, status), th)]
blanchet@49407
   344
        | NONE => accum (* shouldn't happen *)
blanchet@49407
   345
      val facts =
blanchet@49407
   346
        facts |> iterative_relevant_facts ctxt params prover
blanchet@49407
   347
                     (max_facts |> the_default atp_dep_default_max_fact) NONE
blanchet@49407
   348
                     hyp_ts concl_t
blanchet@49407
   349
              |> fold (add_isar_dep facts) isar_deps
blanchet@49407
   350
              |> map fix_name
blanchet@49407
   351
    in
blanchet@49407
   352
      if verbose andalso not auto then
blanchet@49407
   353
        let val num_facts = length facts in
blanchet@49407
   354
          "MaSh: " ^ quote prover ^ " on " ^ quote (nickname_of th) ^
blanchet@49407
   355
          " with " ^ string_of_int num_facts ^ " fact" ^ plural_s num_facts ^
blanchet@49407
   356
          "."
blanchet@49407
   357
          |> Output.urgent_message
blanchet@49407
   358
        end
blanchet@49407
   359
      else
blanchet@49407
   360
        ();
blanchet@49407
   361
      case run_prover_for_mash ctxt params prover facts goal of
blanchet@49407
   362
        {outcome = NONE, used_facts, ...} =>
blanchet@49407
   363
        (if verbose andalso not auto then
blanchet@49407
   364
           let val num_facts = length used_facts in
blanchet@49407
   365
             "Found proof with " ^ string_of_int num_facts ^ " fact" ^
blanchet@49407
   366
             plural_s num_facts ^ "."
blanchet@49407
   367
             |> Output.urgent_message
blanchet@49407
   368
           end
blanchet@49407
   369
         else
blanchet@49407
   370
           ();
blanchet@49407
   371
         used_facts |> map fst)
blanchet@49407
   372
      | _ => isar_deps
blanchet@49407
   373
    end
blanchet@49266
   374
blanchet@49266
   375
blanchet@49317
   376
(*** Low-level communication with MaSh ***)
blanchet@49317
   377
blanchet@49409
   378
(* more friendly than "try o File.rm" for those who keep the files open in their
blanchet@49409
   379
   text editor *)
blanchet@49409
   380
fun wipe_out file = File.write file ""
blanchet@49409
   381
blanchet@49338
   382
fun write_file (xs, f) file =
blanchet@49333
   383
  let val path = Path.explode file in
blanchet@49409
   384
    wipe_out path;
blanchet@49338
   385
    xs |> chunk_list 500
blanchet@49338
   386
       |> List.app (File.append path o space_implode "" o map f)
blanchet@49333
   387
  end
blanchet@49331
   388
blanchet@49409
   389
fun run_mash_tool ctxt overlord save max_suggs write_cmds read_suggs =
blanchet@49326
   390
  let
blanchet@49409
   391
    val (temp_dir, serial) =
blanchet@49409
   392
      if overlord then (getenv "ISABELLE_HOME_USER", "")
blanchet@49409
   393
      else (getenv "ISABELLE_TMP", serial_string ())
blanchet@49409
   394
    val log_file = if overlord then temp_dir ^ "/mash_log" else "/dev/null"
blanchet@49331
   395
    val err_file = temp_dir ^ "/mash_err" ^ serial
blanchet@49333
   396
    val sugg_file = temp_dir ^ "/mash_suggs" ^ serial
blanchet@49331
   397
    val cmd_file = temp_dir ^ "/mash_commands" ^ serial
blanchet@49409
   398
    val core =
blanchet@49409
   399
      "--inputFile " ^ cmd_file ^ " --predictions " ^ sugg_file ^
blanchet@49409
   400
      " --numberOfPredictions " ^ string_of_int max_suggs ^
blanchet@49409
   401
      (if save then " --saveModel" else "")
blanchet@49409
   402
    val command =
blanchet@49409
   403
      mash_home () ^ "/mash --quiet --outputDir " ^ mash_model_dir () ^
blanchet@49409
   404
      " --log " ^ log_file ^ " " ^ core ^ " >& " ^ err_file
blanchet@49331
   405
  in
blanchet@49338
   406
    write_file ([], K "") sugg_file;
blanchet@49331
   407
    write_file write_cmds cmd_file;
blanchet@49409
   408
    trace_msg ctxt (fn () => "Running " ^ command);
blanchet@49409
   409
    Isabelle_System.bash command;
blanchet@49409
   410
    read_suggs (fn () => try File.read_lines (Path.explode sugg_file) |> these)
blanchet@49409
   411
    |> tap (fn _ => trace_msg ctxt (fn () =>
blanchet@49409
   412
           case try File.read (Path.explode err_file) of
blanchet@49409
   413
             NONE => "Done"
blanchet@49409
   414
           | SOME "" => "Done"
blanchet@49409
   415
           | SOME s => "Error: " ^ elide_string 1000 s))
blanchet@49409
   416
    |> not overlord
blanchet@49409
   417
       ? tap (fn _ => List.app (wipe_out o Path.explode)
blanchet@49409
   418
                               [err_file, sugg_file, cmd_file])
blanchet@49331
   419
  end
blanchet@49331
   420
blanchet@49331
   421
fun str_of_update (name, parents, feats, deps) =
blanchet@49331
   422
  "! " ^ escape_meta name ^ ": " ^ escape_metas parents ^ "; " ^
blanchet@49326
   423
  escape_metas feats ^ "; " ^ escape_metas deps ^ "\n"
blanchet@49326
   424
blanchet@49331
   425
fun str_of_query (parents, feats) =
blanchet@49331
   426
  "? " ^ escape_metas parents ^ "; " ^ escape_metas feats
blanchet@49331
   427
blanchet@49347
   428
fun mash_CLEAR ctxt =
blanchet@49409
   429
  let val path = mash_model_dir () |> Path.explode in
blanchet@49347
   430
    trace_msg ctxt (K "MaSh CLEAR");
blanchet@49409
   431
    File.fold_dir (fn file => fn _ =>
blanchet@49409
   432
                      try File.rm (Path.append path (Path.basic file)))
blanchet@49409
   433
                  path NONE;
blanchet@49409
   434
    ()
blanchet@49324
   435
  end
blanchet@49317
   436
blanchet@49331
   437
fun mash_ADD _ _ [] = ()
blanchet@49331
   438
  | mash_ADD ctxt overlord upds =
blanchet@49331
   439
    (trace_msg ctxt (fn () => "MaSh ADD " ^
blanchet@49331
   440
         elide_string 1000 (space_implode " " (map #1 upds)));
blanchet@49409
   441
     run_mash_tool ctxt overlord true 0 (upds, str_of_update) (K ()))
blanchet@49317
   442
blanchet@49333
   443
fun mash_QUERY ctxt overlord max_suggs (query as (_, feats)) =
blanchet@49329
   444
  (trace_msg ctxt (fn () => "MaSh QUERY " ^ space_implode " " feats);
blanchet@49409
   445
   run_mash_tool ctxt overlord false max_suggs
blanchet@49338
   446
       ([query], str_of_query)
blanchet@49409
   447
       (fn suggs =>
blanchet@49409
   448
           case suggs () of
blanchet@49409
   449
             [] => []
blanchet@49409
   450
           | suggs => snd (extract_query (List.last suggs)))
blanchet@49326
   451
   handle List.Empty => [])
blanchet@49317
   452
blanchet@49317
   453
blanchet@49266
   454
(*** High-level communication with MaSh ***)
blanchet@49266
   455
blanchet@49336
   456
fun try_graph ctxt when def f =
blanchet@49336
   457
  f ()
blanchet@49336
   458
  handle Graph.CYCLES (cycle :: _) =>
blanchet@49336
   459
         (trace_msg ctxt (fn () =>
blanchet@49336
   460
              "Cycle involving " ^ commas cycle ^ " when " ^ when); def)
blanchet@49407
   461
       | Graph.DUP name =>
blanchet@49407
   462
         (trace_msg ctxt (fn () =>
blanchet@49407
   463
              "Duplicate fact " ^ quote name ^ " when " ^ when); def)
blanchet@49336
   464
       | Graph.UNDEF name =>
blanchet@49336
   465
         (trace_msg ctxt (fn () =>
blanchet@49336
   466
              "Unknown fact " ^ quote name ^ " when " ^ when); def)
blanchet@49407
   467
       | exn =>
blanchet@49407
   468
         if Exn.is_interrupt exn then
blanchet@49407
   469
           reraise exn
blanchet@49407
   470
         else
blanchet@49407
   471
           (trace_msg ctxt (fn () =>
blanchet@49407
   472
                "Internal error when " ^ when ^ ":\n" ^
blanchet@49407
   473
                ML_Compiler.exn_message exn); def)
blanchet@49336
   474
blanchet@49415
   475
type mash_state = {fact_G : unit Graph.T}
blanchet@49264
   476
blanchet@49415
   477
val empty_state = {fact_G = Graph.empty}
blanchet@49316
   478
blanchet@49316
   479
local
blanchet@49316
   480
blanchet@49405
   481
val version = "*** MaSh 0.0 ***"
blanchet@49405
   482
blanchet@49405
   483
fun load _ (state as (true, _)) = state
blanchet@49405
   484
  | load ctxt _ =
blanchet@49324
   485
    let val path = mash_state_path () in
blanchet@49317
   486
      (true,
blanchet@49317
   487
       case try File.read_lines path of
blanchet@49405
   488
         SOME (version' :: fact_lines) =>
blanchet@49317
   489
         let
blanchet@49337
   490
           fun add_edge_to name parent =
blanchet@49337
   491
             Graph.default_node (parent, ())
blanchet@49337
   492
             #> Graph.add_edge (parent, name)
blanchet@49331
   493
           fun add_fact_line line =
blanchet@49331
   494
             case extract_query line of
blanchet@49331
   495
               ("", _) => I (* shouldn't happen *)
blanchet@49331
   496
             | (name, parents) =>
blanchet@49331
   497
               Graph.default_node (name, ())
blanchet@49337
   498
               #> fold (add_edge_to name) parents
blanchet@49415
   499
           val fact_G =
blanchet@49337
   500
             try_graph ctxt "loading state" Graph.empty (fn () =>
blanchet@49405
   501
                 Graph.empty |> version' = version
blanchet@49405
   502
                                ? fold add_fact_line fact_lines)
blanchet@49415
   503
         in {fact_G = fact_G} end
blanchet@49319
   504
       | _ => empty_state)
blanchet@49317
   505
    end
blanchet@49316
   506
blanchet@49415
   507
fun save {fact_G} =
blanchet@49316
   508
  let
blanchet@49324
   509
    val path = mash_state_path ()
blanchet@49333
   510
    fun fact_line_for name parents =
blanchet@49333
   511
      escape_meta name ^ ": " ^ escape_metas parents
blanchet@49331
   512
    val append_fact = File.append path o suffix "\n" oo fact_line_for
blanchet@49415
   513
    fun append_entry (name, ((), (parents, _))) () =
blanchet@49415
   514
      append_fact name (Graph.Keys.dest parents)
blanchet@49316
   515
  in
blanchet@49405
   516
    File.write path (version ^ "\n");
blanchet@49415
   517
    Graph.fold append_entry fact_G ()
blanchet@49316
   518
  end
blanchet@49316
   519
blanchet@49317
   520
val global_state =
blanchet@49396
   521
  Synchronized.var "Sledgehammer_MaSh.global_state" (false, empty_state)
blanchet@49316
   522
blanchet@49316
   523
in
blanchet@49316
   524
blanchet@49336
   525
fun mash_map ctxt f =
blanchet@49405
   526
  Synchronized.change global_state (load ctxt ##> (f #> tap save))
blanchet@49316
   527
blanchet@49336
   528
fun mash_get ctxt =
blanchet@49405
   529
  Synchronized.change_result global_state (load ctxt #> `snd)
blanchet@49317
   530
blanchet@49347
   531
fun mash_unlearn ctxt =
blanchet@49317
   532
  Synchronized.change global_state (fn _ =>
blanchet@49409
   533
      (mash_CLEAR ctxt; wipe_out (mash_state_path ()); (true, empty_state)))
blanchet@49316
   534
blanchet@49316
   535
end
blanchet@49316
   536
blanchet@49333
   537
fun mash_could_suggest_facts () = mash_home () <> ""
blanchet@49415
   538
fun mash_can_suggest_facts ctxt = not (Graph.is_empty (#fact_G (mash_get ctxt)))
blanchet@49264
   539
blanchet@49415
   540
fun queue_of xs = Queue.empty |> fold Queue.enqueue xs
blanchet@49415
   541
blanchet@49415
   542
fun max_facts_in_graph fact_G facts =
blanchet@49331
   543
  let
blanchet@49393
   544
    val facts = [] |> fold (cons o nickname_of o snd) facts
blanchet@49345
   545
    val tab = Symtab.empty |> fold (fn name => Symtab.update (name, ())) facts
blanchet@49415
   546
    fun enqueue_new seen name =
blanchet@49415
   547
      not (member (op =) seen name) ? Queue.enqueue name
blanchet@49415
   548
    fun find_maxes seen maxs names =
blanchet@49416
   549
      case try Queue.dequeue names of
blanchet@49416
   550
        NONE => map snd maxs
blanchet@49416
   551
      | SOME (name, names) =>
blanchet@49416
   552
        if Symtab.defined tab name then
blanchet@49416
   553
          let
blanchet@49416
   554
            val new = (Graph.all_preds fact_G [name], name)
blanchet@49416
   555
            fun not_ancestor (_, x) (yp, _) = not (member (op =) yp x)
blanchet@49416
   556
            val maxs = maxs |> filter (fn max => not_ancestor max new)
blanchet@49416
   557
            val maxs = maxs |> forall (not_ancestor new) maxs ? cons new
blanchet@49416
   558
          in find_maxes (name :: seen) maxs names end
blanchet@49416
   559
        else
blanchet@49416
   560
          find_maxes (name :: seen) maxs
blanchet@49416
   561
                     (Graph.Keys.fold (enqueue_new seen)
blanchet@49416
   562
                                      (Graph.imm_preds fact_G name) names)
blanchet@49415
   563
  in find_maxes [] [] (queue_of (Graph.maximals fact_G)) end
blanchet@49331
   564
blanchet@49333
   565
(* Generate more suggestions than requested, because some might be thrown out
blanchet@49333
   566
   later for various reasons and "meshing" gives better results with some
blanchet@49333
   567
   slack. *)
blanchet@49333
   568
fun max_suggs_of max_facts = max_facts + Int.min (200, max_facts)
blanchet@49333
   569
blanchet@49415
   570
fun is_fact_in_graph fact_G (_, th) =
blanchet@49415
   571
  can (Graph.get_node fact_G) (nickname_of th)
blanchet@49335
   572
blanchet@49333
   573
fun mash_suggest_facts ctxt ({overlord, ...} : params) prover max_facts hyp_ts
blanchet@49333
   574
                       concl_t facts =
blanchet@49316
   575
  let
blanchet@49317
   576
    val thy = Proof_Context.theory_of ctxt
blanchet@49415
   577
    val fact_G = #fact_G (mash_get ctxt)
blanchet@49415
   578
    val parents = max_facts_in_graph fact_G facts
blanchet@49400
   579
    val feats = features_of ctxt prover thy (Local, General) (concl_t :: hyp_ts)
blanchet@49333
   580
    val suggs =
blanchet@49415
   581
      if Graph.is_empty fact_G then []
blanchet@49335
   582
      else mash_QUERY ctxt overlord (max_suggs_of max_facts) (parents, feats)
blanchet@49335
   583
    val selected = facts |> suggested_facts suggs
blanchet@49415
   584
    val unknown = facts |> filter_out (is_fact_in_graph fact_G)
blanchet@49335
   585
  in (selected, unknown) end
blanchet@49264
   586
blanchet@49331
   587
fun update_fact_graph ctxt (name, parents, feats, deps) (upds, graph) =
blanchet@49331
   588
  let
blanchet@49331
   589
    fun maybe_add_from from (accum as (parents, graph)) =
blanchet@49336
   590
      try_graph ctxt "updating graph" accum (fn () =>
blanchet@49336
   591
          (from :: parents, Graph.add_edge_acyclic (from, name) graph))
blanchet@49336
   592
    val graph = graph |> Graph.default_node (name, ())
blanchet@49331
   593
    val (parents, graph) = ([], graph) |> fold maybe_add_from parents
blanchet@49331
   594
    val (deps, graph) = ([], graph) |> fold maybe_add_from deps
blanchet@49331
   595
  in ((name, parents, feats, deps) :: upds, graph) end
blanchet@49321
   596
blanchet@49399
   597
val learn_timeout_slack = 2.0
blanchet@49333
   598
blanchet@49399
   599
fun launch_thread timeout task =
blanchet@49398
   600
  let
blanchet@49399
   601
    val hard_timeout = time_mult learn_timeout_slack timeout
blanchet@49399
   602
    val birth_time = Time.now ()
blanchet@49399
   603
    val death_time = Time.+ (birth_time, hard_timeout)
blanchet@49399
   604
    val desc = ("machine learner for Sledgehammer", "")
blanchet@49399
   605
  in Async_Manager.launch MaShN birth_time death_time desc task end
blanchet@49399
   606
blanchet@49415
   607
fun freshish_name () =
blanchet@49415
   608
  Date.fmt ".%Y_%m_%d_%H_%M_%S__" (Date.fromTimeLocal (Time.now ())) ^
blanchet@49415
   609
  serial_string ()
blanchet@49415
   610
blanchet@49399
   611
fun mash_learn_proof ctxt ({overlord, timeout, ...} : params) prover t facts
blanchet@49399
   612
                     used_ths =
blanchet@49399
   613
  if is_smt_prover ctxt prover then
blanchet@49399
   614
    ()
blanchet@49399
   615
  else
blanchet@49399
   616
    launch_thread timeout
blanchet@49399
   617
        (fn () =>
blanchet@49399
   618
            let
blanchet@49399
   619
              val thy = Proof_Context.theory_of ctxt
blanchet@49415
   620
              val name = freshish_name ()
blanchet@49400
   621
              val feats = features_of ctxt prover thy (Local, General) [t]
blanchet@49399
   622
              val deps = used_ths |> map nickname_of
blanchet@49399
   623
            in
blanchet@49415
   624
              mash_map ctxt (fn {fact_G} =>
blanchet@49399
   625
                  let
blanchet@49415
   626
                    val parents = max_facts_in_graph fact_G facts
blanchet@49399
   627
                    val upds = [(name, parents, feats, deps)]
blanchet@49415
   628
                    val (upds, fact_G) =
blanchet@49415
   629
                      ([], fact_G) |> fold (update_fact_graph ctxt) upds
blanchet@49415
   630
                  in mash_ADD ctxt overlord upds; {fact_G = fact_G}
blanchet@49399
   631
                  end);
blanchet@49399
   632
              (true, "")
blanchet@49399
   633
            end)
blanchet@49398
   634
blanchet@49407
   635
fun sendback sub =
blanchet@49407
   636
  Markup.markup Isabelle_Markup.sendback (sledgehammerN ^ " " ^ sub)
blanchet@49407
   637
blanchet@49347
   638
(* Too many dependencies is a sign that a decision procedure is at work. There
blanchet@49347
   639
   isn't much too learn from such proofs. *)
blanchet@49347
   640
val max_dependencies = 10
blanchet@49407
   641
val commit_timeout = seconds 30.0
blanchet@49347
   642
blanchet@49333
   643
(* The timeout is understood in a very slack fashion. *)
blanchet@49407
   644
fun mash_learn_facts ctxt (params as {debug, verbose, overlord, timeout, ...})
blanchet@49407
   645
                     prover auto atp learn_timeout facts =
blanchet@49319
   646
  let
blanchet@49333
   647
    val timer = Timer.startRealTimer ()
blanchet@49407
   648
    fun next_commit_time () =
blanchet@49407
   649
      Time.+ (Timer.checkRealTimer timer, commit_timeout)
blanchet@49415
   650
    val {fact_G} = mash_get ctxt
blanchet@49415
   651
    val (old_facts, new_facts) =
blanchet@49415
   652
      facts |> List.partition (is_fact_in_graph fact_G)
blanchet@49415
   653
            ||> sort (thm_ord o pairself snd)
blanchet@49407
   654
    val num_new_facts = length new_facts
blanchet@49323
   655
  in
blanchet@49407
   656
    (if not auto then
blanchet@49409
   657
       "MaShing" ^
blanchet@49409
   658
       (if not auto then
blanchet@49409
   659
          " " ^ string_of_int num_new_facts ^ " fact" ^
blanchet@49409
   660
          plural_s num_new_facts ^
blanchet@49409
   661
          (if atp then " (ATP timeout: " ^ string_from_time timeout ^ ")"
blanchet@49409
   662
           else "")
blanchet@49409
   663
        else
blanchet@49409
   664
          "") ^ "..."
blanchet@49407
   665
     else
blanchet@49409
   666
       "")
blanchet@49407
   667
    |> Output.urgent_message;
blanchet@49415
   668
    if num_new_facts = 0 then
blanchet@49409
   669
      if not auto then
blanchet@49407
   670
        "Nothing to learn.\n\nHint: Try " ^ sendback relearn_isarN ^ " or " ^
blanchet@49411
   671
        sendback relearn_atpN ^ " to learn from scratch."
blanchet@49407
   672
      else
blanchet@49407
   673
        ""
blanchet@49323
   674
    else
blanchet@49319
   675
      let
blanchet@49415
   676
        val last_th = new_facts |> List.last |> snd
blanchet@49415
   677
        (* crude approximation *)
blanchet@49415
   678
        val ancestors =
blanchet@49415
   679
          old_facts |> filter (fn (_, th) => thm_ord (th, last_th) <> GREATER)
blanchet@49330
   680
        val all_names =
blanchet@49415
   681
          facts |> map snd
blanchet@49415
   682
                |> filter_out is_likely_tautology_or_too_meta
blanchet@49415
   683
                |> map (rpair () o nickname_of)
blanchet@49415
   684
                |> Symtab.make
blanchet@49407
   685
        fun do_commit [] state = state
blanchet@49415
   686
          | do_commit upds {fact_G} =
blanchet@49407
   687
            let
blanchet@49415
   688
              val (upds, fact_G) =
blanchet@49415
   689
                ([], fact_G) |> fold (update_fact_graph ctxt) upds
blanchet@49415
   690
            in mash_ADD ctxt overlord (rev upds); {fact_G = fact_G} end
blanchet@49347
   691
        fun trim_deps deps = if length deps > max_dependencies then [] else deps
blanchet@49407
   692
        fun commit last upds =
blanchet@49407
   693
          (if debug andalso not auto then Output.urgent_message "Committing..."
blanchet@49407
   694
           else ();
blanchet@49407
   695
           mash_map ctxt (do_commit (rev upds));
blanchet@49407
   696
           if not last andalso not auto then
blanchet@49407
   697
             let val num_upds = length upds in
blanchet@49407
   698
               "Processed " ^ string_of_int num_upds ^ " fact" ^
blanchet@49407
   699
               plural_s num_upds ^ " in the last " ^
blanchet@49407
   700
               string_from_time commit_timeout ^ "."
blanchet@49407
   701
               |> Output.urgent_message
blanchet@49407
   702
             end
blanchet@49407
   703
           else
blanchet@49407
   704
             ())
blanchet@49407
   705
        fun do_fact _ (accum as (_, (_, _, _, true))) = accum
blanchet@49407
   706
          | do_fact ((_, stature), th)
blanchet@49407
   707
                    (upds, (parents, n, next_commit, false)) =
blanchet@49333
   708
            let
blanchet@49393
   709
              val name = nickname_of th
blanchet@49347
   710
              val feats =
blanchet@49400
   711
                features_of ctxt prover (theory_of_thm th) stature [prop_of th]
blanchet@49407
   712
              val deps =
blanchet@49407
   713
                (if atp then atp_dependencies_of ctxt params prover auto facts
blanchet@49407
   714
                 else isar_dependencies_of) all_names th
blanchet@49407
   715
                |> trim_deps
blanchet@49409
   716
              val n = n |> not (null deps) ? Integer.add 1
blanchet@49407
   717
              val upds = (name, parents, feats, deps) :: upds
blanchet@49407
   718
              val (upds, next_commit) =
blanchet@49407
   719
                if Time.> (Timer.checkRealTimer timer, next_commit) then
blanchet@49407
   720
                  (commit false upds; ([], next_commit_time ()))
blanchet@49407
   721
                else
blanchet@49407
   722
                  (upds, next_commit)
blanchet@49407
   723
              val timed_out =
blanchet@49407
   724
                Time.> (Timer.checkRealTimer timer, learn_timeout)
blanchet@49409
   725
            in (upds, ([name], n, next_commit, timed_out)) end
blanchet@49415
   726
        val parents = max_facts_in_graph fact_G ancestors
blanchet@49407
   727
        val (upds, (_, n, _, _)) =
blanchet@49407
   728
          ([], (parents, 0, next_commit_time (), false))
blanchet@49407
   729
          |> fold do_fact new_facts
blanchet@49333
   730
      in
blanchet@49407
   731
        commit true upds;
blanchet@49407
   732
        if verbose orelse not auto then
blanchet@49409
   733
          "Learned " ^ string_of_int n ^ " nontrivial proof" ^ plural_s n ^
blanchet@49334
   734
          (if verbose then
blanchet@49334
   735
             " in " ^ string_from_time (Timer.checkRealTimer timer)
blanchet@49334
   736
           else
blanchet@49334
   737
             "") ^ "."
blanchet@49334
   738
        else
blanchet@49334
   739
          ""
blanchet@49333
   740
      end
blanchet@49323
   741
  end
blanchet@49319
   742
blanchet@49411
   743
fun mash_learn ctxt (params as {provers, ...}) fact_override chained atp =
blanchet@49331
   744
  let
blanchet@49411
   745
    val css = Sledgehammer_Fact.clasimpset_rule_table_of ctxt
blanchet@49410
   746
    val ctxt = ctxt |> Config.put instantiate_inducts false
blanchet@49410
   747
    val facts =
blanchet@49411
   748
      nearly_all_facts ctxt false fact_override Symtab.empty css chained []
blanchet@49411
   749
                       @{prop True}
blanchet@49331
   750
  in
blanchet@49407
   751
     mash_learn_facts ctxt params (hd provers) false atp infinite_timeout facts
blanchet@49398
   752
     |> Output.urgent_message
blanchet@49331
   753
  end
blanchet@49264
   754
blanchet@49333
   755
(* The threshold should be large enough so that MaSh doesn't kick in for Auto
blanchet@49333
   756
   Sledgehammer and Try. *)
blanchet@49333
   757
val min_secs_for_learning = 15
blanchet@49333
   758
blanchet@49336
   759
fun relevant_facts ctxt (params as {learn, fact_filter, timeout, ...}) prover
blanchet@49336
   760
        max_facts ({add, only, ...} : fact_override) hyp_ts concl_t facts =
blanchet@49329
   761
  if not (subset (op =) (the_list fact_filter, fact_filters)) then
blanchet@49329
   762
    error ("Unknown fact filter: " ^ quote (the fact_filter) ^ ".")
blanchet@49329
   763
  else if only then
blanchet@49304
   764
    facts
blanchet@49336
   765
  else if max_facts <= 0 orelse null facts then
blanchet@49303
   766
    []
blanchet@49303
   767
  else
blanchet@49303
   768
    let
blanchet@49342
   769
      fun maybe_learn () =
blanchet@49399
   770
        if learn andalso not (Async_Manager.has_running_threads MaShN) andalso
blanchet@49399
   771
           Time.toSeconds timeout >= min_secs_for_learning then
blanchet@49399
   772
          let val timeout = time_mult learn_timeout_slack timeout in
blanchet@49399
   773
            launch_thread timeout
blanchet@49407
   774
                (fn () => (true, mash_learn_facts ctxt params prover true false
blanchet@49407
   775
                                                  timeout facts))
blanchet@49334
   776
          end
blanchet@49333
   777
        else
blanchet@49333
   778
          ()
blanchet@49329
   779
      val fact_filter =
blanchet@49329
   780
        case fact_filter of
blanchet@49394
   781
          SOME ff => (() |> ff <> mepoN ? maybe_learn; ff)
blanchet@49333
   782
        | NONE =>
blanchet@49401
   783
          if is_smt_prover ctxt prover then mepoN
blanchet@49401
   784
          else if mash_can_suggest_facts ctxt then (maybe_learn (); meshN)
blanchet@49394
   785
          else if mash_could_suggest_facts () then (maybe_learn (); mepoN)
blanchet@49394
   786
          else mepoN
blanchet@49303
   787
      val add_ths = Attrib.eval_thms ctxt add
blanchet@49307
   788
      fun prepend_facts ths accepts =
blanchet@49303
   789
        ((facts |> filter (member Thm.eq_thm_prop ths o snd)) @
blanchet@49307
   790
         (accepts |> filter_out (member Thm.eq_thm_prop ths o snd)))
blanchet@49308
   791
        |> take max_facts
blanchet@49329
   792
      fun iter () =
blanchet@49313
   793
        iterative_relevant_facts ctxt params prover max_facts NONE hyp_ts
blanchet@49313
   794
                                 concl_t facts
blanchet@49329
   795
      fun mash () =
blanchet@49335
   796
        mash_suggest_facts ctxt params prover max_facts hyp_ts concl_t facts
blanchet@49329
   797
      val mess =
blanchet@49335
   798
        [] |> (if fact_filter <> mashN then cons (iter (), []) else I)
blanchet@49394
   799
           |> (if fact_filter <> mepoN then cons (mash ()) else I)
blanchet@49303
   800
    in
blanchet@49328
   801
      mesh_facts max_facts mess
blanchet@49303
   802
      |> not (null add_ths) ? prepend_facts add_ths
blanchet@49303
   803
    end
blanchet@49303
   804
blanchet@49334
   805
fun kill_learners () = Async_Manager.kill_threads MaShN "learner"
blanchet@49334
   806
fun running_learners () = Async_Manager.running_threads MaShN "learner"
blanchet@49334
   807
blanchet@49263
   808
end;