9.9. plotItem

class itom.plotItem(figure, subplotIdx=0 | figure, objectID=0 | uiItem) → instance of the plot or subplot of a figure.

Bases: itom.uiItem

Use can use this constructor to access any plot or subplot (if more than one plot) of a figure. The subplotIndex row-wisely addresses the subplots, beginning with 0.

As second possibility, the constructor can be used to cast ‘uiItem’ to ‘plotItem’ in order to access methods like ‘pickPoints’ or ‘drawAndPickElement’.

Parameters

figure : {???}

subplotIdx: {???} :

drawAndPickElements(elementType, maxNrElements = -1) -> method to let the user draw geometric elements on a plot (only if plot supports this)

This method lets the user select one or multiple elements of type (up to maxNrElements) at the current plot (if the plot supports this).

Parameters

elementType : {int}

The element type to plot according to ito::PrimitiveContainer::tPrimitive.

maxNrElements: {int}, optional :

let the user select up to this number of points [default: infinity]. Selection can be stopped pressing Space or Esc.

pickPoints(points, maxNrPoints = -1) -> method to let the user pick points on a plot (only if plot supports this)

This method lets the user select one or multiple points (up to maxNrPoints) at the current plot (if the plot supports this).

Parameters

points : {DataObject}

resulting data object containing the 2D positions of the selected points [2 x nrOfSelectedPoints].

maxNrPoints: {int}, optional :

let the user select up to this number of points [default: infinity]. Selection can be stopped pressing Space or Esc.