iqm.qdmi.qiskit

Qiskit-facing integration for the IQM QDMI device library.

Module Contents

class IQMBackend(*, device_id: str | None = None, device: Device | None = None, provider: QDMIProvider | None = None, base_url: str | None = None, token: str | None = None, tokens_file: str | PathLike[str] | None = None, qc_id: str | None = None, qc_alias: str | None = None, calibration_set_id: str | UUID | None = None)[source]

Bases: mqt.core.plugins.qiskit.backend.QDMIBackend

Qiskit backend for the packaged IQM QDMI device library.

This backend loads the shared library distributed with iqm-qdmi and exposes it through MQT Core’s Qiskit-compatible QDMI backend.

Parameters:

  • device_id – Stable ID from the installed catalogue. Defaults to iqm.default.

  • device – An already-open device.

  • provider – Optional Qiskit provider to associate with this backend.

  • base_url – Base URL of the IQM service. Overrides IQM_SERVER_URL, its IQM_BASE_URL alias, and the manifest default when provided.

  • token – Authentication token. Defaults to IQM_TOKEN.

  • tokens_file – Path to an authentication file. Defaults to IQM_TOKENS_FILE.

  • qc_id – Optional IQM quantum computer identifier. Defaults to IQM_QC_ID.

  • qc_alias – Optional IQM quantum computer alias. Defaults to IQM_QUANTUM_COMPUTER, then its IQM_QC_ALIAS alias.

  • calibration_set_id – Optional calibration UUID to use for target construction and execution. When omitted, resolve the server default at initialization.

Environment defaults for the endpoint and quantum computer apply only to iqm.default. An explicit ID or alias takes precedence over either selector from the environment. Named presets use their manifest configuration.

property physical_qubits: tuple[int, ...]

Device site indices in target order, including computational resonators.

property calibration_set_id: str

Effective calibration UUID to share with execution clients.

Raises:

RuntimeError – If the device does not report a calibration UUID.