Rename BasicAer to BasicProvider and refactor interface to follow BackendV2

docs/apidoc/index.rst

@@ -20,8 +20,8 @@ API Reference
    dagcircuit
    extensions
    passmanager
-   providers_basicaer
    providers
+   providers_basic_provider
    providers_fake_provider
    providers_models
    pulse

docs/apidoc/providers_basic_provider.rst

@@ -0,0 +1,6 @@
+.. _qiskit-providers-basicprovider:
+
+.. automodule:: qiskit.providers.basic_provider
+   :no-members:
+   :no-inherited-members:
+   :no-special-members:

examples/python/ghz.py

@@ -1,6 +1,6 @@
 # This code is part of Qiskit.
 #
-# (C) Copyright IBM 2017.
+# (C) Copyright IBM 2017, 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
@@ -15,7 +15,7 @@
 """
 
 from qiskit import QuantumCircuit
-from qiskit import BasicAer, execute
+from qiskit import BasicProvider, execute
 
 
 ###############################################################
@@ -34,8 +34,8 @@
 for i in range(num_qubits):
     qc.measure(i, i)
 
-sim_backend = BasicAer.get_backend("qasm_simulator")
+sim_backend = BasicProvider.get_backend("basic_simulator")
 job = execute(qc, sim_backend, shots=1024)
 result = job.result()
-print("Qasm simulator : ")
+print("Basic simulator : ")
 print(result.get_counts(qc))

examples/python/initialize.py

@@ -1,6 +1,6 @@
 # This code is part of Qiskit.
 #
-# (C) Copyright IBM 2017.
+# (C) Copyright IBM 2017, 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
@@ -15,7 +15,7 @@
 """
 
 import math
-from qiskit import QuantumCircuit, execute, BasicAer
+from qiskit import QuantumCircuit, execute, BasicProvider
 
 
 ###############################################################
@@ -58,7 +58,7 @@
 print([format(abs(x * x), ".3f") for x in desired_vector])
 
 # Initialize on local simulator
-sim_backend = BasicAer.get_backend("qasm_simulator")
+sim_backend = BasicProvider.get_backend("basic_simulator")
 job = execute(circuit, sim_backend, shots=shots)
 result = job.result()
 

examples/python/load_qasm.py

@@ -1,6 +1,6 @@
 # This code is part of Qiskit.
 #
-# (C) Copyright IBM 2017, 2018.
+# (C) Copyright IBM 2017, 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
@@ -13,13 +13,13 @@
 """Example on how to load a file into a QuantumCircuit."""
 
 from qiskit import QuantumCircuit
-from qiskit import execute, BasicAer
+from qiskit import execute, BasicProvider
 
 circ = QuantumCircuit.from_qasm_file("examples/qasm/entangled_registers.qasm")
 print(circ)
 
 # See the backend
-sim_backend = BasicAer.get_backend("qasm_simulator")
+sim_backend = BasicProvider.get_backend("basic_simulator")
 
 
 # Compile and run the Quantum circuit on a local simulator backend

examples/python/qft.py

@@ -16,7 +16,7 @@
 
 import math
 from qiskit import QuantumCircuit
-from qiskit import execute, BasicAer
+from qiskit import execute, BasicProvider
 
 
 ###############################################################
@@ -66,8 +66,8 @@ def qft(circ, n):
 print(qft4)
 print(qft5)
 
-print("Qasm simulator")
-sim_backend = BasicAer.get_backend("qasm_simulator")
+print("Basic simulator")
+sim_backend = BasicProvider.get_backend("basic_simulator")
 job = execute([qft3, qft4, qft5], sim_backend, shots=1024)
 result = job.result()
 print(result.get_counts(qft3))

examples/python/rippleadd.py

@@ -1,6 +1,6 @@
 # This code is part of Qiskit.
 #
