Skip to main contentIBM Quantum Documentation


qiskit.visualization.visualize_transition(circuit, trace=False, saveas=None, fpg=100, spg=2)

GitHub(opens in a new tab)

Creates animation showing transitions between states of a single qubit by applying quantum gates.


  • circuit (QuantumCircuit) – Qiskit single-qubit QuantumCircuit. Gates supported are h,x, y, z, rx, ry, rz, s, sdg, t, tdg and u1.
  • trace (bool(opens in a new tab)) – Controls whether to display tracing vectors - history of 10 past vectors at each step of the animation.
  • saveas (str(opens in a new tab)) – User can choose to save the animation as a video to their filesystem. This argument is a string of path with filename and extension (e.g. “movie.mp4” to save the video in current working directory).
  • fpg (int(opens in a new tab)) – Frames per gate. Finer control over animation smoothness and computational needs to render the animation. Works well for tkinter GUI as it is, for jupyter GUI it might be preferable to choose fpg between 5-30.
  • spg (int(opens in a new tab)) – Seconds per gate. How many seconds should animation of individual gate transitions take.


If arg jupyter is set to True. Otherwise opens tkinter GUI and returns after the GUI is closed.

Return type



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