Is there any function I can call to visualize a stim circuit?


2 Answers 2


Since v1.10, you can use stim.Circuit.diagram to visualize the circuit.

import stim

circuit = stim.Circuit("""
    QUBIT_COORDS(0, 0) 0
    QUBIT_COORDS(0, 1) 1
    QUBIT_COORDS(1, 0) 2
    QUBIT_COORDS(1, 1) 3
    R 0 1 2 3
    H 0 2
    CNOT 0 1
    CNOT 2 3
    M 0 1 2 3

q0: -QUBIT_COORDS(0,0)-R-H-@-M:rec[0]-
q1: -QUBIT_COORDS(0,1)-R---X-M:rec[1]-

q2: -QUBIT_COORDS(1,0)-R-H-@-M:rec[2]-
q3: -QUBIT_COORDS(1,1)-R---X-M:rec[3]-

You can also get an SVG image of the timeline:


In Jupyter notebooks this SVG will display inline. Otherwise you have to print it to a .svg file then open it.

enter image description here

or a 3d model, optionally embedded into a viewer that can be opened in a web browser:

# for this one you really want to have specified qubit coords

enter image description here

In Jupyter notebooks this viewer will display inline in the cell output. Otherwise you have to print it to a .html file then open it.

The diagram types that are currently available are:


You can also use the stimcirq package to convert into a cirq circuit and get diagrams that way (e.g. with the cirq_web package).

  • $\begingroup$ I notice when I have detectors in a stim circuit, the 3d visualization of cirq_web can not work properly. Is that true I must delete all the detectors for visualization with cirq_web? $\endgroup$
    – Inm
    Apr 1, 2022 at 6:33
  • $\begingroup$ @Inm That sounds like a bug in cirq_web to me; it should be ignoring operations with no targets. But yes, filtering out the bad instructions would avoid the problem. $\endgroup$ Apr 1, 2022 at 8:21
  • $\begingroup$ @Inm I reported the bug: github.com/quantumlib/Cirq/issues/5172 $\endgroup$ Apr 1, 2022 at 8:28

You can use stimcirq to convert your Stim circuit into a Cirq circuit then visualize it:

import stim
import stimcirq

cirq_circuit = stimcirq.stim_circuit_to_cirq_circuit(stim_circuit)

Your Answer

By clicking “Post Your Answer”, you agree to our terms of service and acknowledge that you have read and understand our privacy policy and code of conduct.

Not the answer you're looking for? Browse other questions tagged or ask your own question.