BackendV2

class 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 the Provider object 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 the version attribute as version is for the abstract Backend abstract interface version of the object while backend_version is 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	Return the acquisition channel for the given qubit.
control_channel	Return the secondary drive channel for the given qubit
drive_channel	Return the drive channel for the given qubit.
measure_channel	Return the measure stimulus channel for the given qubit.
qubit_properties	Return QubitProperties for a given qubit.
run	Run on the backend.
set_options	Set the options fields for the backend

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

A list of Instruction instances that the backend supports.

Return type

List[Instruction]

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

A qiskit.transpiler.Target object for the backend.

Return type

Target

version = 2