Sample Overlap Stats

PCGEx | Sample : Overlap Stats

Compute overlap statistics between point collections

The Sample Overlap Stats node computes overlap statistics between point collections, providing per-point and per-collection overlap data such as count, sub-count, and relative measures, with optional tagging for overlap detection.

Point collections to be checked against each other

Point Filters

Points filters used to determine which points will be processed. Filtered out points will be treated as not overlapping.

Out

In with extra attributes and properties

The Sample Overlap Stats is designed to extract per-point overlap data between entire collections. It is a bit of a special node, in the sense that it works cross-inputs.
It is primarily designed for PCGDataAsset workflows, to check overlaps against external points.

details/sampling-overlap-stats/lead.png

Properties

Property	Description
Settings
Bounds Source	Which point bounds to use.
Min Threshold	Minimum overlap threhsold required for an overlap to be registered.
Threshold Measure	Let you pick how the overlap threshold is measured. Either as a `Relative` measure (in which case the Min Threhsold is treated as an overlap percentage), or a fixed, `Discrete` penetration measurement, in which case the threshold is treated as world units.

Outputs

Outputs are a mix of per-collection & per-point overlap data.

Output	Description
Overlap Count `int32`	This represents the number of other input collection that have a registered overlap with this point.
Overlap Sub Count `int32`	This represents the number of other individual points that have a registered overlap with this point, all inputs combined. Depending on your data, this number can be very high.
Relative Overlap Count `double`	This is the same as `Overlap Count`, but normalized against the maximum value found during initial processing.
Relative Overlap SubCount `double`	This is the same as `Overlap Sub Count`, but normalized against the maximum value found during initial processing.

Tagging

Some high level tags may be applied to the data based on overlap sampling. This comes very handy to optimize further operations only on overlapping elements, especially if you intend to pair this node with .

Tag	Description
Has Any Overlap	If enabled, add the specified tag to the output data if at least a single overlap has been found.
Has No OVerlap	If enabled, add the specified tag to the output data if no overlap has been found.

Note that overlap/no-overlap tagging will be affected by points filter as well; since filtered out points are considered fails.