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 is_eq_clause : 'a unit_clause -> bool
  56 val vars_of_term : 'a foterm -> int list
  57
  58 module M : Map.S with type key = int
  59
  60 type 'a bag = int (* max ID  *)
  61               * (('a unit_clause * bool * int) M.t)
  62
  63 (* also gives a fresh ID to the clause *)
  64     val add_to_bag :
  65           'a unit_clause -> 'a bag ->
  66             'a bag * 'a unit_clause
  67
  68     val replace_in_bag :
  69           'a unit_clause * bool * int -> 'a bag ->
  70             'a bag
  71
  72     val get_from_bag :
  73           int -> 'a bag -> 'a unit_clause * bool * int
  74
  75     val empty_bag : 'a bag
  76
  77 module type Blob =
  78   sig
  79     (* Blob is the type for opaque leaves:
  80      * - checking equlity should be efficient
  81      * - atoms have to be equipped with a total order relation
  82      *)
  83     type t
  84     val eq : t -> t -> bool
  85     val compare : t -> t -> int
  86     val eqP : t
  87     (* TODO: consider taking in input an imperative buffer for Format
  88      *  val pp : Format.formatter -> t -> unit
  89      * *)
  90     val is_eq : t foterm -> (t foterm * t foterm * t foterm) option
  91     val pp : t -> string
  92
  93     type input
  94     val embed : input -> t foterm
  95     (* saturate [proof] [type] -> [proof] * [type] *)
  96     val saturate : input -> input -> t foterm * t foterm
  97
  98   end
  99