Macro Output (Boundary)
Shippingmacro_outCompound-node output boundary: surfaces one outer output port from a custom subsystem
Signature
Inputs
valueAnyrequired— The inner-graph value to expose on the compound's outer output port (an unwired macro_out is a structural bug and fails loudly).
Outputs
valueAny— Identity passthrough of the input, mapped onto the compound's outer output port after the sub-run.
Parameters
| Key | Type | Default | Notes |
|---|---|---|---|
name | text | out | The output port this node exposes on the parent compound node. |
port_type | enum | one of: , Signal, Float, Integer, Boolean, String, Vector, Matrix, Color, Bundle, Image | |
order | int | 0 | Display order of the exposed port on the compound node. |
Description
Macro Output is a compound node's output boundary bridge. Placed inside a custom (compound) node's internal graph, it surfaces one outer output port named by its name param: whatever the inner graph wires into its value input is re-emitted on its value output, and the recursive executor maps that onto the compound's outer (node, name) port after the sub-run. It is a pure identity passthrough that works in any value domain.
Crucially the passthrough also carries the affine-uncertainty lineage, not just the value and variance — so an uncertain quantity keeps its per-source correlations as it leaves the compound, and downstream nodes don't re-treat it as a fresh, decorrelated source. The value input is required: an unwired macro_out is a structural bug in the custom node and fails the run loudly instead of silently emitting nothing.
This is a structural subsystem-boundary port, not a signal-processing node; it is only used while authoring custom nodes.
Applications
- Exposing a named, typed output on a custom (compound) node.
- Returning a result from a subsystem's inner graph to its parent while preserving uncertainty correlations across the boundary.
Neat
The boundary forwards the input's affine lineage onto its output, so correlated uncertainties survive the compound boundary instead of re-entering downstream as a fresh decorrelated source.
The required `value` input turns a forgotten wire into a loud structural error rather than a silent empty output.