Enum roqoqo_qiskit_devices::devices::IBMDevice

pub enum IBMDevice {
    IBMLagosDevice(IBMLagosDevice),
    IBMNairobiDevice(IBMNairobiDevice),
    IBMPerthDevice(IBMPerthDevice),
    IBMBelemDevice(IBMBelemDevice),
    IBMJakartaDevice(IBMJakartaDevice),
    IBMLimaDevice(IBMLimaDevice),
    IBMManilaDevice(IBMManilaDevice),
    IBMQuitoDevice(IBMQuitoDevice),
}

Collection of IBM quantum devices.

Variants

IBMLagosDevice(IBMLagosDevice)

IBMNairobiDevice(IBMNairobiDevice)

IBMPerthDevice(IBMPerthDevice)

IBMBelemDevice(IBMBelemDevice)

IBMJakartaDevice(IBMJakartaDevice)

IBMLimaDevice(IBMLimaDevice)

IBMManilaDevice(IBMManilaDevice)

IBMQuitoDevice(IBMQuitoDevice)

Implementations

impl IBMDevice

pub fn name(self) -> &'static str

Returns the IBM’s identifier.

Returns

A str of the name IBM uses as identifier.

pub fn set_single_qubit_gate_time( &mut self, gate: &str, qubit: usize, gate_time: f64, ) -> Result<(), RoqoqoError>

Setting the gate time of a single qubit gate.

Arguments

• gate - hqslang name of the single-qubit-gate.
• qubit - The qubit for which the gate time is set.
• gate_time - gate time for the given gate.

pub fn set_two_qubit_gate_time( &mut self, gate: &str, control: usize, target: usize, gate_time: f64, ) -> Result<(), RoqoqoError>

Setting the gate time of a two qubit gate.

Arguments

• gate - hqslang name of the two-qubit-gate.
• control - The control qubit for which the gate time is set.
• target - The target qubit for which the gate time is set.
• gate_time - gate time for the given gate.

pub fn add_damping( &mut self, qubit: usize, damping: f64, ) -> Result<(), RoqoqoError>

Adds qubit damping to noise rates.

Arguments

• qubit - The qubit for which the dampins is added.
• daming - The damping rates.

pub fn add_dephasing( &mut self, qubit: usize, dephasing: f64, ) -> Result<(), RoqoqoError>

Adds qubit dephasing to noise rates.

Arguments

• qubit - The qubit for which the dephasing is added.
• dephasing - The dephasing rates.

pub fn to_generic_device(&self) -> Result<GenericDevice, RoqoqoError>

Converts the device to a qoqo GenericDevice.

Returns

• GenericDevice - The converted device.
• RoqoqoError - The error propagated from adding gate times and decoherence rates.

Trait Implementations

impl From<&IBMBelemDevice> for IBMDevice

fn from(input: &IBMBelemDevice) -> Self

Converts to this type from the input type.

impl From<&IBMJakartaDevice> for IBMDevice

fn from(input: &IBMJakartaDevice) -> Self

Converts to this type from the input type.

impl From<&IBMLagosDevice> for IBMDevice

fn from(input: &IBMLagosDevice) -> Self

Converts to this type from the input type.

impl From<&IBMLimaDevice> for IBMDevice

fn from(input: &IBMLimaDevice) -> Self

Converts to this type from the input type.

impl From<&IBMManilaDevice> for IBMDevice

fn from(input: &IBMManilaDevice) -> Self

Converts to this type from the input type.

impl From<&IBMNairobiDevice> for IBMDevice

fn from(input: &IBMNairobiDevice) -> Self

Converts to this type from the input type.

impl From<&IBMPerthDevice> for IBMDevice

fn from(input: &IBMPerthDevice) -> Self

Converts to this type from the input type.

impl From<&IBMQuitoDevice> for IBMDevice

fn from(input: &IBMQuitoDevice) -> Self

Converts to this type from the input type.

impl From<IBMBelemDevice> for IBMDevice

fn from(input: IBMBelemDevice) -> Self

Converts to this type from the input type.

impl From<IBMJakartaDevice> for IBMDevice

fn from(input: IBMJakartaDevice) -> Self

Converts to this type from the input type.

impl From<IBMLagosDevice> for IBMDevice

fn from(input: IBMLagosDevice) -> Self

Converts to this type from the input type.

impl From<IBMLimaDevice> for IBMDevice

fn from(input: IBMLimaDevice) -> Self

Converts to this type from the input type.

impl From<IBMManilaDevice> for IBMDevice

fn from(input: IBMManilaDevice) -> Self

Converts to this type from the input type.

impl From<IBMNairobiDevice> for IBMDevice

fn from(input: IBMNairobiDevice) -> Self

Converts to this type from the input type.

impl From<IBMPerthDevice> for IBMDevice

fn from(input: IBMPerthDevice) -> Self

Converts to this type from the input type.

impl From<IBMQuitoDevice> for IBMDevice

