[sledge] Add the embedding of arithmetic into terms to the arithmetic interface

Summary:
The implementation of Arithmetic relies on the partial projection from
terms to polynomials. This diff enables it to also embed polynomials
back into terms.

Reviewed By: jvillard

Differential Revision: D24746223

fbshipit-source-id: b6010e7b7

sledge/src/fol/arithmetic_intf.ml

@@ -93,18 +93,20 @@ module type INDETERMINATE = sig
   val vars : trm -> var iter
 end
 
-(** An embedding of arithmetic terms [t] into indeterminates [trm],
+(** An embedding of arithmetic terms [t] into indeterminates [trm]. *)
-    expressed as a partial projection from [trm] to [t]. The inverse
-    embedding function is generally internal to the client. *)
 module type EMBEDDING = sig
   type trm
   type t
 
+  val to_trm : t -> trm
+  (** Embedding from [t] to [trm]: [to_trm a] is arithmetic term [a]
+      embedded in an indeterminate term. *)
+
   val get_arith : trm -> t option
-  (** [get_arith x] should be [Some a] if indeterminate [x] is equivalent to
+  (** Partial projection from [trm] to [t]: [get_arith x] is [Some a] if
-      [a] embedded into an indeterminate term. This is used to flatten
+      [x = to_trm a]. This is used to flatten indeterminates that are
-      indeterminates that are actually arithmetic for the client, thereby
+      actually arithmetic for the client, thereby enabling arithmetic
-      enabling arithmetic operations to be interpreted more often. *)
+      operations to be interpreted more often. *)
 end
 
 (** A type [t] representing arithmetic terms over indeterminates [trm]

sledge/src/fol/trm.ml

@@ -56,6 +56,8 @@ and Arith :
   include Arith0
 
   include Make (struct
+    let to_trm = Trm._Arith
+
     let get_arith (e : Trm.t) =
       match e with
       | Z z -> Some (Arith.const (Q.of_z z))