uniqc.backend_adapter.backend_info module

Unified backend information data structures.

This module defines the canonical BackendInfo dataclass that all quantum cloud platforms are normalised into, plus helpers for parsing and formatting backend identifiers.

class uniqc.backend_adapter.backend_info.BackendInfo(platform, name, description='', num_qubits=0, topology=(), status='unknown', is_simulator=False, is_hardware=False, extra=<factory>, avg_1q_fidelity=None, avg_2q_fidelity=None, avg_readout_fidelity=None, coherence_t1=None, coherence_t2=None)

Bases: object

Canonical description of a single quantum backend / chip / simulator.

One BackendInfo object corresponds to one real device or cloud simulator exposed by a platform. The object is hashable (frozen) so it can be stored in sets.

Parameters:

• platform (Platform)

• name (str)

• description (str)

• num_qubits (int)

• topology (tuple[QubitTopology, ...])

• status (str)

• is_simulator (bool)

• is_hardware (bool)

• extra (dict[str, Any])

• avg_1q_fidelity (float | None)

• avg_2q_fidelity (float | None)

• avg_readout_fidelity (float | None)

• coherence_t1 (float | None)

• coherence_t2 (float | None)

avg_1q_fidelity: float | None

avg_2q_fidelity: float | None

avg_readout_fidelity: float | None

coherence_t1: float | None

coherence_t2: float | None

description: str

extra: dict[str, Any]

classmethod from_dict(d)

Parameters:

d (dict[str, Any])

Return type:

BackendInfo

full_id()

Return the globally-unique identifier: platform:name.

Return type:

str

is_hardware: bool

is_simulator: bool

name: str

num_qubits: int

platform: Platform

status: str

to_dict()

Return type:

dict[str, Any]

topology: tuple[QubitTopology, ...]

class uniqc.backend_adapter.backend_info.Platform(*values)

Bases: Enum

DUMMY = 'dummy'

IBM = 'ibm'

ORIGINQ = 'originq'

QUAFU = 'quafu'

QUARK = 'quark'

class uniqc.backend_adapter.backend_info.QubitTopology(u, v)

Bases: object

Directed edge in a qubit connectivity graph.

Parameters:

• u (int)

• v (int)

classmethod from_dict(d)

Parameters:

d (dict[str, Any])

Return type:

QubitTopology

to_dict()

Return type:

dict[str, int]

u: int

v: int

uniqc.backend_adapter.backend_info.parse_backend_id(identifier)

Parse a backend identifier into (Platform, name).

Supports two forms:

• platform:name (e.g. originq:HanYuan_01)

• bare name (ambiguous; tries to match across all platforms)

Parameters:

identifier (str) – Full or partial backend identifier.

Returns:

(Platform, backend_name) tuple.

Raises:

ValueError – If the format is invalid or the platform is unknown.

Return type:

tuple[Platform, str]