qiskit-documentation/docs/api/qiskit/1.1/qiskit.providers.models.Bac...

133 lines
8.4 KiB
Plaintext
Raw Permalink Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

---
title: BackendConfiguration
description: API reference for qiskit.providers.models.BackendConfiguration
in_page_toc_min_heading_level: 1
python_api_type: class
python_api_name: qiskit.providers.models.BackendConfiguration
---
# BackendConfiguration
<Class id="qiskit.providers.models.BackendConfiguration" isDedicatedPage={true} github="https://github.com/Qiskit/qiskit/tree/stable/1.1/qiskit/providers/models/backendconfiguration.py#L493-L496" signature="qiskit.providers.models.BackendConfiguration(backend_name, backend_version, n_qubits, basis_gates, gates, local, simulator, conditional, open_pulse, memory, max_shots, coupling_map, supported_instructions=None, dynamic_reprate_enabled=False, rep_delay_range=None, default_rep_delay=None, max_experiments=None, sample_name=None, n_registers=None, register_map=None, configurable=None, credits_required=None, online_date=None, display_name=None, description=None, tags=None, dt=None, dtm=None, processor_type=None, parametric_pulses=None, **kwargs)" modifiers="class">
Bases: [`QasmBackendConfiguration`](qiskit.providers.models.QasmBackendConfiguration "qiskit.providers.models.backendconfiguration.QasmBackendConfiguration")
Backwards compat shim representing an abstract backend configuration.
Initialize a QasmBackendConfiguration Object
**Parameters**
* **backend\_name** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) The backend name
* **backend\_version** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) The backend version in the form X.Y.Z
* **n\_qubits** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) the number of qubits for the backend
* **basis\_gates** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")) The list of strings for the basis gates of the backends
* **gates** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")) The list of GateConfig objects for the basis gates of the backend
* **local** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) True if the backend is local or False if remote
* **simulator** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) True if the backend is a simulator
* **conditional** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) True if the backend supports conditional operations
* **open\_pulse** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) True if the backend supports OpenPulse
* **memory** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) True if the backend supports memory
* **max\_shots** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) The maximum number of shots allowed on the backend
* **coupling\_map** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")) The coupling map for the device
* **supported\_instructions** (*List\[*[*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")*]*) Instructions supported by the backend.
* **dynamic\_reprate\_enabled** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) whether delay between programs can be set dynamically (ie via `rep_delay`). Defaults to False.
* **rep\_delay\_range** (*List\[*[*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")*]*) 2d list defining supported range of repetition delays for backend in μs. First entry is lower end of the range, second entry is higher end of the range. Optional, but will be specified when `dynamic_reprate_enabled=True`.
* **default\_rep\_delay** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) Value of `rep_delay` if not specified by user and `dynamic_reprate_enabled=True`.
* **max\_experiments** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) The maximum number of experiments per job
* **sample\_name** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) Sample name for the backend
* **n\_registers** ([*int*](https://docs.python.org/3/library/functions.html#int "(in Python v3.12)")) Number of register slots available for feedback (if conditional is True)
* **register\_map** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")) An array of dimension n\_qubits X n\_registers that specifies whether a qubit can store a measurement in a certain register slot.
* **configurable** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) True if the backend is configurable, if the backend is a simulator
* **credits\_required** ([*bool*](https://docs.python.org/3/library/functions.html#bool "(in Python v3.12)")) True if backend requires credits to run a job.
* **online\_date** ([*datetime.datetime*](https://docs.python.org/3/library/datetime.html#datetime.datetime "(in Python v3.12)")) The date that the device went online
* **display\_name** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) Alternate name field for the backend
* **description** ([*str*](https://docs.python.org/3/library/stdtypes.html#str "(in Python v3.12)")) A description for the backend
* **tags** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")) A list of string tags to describe the backend
* **dt** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) Qubit drive channel timestep in nanoseconds.
* **dtm** ([*float*](https://docs.python.org/3/library/functions.html#float "(in Python v3.12)")) Measurement drive channel timestep in nanoseconds.
* **processor\_type** ([*dict*](https://docs.python.org/3/library/stdtypes.html#dict "(in Python v3.12)"))
Processor type for this backend. A dictionary of the form `{"family": <str>, "revision": <str>, segment: <str>}` such as `{"family": "Canary", "revision": "1.0", segment: "A"}`.
* family: Processor family of this backend.
* revision: Revision version of this processor.
* segment: Segment this processor belongs to within a larger chip.
* **parametric\_pulses** ([*list*](https://docs.python.org/3/library/stdtypes.html#list "(in Python v3.12)")) A list of pulse shapes which are supported on the backend. For example: `['gaussian', 'constant']`
* **\*\*kwargs** optional fields
## Attributes
### num\_qubits
<Attribute id="qiskit.providers.models.BackendConfiguration.num_qubits">
Returns the number of qubits.
In future, n\_qubits should be replaced in favor of num\_qubits for consistent use throughout Qiskit. Until this is properly refactored, this property serves as intermediate solution.
</Attribute>
## Methods
### from\_dict
<Function id="qiskit.providers.models.BackendConfiguration.from_dict" github="https://github.com/Qiskit/qiskit/tree/stable/1.1/qiskit/providers/models/backendconfiguration.py#L386-L400" signature="from_dict(data)" modifiers="classmethod">
Create a new GateConfig object from a dictionary.
**Parameters**
**data** ([*dict*](https://docs.python.org/3/library/stdtypes.html#dict "(in Python v3.12)")) A dictionary representing the GateConfig to create. It will be in the same format as output by [`to_dict()`](#qiskit.providers.models.BackendConfiguration.to_dict "qiskit.providers.models.BackendConfiguration.to_dict").
**Returns**
The GateConfig from the input dictionary.
**Return type**
[GateConfig](qiskit.providers.models.GateConfig "qiskit.providers.models.GateConfig")
</Function>
### to\_dict
<Function id="qiskit.providers.models.BackendConfiguration.to_dict" github="https://github.com/Qiskit/qiskit/tree/stable/1.1/qiskit/providers/models/backendconfiguration.py#L402-L471" signature="to_dict()">
Return a dictionary format representation of the GateConfig.
**Returns**
The dictionary form of the GateConfig.
**Return type**
[dict](https://docs.python.org/3/library/stdtypes.html#dict "(in Python v3.12)")
</Function>
</Class>