Roi

class glue.core.roi.Roi[source]

Bases: object

A geometrical 2D region of interest.

Glue uses Roi’s to represent user-drawn regions on plots. There are many specific sub-classes of Roi, but they all have a contains method to test whether a collection of 2D points lies inside the region.

Methods Summary

center()

Return the (x,y) coordinates of the ROI center

contains(x, y)

Return true/false for each x/y pair.

contains3d(x, y, z)

Return true/false for each x/y/z pair.

copy()

Return a clone of the ROI

defined()

Returns whether or not the subset is properly defined

move_to(x, y)

Translate the ROI to a center of (x, y)

to_polygon()

Returns a tuple of x and y points, approximating the ROI as a polygon.

transformed([xfunc, yfunc])

A transformed version of the ROI

Methods Documentation

center()[source]

Return the (x,y) coordinates of the ROI center

contains(x, y)[source]

Return true/false for each x/y pair.

Parameters
  • x – Array of X locations

  • y – Array of Y locations

Returns

A Boolean array, where each element is True if the corresponding (x,y) tuple is inside the Roi.

Raises

UndefinedROI exception if not defined

contains3d(x, y, z)[source]

Return true/false for each x/y/z pair.

Parameters
xnumpy.ndarray

Array of x locations

ynumpy.ndarray

Array of y locations

znumpy.ndarray

Array of z locations

Returns
numpy.ndarray

A boolean array, where each element is True if the corresponding (x,y,z) tuple is inside the Roi.

Raises
UndefinedROI

if not defined

copy()[source]

Return a clone of the ROI

defined()[source]

Returns whether or not the subset is properly defined

move_to(x, y)[source]

Translate the ROI to a center of (x, y)

to_polygon()[source]

Returns a tuple of x and y points, approximating the ROI as a polygon.

transformed(xfunc=None, yfunc=None)[source]

A transformed version of the ROI