Migrate fake backends to provider

qiskit_ibm_provider/fake_provider/__init__.py

@@ -0,0 +1,253 @@
+# This code is part of Qiskit.
+#
+# (C) Copyright IBM 2022, 2023.
+#
+# This code is licensed under the Apache License, Version 2.0. You may
+# obtain a copy of this license in the LICENSE.txt file in the root directory
+# of this source tree or at http://www.apache.org/licenses/LICENSE-2.0.
+#
+# Any modifications or derivative works of this code must retain this
+# copyright notice, and modified files need to carry a notice indicating
+# that they have been altered from the originals.
+
+"""
+======================================================
+Fake Provider (:mod:`qiskit_ibm_provider.fake_provider`)
+======================================================
+
+.. currentmodule:: qiskit_ibm_provider.fake_provider
+
+Overview
+========
+
+The fake provider module contains fake providers and fake backends classes. The fake backends are
+built to mimic the behaviors of IBM Quantum systems using system snapshots. The system snapshots
+contain important information about the quantum system such as coupling map, basis gates, qubit
+properties (T1, T2, error rate, etc.) which are useful for testing the transpiler and performing
+noisy simulation of the system.
+
+Example Usage
+=============
+
+Here is an example of using a fake backend for transpilation and simulation.
+
+.. plot::
+   :include-source:
+
+   from qiskit import QuantumCircuit
+   from qiskit_ibm_provider.fake_provider import FakeManilaV2
+   from qiskit import transpile
+   from qiskit.tools.visualization import plot_histogram
+
+
+   # Get a fake backend from the fake provider
+   backend = FakeManilaV2()
+
+   # Create a simple circuit
+   circuit = QuantumCircuit(3)
+   circuit.h(0)
+   circuit.cx(0,1)
+   circuit.cx(0,2)
+   circuit.measure_all()
+   circuit.draw('mpl')
+
+   # Transpile the ideal circuit to a circuit that can be directly executed by the backend
+   transpiled_circuit = transpile(circuit, backend)
+   transpiled_circuit.draw('mpl')
+
+   # Run the transpiled circuit using the simulated fake backend
+   job = backend.run(transpiled_circuit)
+   counts = job.result().get_counts()
+   plot_histogram(counts)
+
+.. important::
+
+    Please note that the simulation is done using a noise model generated from system snapshots
+    obtained in the past (sometimes a few years ago) and the results are not representative of the
+    latest behaviours of the real quantum system which the fake backend is mimicking. If you want to
+    run noisy simulations to compare with the real quantum system, you should use the ``qiskit_aer``
+    library. After installation, you can follow the steps below to generate a simulator that
+    mimics a real quantum system with the latest calibration results.
+
+    .. code-block:: python
+
+        from qiskit_ibm_provider import IBMProvider
+        from qiskit.providers.aer import AerSimulator
+
+        # get a real backend from a real provider
+        provider = IBMProvider()
+        backend = provider.get_backend('ibmq_manila')
+
+        # generate a simulator that mimics the real quantum system with the latest calibration results
+        backend_sim = AerSimulator.from_backend(backend)
+
+
+Fake Providers
+==============
+
+Fake providers provide access to a list of fake backends.
+
+.. autosummary::
+    :toctree: ../stubs/
+
+    FakeProviderForBackendV2
+    FakeProvider
+
+Fake Backends
+=============
+
+Fake V2 Backends
+----------------
+
+Fake V2 backends are fake backends with IBM Quantum systems snapshots implemented with
+:mod:`~qiskit.providers.backend.BackendV2` interface.  They are all subclasses of
+:class:`FakeBackendV2`.
+
+.. autosummary::
+    :toctree: ../stubs/
+
+    FakeAlmadenV2
+    FakeArmonkV2
+    FakeAthensV2
+    FakeAuckland
+    FakeBelemV2
+    FakeBoeblingenV2
+    FakeBogotaV2
+    FakeBrooklynV2
+    FakeBurlingtonV2
+    FakeCairoV2
+    FakeCambridgeV2
+    FakeCasablancaV2
+    FakeEssexV2
+    FakeGeneva
+    FakeGuadalupeV2
+    FakeHanoiV2
+    FakeJakartaV2
+    FakeJohannesburgV2
+    FakeKolkataV2
+    FakeLagosV2
+    FakeLimaV2
+    FakeLondonV2
+    FakeManhattanV2
+    FakeManilaV2
+    FakeMelbourneV2
+    FakeMontrealV2
+    FakeMumbaiV2
+    FakeNairobiV2
+    FakeOslo
+    FakeOurenseV2
+    FakeParisV2
+    FakePerth
+    FakePrague
+    FakePoughkeepsieV2
+    FakeQuitoV2
+    FakeRochesterV2
+    FakeRomeV2
+    .. FakeRueschlikonV2 # no v2 version
+    FakeSantiagoV2
+    FakeSherbrooke
+    FakeSingaporeV2
+    FakeSydneyV2
+    .. FakeTenerifeV2 # no v2 version
+    .. FakeTokyoV2 # no v2 version
+    FakeTorontoV2
+    FakeValenciaV2
+    FakeVigoV2
+    FakeWashingtonV2
+    FakeYorktownV2
+
+Fake V1 Backends
+----------------
+
+Fake V1 backends are fake backends with IBM Quantum systems snapshots implemented with
+:mod:`~qiskit.providers.backend.BackendV1` interface.
+
+.. autosummary::
+    :toctree: ../stubs/
+
+    FakeAlmaden
+    FakeArmonk
+    FakeAthens
+    FakeBelem
+    FakeBoeblingen
+    FakeBogota
+    FakeBrooklyn
+    FakeBurlington
+    FakeCairo
+    FakeCambridge
+    FakeCasablanca
+    FakeEssex
+    FakeGuadalupe
+    FakeHanoi
+    FakeJakarta
+    FakeJohannesburg
+    FakeKolkata
+    FakeLagos
+    FakeLima
+    FakeLondon
+    FakeManhattan
+    FakeManila
+    FakeMelbourne
+    FakeMontreal
+    FakeMumbai
+    FakeNairobi
+    FakeOurense
+    FakeParis
+    FakePoughkeepsie
+    FakeQuito
+    FakeRochester
+    FakeRome
+    FakeRueschlikon
+    FakeSantiago
+    FakeSingapore
+    FakeSydney
+    FakeTenerife
+    FakeTokyo
+    FakeToronto
+    FakeValencia
+    FakeVigo
+    FakeWashington
+    FakeYorktown
+
+Special Fake Backends
+=====================
+
+Special fake backends are fake backends that were created for special testing purposes.
+
+.. autosummary::
+    :toctree: ../stubs/
+
+    FakeQasmSimulator
+
+Fake Backend Base Classes
+=========================
+
+The fake backends based on IBM hardware are based on a set of base classes:
+
+.. currentmodule:: qiskit_ibm_provider.fake_provider.fake_backend
+.. autoclass:: qiskit_ibm_provider.fake_provider.fake_backend.FakeBackendV2
+
+.. currentmodule:: qiskit_ibm_provider.fake_provider
+.. autoclass:: FakeBackend
+.. autoclass:: FakeQasmBackend
+.. autoclass:: FakePulseBackend
+"""
+
+# Fake job and qobj classes
+from .fake_job import FakeJob
+from .fake_qobj import FakeQobj
+
+# Base classes for fake backends
+from . import fake_backend
+from .fake_backend import FakeBackend
+from .fake_qasm_backend import FakeQasmBackend
+from .fake_pulse_backend import FakePulseBackend
+
+# Fake providers
+from .fake_provider import FakeProviderFactory, FakeProviderForBackendV2, FakeProvider
+
+# Standard fake backends with IBM Quantum systems snapshots
+from .backends import *
+
+# Special fake backends for special testing purposes
+from .fake_qasm_simulator import FakeQasmSimulator

