Select

Select a value from multiple inputs based on a condition.

What it does

Select pulls a piece of data out of a table, a list, or a piece of geometry. A table reads out as rows, columns, a rectangular range, or individual cells. A list reads out as entries by index. Geometry selects points, edges or faces instead, writing that selection back onto the geometry as a group other nodes use as a mask: a transform, an attribute edit, a physics pin, anywhere a "which elements" input is needed.

An optional Modifier input picks again from whatever Select has extracted, by index or by key, so "get this column, then get this one entry from it" needs no second node.

When to use it

ParameterTypeDefault
dataAny
modeString"Rows"
rowString"0"
columnString"0"
cellsString""
selectionString"[]"
group_nameString"selected"
xrayBooleanfalse
radiusNumber0
falloffString"Smooth"
modifierOneOf([Number, String, IntArray])

Gotchas

Row, Column, Cells and the geometry Selection field each accept either a single value or an array of them (["a","b"] or [0,2]) for a multi-select. A bare value still works for a single pick.

Raise the soft-select Radius above 0 to grade neighbouring points by falloff distance instead of a hard 1/0 pick. At Radius 0, the default, the selection is hard.

Selecting Points, Edges or Primitives removes nothing from the geometry. It writes a selection group, a weighted attribute named selected by default, onto the output. The geometry passes through unchanged; downstream nodes read the attribute as a mask.

X-Ray only affects picking through occluding geometry when clicking to select in the viewport. It has no effect on a selection typed or wired in directly.

Worked example

  1. Add a Select node and wire a table into Data.

  2. Set Mode to Columns and type a column name into Column to pull out that column as a plain list of values.

  3. Switch Mode to Rows and set Row to ["0","2"] to grab two specific rows instead.

  4. Wire a number into Modifier to pick a single entry out of the extracted column or row.

  5. For geometry, wire a mesh into Data, set Mode to Points, and drive Selection from the viewport or a value. The picked points come out with a selected group ready to mask a Transform.

See also

Lookup · Filter · Attribute Reader · Table