1. Function package accepts a parameter (default "some_term"), which specifies the functions
behaviour outside its domain.
2. Bugfix: An exception occured when a function in a mutual definition
was declared but no equation was given.
(* Title: HOL/Refute.thy
ID: $Id$
Author: Tjark Weber
Copyright 2003-2005
Basic setup and documentation for the 'refute' (and 'refute_params') command.
*)
header {* Refute *}
theory Refute
imports Map
uses "Tools/prop_logic.ML"
"Tools/sat_solver.ML"
"Tools/refute.ML"
"Tools/refute_isar.ML"
begin
setup Refute.setup
text {*
\small
\begin{verbatim}
(* ------------------------------------------------------------------------- *)
(* REFUTE *)
(* *)
(* We use a SAT solver to search for a (finite) model that refutes a given *)
(* HOL formula. *)
(* ------------------------------------------------------------------------- *)
(* ------------------------------------------------------------------------- *)
(* NOTE *)
(* *)
(* I strongly recommend that you install a stand-alone SAT solver if you *)
(* want to use 'refute'. For details see 'HOL/Tools/sat_solver.ML'. If you *)
(* have installed (a supported version of) zChaff, simply set 'ZCHAFF_HOME' *)
(* in 'etc/settings'. *)
(* ------------------------------------------------------------------------- *)
(* ------------------------------------------------------------------------- *)
(* USAGE *)
(* *)
(* See the file 'HOL/ex/Refute_Examples.thy' for examples. The supported *)
(* parameters are explained below. *)
(* ------------------------------------------------------------------------- *)
(* ------------------------------------------------------------------------- *)
(* CURRENT LIMITATIONS *)
(* *)
(* 'refute' currently accepts formulas of higher-order predicate logic (with *)
(* equality), including free/bound/schematic variables, lambda abstractions, *)
(* sets and set membership, "arbitrary", "The", "Eps", records and *)
(* inductively defined sets. Defining equations for constants are added *)
(* automatically, as are sort axioms. Other, user-asserted axioms however *)
(* are ignored. Inductive datatypes and recursive functions are supported, *)
(* but may lead to spurious countermodels. *)
(* *)
(* The (space) complexity of the algorithm is non-elementary. *)
(* *)
(* Schematic type variables are not supported. *)
(* ------------------------------------------------------------------------- *)
(* ------------------------------------------------------------------------- *)
(* PARAMETERS *)
(* *)
(* The following global parameters are currently supported (and required): *)
(* *)
(* Name Type Description *)
(* *)
(* "minsize" int Only search for models with size at least *)
(* 'minsize'. *)
(* "maxsize" int If >0, only search for models with size at most *)
(* 'maxsize'. *)
(* "maxvars" int If >0, use at most 'maxvars' boolean variables *)
(* when transforming the term into a propositional *)
(* formula. *)
(* "maxtime" int If >0, terminate after at most 'maxtime' seconds. *)
(* This value is ignored under some ML compilers. *)
(* "satsolver" string Name of the SAT solver to be used. *)
(* *)
(* See 'HOL/SAT.thy' for default values. *)
(* *)
(* The size of particular types can be specified in the form type=size *)
(* (where 'type' is a string, and 'size' is an int). Examples: *)
(* "'a"=1 *)
(* "List.list"=2 *)
(* ------------------------------------------------------------------------- *)
(* ------------------------------------------------------------------------- *)
(* FILES *)
(* *)
(* HOL/Tools/prop_logic.ML Propositional logic *)
(* HOL/Tools/sat_solver.ML SAT solvers *)
(* HOL/Tools/refute.ML Translation HOL -> propositional logic and *)
(* Boolean assignment -> HOL model *)
(* HOL/Tools/refute_isar.ML Adds 'refute'/'refute_params' to Isabelle's *)
(* syntax *)
(* HOL/Refute.thy This file: loads the ML files, basic setup, *)
(* documentation *)
(* HOL/SAT.thy Sets default parameters *)
(* HOL/ex/RefuteExamples.thy Examples *)
(* ------------------------------------------------------------------------- *)
\end{verbatim}
*}
end