Flow, display and utilities

Loops and conditionals, debug and display nodes, sticky notes and subsystems.

10 nodes. Right-click any node in the editor to read this documentation in the app.

Annotation

📝 Sticky Note

id sticky_note · Annotation · Python export: yes

A note for the canvas: write comments, instructions or TODOs next to the nodes they describe. It has no inputs or outputs and does nothing when the workflow runs. The text is saved with the workflow and appears as # comments in the Python export. Drag it by its header; drag the note's bottom-right corner to resize it (the size is saved with the workflow too).

Fields

Field	Type	Default	Choices
Note	textarea

Control Flow

🔚 End For Loop

id end_forloop · Control Flow · Python export: yes

End of a loop body. Closes the loop started by For Loop and passes on the last iteration's value to nodes after the loop.

Inputs

Port	Type	Description
in	Any	Value produced by the loop body.

Outputs

Port	Type	Description
out	Any	The body value from the final iteration.

🔁 For Loop

id forloop · Control Flow · Python export: yes

Start of a loop. Runs everything between this node and its End For Loop once per item in the wired-in sequence; the output is the current item.

Inputs

Port	Type	Description
values	list	Sequence to iterate over (e.g. a List node).

Outputs

Port	Type	Description
value	Any	The current iteration's item.

Debug

ℹ️ Dataset Info

id dataset_info · Debug · Python export: yes

Diagnostic passthrough: shows the type, shape and length of whatever is wired in, and forwards the value unchanged.

Inputs

Port	Type	Description
value	Any	Any value to inspect.

Outputs

Port	Type	Description
value	Any	The input, unchanged.

🖨️ Print / Debug

id print_debug · Debug · Python export: yes

Show whatever is wired in as a preview on the node (tables, arrays, lists, dicts, scalars) and print a one-line summary to the log. The value is passed through unchanged, so it can sit in the middle of a chain.

Inputs

Port	Type	Description
multi_input	Any	Any value to display.

Outputs

Port	Type	Description
value	Any	The input value, unchanged.

Display

🎛️ Dashboard Parameter

id dashboard_parameter · Display · Python export: yes

A value the viewer of an exported dashboard can change. Here in the editor it simply emits its Default; in the exported dashboard it becomes a control (a slider or number box, text box, checkbox or drop-down depending on Type), and pressing Recalculate re-runs the workflow with the value they picked. Name is the key the dashboard uses and must be unique and a valid identifier (letters, digits, underscore); Label is the text shown next to the control. Type is float, int, str, bool or select. Min, Max and Step (numbers only; leave blank for none) bound the control and are enforced on the backend. Options (select only) is a comma-separated list, and the Default must be one of them.

Outputs

Port	Type	Description
value	Any	The parameter's value: the viewer's choice on a dashboard recalculation, else the default.

Fields

Field	Type	Default	Choices
Name	text	param
Label (shown on the dashboard)	text
Type	select	float	float, int, str, bool, select
Default	text	0
Min (numbers; blank = none)	text
Max (numbers; blank = none)	text
Step (numbers; blank = none)	text
Options (select; comma-separated)	text

🔢 KPI Tile

id kpi_value · Display · Python export: yes

Show a single wired-in number as a big-number tile (label + value + optional unit) — the dashboard-panel equivalent of a scorecard. The value passes through unchanged.

Inputs

Port	Type	Description
value	Any	The numeric value to display.

Outputs

Port	Type	Description
value	Any	The input value, unchanged.

Fields

Field	Type	Default	Choices
Label	text
Unit (suffix)	text
Decimal places	int	2

Subsystem

🧩 Run Subsystem

id run_subgraph · Subsystem · Python export: yes

Run another .weave file from this project as a subsystem. Its inputs are the file's Subsystem Argument nodes and its outputs are its Subsystem Return nodes; the file on disk is what runs (not unsaved edits in an open tab). The optional args_dict input passes {argument name: value} pairs and overrides wired arguments of the same name.

Inputs

Port	Type	Description
args_dict	dict	Optional {argument name: value} overrides.

Outputs

Port	Type	Description
returns	Any	The subsystem's Return values (one port per Return, in Order).

Fields

Field	Type	Default	Choices
Subsystem file	subsystem_file

📥 Subsystem Argument

id subsystem_input · Subsystem · Python export: yes

An input of this .weave when another workflow runs it as a subsystem (Run Subsystem node). Emits the value the caller passed for its Name; when the file is run on its own it emits its Default instead, so the workflow stays testable standalone. Order sets the port order on the calling node (lowest first).

Outputs

Port	Type	Description
value	Any	The argument's value: passed by the caller, else the default.

Fields

Field	Type	Default	Choices
Name	text	arg
Order	int	1
Type	select	any	any, int, float, str, bool, list, dict
Default	text

📤 Subsystem Return

id subsystem_output · Subsystem · Python export: yes

An output of this .weave when another workflow runs it as a subsystem. Whatever is wired in becomes the value the caller receives on the port named Name; Order sets the port order on the calling node (lowest first). Also previews the value when the file is run on its own.

Inputs

Port	Type	Description
value	Any	The value to return to the caller.

Outputs

Port	Type	Description
value	Any	The same value, passed through.

Fields

Field	Type	Default	Choices
Name	text	result
Order	int	1
Type	select	any	any, int, float, str, bool, list, dict