About cookies on this site Our websites require some cookies to function properly (required). In addition, other cookies may be used with your consent to analyze site usage, improve the user experience and for advertising. For more information, please review your options. By visiting our website, you agree to our processing of information as described in IBM’sprivacy statement. To provide a smooth navigation, your cookie preferences will be shared across the IBM web domains listed here.
qiskit.visualization.plot_bloch_vector
qiskit.visualization.plot_bloch_vector(bloch, title='', ax=None, figsize=None, coord_type='cartesian', font_size=None)
Plot the Bloch sphere.
Plot a Bloch sphere with the specified coordinates, that can be given in both cartesian and spherical systems.
Parameters
- bloch (list[double]) – array of three elements where [<x>, <y>, <z>] (Cartesian) or [<r>, <theta>, <phi>] (spherical in radians) <theta> is inclination angle from +z direction <phi> is azimuth from +x direction
- title (str) – a string that represents the plot title
- ax (matplotlib.axes.Axes) – An Axes to use for rendering the bloch sphere
- figsize (tuple) – Figure size in inches. Has no effect is passing
ax
. - coord_type (str) – a string that specifies coordinate type for bloch (Cartesian or spherical), default is Cartesian
- font_size (float) – Font size.
Returns
A matplotlib figure instance if ax = None
.
Return type
Raises
MissingOptionalLibraryError – Requires matplotlib.
Examples
from qiskit.visualization import plot_bloch_vector
plot_bloch_vector([0,1,0], title="New Bloch Sphere")

import numpy as np
from qiskit.visualization import plot_bloch_vector
# You can use spherical coordinates instead of cartesian.
plot_bloch_vector([1, np.pi/2, np.pi/3], coord_type='spherical')

Was this page helpful?
Report a bug or request content on GitHub.