PyNutil.results.PointSetResult#

class PyNutil.results.PointSetResult(points, labels, hemi_labels, section_lengths, point_values=None, undamaged_mask=None, orientation='lpi', atlas_shape=None)[source]#

A reusable point-set payload shared across extraction workflows.

points#

Atlas-space coordinates (N x 3).

labels#

Region labels aligned with points.

hemi_labels#

Hemisphere labels aligned with points.

section_lengths#

Per-section counts aligned with canonical arrays.

point_values#

Optional values aligned with points (e.g., intensity/RGB).

undamaged_mask#

Optional unfiltered undamaged mask.

orientation#

3-letter BrainGlobe orientation string describing the coordinate system of points (e.g. “lpi”, “asr”).

atlas_shape#

Shape of the atlas volume in internal orientation, needed for reorienting points between coordinate systems.

filtered_hemi_labels()[source]#

Return hemisphere labels filtered by undamaged mask when available.

Return type:

Optional[ndarray]

filtered_labels()[source]#

Return labels filtered by undamaged mask when available.

Return type:

Optional[ndarray]

filtered_point_values()[source]#

Return point values filtered by undamaged mask when available.

Return type:

Optional[ndarray]

filtered_points()[source]#

Return points filtered by undamaged mask when available.

Return type:

Optional[ndarray]

filtered_section_lengths()[source]#

Return per-section lengths after applying undamaged mask.

Return type:

List[int]

points_in_internal_orientation(pts)[source]#

Reorient pts back to internal orientation if needed.

Parameters:

pts (Optional[ndarray]) – (N, 3) array of points in self.orientation.

Return type:

Optional[ndarray]

Returns:

(N, 3) array of points in internal orientation.