edit
[satune.git] / src / csolver.h
index 9d260e024087aaadadccccd8d50383267d070002..fbf22da5bb7aa3f97284a69b5bbb72946e7c3cd6 100644 (file)
 #define CSOLVER_H
 #include "classlist.h"
 #include "ops.h"
+#include "structs.h"
 
-class CSolver {
-       Set * createSet(Type type, uint64_t ** elements);
-       Set * createSet(Type type, uint64_t lowrange, uint64_t highrange);
-       MutableSet * createMutableSet(Type type);
+struct CSolver {
+       SATEncoder *satEncoder;
+       bool unsat;
+       Tuner *tuner;
+       
+       /** This is a vector of constraints that must be satisfied. */
+       HashSetBoolean *constraints;
 
-       void addItem(MutableSet * set, uint64_t element);
-       int64_t createUniqueItem(MutableSet * set);
+       /** This is a vector of all boolean structs that we have allocated. */
+       VectorBoolean *allBooleans;
 
-       Element * getElementVar(Set * set);
-       Constraint * getBooleanVar();
+       /** This is a vector of all set structs that we have allocated. */
+       VectorSet *allSets;
 
-       Function * createFunctionOperator(enum ArithOp op, Set ** domain, Set * range, enum OverFlowBehavior overflowbehavior, Constraint * overflowstatus);
-       Function * createFunctionOperator(enum ArithOp op);                                                                                                             //Does Not Overflow
-       Predicate * createPredicateOperator(enum CompOp op, Set ** domain);
+       /** This is a vector of all element structs that we have allocated. */
+       VectorElement *allElements;
 
-       Table * createTable(Set **domains, Set * range);
-       void addTableEntry(Element ** inputs, Element *result);
-       Function * completeTable(struct Table *);
+       /** This is a vector of all predicate structs that we have allocated. */
+       VectorPredicate *allPredicates;
 
-       Element * applyFunction(Function * function, Element ** array);
-       Constraint * applyPredicate(Predicate * predicate, Element ** inputs);
-       Constraint * applyLogicalOperation(enum LogicOp op, Constraint ** array);
+       /** This is a vector of all table structs that we have allocated. */
+       VectorTable *allTables;
 
-       void addConstraint(Constraint * constraint);
+       /** This is a vector of all order structs that we have allocated. */
+       VectorOrder *allOrders;
 
-       Order * createOrder(enum OrderType type, Set * set);
-       Constraint * orderedConstraint(Order * order, uint64_t first, uint64_t second);
+       /** This is a vector of all function structs that we have allocated. */
+       VectorFunction *allFunctions;
 };
+
+/** Create a new solver instance. */
+
+CSolver *allocCSolver();
+
+/** Delete solver instance. */
+
+void deleteSolver(CSolver *This);
+
+/** This function creates a set containing the elements passed in the array. */
+
+Set *createSet(CSolver *, VarType type, uint64_t *elements, uint num);
+
+/** This function creates a set from lowrange to highrange (inclusive). */
+
+Set *createRangeSet(CSolver *, VarType type, uint64_t lowrange, uint64_t highrange);
+
+/** This function creates a mutable set. */
+
+MutableSet *createMutableSet(CSolver *, VarType type);
+
+/** This function adds a new item to a set. */
+
+void addItem(CSolver *, MutableSet *set, uint64_t element);
+
+/** This function adds a new unique item to the set and returns it.
+    This function cannot be used in conjunction with manually adding
+    items to the set. */
+
+uint64_t createUniqueItem(CSolver *, MutableSet *set);
+
+/** This function creates an element variable over a set. */
+
+Element *getElementVar(CSolver *, Set *set);
+
+/** This function creates an element constrant. */
+Element *getElementConst(CSolver *, VarType type, uint64_t value);
+
+/** This function creates a boolean variable. */
+
+Boolean *getBooleanVar(CSolver *, VarType type);
+
+/** This function creates a function operator. */
+
+Function *createFunctionOperator(CSolver *solver, ArithOp op, Set **domain, uint numDomain, Set *range,
+                                                                                                                                OverFlowBehavior overflowbehavior);
+
+/** This function creates a predicate operator. */
+
+Predicate *createPredicateOperator(CSolver *solver, CompOp op, Set **domain, uint numDomain);
+
+Predicate *createPredicateTable(CSolver *solver, Table *table, UndefinedBehavior behavior);
+
+/** This function creates an empty instance table.*/
+
+Table *createTable(CSolver *solver, Set **domains, uint numDomain, Set *range);
+
+Table *createTableForPredicate(CSolver *solver, Set **domains, uint numDomain);
+/** This function adds an input output relation to a table. */
+
+void addTableEntry(CSolver *solver, Table *table, uint64_t *inputs, uint inputSize, uint64_t result);
+
+/** This function converts a completed table into a function. */
+
+Function *completeTable(CSolver *, Table *, UndefinedBehavior behavior);
+
+/** This function applies a function to the Elements in its input. */
+
+Element *applyFunction(CSolver *, Function *function, Element **array, uint numArrays, Boolean *overflowstatus);
+
+/** This function applies a predicate to the Elements in its input. */
+
+Boolean *applyPredicateTable(CSolver *, Predicate *predicate, Element **inputs, uint numInputs, Boolean *undefinedStatus);
+
+Boolean *applyPredicate(CSolver *, Predicate *predicate, Element **inputs, uint numInputs);
+
+/** This function applies a logical operation to the Booleans in its input. */
+
+Boolean *applyLogicalOperation(CSolver *, LogicOp op, Boolean **array, uint asize);
+
+/** This function adds a boolean constraint to the set of constraints
+    to be satisfied */
+
+void addConstraint(CSolver *, Boolean *constraint);
+
+/** This function instantiates an order of type type over the set set. */
+Order *createOrder(CSolver *, OrderType type, Set *set);
+
+/** This function instantiates a boolean on two items in an order. */
+Boolean *orderConstraint(CSolver *, Order *order, uint64_t first, uint64_t second);
+
+/** When everything is done, the client calls this function and then csolver starts to encode*/
+int startEncoding(CSolver *);
+
+/** After getting the solution from the SAT solver, client can get the value of an element via this function*/
+uint64_t getElementValue(CSolver *, Element *element);
+
+/** After getting the solution from the SAT solver, client can get the value of a boolean via this function*/
+bool getBooleanValue( CSolver *, Boolean *boolean);
+
+HappenedBefore getOrderConstraintValue(CSolver *, Order *order, uint64_t first, uint64_t second);
+
 #endif