Roi

class glue.core.roi.Roi

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()

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

contains(x, y)

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)

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()

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=None, yfunc=None)

A transformed version of the ROI