How to create and share experiments

Overview

IBM Quantum experiments is a web interface for Qiskit Experiments. Qiskit Experiments is a package containing a suite of experiments for calibrating, characterizing, and benchmarking quantum systems and individual qubits. Example experiments include Quantum Volume, randomized benchmarking, tomography, and single-qubit calibration and spectroscopy. After running experiments against systems, you can review the results on the Experiments page.

To explore the API references, tutorials, experiment library, and release notes, see the Qiskit Experiments documentation.

View experiments

To access your experiments, go to the Application switcher ( switcher ) and select Experiments. From this page you can view experiments in a table or card format. You can filter the experiments shown to be only the experiments you ran or all experiments shared with you, or you can further filter the list by clicking the filter icon ( filter ). Filtering options include the system and provider it was run on, time, and so on.

view-exp

You can sort the data by date/time or by experiment name. In the table view, hover over the Run or Experiment column header, and click on the arrows to sort that column. In the card view, click on the sort icon (sort), then choose a sorting option.

In the search bar you can also do a search by experiment name. The search is case-insensitive and will search as you type.

View experiment details

In the table view, click anywhere in an experiment’s row to view that experiment’s details page. In the card view, click any card to view that experiment’s details page.

This page displays information such as the experiment ID, description, analysis results, plots, and downloadable artifact files. You can also add tags and a description to your experiment on this page.

view-det

To return to the main Experiments page, either click the word Experiments at the top of the page, or use your browser’s back button.

Share experiments

By default, only you can see your experiments. However, you can share experiments with others by changing the share level on the Experiments page.

If you are in the card view, switch to the table view. Click the vertical menu icon (overflow) found at the far right of an experiment’s row, and choose the new share level:

  • Private: Only available to the experiment owner.

  • Project: Shared with users in the same project (within the same group and hub).

  • Group: Shared with users in the same group (within the same hub) regardless of project membership.

  • Hub: Shared with users in the same hub, regardless of group or project membership.

  • Public: Shared with all users regardless of hub, group or project membership.

change-share

You can also change the share level from the Experiment details page. Click on the pencil icon next to the Share level.

change-share-details

Note

To view an experiment, you must have access to the system that the experiment was run on, even if the experiment is already shared with a provider (combination of hub, group, and project) that you can access.

Tutorial: saving experiment data to the Cloud

See an example of how to use experiments and try it out for yourself by following the Qiskit tutorial, Saving experiment data to the Cloud. View the tutorial on the qiskit.org site, or interact with the Jupyter notebook version in IBM Quantum Lab. Note that you will need to sign in to view and interact with the notebook.