fn from(input: IBMQuitoDevice) -> Self

Converts to this type from the input type.

impl QoqoDevice for IBMDevice

Implements the Device trait for IBMDevice.

Defines standard functions available for roqoqo-iqm devices.

fn single_qubit_gate_time(&self, hqslang: &str, qubit: &usize) -> Option<f64>

Returns the gate time of a single qubit operation if the single qubit operation is available on device.

Arguments

• hqslang - The hqslang name of a single qubit gate.
• qubit - The qubit the gate acts on.

Returns

• Some<f64> - The gate time.
• None - The gate is not available on the device.

fn single_qubit_gate_names(&self) -> Vec<String>

Returns the names of a single qubit operations available on the device.

Returns

• Vec<String> - The list of gate names.

fn two_qubit_gate_time( &self, hqslang: &str, control: &usize, target: &usize, ) -> Option<f64>

Returns the gate time of a two qubit operation if the two qubit operation is available on device.

Arguments

• hqslang - The hqslang name of a two qubit gate.
• control - The control qubit the gate acts on.
• target - The target qubit the gate acts on.

Returns

• Some<f64> - The gate time.
• None - The gate is not available on the device.

fn two_qubit_gate_names(&self) -> Vec<String>

Returns the names of a two qubit operations available on the device.

Returns

• Vec<String> - The list of gate names.

fn three_qubit_gate_time( &self, hqslang: &str, control_0: &usize, control_1: &usize, target: &usize, ) -> Option<f64>

Returns the gate time of a three qubit operation if the three qubit operation is available on device.

Arguments

• hqslang - The hqslang name of a two qubit gate.
• control - The control qubit the gate acts on.
• target - The target qubit the gate acts on.

Returns

• Some<f64> - The gate time.
• None - The gate is not available on the device.

fn multi_qubit_gate_time(&self, hqslang: &str, qubits: &[usize]) -> Option<f64>

Returns the gate time of a multi qubit operation if the multi qubit operation is available on device.

Arguments

• hqslang - The hqslang name of a multi qubit gate.
• qubits - The qubits the gate acts on.

Returns

• Some<f64> - The gate time.
• None - The gate is not available on the device.

fn multi_qubit_gate_names(&self) -> Vec<String>

Returns the names of a multi qubit operations available on the device.

The list of names also includes the three qubit gate operations.

Returns

• Vec<String> - The list of gate names.

fn qubit_decoherence_rates(&self, qubit: &usize) -> Option<Array2<f64>>

Returns the matrix of the decoherence rates of the Lindblad equation.

Arguments

• qubit - The qubit for which the rate matrix is returned.

Returns

• Some<Array2<f64>> - The decoherence rates.
• None - The qubit is not part of the device.

fn number_qubits(&self) -> usize

Returns the number of qubits the device supports.

Returns

usize - The number of qubits in the device.

fn longest_chains(&self) -> Vec<Vec<usize>>

Return a list of longest linear chains through the device.

Returns at least one chain of qubits with linear connectivity in the device, that has the maximum possible number of qubits with linear connectivity in the device. Can return more that one of the possible chains but is not guaranteed to return all possible chains. (For example for all-to-all connectivity only one chain will be returned).

Returns

• Vec<Vec<usize>> - A list of the longest chains given by vectors of qubits in the chain.

fn longest_closed_chains(&self) -> Vec<Vec<usize>>

Return a list of longest closed linear chains through the device.

Returns at least one chain of qubits with linear connectivity in the device , that has the maximum possible number of qubits with linear connectivity in the device. The chain must be closed, the first qubit needs to be connected to the last qubit. Can return more that one of the possible chains but is not guaranteed to return all possible chains. (For example for all-to-all connectivity only one chain will be returned).

Returns

• Vec<Vec<usize>> - A list of the longest chains given by vectors of qubits in the chain.

fn two_qubit_edges(&self) -> Vec<(usize, usize)>

Returns the list of pairs of qubits linked with a native two-qubit-gate in the device.

A pair of qubits is considered linked by a native two-qubit-gate if the device can implement a two-qubit-gate between the two qubits without decomposing it into a sequence of gates that involves a third qubit of the device. The two-qubit-gate also has to form a universal set together with the available single qubit gates.

The returned vectors is a simple, graph-library independent, representation of the undirected connectivity graph of the device. It can be used to construct the connectivity graph in a graph library of the users choice from a list of edges and can be used for applications like routing in quantum algorithms.

Returns

• Vec<(usize, usize)> - A list of pairs of qubits linked with a native two-qubit-gate in the device.

fn add_active_gate_noise( &self, circuit: &Circuit, ) -> Result<Circuit, RoqoqoBackendError>

Adds the noise contributions due to qubit gates being applied

fn change_device( &mut self, hqslang: &str, operation: &[u8], ) -> Result<(), RoqoqoBackendError>

Changes the device topology based on a Pragma operation.