All Data Structures Namespaces Files Functions Variables Typedefs Enumerations Enumerator Macros Groups Pages
How to add interfaces to expression interpreters An expression interpreter is a tool to compute point-wise and interval-wise the function values, gradients, and derivatives of algebraic expressions which are given in the form of an expression tree. It is used, e.g., by an NLP solver interface to compute Jacobians and Hessians for the solver. The expression interpreter interface in SCIP has been implemented similar to those of the LP solver interface (LPI). For one binary, exactly one expression interpreter has to be linked. The expression interpreter API has been designed such that it can be used independently from SCIP. A complete list of all expression interpreters contained in this release can be found here. We now explain how users can add their own expression interpreters. Take the interface to CppAD (exprinterpret_cppad.cpp) as an example. Unlike most other plugins, it is written in C++. Additional documentation for the callback methods of an expression interpreter, in particular for their input parameters, can be found in the file exprinterpret.h Note that the expression interpreter API has Here is what you have to do to implement an expression interpreter: - Copy the file exprinterpret_none.c into a file named "exprinterpreti_myexprinterpret.c".
Make sure to adjust your Makefile such that these files are compiled and linked to your project. - Open the new files with a text editor.
- Define the expression interpreter data (see Expression Interpreter Data).
- Implement the interface methods (see Interface Methods).
## Expression Interpreter DataIn "struct SCIP_ExprInt", you can store the general data of your expression interpreter. For example, you could store a pointer to the block memory data structure. ## Interface MethodsThe expression interpreter has to implement a set of interface method. In your "exprinterpret_myexprinterpret.c", these methods are mostly dummy methods that return error codes. ## SCIPexprintGetNameThe SCIPexprintGetName method should return the name of the expression interpreter. ## SCIPexprintGetDescThe SCIPexprintGetDesc method should return a short description of the expression interpreter, e.g., the name of the developer of the code. ## SCIPexprintGetCapabilityThe SCIPexprintGetCapability method should return a bitmask that indicates the capabilities of the expression interpreter, i.e., whether it can evaluate gradients, Hessians, or do interval arithmetic. ## SCIPexprintCreateThe SCIPexprintCreate method is called to create an expression interpreter data structure. The method should initialize a "struct SCIP_ExprInt" here. ## SCIPexprintFreeThe SCIPexprintFree method is called to free an expression interpreter data structure. The method should free a "struct SCIP_ExprInt" here. ## SCIPexprintCompileThe SCIPexprintCompile method is called to initialize the data structures that are required to evaluate a particular expression tree. The expression interpreter can store data that is particular to a given expression tree in the tree by using SCIPexprtreeSetInterpreterData(). ## SCIPexprintFreeDataThe SCIPexprintFreeData method is called when an expression tree is freed. The expression interpreter should free the given data structure. ## SCIPexprintNewParametrizationThe SCIPexprintNewParametrization method is called when the values of the parameters in a parametrized expression tree have changed. ## SCIPexprintEvalThe SCIPexprintEval method is called when the value of an expression represented by an expression tree should be computed for a point. ## SCIPexprintEvalIntThe SCIPexprintEvalInt method is called when an interval that contains the range of an expression represented by an expression tree with respect to intervals for the variables should be computed. ## SCIPexprintGradThe SCIPexprintGrad method is called when the gradient of an expression represented by an expression tree should be computed for a point. ## SCIPexprintGradIntThe SCIPexprintGradInt method is called when an interval vector that contains the range of the gradients of an expression represented by an expression tree with respect to intervals for the variables should be computed. ## SCIPexprintHessianSparsityDenseThe SCIPexprintHessianSparsityDense method is called when the sparsity structure of the Hessian matrix should be computed and returned in dense form. ## SCIPexprintHessianDenseThe SCIPexprintHessianDense method is called when the Hessian of an expression represented by an expression tree should be computed for a point. |