qiskit_ibm_provider/fake_provider/backends/__init__.py

@@ -0,0 +1,110 @@
+# This code is part of Qiskit.
+#
+# (C) Copyright IBM 2019, 2023.
+#
+# This code is licensed under the Apache License, Version 2.0. You may
+# obtain a copy of this license in the LICENSE.txt file in the root directory
+# of this source tree or at http://www.apache.org/licenses/LICENSE-2.0.
+#
+# Any modifications or derivative works of this code must retain this
+# copyright notice, and modified files need to carry a notice indicating
+# that they have been altered from the originals.
+
+
+"""
+Mocked versions of real quantum backends.
+"""
+
+# BackendV2 Backends
+from .almaden import FakeAlmadenV2
+from .armonk import FakeArmonkV2
+from .athens import FakeAthensV2
+from .auckland import FakeAuckland
+from .belem import FakeBelemV2
+from .boeblingen import FakeBoeblingenV2
+from .bogota import FakeBogotaV2
+from .brooklyn import FakeBrooklynV2
+from .burlington import FakeBurlingtonV2
+from .cairo import FakeCairoV2
+from .cambridge import FakeCambridgeV2
+from .casablanca import FakeCasablancaV2
+from .essex import FakeEssexV2
+from .geneva import FakeGeneva
+from .guadalupe import FakeGuadalupeV2
+from .hanoi import FakeHanoiV2
+from .jakarta import FakeJakartaV2
+from .johannesburg import FakeJohannesburgV2
+from .kolkata import FakeKolkataV2
+from .lagos import FakeLagosV2
+from .lima import FakeLimaV2
+from .london import FakeLondonV2
+from .manhattan import FakeManhattanV2
+from .manila import FakeManilaV2
+from .melbourne import FakeMelbourneV2
+from .montreal import FakeMontrealV2
+from .mumbai import FakeMumbaiV2
+from .nairobi import FakeNairobiV2
+from .oslo import FakeOslo
+from .ourense import FakeOurenseV2
+from .paris import FakeParisV2
+from .perth import FakePerth
+from .prague import FakePrague
+from .poughkeepsie import FakePoughkeepsieV2
+from .quito import FakeQuitoV2
+from .rochester import FakeRochesterV2
+from .rome import FakeRomeV2
+from .santiago import FakeSantiagoV2
+from .sherbrooke import FakeSherbrooke
+from .singapore import FakeSingaporeV2
+from .sydney import FakeSydneyV2
+from .toronto import FakeTorontoV2
+from .valencia import FakeValenciaV2
+from .vigo import FakeVigoV2
+from .washington import FakeWashingtonV2
+from .yorktown import FakeYorktownV2
+
+# BackendV1 Backends
+from .almaden import FakeAlmaden
+from .armonk import FakeArmonk
+from .athens import FakeAthens
+from .belem import FakeBelem
+from .boeblingen import FakeBoeblingen
+from .bogota import FakeBogota
+from .brooklyn import FakeBrooklyn
+from .burlington import FakeBurlington
+from .cairo import FakeCairo
+from .cambridge import FakeCambridge
+from .cambridge import FakeCambridgeAlternativeBasis
+from .casablanca import FakeCasablanca
+from .essex import FakeEssex
+from .guadalupe import FakeGuadalupe
+from .hanoi import FakeHanoi
+from .jakarta import FakeJakarta
+from .johannesburg import FakeJohannesburg
+from .kolkata import FakeKolkata
+from .lagos import FakeLagos
+from .lima import FakeLima
+from .london import FakeLondon
+from .manhattan import FakeManhattan
+from .manila import FakeManila
+from .melbourne import FakeMelbourne
+from .montreal import FakeMontreal
+from .mumbai import FakeMumbai
+from .nairobi import FakeNairobi
+from .ourense import FakeOurense
+from .paris import FakeParis
+from .poughkeepsie import FakePoughkeepsie
+from .quito import FakeQuito
+from .rochester import FakeRochester
+from .rome import FakeRome
+from .rueschlikon import FakeRueschlikon
+from .santiago import FakeSantiago
+from .singapore import FakeSingapore
+from .sydney import FakeSydney
+from .tenerife import FakeTenerife
+from .tokyo import FakeTokyo
+from .toronto import FakeToronto
+from .valencia import FakeValencia
+from .vigo import FakeVigo
+from .washington import FakeWashington
+from .yorktown import FakeYorktown

qiskit_ibm_provider/fake_provider/backends/almaden/__init__.py

@@ -0,0 +1,16 @@
+# This code is part of Qiskit.
+#
+# (C) Copyright IBM 2019, 2023.
+#
+# This code is licensed under the Apache License, Version 2.0. You may
+# obtain a copy of this license in the LICENSE.txt file in the root directory
+# of this source tree or at http://www.apache.org/licenses/LICENSE-2.0.
+#
+# Any modifications or derivative works of this code must retain this
+# copyright notice, and modified files need to carry a notice indicating
+# that they have been altered from the originals.
+
+"""Mock almaden backend"""
+
+from .fake_almaden import FakeAlmadenV2
+from .fake_almaden import FakeAlmaden