helm/software/components/ng_paramodulation/terms.mli

   1 (*
   2     ||M||  This file is part of HELM, an Hypertextual, Electronic
   3     ||A||  Library of Mathematics, developed at the Computer Science
   4     ||T||  Department, University of Bologna, Italy.
   5     ||I||
   6     ||T||  HELM is free software; you can redistribute it and/or
   7     ||A||  modify it under the terms of the GNU General Public License
   8     \   /  version 2 or (at your option) any later version.
   9      \ /   This software is distributed as is, NO WARRANTY.
  10       V_______________________________________________________________ *)
  11
  12 (* $Id$ *)
  13
  14 type 'a foterm =
  15   | Leaf of 'a
  16   | Var of int
  17   | Node of ('a foterm) list
  18
  19 type 'a substitution = (int * 'a foterm) list
  20
  21 type comparison = Lt | Eq | Gt | Incomparable | Invertible
  22
  23 type rule = Superposition | Demodulation
  24
  25 (* A Discrimination tree is a map: foterm |-> (dir, clause) *)
  26 type direction = Left2Right | Right2Left | Nodir
  27
  28 type position = int list
  29
  30 type 'a proof =
  31   | Exact of 'a foterm
  32          (* for theorems like T : \forall x. C[x] = D[x] the proof is
  33           * a foterm like (Node [ Leaf T ; Var i ]), while for the Goal
  34           * it is just (Var g), i.e. the identity proof *)
  35   | Step of rule * int * int * direction * position * 'a substitution
  36          (* rule, eq1, eq2, direction of eq2, position, substitution *)
  37
  38 type 'a literal =
  39  | Equation of    'a foterm  (* lhs *)
  40                 * 'a foterm  (* rhs *)
  41                 * 'a foterm  (* type *)
  42                 * comparison (* orientation *)
  43  | Predicate of   'a foterm
  44
  45 type varlist = int list
  46
  47 type 'a unit_clause =
  48    int        (* ID *)
  49  * 'a literal
  50  * varlist
  51  * 'a proof      (* proof *)
  52
  53 type 'a passive_clause = int * 'a unit_clause (* weight * equation *)
  54
  55 val vars_of_term : 'a foterm -> int list
  56
  57 module M : Map.S with type key = int
  58
  59 type 'a bag = int (* max ID  *)
  60               * (('a unit_clause * bool * int) M.t)
  61
  62 (* also gives a fresh ID to the clause *)
  63     val add_to_bag :
  64           'a unit_clause -> 'a bag ->
  65             'a bag * 'a unit_clause
  66
  67     val replace_in_bag :
  68           'a unit_clause * bool * int -> 'a bag ->
  69             'a bag
  70
  71     val get_from_bag :
  72           int -> 'a bag -> 'a unit_clause * bool * int
  73
  74     val empty_bag : 'a bag
  75
  76 module type Blob =
  77   sig
  78     (* Blob is the type for opaque leaves:
  79      * - checking equlity should be efficient
  80      * - atoms have to be equipped with a total order relation
  81      *)
  82     type t
  83     val eq : t -> t -> bool
  84     val compare : t -> t -> int
  85     val eqP : t
  86     (* TODO: consider taking in input an imperative buffer for Format
  87      *  val pp : Format.formatter -> t -> unit
  88      * *)
  89     val pp : t -> string
  90
  91     type input
  92     val embed : input -> t foterm
  93     (* saturate [proof] [type] -> [proof] * [type] *)
  94     val saturate : input -> input -> t foterm * t foterm
  95
  96   end
  97