---
title: plot_bloch_vector (v1.0)
description: API reference for qiskit.visualization.plot_bloch_vector in qiskit v1.0
source: https://eu-de.quantum.cloud.ibm.com/docs/en/api/qiskit/1.0/qiskit.visualization.plot_bloch_vector
---

# qiskit.visualization.plot\_bloch\_vector

`qiskit.visualization.plot_bloch_vector(bloch, title='', ax=None, figsize=None, coord_type='cartesian', font_size=None)`

[GitHub](https://github.com/Qiskit/qiskit/tree/stable/1.0/qiskit/utils/lazy_tester.py#L186-L250)

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*](https://docs.python.org/3/library/stdtypes.html#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*](https://docs.python.org/3/library/stdtypes.html#str)) – a string that represents the plot title
- **ax** ([*matplotlib.axes.Axes*](https://matplotlib.org/stable/api/_as_gen/matplotlib.axes.Axes.html#matplotlib.axes.Axes "(in Matplotlib v3.8.4)")) – An Axes to use for rendering the bloch sphere
- **figsize** ([*tuple*](https://docs.python.org/3/library/stdtypes.html#tuple)) – Figure size in inches. Has no effect is passing `ax`.
- **coord\_type** ([*str*](https://docs.python.org/3/library/stdtypes.html#str)) – a string that specifies coordinate type for bloch (Cartesian or spherical), default is Cartesian
- **font\_size** ([*float*](https://docs.python.org/3/library/functions.html#float)) – Font size.

**Returns**

A matplotlib figure instance if `ax = None`.

**Return type**

[`matplotlib.figure.Figure`](https://matplotlib.org/stable/api/figure_api.html#matplotlib.figure.Figure "(in Matplotlib v3.8.4)")

**Raises**

[**MissingOptionalLibraryError**](/docs/api/qiskit/1.0/exceptions#qiskit.exceptions.MissingOptionalLibraryError "qiskit.exceptions.MissingOptionalLibraryError") – Requires matplotlib.

**Examples**

```python
from qiskit.visualization import plot_bloch_vector

plot_bloch_vector([0,1,0], title="New Bloch Sphere")
```

![../\_images/qiskit-visualization-plot\_bloch\_vector-1.png](https://eu-de.quantum.cloud.ibm.com/docs/images/api/qiskit/1.0/qiskit-visualization-plot_bloch_vector-1.avif)

```python
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')
```

![../\_images/qiskit-visualization-plot\_bloch\_vector-2.png](https://eu-de.quantum.cloud.ibm.com/docs/images/api/qiskit/1.0/qiskit-visualization-plot_bloch_vector-2.avif)