Data Monitor¶
A multipurpose node to visualize, transform, and forward data. It can pass through incoming data, convert it to a specified type, evaluate simple formulas, and substitute auxiliary variables into text. When a passthrough value is connected, it previews the processed value for quick inspection.
Usage¶
Use this node to inspect intermediate values, convert data types, or compute simple expressions before passing data onward. Typical workflows include: previewing outputs from other nodes; converting strings to numbers/lists/JSON; evaluating a short expression in FORMULA mode; and templating text with %aux%, %aux2%, etc., sourced from auxiliary inputs.
Inputs¶
| Field | Required | Type | Description | Example |
|---|---|---|---|---|
| text | True | STRING | Base text to process when no passthrough is provided. Supports variable replacement using %aux%, %aux2%, %aux3%, %aux4%, and %aux5% (case-insensitive). | The value is %aux% units |
| output_type | True | CHOICE | Controls how the input is processed or converted. Options: ANY, STRING, INT, FLOAT, BOOLEAN, LIST, TUPLE, DICT, JSON, FORMULA. | JSON |
| passthrough | False | ANY | Optional data to visualize and forward. If provided, it is used as the primary input (with optional variable substitution if it is string-like). | [1, 2, 3] |
| aux | False | ANY | Auxiliary value used for variable substitution in text or passthrough via %aux%. | 42 |
| aux2 | False | ANY | Auxiliary value used for variable substitution via %aux2%. | 3.14 |
| aux3 | False | ANY | Auxiliary value used for variable substitution via %aux3%. | true |
| aux4 | False | ANY | Auxiliary value used for variable substitution via %aux4%. | {"key": "value"} |
| aux5 | False | ANY | Auxiliary value used for variable substitution via %aux5%. | [10, 20] |
Outputs¶
| Field | Type | Description | Example |
|---|---|---|---|
| output | ANY | The processed value after applying variable substitution and conversion as per output_type. If passthrough is connected, this is the transformed passthrough; otherwise, it is the transformed text. | {"a": 1} |
Important Notes¶
- • Passthrough takes precedence. If provided, it becomes the primary data source; otherwise the node processes the text input.
- • Variable replacement is case-insensitive and supports %aux%, %aux2%, %aux3%, %aux4%, and %aux5% when the source is string-like.
- • output_type behavior: ANY (forward as-is), STRING (str conversion), INT/FLT/BOOLEAN (numeric/boolean conversion), LIST/TUPLE/DICT (collection conversion), JSON (parse from JSON string), FORMULA (evaluate expression).
- • JSON requires valid JSON input; invalid JSON will cause processing errors.
- • FORMULA evaluates a Python expression derived from the input; use with caution and only on trusted content.
- • Some scalar results may be internally wrapped for display purposes; the actual output remains the converted value.
- • When passthrough is a tensor or a non-string object, variable substitution does not apply to the object itself; it is forwarded or converted according to output_type.
Troubleshooting¶
- • JSON parsing fails: Ensure the input is valid JSON (e.g., use double quotes and proper structure).
- • Type conversion errors (INT/FLOAT/BOOLEAN/LIST/TUPLE/DICT): Provide inputs compatible with the chosen type. For dictionaries, prefer JSON or an iterable of key-value pairs.
- • Unexpected TRUE for BOOLEAN: Non-empty strings evaluate to True; use exact "true"/"false" strings with JSON mode if you need strict booleans.
- • Formula errors or unsafe content: Verify your expression is valid and safe. Avoid untrusted inputs in FORMULA mode.
- • No visible substitution: Variable placeholders only replace when the source is string-like and matches %aux%, %aux2%, %aux3%, %aux4%, or %aux5% (case-insensitive).