iqm-client 29.9.0__py3-none-any.whl → 29.11.0__py3-none-any.whl

iqm/cirq_iqm/iqm_sampler.py

@@ -25,7 +25,7 @@ import warnings
 import cirq
 from iqm.cirq_iqm.devices.iqm_device import IQMDevice, IQMDeviceMetadata
 from iqm.cirq_iqm.serialize import serialize_circuit
-from iqm.iqm_client import CircuitCompilationOptions, IQMClient, JobAbortionError, RunRequest
+from iqm.iqm_client import CircuitBatch, CircuitCompilationOptions, IQMClient, JobAbortionError, RunRequest
 import numpy as np
 
 
@@ -151,7 +151,7 @@ class IQMSampler(cirq.work.Sampler):
         if isinstance(programs, cirq.Circuit):
             programs, _ = self._resolve_parameters(programs, params)
 
-        serialized_circuits = [serialize_circuit(circuit) for circuit in programs]
+        serialized_circuits: CircuitBatch = [serialize_circuit(circuit) for circuit in programs]
 
         if not self._client:
             raise RuntimeError("Cannot submit circuits since session to IQM client has been closed.")

iqm/iqm_client/iqm_client.py

@@ -45,6 +45,7 @@ from iqm.iqm_client.models import (
     ClientLibrary,
     ClientLibraryDict,
     DynamicQuantumArchitecture,
+    QIRCode,
     QualityMetricSet,
     QuantumArchitectureSpecification,
     RunCounts,
@@ -64,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
@@ -232,6 +234,8 @@ class IQMClient:
 
         for i, circuit in enumerate(circuits):
             try:
+                if isinstance(circuit, (QIRCode)):
+                    continue
                 # validate the circuit against the static information in iqm.iqm_client.models._SUPPORTED_OPERATIONS
                 validate_circuit(circuit)
             except ValueError as e:
@@ -904,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/iqm_client/models.py

@@ -459,7 +459,10 @@ class Circuit(BaseModel):
         return instructions
 
 
-CircuitBatch = list[Circuit]
+QIRCode = str
+"""QIR program code in string representation"""
+
+CircuitBatch = list[Circuit | QIRCode]
 """Type that represents a list of quantum circuits to be executed together in a single batch."""
 
 
@@ -473,7 +476,12 @@ def validate_circuit(circuit: Circuit) -> None:
         pydantic.error_wrappers.ValidationError: validation failed
 
     """
-    Circuit.model_validate(circuit.__dict__)
+    if isinstance(circuit, Circuit):
+        Circuit.model_validate(circuit.__dict__)
+    elif isinstance(circuit, QIRCode):
+        pass
+    else:
+        raise ValueError("Every circuit in a batch should be of type <Circuit> or <QIRCode>")
 
 
 class SingleQubitMapping(BaseModel):
@@ -706,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/iqm_client/validation.py

@@ -18,6 +18,7 @@ from iqm.iqm_client.models import (
     DynamicQuantumArchitecture,
     Instruction,
     MoveGateValidationMode,
+    QIRCode,
 )
 
 
@@ -49,6 +50,8 @@ def validate_qubit_mapping(
 
     # check if qubit mapping covers all qubits in the circuits
     for i, circuit in enumerate(circuits):
+        if isinstance(circuit, (QIRCode)):
+            continue
         diff = circuit.all_qubits() - set(qubit_mapping)
         if diff:
             raise CircuitValidationError(
@@ -86,6 +89,9 @@ def validate_circuit_instructions(
 
     """
     for index, circuit in enumerate(circuits):
+        if isinstance(circuit, QIRCode):
+            continue
+
         measurement_keys: set[str] = set()
         for instr in circuit.instructions:
             validate_instruction(architecture, instr, qubit_mapping)

iqm/qiskit_iqm/iqm_job.py

@@ -24,6 +24,7 @@ import warnings
 from iqm.iqm_client import (
     DEFAULT_TIMEOUT_SECONDS,
     APITimeoutError,
+    Circuit,
     CircuitMeasurementResults,
     HeraldingMode,
     IQMClient,
@@ -79,8 +80,11 @@ class IQMJob(JobV1):
         expect_exact_shots = iqm_result.metadata.heralding_mode == HeraldingMode.NONE
 
         return [
-            (circuit.name, self._format_measurement_results(measurements, requested_shots, expect_exact_shots))
-            for measurements, circuit in zip(iqm_result.measurements, iqm_result.metadata.circuits)
+            (
+                circuit.name if isinstance(circuit, Circuit) else f"circuit_{i}",
+                self._format_measurement_results(measurements, requested_shots, expect_exact_shots),
+            )
+            for i, (measurements, circuit) in enumerate(zip(iqm_result.measurements, iqm_result.metadata.circuits))
         ]
 
     @staticmethod
@@ -194,7 +198,9 @@ class IQMJob(JobV1):
             # was created manually from a job_id. In that case retrieve circuit metadata from
             # RunResult.metadata.request.circuits[n].metadata
             if self.circuit_metadata is None and results.metadata.request is not None:
-                self.circuit_metadata = [c.metadata for c in results.metadata.circuits]
+                self.circuit_metadata = [
+                    c.metadata if isinstance(c, Circuit) else {} for c in results.metadata.circuits
+                ]
 
         result_dict = {
             "backend_name": None,

iqm/qiskit_iqm/iqm_provider.py

@@ -23,6 +23,7 @@ import warnings
 
 from iqm.iqm_client import (
     Circuit,
+    CircuitBatch,
     CircuitCompilationOptions,
     CircuitValidationError,
     IQMClient,
@@ -111,7 +112,7 @@ class IQMBackend(IQMBackendBase):
         run_request = self.create_run_request(run_input, **options)
         job_id = self.client.submit_run_request(run_request)
         job = IQMJob(self, str(job_id), shots=run_request.shots)
-        job.circuit_metadata = [c.metadata for c in run_request.circuits]
+        job.circuit_metadata = [c.metadata if isinstance(c, Circuit) else {} for c in run_request.circuits]
         return job
 
     def create_run_request(
@@ -181,7 +182,7 @@ class IQMBackend(IQMBackendBase):
         if circuit_callback:
             circuit_callback(circuits)
 
-        circuits_serialized: list[Circuit] = [self.serialize_circuit(circuit, qubit_mapping) for circuit in circuits]
+        circuits_serialized: CircuitBatch = [self.serialize_circuit(circuit, qubit_mapping) for circuit in circuits]
 
         if self._use_default_calibration_set:
             default_calset_id = self.client.get_dynamic_quantum_architecture(None).calibration_set_id

{iqm_client-29.9.0.dist-info → iqm_client-29.11.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: iqm-client
-Version: 29.9.0
+Version: 29.11.0
 Summary: Client library for accessing an IQM quantum computer
 Author-email: IQM Finland Oy <developers@meetiqm.com>
 License: Apache License

{iqm_client-29.9.0.dist-info → iqm_client-29.11.0.dist-info}/RECORD

@@ -1,7 +1,7 @@
 iqm/cirq_iqm/__init__.py,sha256=QpdI1542qLHx9eTMy3CFJ7oj2BwVZ_LWKe6KxQAh5Zc,1107
 iqm/cirq_iqm/extended_qasm_parser.py,sha256=csDzfHLhy_9maGbappLbnFo2NHQjQeyd-1F8P380Mbk,1917
 iqm/cirq_iqm/iqm_gates.py,sha256=xnZex5ZfNOk_WSsFjVCRybc14FlGNbmwOs3mIfOE_F8,2488
-iqm/cirq_iqm/iqm_sampler.py,sha256=KLz6j9JcN91GdCAW6fawK99Eyipml3zY89USMVFv2rc,11428
+iqm/cirq_iqm/iqm_sampler.py,sha256=MLHB5FiBXsTCnxjlNJV8LhrIuZ2RS6946zEhI6OBmh4,11456
 iqm/cirq_iqm/optimizers.py,sha256=vJ7BzTLlfULJq-zt3tHQJGv0LzQAdMVlzQxpuw8JdH0,8550
 iqm/cirq_iqm/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 iqm/cirq_iqm/serialize.py,sha256=tRkNrzef24va8UMq_Z-TKCsmP7xXtHm3R5qB2VyiIt4,8141
@@ -21,12 +21,12 @@ iqm/iqm_client/__init__.py,sha256=D-8W54EcQIxk_1JZo_86GYlR1YitHhPIiFwwLJ2IfGE,14
 iqm/iqm_client/api.py,sha256=_c6OVuv2dyzBF7J2XlK_qxisTSPyOiI4gYokZPsuaJY,3083
 iqm/iqm_client/authentication.py,sha256=kHFqPI6w3OAk9k5ioPxi-FrD2EP-vjn8Z_wZYccJVyE,12259
 iqm/iqm_client/errors.py,sha256=ty2P-sg80zlAoL3_kC3PlprgDUv4PI-KFhmmxaaapS0,1429
-iqm/iqm_client/iqm_client.py,sha256=dZo6do3Q562X-wDTXdeLKzlTjjr_00J7CMU04ldYP-I,39450
-iqm/iqm_client/models.py,sha256=PdqpI_6MVCRzQozl6-qGD2LaR-gTdW0at8Lw5KcTBnU,50895
+iqm/iqm_client/iqm_client.py,sha256=yrrpJlSW4N9TCp5zeokHk2lU8N5guYpU643HCMX5oOI,40994
+iqm/iqm_client/models.py,sha256=Sdx_J7wBCM7E_arusU3eC6dQfqu5dpADywr-9JmFvsY,51597
 iqm/iqm_client/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 iqm/iqm_client/transpile.py,sha256=eEv9eY5QG94Lke7Xp6BkQapl1rvlmlVQ_IkQFopPNQ8,36981
 iqm/iqm_client/util.py,sha256=FLRUhhi0YDxomVtilCVPJLixyijFtU10PVefIx-eelw,1516
-iqm/iqm_client/validation.py,sha256=vIwRx9ZjMpR2lciWX0Dlexoozv_KRrZXbu0whvcxIq4,11772
+iqm/iqm_client/validation.py,sha256=IKXBxnhLLnEuUCU2J0q6VEYn9k-O9z_MI4ys7mpFZdE,11912
 iqm/iqm_client/cli/__init__.py,sha256=zzLDDz5rc3lJke3OKU8zxR5zQyQoM9oI2bLJ2YKk_zQ,692
 iqm/iqm_client/cli/auth.py,sha256=SCOZ6QHw9l8oE-A1QSYfAKYuqZxkZkYrwaNWzGFY1AU,6363
 iqm/iqm_client/cli/cli.py,sha256=YhTgOGrvNXPwCdCKHcwLHeE_6C3n91MxFhvgQYT78C4,28633
@@ -36,10 +36,10 @@ iqm/qiskit_iqm/__init__.py,sha256=Mv9V_r8ZcmGC8Ke5S8-7yLOx02vjZ1qiVx8mtbOpwnY,14
 iqm/qiskit_iqm/iqm_backend.py,sha256=LhyhccB9u_Y4lyFTzAQkYfX7CI_hbBx3CQHwbwR3wlA,13975
 iqm/qiskit_iqm/iqm_circuit.py,sha256=fFQW8SRlgZjqZUOLfyuJhhXEDp5I1jopFWa1k4rb7ac,1384
 iqm/qiskit_iqm/iqm_circuit_validation.py,sha256=vE5CNyJOQ7OMRpQV-xsO1uf_NNFE8v6-TSzboFSrGYM,1721
-iqm/qiskit_iqm/iqm_job.py,sha256=_JF2DANalsRu4b0r-XxMmTNOqmaShjp1rmU7h44DKRo,11466
+iqm/qiskit_iqm/iqm_job.py,sha256=Q26hk4JuZP48Xw3qVk4b44LrHbgNQp-mq_itF9umkqg,11666
 iqm/qiskit_iqm/iqm_move_layout.py,sha256=pHqV1G4bri3rFEsMBN6FrtQ0FXVNQG-Ymm4v7zdnilQ,10787
 iqm/qiskit_iqm/iqm_naive_move_pass.py,sha256=HoLPgkRK7X2g8KM2ML5-rggNE5HIfGEzq4vkthYSPyg,12398
-iqm/qiskit_iqm/iqm_provider.py,sha256=TjrpZZIAI2_K3pWG6sn30M3jFfEDAWp64_4pDis0OU8,16589
+iqm/qiskit_iqm/iqm_provider.py,sha256=5L2-GFbTqMlW7JTagRxl2pV2kw0KKA4hw2YGLYsoUvk,16640
 iqm/qiskit_iqm/iqm_transpilation.py,sha256=2bwvVd8NwBRU6gwlPOsovhyAmUnm8thKokvkuCwfWC8,8915
 iqm/qiskit_iqm/move_gate.py,sha256=QU9RKKVvbGq33qcIi9AKLcvQVQMibkgW4ibjzk-oVy4,2808
 iqm/qiskit_iqm/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
@@ -56,10 +56,10 @@ iqm/qiskit_iqm/fake_backends/fake_apollo.py,sha256=eT2vd3kQBi1rrvxCpePymBCfFK84d
 iqm/qiskit_iqm/fake_backends/fake_deneb.py,sha256=RzQXmLXmBARDiMKVxk5Aw9fVbc6IYlW0A5jibk9iYD0,3156
 iqm/qiskit_iqm/fake_backends/fake_garnet.py,sha256=GI0xafTCj1Um09qVuccO6GPOGBm6ygul_O40Wu220Ys,5555
 iqm/qiskit_iqm/fake_backends/iqm_fake_backend.py,sha256=wJtfsxjPYbDKmzaz5R4AuaXvvPHa21WyPtRgNctL9eY,16785
-iqm_client-29.9.0.dist-info/AUTHORS.rst,sha256=qsxeK5A3-B_xK3hNbhFHEIkoHNpo7sdzYyRTs7Bdtm8,795
-iqm_client-29.9.0.dist-info/LICENSE.txt,sha256=2DXrmQtVVUV9Fc9RBFJidMiTEaQlG2oAtlC9PMrEwTk,11333
-iqm_client-29.9.0.dist-info/METADATA,sha256=nk6c2OpBQlMAuR1Vt8IuSn3KdF_H1VtM_LXpOMH2-WI,17590
-iqm_client-29.9.0.dist-info/WHEEL,sha256=y4mX-SOX4fYIkonsAGA5N0Oy-8_gI4FXw5HNI1xqvWg,91
-iqm_client-29.9.0.dist-info/entry_points.txt,sha256=Kk2qfRwk8vbIJ7qCAvmaUogfRRn6t92_hBFhe6kqAE4,1317
-iqm_client-29.9.0.dist-info/top_level.txt,sha256=NB4XRfyDS6_wG9gMsyX-9LTU7kWnTQxNvkbzIxGv3-c,4
-iqm_client-29.9.0.dist-info/RECORD,,
+iqm_client-29.11.0.dist-info/AUTHORS.rst,sha256=qsxeK5A3-B_xK3hNbhFHEIkoHNpo7sdzYyRTs7Bdtm8,795
+iqm_client-29.11.0.dist-info/LICENSE.txt,sha256=2DXrmQtVVUV9Fc9RBFJidMiTEaQlG2oAtlC9PMrEwTk,11333
+iqm_client-29.11.0.dist-info/METADATA,sha256=yvcSPUwsECazAvq9XipwpCL511HB2NGswPmSdlflKn4,17591
+iqm_client-29.11.0.dist-info/WHEEL,sha256=y4mX-SOX4fYIkonsAGA5N0Oy-8_gI4FXw5HNI1xqvWg,91
+iqm_client-29.11.0.dist-info/entry_points.txt,sha256=Kk2qfRwk8vbIJ7qCAvmaUogfRRn6t92_hBFhe6kqAE4,1317
+iqm_client-29.11.0.dist-info/top_level.txt,sha256=NB4XRfyDS6_wG9gMsyX-9LTU7kWnTQxNvkbzIxGv3-c,4
+iqm_client-29.11.0.dist-info/RECORD,,