You can define Macros that can be used the same way as builtin functions allowing you to provide specialized capabilities that can be created once and then used multiple times. For example, you can create variations of the built in delay and smooth functions such as a second or fourth order material delay.
Macros are defined using modules (see Working with Modules) where there is only a single output coming from the module. Most of the creation work in macros is, thus, just standard modeling work, with some additional information needed to define the arguments that the macros take and identify the output.
Because macros are defined in this way when you make a change to the definitions, that change will be applied everywhere the macro is used. This effectively allows you to set up specialized logic for combining different inputs and then change that logic globally without having to look for each place it was used (as you would need to do if the logic were repeated in different places within the model).
Macros are associated with models, though there is functionality that makes it easy to bring macros in from other models so that it is straightforward to create a library of macros that can be used with multiple models. Creating, importing, and exporting macros is done using the Macro Manager dialog. You can also start editing a macro by right clicking on the name of the macro and selecting Jump to Definition (in the Equation Tab of the properties panel for a variable using the macro). When you do this Picture in Picture Module Viewing will be enabled for the macro and you can look at the macro structure and click on the Go button to edit it.
Note Stella supports equation only macros with no defined stock and flow structure, but you will not be able to edit these in Stella, instead you will need to edit the mode file directly.
Most of the work in creating macros is the same as it is for creating model components. The specification of the inputs and the output is done on the Macro Settings Tab.
Macros are used in equations the same way that the builtins are used. In the Equation Tab for a variable you can type in the name of the macro or select it from the list of Builtins (User Macro is one type that can be used to filter this list). As you begin to type the name auto-complete will list the macro names that match. When you hover over the name of the macro it will list the arguments that the macro takes, with optional arguments identified by square brackets [].
If the macro does not take any arguments (or all of its arguments are optional and you are not using any arguments) the name should appear without any parenthesis (as PI and DT do). Otherwise the name should appear with a comma (or semicolon if you are using , as a decimal) separated list of arguments.
If you hover over the name of the macro it will display the arguments. These argument names are the names that you set for the variables when defining the macro.
Macros can, of course, have errors in them and these errors are treated like other model errors. They will be included in the list of errors shown on the dropdown in the lower right of the model window. Clicking on one will then open the macro for editing so that you can fix the errors. The errors can be in model equations, and these are fixed the same way that all more errors are fixed, or there can be errors in the macro arguments and output. The latter errors will display on the Macro Settings Tab of the properties panel.
Macro errors will prevent a model from simulating, even when the macro is not used. Once the macro error are corrected you will be able to simulate the model. Use the dropdown error list to find and fix the errors.
Macro names follow the same rules as other variable names, but there are some naming conventions that will make it easier to work with them.
You can use macros in a macro definition, and there is no limit on the depth of such nesting (that is you can define a macro with a macro that depends on another macro and so on).
Recursion, on the other hand, is not supported. If you use a macro in its own definitions, or if you use a macro that depends on the macro you are defining, you will get an error message.
To see an example of creating and using a macro look at Macro Example.