BackendV2
BackendV2(provider=None, name=None, description=None, online_date=None, backend_version=None, **fields)
Bases: qiskit.providers.backend.Backend, abc.ABC
Abstract class for Backends
This abstract class is to be used for all Backend objects created by a provider. This version differs from earlier abstract Backend classes in that the configuration attribute no longer exists. Instead, attributes exposing equivalent required immutable properties of the backend device are added. For example backend.configuration().n_qubits is accessible from backend.num_qubits now.
The options attribute of the backend is used to contain the dynamic user configurable options of the backend. It should be used more for runtime options that configure how the backend is used. For example, something like a shots field for a backend that runs experiments which would contain an int for how many shots to execute.
If migrating a provider from BackendV1 or BaseBackend one thing to keep in mind is for backwards compatibility you might need to add a configuration method that will build a BackendConfiguration object and BackendProperties from the attributes defined in this class for backwards compatibility.
Initialize a BackendV2 based backend
Parameters
- provider (
Optional[Provider]) – An optional backwards reference to theProviderobject that the backend is from - name (
Optional[str]) – An optional name for the backend - description (
Optional[str]) – An optional description of the backend - online_date (
Optional[datetime]) – An optional datetime the backend was brought online - backend_version (
Optional[str]) – An optional backend version string. This differs from theversionattribute asversionis for the abstractBackendabstract interface version of the object whilebackend_versionis for versioning the backend itself. - fields – kwargs for the values to use to override the default options.
Raises
AttributeError – If a field is specified that’s outside the backend’s options
Methods
acquire_channel
BackendV2.acquire_channel(qubit)
Return the acquisition channel for the given qubit.
This is required to be implemented if the backend supports Pulse scheduling.
Returns
The Qubit measurement acquisition line.
Return type
Raises
NotImplementedError – if the backend doesn’t support querying the measurement mapping
control_channel
BackendV2.control_channel(qubits)
Return the secondary drive channel for the given qubit
This is typically utilized for controlling multiqubit interactions. This channel is derived from other channels.
This is required to be implemented if the backend supports Pulse scheduling.
Parameters
qubits (Iterable[int]) – Tuple or list of qubits of the form (control_qubit, target_qubit).
Returns
The Qubit measurement acquisition line.
Return type
List[ControlChannel]
Raises
NotImplementedError – if the backend doesn’t support querying the measurement mapping
drive_channel
BackendV2.drive_channel(qubit)
Return the drive channel for the given qubit.
This is required to be implemented if the backend supports Pulse scheduling.
Returns
The Qubit drive channel
Return type
Raises
NotImplementedError – if the backend doesn’t support querying the measurement mapping
measure_channel
BackendV2.measure_channel(qubit)
Return the measure stimulus channel for the given qubit.
This is required to be implemented if the backend supports Pulse scheduling.
Returns
The Qubit measurement stimulus line
Return type
Raises
NotImplementedError – if the backend doesn’t support querying the measurement mapping
qubit_properties
BackendV2.qubit_properties(qubit)
Return QubitProperties for a given qubit.
If there are no defined or the backend doesn’t support querying these details this method does not need to be implemented.
Parameters
qubit (Union[int, List[int]]) – The qubit to get the QubitProperties object for. This can be a single integer for 1 qubit or a list of qubits and a list of QubitProperties objects will be returned in the same order
Raises
NotImplementedError – if the backend doesn’t support querying the qubit properties
Return type
Union[QubitProperties, List[QubitProperties]]
run
abstract BackendV2.run(run_input, **options)
Run on the backend.
This method that will return a Job object that run circuits. Depending on the backend this may be either an async or sync call. It is the discretion of the provider to decide whether running should block until the execution is finished or not. The Job class can handle either situation.
Parameters
- run_input (QuantumCircuit orSchedule orScheduleBlock or list) – An individual or a list of
ScheduleBlock, orScheduleobjects to run on the backend. - options – Any kwarg options to pass to the backend for running the config. If a key is also present in the options attribute/object then the expectation is that the value specified will be used instead of what’s set in the options object.
Returns
The job object for the run
Return type
set_options
BackendV2.set_options(**fields)
Set the options fields for the backend
This method is used to update the options of a backend. If you need to change any of the options prior to running just pass in the kwarg with the new value for the options.
Parameters
fields – The fields to update the options
Raises
AttributeError – If the field passed in is not part of the options
Attributes
coupling_map
Return the CouplingMap object
dt
Return the system time resolution of input signals
This is required to be implemented if the backend supports Pulse scheduling.
Returns
The input signal timestep in seconds. If the backend doesn’t define dt None will be returned
Return type
dt
dtm
Return the system time resolution of output signals
Returns
The output signal timestep in seconds.
Return type
dtm
Raises
NotImplementedError – if the backend doesn’t support querying the output signal timestep
instruction_durations
Return the InstructionDurations object.
instruction_schedule_map
Return the InstructionScheduleMap for the instructions defined in this backend’s target.
instructions
A list of Instruction tuples on the backend of the form (instruction, (qubits)
Return type
List[Tuple[Instruction, Tuple[int]]]
max_circuits
The maximum number of circuits (or Pulse schedules) that can be run in a single job.
If there is no limit this will return None
meas_map
Return the grouping of measurements which are multiplexed
This is required to be implemented if the backend supports Pulse scheduling.
Returns
The grouping of measurements which are multiplexed
Return type
meas_map
Raises
NotImplementedError – if the backend doesn’t support querying the measurement mapping
num_qubits
Return the number of qubits the backend has.
Return type
int
operation_names
A list of instruction names that the backend supports.
Return type
List[str]
operations
options
Return the options for the backend
The options of a backend are the dynamic parameters defining how the backend is used. These are used to control the run() method.
target
version
= 2