{"id":24491,"library":"qiskit-experiments","title":"Qiskit Experiments","description":"A library for building, running, and analyzing quantum computing experiments on IBM Qiskit. Current version 0.13.0, released quarterly. Provides experiment classes, analysis modules, and database storage. Requires qiskit-terra and qiskit-ibm-runtime.","status":"active","version":"0.13.0","language":"python","source_language":"en","source_url":"https://github.com/Qiskit-Community/qiskit-experiments","tags":["quantum computing","qiskit","experiment","IBM"],"install":[{"cmd":"pip install qiskit-experiments","lang":"bash","label":"Default install"}],"dependencies":[{"reason":"Core Qiskit framework for circuit construction and transpilation","package":"qiskit","optional":false},{"reason":"Required for running experiments on IBM quantum devices","package":"qiskit-ibm-runtime","optional":true},{"reason":"Used for curve fitting in analysis modules","package":"scipy","optional":false}],"imports":[{"note":"Experiment is in the framework submodule, not top-level.","wrong":"from qiskit_experiments import Experiment","symbol":"Experiment","correct":"from qiskit_experiments.framework import Experiment"},{"note":"ParallelExperiment is part of framework, not directly in qiskit_experiments.","wrong":"from qiskit_experiments import ParallelExperiment","symbol":"ParallelExperiment","correct":"from qiskit_experiments.framework import ParallelExperiment"},{"note":"CompositeExperiment is in the framework submodule.","wrong":"from qiskit_experiments import CompositeExperiment","symbol":"CompositeExperiment","correct":"from qiskit_experiments.framework import CompositeExperiment"},{"note":"AnalysisResult comes from database_service module.","wrong":"from qiskit_experiments import AnalysisResult","symbol":"AnalysisResult","correct":"from qiskit_experiments.database_service import AnalysisResult"},{"note":"Fit classes like RbFitter are in the library submodule.","wrong":"from qiskit_experiments import RbFitter","symbol":"RbFitter","correct":"from qiskit_experiments.library import RbFitter"}],"quickstart":{"code":"from qiskit.providers.fake_provider import FakePerth\nfrom qiskit_experiments.library import RandomizedBenchmarking\nfrom qiskit_experiments.framework import ExperimentData\n\nbackend = FakePerth()\nexp = RandomizedBenchmarking(qubits=(0,), lengths=[1, 10, 20], num_samples=10)\nexp_data = exp.run(backend, shots=1024).block_for_results()\nprint(exp_data.analysis_results())","lang":"python","description":"Run a simple randomized benchmarking experiment on a fake backend, then print analysis results."},"warnings":[{"fix":"Remove any usage of DbExperimentDataV2. For persistent storage, manually serialize ExperimentData to JSON or use the new database service (qiskit_experiments.database_service), which is still experimental.","message":"Database storage (DbExperimentDataV2) is deprecated since 0.12 and removed in 0.13. Use memory-based ExperimentData instead.","severity":"breaking","affected_versions":">=0.13.0"},{"fix":"Change imports: from qiskit_experiments.framework.data_processing import DataProcessor","message":"The `from qiskit_experiments.data_processing` module is deprecated since 0.10. Use `data_processing` from `qiskit_experiments.framework` instead.","severity":"deprecated","affected_versions":">=0.10.0"},{"fix":"Use `from qiskit_ibm_runtime import QiskitRuntimeService; service = QiskitRuntimeService(); backend = service.backend('ibm_qasm_simulator')`.","message":"When running on real hardware, you must pass a backend obtained from qiskit_ibm_runtime, not qiskit.providers.ibmq.","severity":"gotcha","affected_versions":"all"}],"env_vars":null,"last_verified":"2026-05-01T00:00:00.000Z","next_check":"2026-07-30T00:00:00.000Z","problems":[{"fix":"Run `pip install qiskit-experiments` in your current Python environment.","cause":"qiskit-experiments not installed or installed in a different environment.","error":"ModuleNotFoundError: No module named 'qiskit_experiments'"},{"fix":"Use `from qiskit_experiments.framework import Experiment`","cause":"Importing Experiment from the wrong location (top-level instead of framework).","error":"AttributeError: module 'qiskit_experiments' has no attribute 'Experiment'"},{"fix":"Call `.block_for_results()` on the ExperimentData object before accessing analysis_results().","cause":"ExperimentData not blocked for results before reading.","error":"TypeError: 'NoneType' object is not subscriptable when accessing analysis_results()"}],"ecosystem":"pypi","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}