src/HOL/Tools/Sledgehammer/sledgehammer_isar.ML
author blanchet
Wed, 01 Sep 2010 16:46:11 +0200
changeset 39240 6905ba37376c
parent 39232 483879af0643
child 39241 78ac4468cf9d
permissions -rw-r--r--
generalize theorem argument parsing syntax
     1 (*  Title:      HOL/Tools/Sledgehammer/sledgehammer_isar.ML
     2     Author:     Jasmin Blanchette, TU Muenchen
     3 
     4 Adds "sledgehammer" and related commands to Isabelle/Isar's outer syntax.
     5 *)
     6 
     7 signature SLEDGEHAMMER_ISAR =
     8 sig
     9   type params = Sledgehammer.params
    10 
    11   val atps: string Unsynchronized.ref
    12   val timeout: int Unsynchronized.ref
    13   val full_types: bool Unsynchronized.ref
    14   val default_params : theory -> (string * string) list -> params
    15 end;
    16 
    17 structure Sledgehammer_Isar : SLEDGEHAMMER_ISAR =
    18 struct
    19 
    20 open ATP_Systems
    21 open Sledgehammer_Util
    22 open Sledgehammer
    23 open Sledgehammer_Minimize
    24 
    25 (** Sledgehammer commands **)
    26 
    27 fun add_to_relevance_override ns : relevance_override =
    28   {add = ns, del = [], only = false}
    29 fun del_from_relevance_override ns : relevance_override =
    30   {add = [], del = ns, only = false}
    31 fun only_relevance_override ns : relevance_override =
    32   {add = ns, del = [], only = true}
    33 fun merge_relevance_override_pairwise (r1 : relevance_override)
    34                                       (r2 : relevance_override) =
    35   {add = #add r1 @ #add r2, del = #del r1 @ #del r2,
    36    only = #only r1 andalso #only r2}
    37 fun merge_relevance_overrides rs =
    38   fold merge_relevance_override_pairwise rs (only_relevance_override [])
    39 
    40 (*** parameters ***)
    41 
    42 val atps = Unsynchronized.ref ""
    43 val timeout = Unsynchronized.ref 60
    44 val full_types = Unsynchronized.ref false
    45 
    46 val _ =
    47   ProofGeneralPgip.add_preference Preferences.category_proof
    48       (Preferences.string_pref atps
    49           "Sledgehammer: ATPs"
    50           "Default automatic provers (separated by whitespace)")
    51 
    52 val _ =
    53   ProofGeneralPgip.add_preference Preferences.category_proof
    54       (Preferences.int_pref timeout
    55           "Sledgehammer: Time Limit"
    56           "ATPs will be interrupted after this time (in seconds)")
    57 
    58 val _ =
    59   ProofGeneralPgip.add_preference Preferences.category_proof
    60       (Preferences.bool_pref full_types
    61           "Sledgehammer: Full Types" "ATPs will use full type information")
    62 
    63 type raw_param = string * string list
    64 
    65 val default_default_params =
    66   [("blocking", "false"),
    67    ("debug", "false"),
    68    ("verbose", "false"),
    69    ("overlord", "false"),
    70    ("explicit_apply", "false"),
    71    ("relevance_thresholds", "45 85"),
    72    ("max_relevant", "smart"),
    73    ("theory_relevant", "smart"),
    74    ("isar_proof", "false"),
    75    ("isar_shrink_factor", "1")]
    76 
    77 val alias_params =
    78   [("atp", "atps")]
    79 val negated_alias_params =
    80   [("non_blocking", "blocking"),
    81    ("no_debug", "debug"),
    82    ("quiet", "verbose"),
    83    ("no_overlord", "overlord"),
    84    ("partial_types", "full_types"),
    85    ("implicit_apply", "explicit_apply"),
    86    ("theory_irrelevant", "theory_relevant"),
    87    ("no_isar_proof", "isar_proof")]
    88 
    89 val params_for_minimize =
    90   ["debug", "verbose", "overlord", "full_types", "isar_proof",
    91    "isar_shrink_factor", "timeout"]
    92 
    93 val property_dependent_params = ["atps", "full_types", "timeout"]
    94 
    95 fun is_known_raw_param s =
    96   AList.defined (op =) default_default_params s orelse
    97   AList.defined (op =) alias_params s orelse
    98   AList.defined (op =) negated_alias_params s orelse
    99   member (op =) property_dependent_params s orelse s = "expect"
   100 
   101 fun check_raw_param (s, _) =
   102   if is_known_raw_param s then ()
   103   else error ("Unknown parameter: " ^ quote s ^ ".")
   104 
   105 fun unalias_raw_param (name, value) =
   106   case AList.lookup (op =) alias_params name of
   107     SOME name' => (name', value)
   108   | NONE =>
   109     case AList.lookup (op =) negated_alias_params name of
   110       SOME name' => (name', case value of
   111                               ["false"] => ["true"]
   112                             | ["true"] => ["false"]
   113                             | [] => ["false"]
   114                             | _ => value)
   115     | NONE => (name, value)
   116 
   117 structure Data = Theory_Data(
   118   type T = raw_param list
   119   val empty = default_default_params |> map (apsnd single)
   120   val extend = I
   121   fun merge p : T = AList.merge (op =) (K true) p)
   122 
   123 val set_default_raw_param = Data.map o AList.update (op =) o unalias_raw_param
   124 fun default_raw_params thy =
   125   Data.get thy
   126   |> fold (AList.default (op =))
   127           [("atps", [case !atps of "" => default_atps_param_value () | s => s]),
   128            ("full_types", [if !full_types then "true" else "false"]),
   129            ("timeout", let val timeout = !timeout in
   130                          [if timeout <= 0 then "none"
   131                           else string_of_int timeout ^ " s"]
   132                        end)]
   133 
   134 val infinity_time_in_secs = 60 * 60 * 24 * 365
   135 val the_timeout = the_default (Time.fromSeconds infinity_time_in_secs)
   136 
   137 fun extract_params default_params override_params =
   138   let
   139     val override_params = map unalias_raw_param override_params
   140     val raw_params = rev override_params @ rev default_params
   141     val lookup = Option.map (space_implode " ") o AList.lookup (op =) raw_params
   142     val lookup_string = the_default "" o lookup
   143     fun general_lookup_bool option default_value name =
   144       case lookup name of
   145         SOME s => parse_bool_option option name s
   146       | NONE => default_value
   147     val lookup_bool = the o general_lookup_bool false (SOME false)
   148     val lookup_bool_option = general_lookup_bool true NONE
   149     fun lookup_time name =
   150       the_timeout (case lookup name of
   151                      NONE => NONE
   152                    | SOME s => parse_time_option name s)
   153     fun lookup_int name =
   154       case lookup name of
   155         NONE => 0
   156       | SOME s => case Int.fromString s of
   157                     SOME n => n
   158                   | NONE => error ("Parameter " ^ quote name ^
   159                                    " must be assigned an integer value.")
   160     fun lookup_int_pair name =
   161       case lookup name of
   162         NONE => (0, 0)
   163       | SOME s => case s |> space_explode " " |> map Int.fromString of
   164                     [SOME n1, SOME n2] => (n1, n2)
   165                   | _ => error ("Parameter " ^ quote name ^
   166                                 "must be assigned a pair of integer values \
   167                                 \(e.g., \"60 95\")")
   168     fun lookup_int_option name =
   169       case lookup name of
   170         SOME "smart" => NONE
   171       | _ => SOME (lookup_int name)
   172     val blocking = lookup_bool "blocking"
   173     val debug = lookup_bool "debug"
   174     val verbose = debug orelse lookup_bool "verbose"
   175     val overlord = lookup_bool "overlord"
   176     val atps = lookup_string "atps" |> space_explode " "
   177     val full_types = lookup_bool "full_types"
   178     val explicit_apply = lookup_bool "explicit_apply"
   179     val relevance_thresholds =
   180       lookup_int_pair "relevance_thresholds"
   181       |> pairself (fn n => 0.01 * Real.fromInt n)
   182     val max_relevant = lookup_int_option "max_relevant"
   183     val theory_relevant = lookup_bool_option "theory_relevant"
   184     val isar_proof = lookup_bool "isar_proof"
   185     val isar_shrink_factor = Int.max (1, lookup_int "isar_shrink_factor")
   186     val timeout = lookup_time "timeout"
   187     val expect = lookup_string "expect"
   188   in
   189     {blocking = blocking, debug = debug, verbose = verbose, overlord = overlord,
   190      atps = atps, full_types = full_types, explicit_apply = explicit_apply,
   191      relevance_thresholds = relevance_thresholds, max_relevant = max_relevant,
   192      theory_relevant = theory_relevant, isar_proof = isar_proof,
   193      isar_shrink_factor = isar_shrink_factor, timeout = timeout,
   194      expect = expect}
   195   end
   196 
   197 fun get_params thy = extract_params (default_raw_params thy)
   198 fun default_params thy = get_params thy o map (apsnd single)
   199 
   200 (* Sledgehammer the given subgoal *)
   201 
   202 val sledgehammerN = "sledgehammer"
   203 val sledgehammer_paramsN = "sledgehammer_params"
   204 
   205 val runN = "run"
   206 val minimizeN = "minimize"
   207 val messagesN = "messages"
   208 val available_atpsN = "available_atps"
   209 val running_atpsN = "running_atps"
   210 val kill_atpsN = "kill_atps"
   211 val refresh_tptpN = "refresh_tptp"
   212 
   213 val is_raw_param_relevant_for_minimize =
   214   member (op =) params_for_minimize o fst o unalias_raw_param
   215 fun string_for_raw_param (key, values) =
   216   key ^ (case space_implode " " values of "" => "" | value => " = " ^ value)
   217 
   218 fun minimize_command override_params i atp_name fact_names =
   219   sledgehammerN ^ " " ^ minimizeN ^ " [atp = " ^ atp_name ^
   220   (override_params |> filter is_raw_param_relevant_for_minimize
   221                    |> implode o map (prefix ", " o string_for_raw_param)) ^
   222   "] (" ^ space_implode " " fact_names ^ ")" ^
   223   (if i = 1 then "" else " " ^ string_of_int i)
   224 
   225 fun hammer_away override_params subcommand opt_i relevance_override state =
   226   let
   227     val thy = Proof.theory_of state
   228     val _ = app check_raw_param override_params
   229   in
   230     if subcommand = runN then
   231       let val i = the_default 1 opt_i in
   232         run_sledgehammer (get_params thy override_params) i relevance_override
   233                          (minimize_command override_params i) state
   234       end
   235     else if subcommand = minimizeN then
   236       run_minimize (get_params thy override_params) (the_default 1 opt_i)
   237                    (#add relevance_override) state
   238     else if subcommand = messagesN then
   239       messages opt_i
   240     else if subcommand = available_atpsN then
   241       available_atps thy
   242     else if subcommand = running_atpsN then
   243       running_atps ()
   244     else if subcommand = kill_atpsN then
   245       kill_atps ()
   246     else if subcommand = refresh_tptpN then
   247       refresh_systems_on_tptp ()
   248     else
   249       error ("Unknown subcommand: " ^ quote subcommand ^ ".")
   250   end
   251 
   252 fun sledgehammer_trans (((subcommand, params), relevance_override), opt_i) =
   253   Toplevel.keep (hammer_away params subcommand opt_i relevance_override
   254                  o Toplevel.proof_of)
   255 
   256 fun string_for_raw_param (name, value) = name ^ " = " ^ space_implode " " value
   257 
   258 fun sledgehammer_params_trans params =
   259   Toplevel.theory
   260       (fold set_default_raw_param params
   261        #> tap (fn thy => 
   262                   writeln ("Default parameters for Sledgehammer:\n" ^
   263                            (case rev (default_raw_params thy) of
   264                               [] => "none"
   265                             | params =>
   266                               (map check_raw_param params;
   267                                params |> map string_for_raw_param
   268                                       |> sort_strings |> cat_lines)))))
   269 
   270 val parse_key = Scan.repeat1 Parse.typ_group >> space_implode " "
   271 val parse_value = Scan.repeat1 Parse.xname
   272 val parse_param = parse_key -- Scan.optional (Parse.$$$ "=" |-- parse_value) []
   273 val parse_params = Scan.optional (Args.bracks (Parse.list parse_param)) []
   274 val parse_fact_refs =
   275   Scan.repeat1 (Scan.unless (Parse.name -- Args.colon) Parse_Spec.xthm)
   276 val parse_relevance_chunk =
   277   (Args.add |-- Args.colon |-- parse_fact_refs >> add_to_relevance_override)
   278   || (Args.del |-- Args.colon |-- parse_fact_refs
   279       >> del_from_relevance_override)
   280   || (parse_fact_refs >> only_relevance_override)
   281 val parse_relevance_override =
   282   Scan.optional (Args.parens (Scan.repeat parse_relevance_chunk
   283                               >> merge_relevance_overrides))
   284                 (add_to_relevance_override [])
   285 val parse_sledgehammer_command =
   286   (Scan.optional Parse.short_ident runN -- parse_params
   287    -- parse_relevance_override -- Scan.option Parse.nat) #>> sledgehammer_trans
   288 val parse_sledgehammer_params_command =
   289   parse_params #>> sledgehammer_params_trans
   290 
   291 val _ =
   292   Outer_Syntax.improper_command sledgehammerN
   293       "search for first-order proof using automatic theorem provers" Keyword.diag
   294       parse_sledgehammer_command
   295 val _ =
   296   Outer_Syntax.command sledgehammer_paramsN
   297       "set and display the default parameters for Sledgehammer" Keyword.thy_decl
   298       parse_sledgehammer_params_command
   299 
   300 end;