iqm-client 29.10.0__tar.gz → 29.12.0__tar.gz

{iqm_client-29.10.0 → iqm_client-29.12.0}/CHANGELOG.rst

@@ -2,6 +2,22 @@
 Changelog
 =========
 
+Version 29.12.0 (2025-08-08)
+============================
+
+Features
+--------
+
+- Minimal changes needed to support Qiskit version 1.3 and version 1.4. :issue:`SW-944`.
+
+Version 29.11.0 (2025-08-07)
+============================
+
+Features
+--------
+
+- Added :meth:`IQMClient.get_structured_metrics` for obtaining quality metric information.
+
 Version 29.10.0 (2025-07-31)
 ============================
 

{iqm_client-29.10.0 → iqm_client-29.12.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: iqm-client
-Version: 29.10.0
+Version: 29.12.0
 Summary: Client library for accessing an IQM quantum computer
 Author-email: IQM Finland Oy <developers@meetiqm.com>
 License:                                  Apache License
@@ -238,8 +238,8 @@ Requires-Dist: python-daemon>=2.3.0; extra == "cli"
 Provides-Extra: qiskit
 Requires-Dist: iqm-station-control-client<10,>=9; extra == "qiskit"
 Requires-Dist: iqm-exa-common<27,>=26; extra == "qiskit"
-Requires-Dist: qiskit<1.3,>=1.0; extra == "qiskit"
-Requires-Dist: qiskit-aer<0.16,>=0.13.1; extra == "qiskit"
+Requires-Dist: qiskit<=1.4.2,>=1.0; extra == "qiskit"
+Requires-Dist: qiskit-aer<0.18,>=0.13.1; extra == "qiskit"
 
 IQM Client
 ###########

iqm_client-29.12.0/requirements/qiskit.in

@@ -0,0 +1,2 @@
+qiskit >= 1.0, <= 1.4.2 # 1.4.3 broke the transpiler internally
+qiskit-aer >= 0.13.1, < 0.18

{iqm_client-29.10.0 → iqm_client-29.12.0}/requirements/qiskit.txt

@@ -1,4 +1,4 @@
 iqm-station-control-client>=9,<10
 iqm-exa-common>=26,<27
-qiskit >= 1.0, < 1.3
-qiskit-aer >= 0.13.1, < 0.16
+qiskit >= 1.0, <= 1.4.2
+qiskit-aer >= 0.13.1, < 0.18

{iqm_client-29.10.0 → iqm_client-29.12.0}/src/iqm/iqm_client/iqm_client.py

@@ -65,6 +65,7 @@ import requests
 from requests import HTTPError
 
 from iqm.station_control.client.iqm_server.iqm_server_client import IqmServerClient
+from iqm.station_control.client.qon import ObservationFinder
 from iqm.station_control.client.utils import init_station_control
 from iqm.station_control.interface.models import ObservationLite
 from iqm.station_control.interface.station_control import StationControlInterface
@@ -907,3 +908,33 @@ class IQMClient:
         except json.decoder.JSONDecodeError as e:
             raise EndpointRequestError(f"Invalid response: {response.text}, {e!r}") from e
         return model
+
+    def get_structured_metrics(self, calibration_set_id: UUID | None = None) -> ObservationFinder:
+        """Retrieve the given calibration set and related quality metrics from the server.
+
+        Args:
+            calibration_set_id: ID of the calibration set to retrieve.
+                If ``None``, the current default calibration set is retrieved.
+
+        Returns:
+            Requested calibration set and related quality metrics in a searchable structure.
+
+        Raises:
+            EndpointRequestError: did not understand the endpoint response
+            ClientAuthenticationError: no valid authentication provided
+            HTTPException: HTTP exceptions
+
+        """
+        if isinstance(self._station_control, IqmServerClient):
+            raise ValueError("The get_structured_metrics method is not supported by IqmServerClient.")
+
+        if not calibration_set_id:
+            # find out the default calset id
+            default_calset = self._station_control.get_default_calibration_set()
+            calibration_set_id = default_calset.observation_set_id
+
+        calset_obs = self._station_control.get_observation_set_observations(calibration_set_id)
+        quality_metrics = self._station_control.get_calibration_set_quality_metrics(calibration_set_id)
+        qm_obs = quality_metrics.observations
+
+        return ObservationFinder(list(calset_obs) + qm_obs)

{iqm_client-29.10.0 → iqm_client-29.12.0}/src/iqm/iqm_client/models.py

@@ -714,6 +714,20 @@ class GateInfo(BaseModel):
         loci_sorted = sorted(loci_set, key=lambda locus: tuple(map(_component_sort_key, locus)))
         return tuple(loci_sorted)
 
+    def get_default_implementation(self, locus: Locus) -> str:
+        """Default implementation of this gate for the given locus.
+
+        Args:
+            locus: gate locus
+
+        Returns:
+            Name of the default implementation of this gate for ``locus``.
+
+        """
+        if (impl := self.override_default_implementation.get(locus)) is not None:
+            return impl
+        return self.default_implementation
+
 
 class DynamicQuantumArchitecture(BaseModel):
     """Dynamic quantum architecture as returned by server.

{iqm_client-29.10.0 → iqm_client-29.12.0}/src/iqm/qiskit_iqm/iqm_backend.py

@@ -58,9 +58,11 @@ class IQMBackendBase(BackendV2, ABC):
         # qubits, or else transpiling with optimization_level=0 will fail because of lacking resonator indices.
         qb_to_idx = {qb: idx for idx, qb in enumerate(architecture.qubits + architecture.computational_resonators)}
 
-        self._target = IQMTarget(architecture, qb_to_idx, include_resonators=False)
+        self._target = IQMTarget(architecture, component_to_idx=qb_to_idx, include_resonators=False)
         self._fake_target_with_moves = (
-            IQMTarget(architecture, qb_to_idx, include_resonators=True) if "move" in architecture.gates else None
+            IQMTarget(architecture, component_to_idx=qb_to_idx, include_resonators=True)
+            if "move" in architecture.gates
+            else None
         )
         self._qb_to_idx = qb_to_idx
         self._idx_to_qb = {v: k for k, v in qb_to_idx.items()}
@@ -135,7 +137,10 @@ class IQMBackendBase(BackendV2, ABC):
         return "iqm_default_scheduling"
 
     def restrict_to_qubits(
-        self, qubits: list[int] | list[str], include_resonators: bool = False, include_fake_czs: bool = True
+        self,
+        qubits: list[int] | list[str],
+        include_resonators: bool = False,
+        include_fake_czs: bool = True,
     ) -> IQMTarget:
         """Generated a restricted transpilation target from this backend that only contains the given qubits.
 
@@ -153,7 +158,10 @@ class IQMBackendBase(BackendV2, ABC):
 
 
 def _restrict_dqa_to_qubits(
-    architecture: DynamicQuantumArchitecture, qubits: list[str], include_resonators: bool, include_fake_czs: bool = True
+    architecture: DynamicQuantumArchitecture,
+    qubits: list[str],
+    include_resonators: bool,
+    include_fake_czs: bool = True,
 ) -> IQMTarget:
     """Generated a restricted transpilation target from this backend that only contains the given qubits.
 
@@ -170,7 +178,10 @@ def _restrict_dqa_to_qubits(
     new_gates = {}
     for gate_name, gate_info in architecture.gates.items():
         new_implementations = {}
-        for implementation_name, implementation_info in gate_info.implementations.items():
+        for (
+            implementation_name,
+            implementation_info,
+        ) in gate_info.implementations.items():
             new_loci = tuple(locus for locus in implementation_info.loci if all(q in qubits for q in locus))
             if new_loci:
                 new_implementations[implementation_name] = GateImplementationInfo(loci=new_loci)
@@ -186,7 +197,12 @@ def _restrict_dqa_to_qubits(
         computational_resonators=[q for q in qubits if q in architecture.computational_resonators],
         gates=new_gates,
     )
-    return IQMTarget(new_arch, {name: idx for idx, name in enumerate(qubits)}, include_resonators, include_fake_czs)
+    return IQMTarget(
+        new_arch,
+        component_to_idx={name: idx for idx, name in enumerate(qubits)},
+        include_resonators=include_resonators,
+        include_fake_czs=include_fake_czs,
+    )
 
 
 class IQMTarget(Target):
@@ -322,5 +338,8 @@ class IQMTarget(Target):
         """
         qubits_str = [self.iqm_idx_to_component[q] if isinstance(q, int) else str(q) for q in qubits]
         return _restrict_dqa_to_qubits(
-            self.iqm_dqa, qubits_str, self.iqm_includes_resonators, self.iqm_includes_fake_czs
+            self.iqm_dqa,
+            qubits_str,
+            self.iqm_includes_resonators,
+            self.iqm_includes_fake_czs,
         )

{iqm_client-29.10.0 → iqm_client-29.12.0}/src/iqm/qiskit_iqm/iqm_naive_move_pass.py

@@ -103,7 +103,9 @@ class IQMNaiveResonatorMoving(TransformationPass):
         )
         try:
             routed_iqm_circuit = transpile_insert_moves(
-                iqm_circuit, self.architecture, existing_moves=self.existing_moves_handling
+                iqm_circuit,
+                self.architecture,
+                existing_moves=self.existing_moves_handling,
             )
             routed_circuit = deserialize_instructions(
                 list(routed_iqm_circuit.instructions), self.component_to_idx, layout
@@ -121,7 +123,11 @@ class IQMNaiveResonatorMoving(TransformationPass):
 
         # Create the new DAG and make sure that the qubits are properly ordered.
         ordered_qubits = [layout.get_physical_bits()[i] for i in range(len(layout.get_physical_bits()))]
-        new_dag = circuit_to_dag(routed_circuit, qubit_order=ordered_qubits, clbit_order=routed_circuit.clbits)
+        new_dag = circuit_to_dag(
+            routed_circuit,
+            qubit_order=ordered_qubits,
+            clbit_order=routed_circuit.clbits,
+        )
 
         # Reinsert the symbolic parameters.
         for node in new_dag.topological_op_nodes():
@@ -208,6 +214,11 @@ def transpile_to_IQM(  # noqa: PLR0913
 
     Works with both the Crystal and Star architectures.
 
+    Note: When transpiling a circuit with MOVE gates, you might need to set the `optimization_level` lower.
+    If the `optimization_level` is set too high, the transpiler might add single qubit gates onto the resonator,
+    which is not supported by the IQM Star architectures. If this in undesired, it is best to have the transpiler
+    add the MOVE gates automatically, rather than manually adding them to the circuit.
+
     Args:
         circuit: The circuit to be transpiled without MOVE gates.
         backend: The target backend to compile to. Does not require a resonator.
@@ -233,7 +244,7 @@ def transpile_to_IQM(  # noqa: PLR0913
         restrict_to_qubits = [backend.qubit_name_to_index(q) if isinstance(q, str) else q for q in restrict_to_qubits]
 
     if target is None:
-        if circuit.count_ops().get("move", 0) > 0:
+        if circuit.count_ops().get("move", 0) > 0 or circuit.num_qubits > backend.num_qubits:
             target = backend.target_with_resonators
             # Create a sensible initial layout if none is provided
             if initial_layout is None:
@@ -263,5 +274,10 @@ def transpile_to_IQM(  # noqa: PLR0913
             + "`ignore_barriers`, and `existing_moves_handling` arguments."
         )
     qiskit_transpiler_kwargs["scheduling_method"] = scheduling_method
-    new_circuit = transpile(circuit, target=target, initial_layout=initial_layout, **qiskit_transpiler_kwargs)
+    new_circuit = transpile(
+        circuit,
+        target=target,
+        initial_layout=initial_layout,
+        **qiskit_transpiler_kwargs,
+    )
     return new_circuit

{iqm_client-29.10.0 → iqm_client-29.12.0}/src/iqm/qiskit_iqm/iqm_transpilation.py

@@ -22,7 +22,11 @@ from qiskit.circuit.equivalence_library import SessionEquivalenceLibrary
 from qiskit.circuit.library import RGate, UnitaryGate
 from qiskit.dagcircuit import DAGCircuit
 from qiskit.transpiler.basepasses import TransformationPass
-from qiskit.transpiler.passes import BasisTranslator, Optimize1qGatesDecomposition, RemoveBarriers
+from qiskit.transpiler.passes import (
+    BasisTranslator,
+    Optimize1qGatesDecomposition,
+    RemoveBarriers,
+)
 from qiskit.transpiler.passmanager import PassManager
 
 TOLERANCE = 1e-10  # The tolerance for equivalence checking against zero.
@@ -73,12 +77,16 @@ class IQMOptimizeSingleQubitGates(TransformationPass):
         for node in dag.topological_op_nodes():
             if node.name == "u":
                 # convert into PRX + RZ
-                qubit_index = dag.find_bit(node.qargs[0])[0]
+                qubit_index = dag.find_bit(node.qargs[0]).index
                 if isinstance(node.op.params[0], float) and math.isclose(node.op.params[0], 0, abs_tol=TOLERANCE):
                     dag.remove_op_node(node)
                 else:
                     dag.substitute_node(
-                        node, RGate(node.op.params[0], np.pi / 2 - node.op.params[2] - rz_angles[qubit_index])
+                        node,
+                        RGate(
+                            node.op.params[0],
+                            np.pi / 2 - node.op.params[2] - rz_angles[qubit_index],
+                        ),
                     )
                 phase = node.op.params[1] + node.op.params[2]
                 dag.global_phase += phase / 2
@@ -89,7 +97,7 @@ class IQMOptimizeSingleQubitGates(TransformationPass):
                 # are arbitrary so we could set rz_angles to any values here, but zeroing the
                 # angles results in fewest changes to the circuit.
                 for qubit in node.qargs:
-                    rz_angles[dag.find_bit(qubit)[0]] = 0
+                    rz_angles[dag.find_bit(qubit).index] = 0
             elif node.name == "barrier":
                 # TODO barriers are meant to restrict circuit optimization, so strictly speaking
                 # we should output any accumulated ``rz_angles`` here as explicit z rotations (like
@@ -100,7 +108,10 @@ class IQMOptimizeSingleQubitGates(TransformationPass):
                 pass
             elif node.name == "move":
                 # acts like iSWAP with RZ, moving it to the other component
-                qb, res = dag.find_bit(node.qargs[0])[0], dag.find_bit(node.qargs[1])[0]
+                qb, res = (
+                    dag.find_bit(node.qargs[0]).index,
+                    dag.find_bit(node.qargs[1]).index,
+                )
                 rz_angles[res], rz_angles[qb] = rz_angles[qb], rz_angles[res]
             elif node.name in {"cz", "delay"}:
                 pass  # commutes with RZ gates

{iqm_client-29.10.0 → iqm_client-29.12.0}/src/iqm_client.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: iqm-client
-Version: 29.10.0
+Version: 29.12.0
 Summary: Client library for accessing an IQM quantum computer
 Author-email: IQM Finland Oy <developers@meetiqm.com>
 License:                                  Apache License
@@ -238,8 +238,8 @@ Requires-Dist: python-daemon>=2.3.0; extra == "cli"
 Provides-Extra: qiskit
 Requires-Dist: iqm-station-control-client<10,>=9; extra == "qiskit"
 Requires-Dist: iqm-exa-common<27,>=26; extra == "qiskit"
-Requires-Dist: qiskit<1.3,>=1.0; extra == "qiskit"
-Requires-Dist: qiskit-aer<0.16,>=0.13.1; extra == "qiskit"
+Requires-Dist: qiskit<=1.4.2,>=1.0; extra == "qiskit"
+Requires-Dist: qiskit-aer<0.18,>=0.13.1; extra == "qiskit"
 
 IQM Client
 ###########

{iqm_client-29.10.0 → iqm_client-29.12.0}/src/iqm_client.egg-info/requires.txt

@@ -23,5 +23,5 @@ python-daemon>=2.3.0
 [qiskit]
 iqm-station-control-client<10,>=9
 iqm-exa-common<27,>=26
-qiskit<1.3,>=1.0
-qiskit-aer<0.16,>=0.13.1
+qiskit<=1.4.2,>=1.0
+qiskit-aer<0.18,>=0.13.1

iqm_client-29.12.0/version.txt

@@ -0,0 +1 @@
+29.12.0

iqm_client-29.10.0/requirements/qiskit.in

@@ -1,2 +0,0 @@
-qiskit >= 1.0, < 1.3
-qiskit-aer >= 0.13.1, < 0.16

iqm_client-29.10.0/version.txt

@@ -1 +0,0 @@
-29.10.0