Table

Store and edit tabular data in a spreadsheet-style grid.

What it does

Table stores rows and columns of values, typed directly into a spreadsheet-style grid or driven from upstream nodes. Each column has a type (number, text, boolean, colour, vector and so on), and each cell coerces whatever arrives to that column's type. Wire a collection into Input and the Table re-sizes and re-presents it in place of its own grid; leave Input disconnected and Row Count / Column Count control the grid edited by hand.

Individual cells and rows are also available as their own sockets, held inside the table widget rather than on the node body.

When to use it

ParameterTypeDefault
inputAny
column_countNumber3
row_countNumber4
transposeBooleanfalse
has_header_rowBooleanfalse
has_header_columnBooleanfalse

Gotchas

Per-cell and per-row sockets are not on the node body. Hover over a cell in the grid to reveal its socket, then wire a value into or out of that single cell instead of the whole table.

Column Count and Row Count are ignored whenever something is wired into Input; the table auto-sizes to match the incoming data. Disconnect Input for manual control over the grid size.

Has Header Row and Has Header Column change how the first row or column is styled and lock it from being edited as data. They do not remove or relabel that row or column, and they do not affect what downstream nodes see as the table's contents.

Worked example

  1. Add a Table node. Set Row Count and Column Count for the grid size required.

  2. Click into cells and type values directly: text, numbers, or whatever the column type expects.

  3. Enable Has Header Row if the first row should read as column labels rather than data.

  4. Hover over a single cell to reveal its socket, and wire a value in from another node to drive that cell live.

  5. Enable Transpose to work with what are currently columns laid out as rows.

See also

Value · Select · Lookup · Collections