Run circuits and view results

Follow the steps below to run circuits on IBM Quantum backends (either simulators or real quantum hardware) and view the results.

For instructions to run circuits and view the results by using REST APIs, see Steps to run a job.

Step 1. Sign in.

Sign in, if you haven’t already. If you don’t sign in, the visualizations at the bottom of the page automatically show simulated results for up to four qubits. However, if you want to run your circuit on a simulator backend or on real quantum hardware, you must sign in.

Step 2. Choose a backend and the number of shots.

To specify settings such as the backend to use, click the Run Settings button next to the Run button in the upper right corner. In the bar that opens, select an available backend. Note that some backends are simulators (the backend name will contain the word ‘simulator’); the other backends will send the circuit to real quantum hardware. You can also change the number of shots (executions) of your circuit that the backend will perform.


Toolbar displaying backend choices and number of shots.

If you have an open access account, you will see the remaining number of jobs that you can have in the queue at any one time. This will not apply if you have a premium access account through the IBM Q Network. Once a job has finished, the job limit will replenish. See more information in the Open provider section.

Note

When you run a circuit, it is automatically sent to the least busy backend, unless you change the backend in the Run settings. If you run the same circuit again, the backend selection window will default to your previous choice.

Step 3. Click Run.

You can view the job’s progress by clicking the Jobs tab: jobs

Step 4. View results.

Once your job completes, a hyperlink to the results page will appear under the Jobs tab. The results page displays run details, diagrams of the original and the transpiled circuit, an OpenQASM tab to view both original and transpiled circuits in OpenQASM, and a histogram of the results.

You can download the circuits and the histogram by selecting the menu in the upper right corner of each diagram, then selecting a format for the download (PNG or SVG; additionally, you can export the histogram as a CSV file).