mbxmlutils  1.3.0
Multi-Body XML Utils
eval.h
1#ifndef _MBXMLUTILS_EVAL_H_
2#define _MBXMLUTILS_EVAL_H_
3
4#include <fmatvec/atom.h>
5#include <boost/filesystem.hpp>
6#include <xercesc/util/XercesDefs.hpp>
7#include <mbxmlutilshelper/dom.h>
8#include <mbxmlutilshelper/thislinelocation.h>
9#include <unordered_map>
10#include <stack>
11#include "mbxmlutilshelper/utils.h"
12
13#define MBXMLUTILS_EVAL_CONCAT1(X, Y) X##Y
14#define MBXMLUTILS_EVAL_CONCAT(X, Y) MBXMLUTILS_EVAL_CONCAT1(X, Y)
15#define MBXMLUTILS_EVAL_APPENDLINE(X) MBXMLUTILS_EVAL_CONCAT(X, __LINE__)
16
18#define MBXMLUTILS_EVAL_REGISTER(T) \
19 namespace { \
20 struct Reg { \
21 Reg() { Eval::registerEvaluator<T>(); } \
22 } MBXMLUTILS_EVAL_APPENDLINE(regDummy); \
23 }
24
25namespace XERCES_CPP_NAMESPACE {
26 class DOMElement;
27 class DOMAttr;
28 class DOMDocument;
29}
30
31namespace MBXMLUtils {
32
33bool tryDouble2Int(double d, int &i);
34
36class CodeString : public std::string {
37 public:
38 CodeString(const std::string &str) : std::string(str) {}
39};
40
41// Store the current directory in the ctor an restore in the dtor
43 public:
45 dir=MBXMLUtils::current_path();
46 }
48 MBXMLUtils::current_path(dir);
49 }
50 private:
51 boost::filesystem::path dir;
52};
53
54class Eval;
55
58 public:
60 NewParamLevel(std::shared_ptr<Eval> oe_, bool newLevel_=true);
63
64 NewParamLevel(const NewParamLevel& other) = delete; // copy constructor
65 NewParamLevel(NewParamLevel&& other) = delete; // move constructor
66 NewParamLevel& operator=(const NewParamLevel& other) = delete; // copy assignment
67 NewParamLevel& operator=(NewParamLevel&& other) = delete; // move assignment
68 protected:
69 static void* operator new(std::size_t); // no heap allocation allowed
70 static void* operator new[](std::size_t); // no heap allocation allowed
71
72 std::shared_ptr<Eval> oe;
73 bool newLevel;
74};
75
77class Eval : public std::enable_shared_from_this<Eval>, virtual public fmatvec::Atom {
78 public:
79 friend class NewParamLevel;
80
83 enum ValueType {
84 ScalarType,
85 VectorType,
86 MatrixType,
87 StringType,
88 FunctionType
89 };
90
92 using Value = std::shared_ptr<void>;
93
94 static boost::filesystem::path installPath;
95
96 protected:
98 Eval(std::vector<boost::filesystem::path> *dependencies_);
99 public:
101 ~Eval() override;
102
103 Eval(const Eval& other) = delete; // copy constructor
104 Eval(Eval&& other) = delete; // move constructor
105 Eval& operator=(const Eval& other) = delete; // copy assignment
106 Eval& operator=(Eval&& other) = delete; // move assignment
107
109 static std::shared_ptr<Eval> createEvaluator(const std::string &evalName, std::vector<boost::filesystem::path> *dependencies_=nullptr);
110
111 // Register a new evaluator.
112 template<class E>
113 static void registerEvaluator() {
114 getEvaluators()[E::getNameStatic()]=&newEvaluator<E>;
115 }
116
118 virtual std::string getName() const=0;
119
121 void addParam(const std::string &paramName, const Value& value);
125 void addParamSet(const xercesc::DOMElement *e);
126
129 virtual void addImport(const std::string &code, const xercesc::DOMElement *e, const std::string &action="")=0;
130
133 Value eval(const xercesc::DOMElement *e);
134
138 Value eval(const xercesc::DOMAttr *a);
139
142 Value eval(const std::string &str, const xercesc::DOMElement *e=nullptr, bool skipRet=false);
143
145 void checkIfValueMatchesElement(const Value& value, const xercesc::DOMElement *e);
146
214 template<typename T>
215 T cast(const Value &value) const;
216
218 virtual std::string getStringRepresentation(const Value &x) const;
219
226 virtual bool valueIsOfType(const Value &value, ValueType type) const=0;
227
231 Value stringToValue(const std::string &str, const xercesc::DOMElement *e=nullptr, bool fullEval=true, bool skipRet=false) const;
232
238 template<class T>
239 Value create(const T& v) const;
240
247 template<class T>
248 std::string createSourceCode(const T& v) const;
249
251 virtual std::map<boost::filesystem::path, std::pair<boost::filesystem::path, bool> >& requiredFiles() const=0;
252
256 virtual void convertIndex(Value &v, bool evalTo1Based)=0;
257
259 static void setValue(xercesc::DOMElement *e, const Value &v);
260
274 virtual Value callFunction(const std::string &name, const std::vector<Value>& args) const=0;
275
276 size_t getStackSize() { assert(paramStack.size()==importStack.size()); return paramStack.size(); }
277
278 protected:
280 virtual Value createFunctionIndep(int dim) const = 0;
282 virtual Value createFunctionDep(const std::vector<Value>& v) const=0;
284 virtual Value createFunctionDep(const std::vector<std::vector<Value> >& v) const=0;
286 virtual Value createFunction(const std::vector<Value> &indeps, const Value &dep) const = 0;
287
289 void pushContext();
290
292 void popContext();
293
294 std::vector<boost::filesystem::path> *dependencies;
295
296 // map of the current parameters
297 std::unordered_map<std::string, Value> currentParam;
298 // stack of parameters
299 std::stack<std::unordered_map<std::string, Value> > paramStack;
300
301 // current imports
302 std::unordered_map<std::string, Value> currentImport;
303 // stack of imports
304 std::stack<std::unordered_map<std::string, Value> > importStack;
305
307 virtual Value fullStringToValue(const std::string &str, const xercesc::DOMElement *e, bool skipRet=false) const=0;
308
310 std::string partialStringToString(const std::string &str, const xercesc::DOMElement *e) const;
311
312 template<class E>
313 static std::shared_ptr<Eval> newEvaluator(std::vector<boost::filesystem::path>* dependencies_) {
314 return std::shared_ptr<E>(new E(dependencies_));
315 }
316
317 void addStaticDependencies(const xercesc::DOMElement *e) const;
318
319 static void printEvaluatorMsg(const std::ostringstream &str, MsgType msgType);
320
321 private:
322 // virtual spezialization of cast(const Value &value)
323 virtual double cast_double (const Value &value) const=0;
324 virtual std::vector<double> cast_vector_double (const Value &value) const=0;
325 virtual std::vector<std::vector<double> > cast_vector_vector_double(const Value &value) const=0;
326 virtual std::string cast_string (const Value &value) const=0;
327 // spezialization of cast(const Value &value)
328 CodeString cast_CodeString (const Value &value) const;
329 int cast_int (const Value &value) const;
330
331 // virtual spezialization of create(...)
332 virtual Value create_double (const double& v) const=0;
333 virtual Value create_vector_double (const std::vector<double>& v) const=0;
334 virtual Value create_vector_vector_double (const std::vector<std::vector<double> >& v) const=0;
335 virtual Value create_string (const std::string& v) const=0;
336
337 // virtual spezialization of createSourceCode(...)
338 virtual std::string createSourceCode_double (const double& v) const=0;
339 virtual std::string createSourceCode_vector_double (const std::vector<double>& v) const=0;
340 virtual std::string createSourceCode_vector_vector_double (const std::vector<std::vector<double> >& v) const=0;
341 virtual std::string createSourceCode_string (const std::string& v) const=0;
342
343 virtual std::string serializeFunction(const Value &x) const = 0;
344
345 Value handleUnit(const xercesc::DOMElement *e, const Value &ret);
346
347 static std::map<std::string, std::string> units;
348
349 static std::map<std::string, std::function<std::shared_ptr<Eval>(std::vector<boost::filesystem::path>*)> >& getEvaluators();
350
351};
352
353// specializations
354template<> std::string Eval::cast<std::string>(const Value &value) const;
355template<> CodeString Eval::cast<CodeString>(const Value &value) const;
356template<> double Eval::cast<double>(const Value &value) const;
357template<> int Eval::cast<int>(const Value &value) const;
358template<> std::vector<double> Eval::cast<std::vector<double> >(const Value &value) const;
359template<> std::vector<std::vector<double> > Eval::cast<std::vector<std::vector<double> > >(const Value &value) const;
360
361// spezializations for create
362template<> Eval::Value Eval::create<double> (const double& v) const;
363template<> Eval::Value Eval::create<std::vector<double> > (const std::vector<double>& v) const;
364template<> Eval::Value Eval::create<std::vector<std::vector<double> > > (const std::vector<std::vector<double> >& v) const;
365template<> Eval::Value Eval::create<std::string> (const std::string& v) const;
366
367// spezializations for createSourceCode
368template<> std::string Eval::createSourceCode<double> (const double& v) const;
369template<> std::string Eval::createSourceCode<std::vector<double> > (const std::vector<double>& v) const;
370template<> std::string Eval::createSourceCode<std::vector<std::vector<double> > > (const std::vector<std::vector<double> >& v) const;
371template<> std::string Eval::createSourceCode<std::string> (const std::string& v) const;
372
373} // end namespace MBXMLUtils
374
375#endif
A dummy object representing a value as string in the syntax of the Eval (xmlflat).
Definition: eval.h:36
Definition: eval.h:77
std::string createSourceCode(const T &v) const
virtual std::string getName() const =0
Get the type of this evaluator.
ValueType
Definition: eval.h:83
void addParam(const std::string &paramName, const Value &value)
Add a value to the current parameters.
Definition: eval.cc:229
std::shared_ptr< void > Value
Typedef for a shared value.
Definition: eval.h:92
static std::shared_ptr< Eval > createEvaluator(const std::string &evalName, std::vector< boost::filesystem::path > *dependencies_=nullptr)
Create a evaluator.
Definition: eval.cc:116
virtual Value callFunction(const std::string &name, const std::vector< Value > &args) const =0
~Eval() override
Destructor.
T cast(const Value &value) const
void popContext()
Overwrite the current context with the top level context from the internal stack.
Definition: eval.cc:182
virtual Value createFunctionIndep(int dim) const =0
create a function independent variable. If dim == 0 a scalar is created else a vector.
virtual void convertIndex(Value &v, bool evalTo1Based)=0
virtual Value createFunctionDep(const std::vector< std::vector< Value > > &v) const =0
create a matrix function dependent
virtual std::map< boost::filesystem::path, std::pair< boost::filesystem::path, bool > > & requiredFiles() const =0
return a list of all required files of the evaluator (excluding dependent files of libraries)
void checkIfValueMatchesElement(const Value &value, const xercesc::DOMElement *e)
Check if the type of the value 'value' matches the type of DOMElement 'e'.
Definition: eval.cc:571
virtual std::string getStringRepresentation(const Value &x) const
Returns a evaluator specific string representation of x. This is only useful for display to the user.
Definition: eval.cc:713
static void setValue(xercesc::DOMElement *e, const Value &v)
Set value on DOMElement (is used by Eval::cast)
Definition: eval.cc:726
Value eval(const xercesc::DOMElement *e)
Value stringToValue(const std::string &str, const xercesc::DOMElement *e=nullptr, bool fullEval=true, bool skipRet=false) const
Definition: eval.cc:657
virtual void addImport(const std::string &code, const xercesc::DOMElement *e, const std::string &action="")=0
Value create(const T &v) const
virtual Value fullStringToValue(const std::string &str, const xercesc::DOMElement *e, bool skipRet=false) const =0
evaluate the string str using the current parameters and return the result.
void pushContext()
Push the current context to a internal stack.
Definition: eval.cc:177
void addParamSet(const xercesc::DOMElement *e)
Definition: eval.cc:233
virtual bool valueIsOfType(const Value &value, ValueType type) const =0
Value eval(const std::string &str, const xercesc::DOMElement *e=nullptr, bool skipRet=false)
virtual Value createFunctionDep(const std::vector< Value > &v) const =0
create a vector function dependent
virtual Value createFunction(const std::vector< Value > &indeps, const Value &dep) const =0
create a Function with n independents and a dependent function (scalar, vector or matrix)
std::string partialStringToString(const std::string &str, const xercesc::DOMElement *e) const
evaluate str partially and return result as an std::string
Definition: eval.cc:609
Eval(std::vector< boost::filesystem::path > *dependencies_)
Constructor.
Create a new parameter level for a evaluator which is automatically resetted if the scope of this obj...
Definition: eval.h:57
~NewParamLevel()
Reset to the previous parameter level.
Definition: eval.cc:91
NewParamLevel(std::shared_ptr< Eval > oe_, bool newLevel_=true)
Create a new parameter level in the evaluator oe_.
Definition: eval.h:42