Plot
Project bound attributes onto Cartesian, Polar, Cylindrical, or Spherical axes to set absolute position. The dual of Sample.
What it does
Plot sets the absolute position of points, geometry, or a collection by projecting chosen attributes onto coordinate axes. Pick a Coordinate System, Cartesian, Polar, Cylindrical, or Spherical, and bind an attribute to Axis A, B, and/or C. Each bound attribute is read per element and turned into a position under that system. An unbound axis sits at that axis's centre.
Each axis has its own Domain: Auto fits the axis to the attribute's real range, Manual takes a fixed [min, max], and Normalized assumes the attribute already sits in 0–1. Scale sizes the whole result in world units. Plot only sets where things land. It never offsets them and never creates new elements.
When to use it
Laying out points or copies by an attribute instead of by hand: colour by hue, rank by an ID, cluster by a group value.
A colour-solid style layout: hue, luminance and saturation bound to Azimuth, Polar-angle and Radius under Spherical.
A circular, ring, or drum-style arrangement: Polar or Cylindrical rather than Cartesian.
A chart or plot from data attributes, where each element's position comes directly from its values.
| Parameter | Type | Default |
|---|---|---|
input | OneOf([Collection]) | — |
mask | String | "" |
coordinate_system | String | "Cartesian" |
axis_a_attr | String | "" |
axis_a_domain | String | "Auto" |
axis_a_domain_range | Vec2 | (0, 1) |
axis_b_attr | String | "" |
axis_b_domain | String | "Auto" |
axis_b_domain_range | Vec2 | (0, 1) |
axis_c_attr | String | "" |
axis_c_domain | String | "Auto" |
axis_c_domain_range | Vec2 | (0, 1) |
scale | Number | 1 |
strength | Number | 1 |
Gotchas
Mask names a selection weight attribute, the same one Select writes. Leave it empty and the whole input is projected. Name a selection and only those elements move; a partly selected element travels partway to its plotted position, so a soft selection gives you a partial plot. Name an attribute the input does not carry and nothing moves at all, rather than everything moving.
Leaving an axis's attribute empty does not error: that axis sits at its neutral centre, the middle of a Cartesian axis or the origin for a radius or angle. This is how Plot collapses to fewer active axes, for example Polar, which uses A and B only, leaving Axis C unused.
Auto domain fits each axis to the live min and max of the bound attribute across every element, with no separate node needed to find the range first. Switch to Manual for a fixed range that will not shift as the data changes.
If every element shares the same attribute value, an Auto or Manual axis with min == max would divide by zero. That axis is collapsed to its centre instead of producing garbage positions.
Worked example
Add a Plot node and wire in a Collection of points that carry a numeric attribute, e.g.
idorweight.Set Coordinate System to Spherical for a colour-solid style layout.
Bind Axis A to
hue, Axis B toluminance, and Axis C tosaturation, leaving their Domains on Auto to start.Raise Scale until the layout fills the scene at the size you want.