Relax Points

Applies Lloyd relaxation to a set of points inside an area.

Node id tessellation/relax-points

The Relax Points node applies Lloyd relaxation to a collection of points inside an area. In each iteration, every point that produces a Voronoi cell moves to the area centroid of its cell. This evens out point distributions into more uniform, honeycomb-like arrangements.

Inputs

NameTypeDefaultNotes
pointsArray<Point>—
areaBoundingBox—
iterationsnumber1

Outputs

NameTypeNotes
pointsArray<Point>

Behaviour

  • Iterations. iterations (default 1) controls how many relaxation steps to perform. Setting iterations to 0 returns the input points unchanged. Higher numbers make cell sizes and point spacings progressively more uniform.
  • Outside points. Points outside the area that produce a cell move to its clipped centroid, which brings them inside the area.
  • Duplicate and skipped points. Points that produce no cell or are exact duplicates stay at their current position. Output order and length always match the input points.

Errors

  • area must be connected (for example from Make BoundingBox or Page).
  • iterations must be an integer between 0 and 100.
  • Non-finite coordinates in area or in any point of points are node errors.
  • Providing more than 10 000 points is a node error.

Example

Voronoi cells before and after Lloyd relaxation.

Voronoi cells before and after Lloyd relaxationOpen in Playground
© 2026 Wirepaint