Model debugging

= Debugging Macros =

Notes:
 * Debug file is located at $VLE_HOME/vle.log
 * Debug modes are cumulative. For example, if one uses mode 2, traces available at levels 0, 1 and 2 are printed into the log file.
 * DTrace* macros are removed when the compile mode Release is declared, on contrary of  Trace*  macros. To declare the compile mode Release use either :
 * in the CMake configuration :
 * As options of any compiler :

= Define the models to debug = It can be useful to identify which atomic models one wants to debug.

Usually, to declare a dynamics, the macro DECLARE_DYNAMICS should be added into the c++ code. Another solution is to use the macro associated to the extension (e.g. the macro DECLARE_DIFFERENCE_EQUATION_MULTIPLE).

In order to produce debug traces, the suffix "_DBG" has to be added. If the dynamics declaration is DECLARE_DYNAMICS_DBG, the all debug levels are available. On the other hand, if the dynamics declaration is DECLARE_DIFFERENCE_EQUATION_MULTIPLE_DBG, only debug traces at level 2, 1 and 0 are available.

= Examples =


 * Model developer can use the macros TraceModel in the c++ code.


 * Usage