iqm-client 29.7.0__tar.gz → 29.9.0__tar.gz

{iqm_client-29.7.0 → iqm_client-29.9.0}/CHANGELOG.rst

@@ -2,6 +2,23 @@
 Changelog
 =========
 
+Version 29.9.0 (2025-07-29)
+===========================
+
+Features
+--------
+
+- Remove cocos from IQM_SERVER_URL
+
+Version 29.8.0 (2025-07-23)
+===========================
+
+Features
+--------
+
+- An update to IQMFacadeBackend such that all available IQMFakeBackends are usable for simulation, rather than
+just IQMFakeAdonis
+
 Version 29.7.0 (2025-07-15)
 ===========================
 

{iqm_client-29.7.0 → iqm_client-29.9.0}/INTEGRATION_GUIDE.rst

@@ -22,7 +22,7 @@ requires only the URL of the IQM quantum computer.
 
     from iqm.iqm_client import IQMClient
 
-    server_url = "https://STATION_CONTROL_URL"
+    server_url = "https://IQM_SERVER_URL/station"
 
     iqm_client = IQMClient(server_url)
 

{iqm_client-29.7.0 → iqm_client-29.9.0}/PKG-INFO

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

{iqm_client-29.7.0 → iqm_client-29.9.0}/docs/user_guide_qiskit.rst

@@ -102,10 +102,7 @@ If the IQM server you are connecting to requires authentication, you may use
 then set the :envvar:`IQM_TOKENS_FILE` environment variable, as instructed, to point to the tokens file.
 See IQM Client CLI's `documentation <https://docs.meetiqm.com/iqm-client/user_guide_cli.html>`__ for details.
 
-You may also authenticate yourself using the :envvar:`IQM_AUTH_SERVER`,
-:envvar:`IQM_AUTH_USERNAME` and :envvar:`IQM_AUTH_PASSWORD` environment variables, or pass them as
-arguments to :class:`.IQMProvider`, however this approach is less secure and considered deprecated.
-
+You may also authenticate yourself by setting the access token in the the :envvar:`IQM_TOKEN` variable
 
 Running quantum circuits on an IQM quantum computer
 ---------------------------------------------------
@@ -156,7 +153,7 @@ circuit(s) are sampled:
     from qiskit import transpile
     from iqm.qiskit_iqm import IQMProvider
 
-    iqm_server_url = "https://demo.qc.iqm.fi/cocos/"  # Replace this with the correct URL
+    iqm_server_url = "https://demo.qc.iqm.fi"  # Replace this with the correct URL
     provider = IQMProvider(iqm_server_url)
     backend = provider.get_backend()
 
@@ -734,9 +731,10 @@ Results from such executions are random bits. This may be useful when developing
 Qiskit on IQM contains :class:`.IQMFacadeBackend`, which allows to combine the mock remote execution with a local
 noisy quantum circuit simulation. This way you can both validate your integration as well as get an idea of the expected circuit execution results.
 
-To run a circuit this way, use the ``"facade_adonis"`` backend retrieved from the provider. Note that the provider must be
-initialized with the URL of a quantum computer with the equivalent architecture (i.e. names of qubits, their
-connectivity, and the native gateset should match the 5-qubit Adonis architecture).
+To run a circuit this way, use the ``"facade_x"``, (where `x` is one of the adonis, aprhodite, apollo, deneb or garnet architectures) backend retrieved from the provider.
+Note that the provider must be initialized with the URL of a quantum computer with the equivalent architecture (i.e. names of qubits, their
+connectivity, and the native gateset should match the desired architecture). 
+Additionally, the URL should point to a mock environment rather than a real device as the execution results from the remote will be discarded and replaced by a simulated result generated by Qiskit Aer.
 
 .. code-block:: python
 
@@ -748,7 +746,7 @@ connectivity, and the native gateset should match the 5-qubit Adonis architectur
     circuit.cx(0, 1)
     circuit.measure_all()
 
-    iqm_server_url = "https://demo.qc.iqm.fi/cocos/"  # Replace this with the correct URL
+    iqm_server_url = "https://demo.qc.iqm.fi/"  # Replace this with the correct URL
     provider = IQMProvider(iqm_server_url)
     backend = provider.get_backend('facade_adonis')
     transpiled_circuit = transpile(circuit, backend=backend)

{iqm_client-29.7.0 → iqm_client-29.9.0}/src/iqm/cirq_iqm/examples/demo_iqm_execution.py

@@ -14,14 +14,14 @@
 """Demonstrates executing a quantum circuit on an IQM quantum computer.
 
 Set the STATION_CONTROL_URL environment variable before running this script.
-Also, if the server you are running against requires authentication you will also have to set
-IQM_AUTH_SERVER, and either IQM_TOKENS_FILE or both of IQM_AUTH_USERNAME and IQM_AUTH_PASSWORD.
+Also, if the server you are running against requires authentication you will also have to use
+the IQM_TOKENS_FILE or the IQM_TOKEN variable to set the access token.
 
 E.g.
 
     export STATION_CONTROL_URL="https://example.com/station"
-    export IQM_AUTH_SERVER="https://example.com/auth"
     export IQM_TOKENS_FILE="/path/to/my/tokens.json"
+    export IQM_TOKEN="<token here>"
 """
 
 import os