-# (C) Copyright IBM 2017.
+# (C) Copyright IBM 2017, 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
@@ -16,13 +16,13 @@
 """
 
 from qiskit import QuantumRegister, ClassicalRegister, QuantumCircuit
-from qiskit import BasicAer
+from qiskit import BasicProvider
 from qiskit import execute
 
 ###############################################################
 # Set the backend name and coupling map.
 ###############################################################
-backend = BasicAer.get_backend("qasm_simulator")
+backend = BasicProvider.get_backend("basic_simulator")
 coupling_map = [
     [0, 1],
     [0, 8],

examples/python/teleport.py

@@ -1,6 +1,6 @@
 # This code is part of Qiskit.
 #
-# (C) Copyright IBM 2017.
+# (C) Copyright IBM 2017, 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
@@ -18,14 +18,14 @@
 """
 
 from qiskit import QuantumRegister, ClassicalRegister, QuantumCircuit
-from qiskit import BasicAer
+from qiskit import BasicProvider
 from qiskit import execute
 
 ###############################################################
 # Set the backend name and coupling map.
 ###############################################################
 coupling_map = [[0, 1], [0, 2], [1, 2], [3, 2], [3, 4], [4, 2]]
-backend = BasicAer.get_backend("qasm_simulator")
+backend = BasicProvider.get_backend("basic_simulator")
 
 ###############################################################
 # Make a quantum program for quantum teleportation.

examples/python/using_qiskit_terra_level_0.py

@@ -1,6 +1,6 @@
 # This code is part of Qiskit.
 #
-# (C) Copyright IBM 2017, 2018.
+# (C) Copyright IBM 2017, 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
@@ -14,7 +14,7 @@
 Example showing how to use Qiskit-Terra at level 0 (novice).
 
 This example shows the most basic way to user Terra. It builds some circuits
-and runs them on both the BasicAer (local Qiskit provider) or IBMQ (remote IBMQ provider).
+and runs them on both the BasicProvider(local Qiskit provider).
 
 To control the compile parameters we have provided a transpile function which can be used
 as a level 1 user.
@@ -23,7 +23,7 @@
 
 # Import the Qiskit modules
 from qiskit import QuantumCircuit
-from qiskit import execute, BasicAer
+from qiskit import execute, BasicProvider
 
 # making first circuit: bell state
 qc1 = QuantumCircuit(2, 2)
@@ -37,11 +37,11 @@
 qc2.measure([0, 1], [0, 1])
 
 # setting up the backend
-print("(BasicAER Backends)")
-print(BasicAer.backends())
+print("(BasicProvider Backends)")
+print(BasicProvider.backends())
 
 # running the job
-job_sim = execute([qc1, qc2], BasicAer.get_backend("qasm_simulator"))
+job_sim = execute([qc1, qc2], BasicProvider.get_backend("basic_simulator"))
 sim_result = job_sim.result()
 
 # Show the results

qiskit/__init__.py

@@ -70,7 +70,7 @@
 import qiskit.circuit.reset
 
 # Please note these are global instances, not modules.
-from qiskit.providers.basicaer import BasicAer
+from qiskit.providers.basic_provider import BasicProvider
 
 _config = _user_config.get_config()
 
