itom.plot

itom.plot(data[, className, properties]) → plots a dataObject, pointCloud or polygonMesh in a new figure

Plots an existing dataObject, pointCloud or polygonMesh in a dockable, not blocking window. The style of the plot depends on the object dimensions.

If no ‘className’ is given, the type of the plot is chosen depending on the type and the size of the object. The defaults for several plot classes can be adjusted in the property dialog of itom.

You can also set a class name of your preferred plot plugin (see also property dialog of itom). If your preffered plot is not able to display the given object, a warning is returned and the default plot type is used again. For dataObjects, it is also possible to simply set ‘className’ to ‘1D’, ‘2D’ or ‘2.5D’ in order to choose the default plot type depending on these aliases. For pointCloud and polygonMesh only the alias ‘2.5D’ is valid.

Every plot has several properties that can be configured in the Qt Designer (if the plot is embedded in a GUI), or by the property toolbox in the plot itself or by using the info() method of the corresponding itom.uiItem instance.

Use the ‘properties’ argument to pass a dictionary with properties you want to set to a certain value.

Parameters:

data : {DataObject, PointCloud, PolygonMesh}

Is the data object whose region of interest will be plotted.

className : {str}, optional

class name of desired plot (if not indicated or if the className can not be found, the default plot will be used (see application settings))

Depending on the object, you can also use ‘1D’, ‘2D’ or ‘2.5D’ for displaying the object in the default plot of the indicated categories.

properties : {dict}, optional

optional dictionary of properties that will be directly applied to the plot widget.

Returns:

index : {int}

This index is the figure index of the plot figure that is opened by this command. Use figure(index) to get a reference to the figure window of this plot. The plot can be closed by ‘close(index)’.

plotHandle: {plotItem} :

Handle of the plot. This handle is used to control the properties of the plot, connect to its signals or call slots of the plot.

See also

liveImage, plotItem