PlotCanvas

class PlotCanvas(*args: Any, **kwargs: Any)

Main Plot canvas widget.

This class extends the FigureCanvas class.

Access with:

canvas = gui.canvas

Parameters:

• design (QDesign) – The design.

• parent (QMainWindowPlot) – The main window. Defaults to None.

• logger (logging.Logger) – The logger. Defaults to None.

• statusbar_label (str) – Statusbar label. Defaults to None.

Methods

__call__(*args: Any, **kwargs: Any) → Any

Call self as a function.

__getitem__(key: Any) → _MockObject

__len__() → int

auto_scale()

Automaticlaly scale.

clear_annotation()

Clear the annotations.

Raises:

Exception – Error while clearing the annotations

clear_axis(ax: Axes = None)

Clear an axis or clear all axes.

Parameters:

ax (plt.Axes) – Clear an axis, or if None, then clear all axes. Defaults to None.

debug_axis_config(ax=None)

Print axis configuration for debugging.

find_component_bounds(components: List[str], zoom: float = 1.2)

Find bounds of a set of components.

Parameters:

• components (List[str]) – A list of component names

• zoom (float) – Fraction to expand the bounding vbox by

Returns:

List of x,y coordinates defining the bounding box

Return type:

List

get_axis()

Gets the current axis.

highlight_components(component_names: List[str])

Highlight a list of components.

Parameters:

component_names (List[str]) – A list of component names

plot(clear=True, with_try=True)

Render the plot.

Parameters:

• clear (bool) – True to clear everything first. Defaults to True.

• with_try (bool) – True to execute in a try-catch block. Defaults to True.

Raises:

Exception – Plotting error

refresh()

Force refresh.

Does not replot renderer. Just mpl refresh.

set_component(name: str)

Shortcut to set a component in the component widget to be examined.

Parameters:

name (str) – Name of the component in the design

set_design(design: QDesign)

Set the design.

Parameters:

design (QDesign) – the design

setup_figure_and_axes()

Main setup from scratch.

setup_rendering()

Line segment simplificatio: For plots that have line segments (e.g. typical line plots, outlines of polygons, etc.), rendering performance can be controlled by the path.simplify and path.simplify_threshold.

path_simplify:

When True, simplify paths by removing “invisible” points to reduce file size and increase rendering speed

path_simplify_threshold:

The threshold of similarity below which vertices will be removed in the simplification process

chuncksize:

0 to disable; values in the range 10000 to 100000 can improve speed slightly and prevent an Agg rendering failure when plotting very large data sets, especially if they are very gappy. It may cause minor artifacts, though. A value of 20000 is probably a good starting point.

https://matplotlib.org/3.1.1/tutorials/introductory/usage.html

style_axis(ax, num: int)

Style the axis.

Parameters:

• ax (axis) – The axis

• num (int) – Not used

style_figure()

Style a figure.

welcome_message()

The GUI displays a message to let users know they are using Qiskit Metal.

zoom_to_rectangle(bounds: tuple, ax: Axes = None)

Zoom to the specified rectangle.

Parameters:

• bounds (tuple) – Tuple containing minx, miny, maxx, maxy values for the bounds of the series as a whole.

• ax (Axes) – Does for all if none (default: {None})