@@ -128,7 +128,7 @@ def __getattr__(self, attr):
 __all__ = [
     "Aer",
     "AncillaRegister",
-    "BasicAer",
+    "BasicProvider",
     "ClassicalRegister",
     "MissingOptionalLibraryError",
     "QiskitError",

qiskit/circuit/__init__.py

@@ -71,7 +71,7 @@
 .. plot::
    :include-source:
 
-   from qiskit import BasicAer, transpile, QuantumRegister, ClassicalRegister, QuantumCircuit
+   from qiskit import BasicProvider, transpile, QuantumRegister, ClassicalRegister, QuantumCircuit
 
    qr = QuantumRegister(1)
    cr = ClassicalRegister(1)
@@ -82,7 +82,7 @@
 
 .. code-block::
 
-   backend = BasicAer.get_backend('qasm_simulator')
+   backend = BasicProvider.get_backend('basic_simulator')
    tqc = transpile(qc, backend)
    counts = backend.run(tqc).result().get_counts()
 
@@ -100,7 +100,7 @@
 .. plot::
    :include-source:
 
-   from qiskit import BasicAer, transpile, QuantumRegister, ClassicalRegister, QuantumCircuit
+   from qiskit import BasicProvider, transpile, QuantumRegister, ClassicalRegister, QuantumCircuit
 
    qr = QuantumRegister(1)
    cr = ClassicalRegister(1)
@@ -115,7 +115,7 @@
 
 .. code-block::
 
-   backend = BasicAer.get_backend('qasm_simulator')
+   backend = BasicProvider.get_backend('basic_simulator')
    tqc = transpile(qc, backend)
    counts = backend.run(tqc).result().get_counts()
 

qiskit/execute_function.py

@@ -1,6 +1,6 @@
 # This code is part of Qiskit.
 #
-# (C) Copyright IBM 2017, 2019.
+# (C) Copyright IBM 2017, 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
@@ -253,9 +253,9 @@ def execute(
 
         .. code-block::
 
-            from qiskit import QuantumCircuit, execute, BasicAer
+            from qiskit import QuantumCircuit, execute, BasicProvider
 
-            backend = BasicAer.get_backend('qasm_simulator')
+            backend = BasicProvider.get_backend('basic_simulator')
 
             qc = QuantumCircuit(5, 5)
             qc.h(0)

qiskit/providers/backend_compat.py

@@ -84,7 +84,7 @@ def convert_to_target(
         "switch_case": SwitchCaseOp,
     }
 
-    in_data = {"num_qubits": configuration.n_qubits}
+    in_data = {"num_qubits": getattr(configuration, "n_qubits", None)}
 
     # Parse global configuration properties
     if hasattr(configuration, "dt"):

qiskit/providers/basicaer/__init__.py → qiskit/providers/basic_provider/__init__.py

@@ -1,6 +1,6 @@
 # This code is part of Qiskit.
 #
-# (C) Copyright IBM 2017, 2018.
+# (C) Copyright IBM 2017, 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
@@ -11,20 +11,20 @@
 # that they have been altered from the originals.
 
 """
-====================================================================
-BasicAer: Python-based Simulators (:mod:`qiskit.providers.basicaer`)
-====================================================================
+================================================================================
+BasicProvider: Python-based Simulators (:mod:`qiskit.providers.basic_provider`)
+================================================================================
 
-.. currentmodule:: qiskit.providers.basicaer
+.. currentmodule:: qiskit.providers.basic_provider
 
 A module of Python-based quantum simulators.  Simulators are accessed
-via the `BasicAer` provider, e.g.:
+via the `BasicProvider` provider, e.g.:
 
 .. code-block::
 
-   from qiskit import BasicAer
+   from qiskit import BasicProvider
 
-   backend = BasicAer.get_backend('qasm_simulator')
+   backend = BasicProvider.get_backend('basic_simulator')
 
 
 Simulators
@@ -33,41 +33,38 @@
 .. autosummary::
    :toctree: ../stubs/
 
-   QasmSimulatorPy
-   StatevectorSimulatorPy
-   UnitarySimulatorPy
+   BasicSimulator
 
 Provider
 ========
 
 .. autosummary::
    :toctree: ../stubs/
 
-   BasicAerProvider
+   BasicProvider
 
 Job Class
 =========
 
 .. autosummary::
    :toctree: ../stubs/
 
-   BasicAerJob
+   BasicProviderJob
 
 Exceptions
 ==========
 
 .. autosummary::
    :toctree: ../stubs/
 
-   BasicAerError
+   BasicProviderError
 """
 
-from .basicaerprovider import BasicAerProvider
-from .basicaerjob import BasicAerJob
-from .qasm_simulator import QasmSimulatorPy
-from .statevector_simulator import StatevectorSimulatorPy
-from .unitary_simulator import UnitarySimulatorPy
-from .exceptions import BasicAerError
+from .basic_provider import BasicProvider
+from .basic_provider_job import BasicProviderJob
+from .basic_simulator import BasicSimulator
+from .exceptions import BasicProviderError
 
 # Global instance to be used as the entry point for convenience.
-BasicAer = BasicAerProvider()
+
+BasicProvider = BasicProvider()