Header-level declarations define the global properties and settings for a model, including constants, properties, and external values that set up the foundation of the CML code.
Use these declarations to create reusable components and configuration settings that you can reference throughout the model.
Use global constants to define values that remain fixed throughout the model. These constants can be numeric values, strings, lists, or other supported data types. Use constants to create standardized settings or options that you can reference multiple times. See Example 1: Use Regex Global Variable.
In the example, MAX_COUNT is a global constant that is hard-coded to 100: define MAX_COUNT 100.
Regex (regular expressions) can be used to define global constants. The generalized abstract syntax structure for regex expressions is define <CONSTANT_NAME> "^<REGEX_PATTERN_STRING>$".
This table lists regex components and their details.
| Regex Component | Description | Generalization |
|---|---|---|
| ^ and $ | Anchors that ensure the pattern matches the entire string, from the beginning (^) to the end ($). | Ensures strict adherence to the required format. |
| () | Capturing Groups used to isolate portions of the matched string. You can reference the captured parts later by using $1, $2, and so on, in functions such as regexpreplace. See String Variable Functions and Operators. | Allows extraction of specific data fields from a string. |
| + | Character Class and Quantifier that matches one or more (+) digits or characters. | Defines the permitted characters and minimum occurrences for the data fields. |
| / | Literal Character matching the forward slash separator present in the input data. | Matches fixed delimiters in the input string. |
In the example, VOLTAGE_REGEX is a global constant that defines a fixed regular expression pattern used for validation or parsing throughout the model define VOLTAGE_REGEX "^([0-9]+)/([0-9]+)$".
For more on the usage of global properties, see External Variables.
j
