You are viewing the RapidMiner Studio documentation for version 9.2 -Check here for latest version
Macros
宏是什么?
A macro is a key–value pair that is only available during the process execution. Predefined macros contain context related information like the current iteration of a loop or the process name. Macros can be defined during runtime with theSet Macros,Generate MacrosorExtract Macrooperator, and used in nearly every operator parameter field. It is also possible to define static macros in theContext Panel(View➟Show Panel➟Context).
Debugging Macros
User defined macros can be watched with theMacros Panel(View➟Show Panel➟Macros). In this panel the current values of the macros are displayed. Use breakpoints before and after you set the macro to see the change.
List of predefined Macros
Process Macros
| Macro | Value | Description |
|---|---|---|
| %{process_name} | 02_LinearRegression | current process name |
| %{process_file} | 02_LinearRegression.rmp 02_LinearRegression |
process file name (opened as file) process name (opened from repository) |
| %{process_path} | C:\02_LinearRegression.rmp //Repo/02_LinearRegression |
file path (opened as file) repository path (opened from repository) |
| %{process_start} | 2017_12_24-PM_00_01_25 | process start date and time |
| %{t} | 2017_12_24-PM_00_01_30 | current date and time |
For higher accuracy requirements use thedate_now()function instead of%{t}.
Operator Macros
| Macro | Value | Description |
|---|---|---|
| %{execution_count} %{a} |
1 | number of times the current operator is executed |
| %{b} | 2 | execution_count + 1 |
| %{operator_name} %{n} |
Generate Data | (user given) name of the current operator |
| %{c} | com.rapidminer.GenerateData | package and class of the current operator |
Operators likeLoop, orHandle Exceptionprovide additional macros.
Macros and functions
Parsing Numbers
We've seen before that%{b}returns execution_count + 1, but what if we need execution_count - 1?
This can be achieved with the function expressionparse(%{execution_count})-1for theGenerate Macrooperator.
Parsing Dates
To parse a date macro into a date we can usedate_parse_custom(%{process_start},"yyyy_MM_dd-a_KK_mm_ss"). A table of all pattern letters can be found underSimpleDateFormat.
Evaluating Macros
It is possible to store an expression as an nominal value with theSet Macrosoperator and execute it afterwards with theeval(%{macro})function. Please be aware that theevalfunction, like all other functions, is only available for selected operators. To use the evaluated macro value in every field, use theGenerate Macrooperator beforehand and store the result of the evaluation in a new macro.