{iqm_client-29.7.0 → iqm_client-29.9.0}/src/iqm/qiskit_iqm/iqm_provider.py

@@ -21,9 +21,17 @@ from typing import Any
 from uuid import UUID
 import warnings
 
-from iqm.iqm_client import Circuit, CircuitCompilationOptions, CircuitValidationError, IQMClient, RunRequest
+from iqm.iqm_client import (
+    Circuit,
+    CircuitCompilationOptions,
+    CircuitValidationError,
+    IQMClient,
+    RunRequest,
+)
 from iqm.iqm_client.util import to_json_dict
+from iqm.qiskit_iqm import IQMFakeAphrodite, IQMFakeApollo, IQMFakeDeneb
 from iqm.qiskit_iqm.fake_backends import IQMFakeAdonis
+from iqm.qiskit_iqm.fake_backends.fake_garnet import IQMFakeGarnet
 from iqm.qiskit_iqm.iqm_backend import IQMBackendBase
 from iqm.qiskit_iqm.iqm_job import IQMJob
 from iqm.qiskit_iqm.qiskit_to_iqm import serialize_instructions
@@ -257,26 +265,31 @@ class IQMBackend(IQMBackendBase):
         return Circuit(name=circuit.name, instructions=instructions, metadata=metadata)
 
 
+facade_names = {
+    "facade_adonis": IQMFakeAdonis(),
+    "facade_aphrodite": IQMFakeAphrodite(),
+    "facade_apollo": IQMFakeApollo(),
+    "facade_deneb": IQMFakeDeneb(),
+    "facade_garnet": IQMFakeGarnet(),
+}
+
+
 class IQMFacadeBackend(IQMBackend):
-    """Facade backend for mimicking the execution of quantum circuits on IQM quantum computers. Allows to submit a
-     circuit to the IQM server, and if the execution was successful, performs a simulation with a respective IQM noise
-     model locally, then returns the simulated results.
+    """Simulates the execution of quantum circuits on a mock IQM quantum computer.
+
+    Can be used to submit a circuit to a mock IQM server that has no real quantum hardware,
+    and if the mock execution is successful, simulates the circuit locally using an error model that
+    is representative of the mocked QPU. Finally returns the simulated results.
 
     Args:
-        client: client instance for communicating with an IQM server
-        **kwargs: optional arguments to be passed to the parent Backend initializer
+        client: Client instance for communicating with an IQM server.
+        **kwargs: Optional arguments to be passed to the parent class.
 
     """
 
     def __init__(self, client: IQMClient, **kwargs):
-        self.fake_adonis = IQMFakeAdonis()
-        target_architecture = client.get_static_quantum_architecture()
-
-        if not self.fake_adonis.validate_compatible_architecture(target_architecture):
-            raise ValueError("Quantum architecture of the remote quantum computer does not match Adonis.")
-
         super().__init__(client, **kwargs)
-        self.name = "facade_adonis"
+        self.backend = self._determine_facade_backend_from_sqa()
 
     def _validate_no_empty_cregs(self, circuit: QuantumCircuit) -> bool:
         """Returns True if given circuit has no empty (unused) classical registers, False otherwise."""
@@ -289,6 +302,12 @@ class IQMFacadeBackend(IQMBackend):
             return False
         return True
 
+    def _determine_facade_backend_from_sqa(self) -> IQMFacadeBackend:
+        for backend in facade_names.values():
+            if backend.validate_compatible_architecture(self.client.get_static_quantum_architecture()):
+                return backend
+        raise ValueError("Quantum architecture of the remote quantum computer does not match facade input.")
+
     def run(self, run_input: QuantumCircuit | list[QuantumCircuit], **options) -> JobV1:
         circuits = [run_input] if isinstance(run_input, QuantumCircuit) else run_input
         circuits_validated_cregs: list[bool] = [self._validate_no_empty_cregs(circuit) for circuit in circuits]
@@ -302,7 +321,7 @@ class IQMFacadeBackend(IQMBackend):
         iqm_backend_job.result()  # get and discard results
         if iqm_backend_job.status() == JobStatus.ERROR:
             raise RuntimeError("Remote execution did not succeed.")
-        return self.fake_adonis.run(run_input, **options)
+        return self.backend.run(run_input, **options)
 
 
 class IQMProvider:
@@ -336,7 +355,9 @@ class IQMProvider:
         client = IQMClient(self.url, **self.user_auth_args)
 
         if name and name.startswith("facade_"):
-            if name == "facade_adonis":
+            if name in facade_names:
+                if not facade_names[name].validate_compatible_architecture(client.get_static_quantum_architecture()):
+                    raise ValueError("Quantum architecture of the remote quantum computer does not match facade input.")
                 return IQMFacadeBackend(client)
 
             warnings.warn(f"Unknown facade backend: {name}. A regular backend associated with {self.url} will be used.")

{iqm_client-29.7.0 → iqm_client-29.9.0}/src/iqm_client.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: iqm-client
-Version: 29.7.0
+Version: 29.9.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/version.txt

@@ -0,0 +1 @@
+29.9.0

iqm_client-29.7.0/version.txt

@@ -1 +0,0 @@
-29.7.0