> tools

Measure

tools/measure·v1.5.1

IN:1 OUT:1

SUMMARY

Measure computes a value per point from its neighbors: density, surface variation, mean curvature, curvedness, or the gradient of a scalar attribute. Scalar results are normalized to 0 to 1 over the group and written to an attribute named after the measure, while the gradient keeps its direction; the curvature measures read N.

Neighbors are found by distance or connectivity up to Max Neighbors, or reused from a previous Measure through Output Neighbors Attributes, and Smoothing Radius sets the kernel size. Preview Measure colors the points through a heatmap, blackbody, infrared or custom ramp so the result can be checked before it drives other operators.

PARAMETERS

PAGEMeasure

Group	Group	If there are input groups, specifying a group name in this field will cause this POP to act only upon the group specified.
[+]Measure	Measure	Determines what is measured: Density, Surface Variation, Mean Curvature, Curvedness or Gradient.
Scalar Attribute	Scalarattr	Sets the scalar attribute used by the Gradient measure.
Use Existing Neighbors Attributes	Usenebrsattr	Whether to reuse the neighbor attributes of a previous Measure instead of recomputing them.
[+]Neighbors Type	Nebrtype	When checking for neighbors, choose to use edge connectivity or only distance to neighbor points.
Max Neighbors Distance	Maxdistance	Specifies the distance below which a point is considered a neighbor of the current point.
[+]Distribution	Distribution	Determines how neighbors are selected: Default, Unique, Closest or Random.
Max Neighbors	Maxneighbors	Maximum number of neighbors per point.
Smoothing Radius	Smoothingradius	Radius used to smooth the measured values.
Output Neighbors Attributes	Outputneighborsattrs	Whether to output the neighbor attributes for reuse by a later Measure.

PAGEPreview Measure

Preview Measure	Previewmeasure	Enable coloring the points by the measured value.
[+]Measure Ramp	Measureramp	Selects the preview color ramp: Heatmap, Blackbody, Infrared or Custom.
Open Custom Ramp Editor	Opencustomrampeditor	Open the editor of the custom preview ramp.
Reset Custom Ramp	Resetcustomramp	Resets the custom preview ramp.

PAGECommon

Bypass	Bypass	Pass through the first input to the output unchanged.
Free Extra GPU Memory	Freeextragpumem	Free memory that has accumulated when output memory has grown and shrunk.
Render Primitives	Renderprimitives	Whether to render the full POPX geometry. When off, only point instances are drawn.
Convert to Point Primitives	Converttoptprim	Enable converting points to point primitives when Render Primitives is off.
SRT / RST	Srtrst	Sets the transform order, SRT or RST, used when the points are rendered as TouchDesigner instances.

INPUTS

Input 0 POP - POPX/POP Geometry

OUTPUTS

Output 0 POP - POPX/POP Geometry