iqm-pulla 10.0.0__tar.gz → 11.0.0__tar.gz

{iqm_pulla-10.0.0 → iqm_pulla-11.0.0}/CHANGELOG.rst

@@ -2,6 +2,24 @@
 Changelog
 =========
 
+Version 11.0.0 (2025-09-11)
+===========================
+
+Breaking changes
+----------------
+
+- Replace :class:`iqm.cpc.interface.compiler.Circuit` with :class:`iqm.pulse.Circuit`.
+  :issue:`SW-1663`
+- Remove ``Instruction`` and ``Circuit`` models from ``iqm.pulla.interface``. :issue:`SW-1663`
+
+Version 10.1.0 (2025-09-08)
+===========================
+
+Features
+--------
+
+- bump iqm-pulse version
+
 Version 10.0.0 (2025-09-08)
 ===========================
 

{iqm_pulla-10.0.0 → iqm_pulla-11.0.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: iqm-pulla
-Version: 10.0.0
+Version: 11.0.0
 Summary: Client library for pulse-level access to an IQM quantum computer
 Author-email: IQM Finland Oy <developers@meetiqm.com>
 License:                                  Apache License
@@ -218,29 +218,29 @@ License-File: LICENSE.txt
 License-File: AUTHORS.rst
 Requires-Dist: iqm-exa-common<27,>=26
 Requires-Dist: iqm-station-control-client<10,>=9
-Requires-Dist: iqm-pulse<12,>=11
+Requires-Dist: iqm-pulse<13,>=12
 Requires-Dist: iqm-data-definitions<3.0,>=2.13
 Requires-Dist: pylatexenc==2.10
 Requires-Dist: pydantic<3.0,>=2.10.4
 Provides-Extra: notebook
 Requires-Dist: iqm-exa-common<27,>=26; extra == "notebook"
 Requires-Dist: iqm-station-control-client<10,>=9; extra == "notebook"
-Requires-Dist: iqm-pulse<12,>=11; extra == "notebook"
+Requires-Dist: iqm-pulse<13,>=12; extra == "notebook"
 Requires-Dist: notebook<7,>=6.4.11; extra == "notebook"
 Requires-Dist: matplotlib<4,>=3.6.3; extra == "notebook"
 Requires-Dist: nbclient~=0.5.10; extra == "notebook"
 Provides-Extra: qir
 Requires-Dist: iqm-exa-common<27,>=26; extra == "qir"
 Requires-Dist: iqm-station-control-client<10,>=9; extra == "qir"
-Requires-Dist: iqm-pulse<12,>=11; extra == "qir"
+Requires-Dist: iqm-pulse<13,>=12; extra == "qir"
 Requires-Dist: iqm-pyqir==0.12.0; extra == "qir"
 Requires-Dist: iqm-qiskit-qir==0.8.0; extra == "qir"
 Provides-Extra: qiskit
 Requires-Dist: iqm-exa-common<27,>=26; extra == "qiskit"
 Requires-Dist: iqm-station-control-client<10,>=9; extra == "qiskit"
-Requires-Dist: iqm-pulse<12,>=11; extra == "qiskit"
-Requires-Dist: iqm-client[qiskit]<31,>=30; extra == "qiskit"
-Requires-Dist: iqm-client<31,>=30; extra == "qiskit"
+Requires-Dist: iqm-pulse<13,>=12; extra == "qiskit"
+Requires-Dist: iqm-client<32,>=31; extra == "qiskit"
+Requires-Dist: iqm-client[qiskit]<32,>=31; extra == "qiskit"
 
 IQM Pulla
 #########

{iqm_pulla-10.0.0 → iqm_pulla-11.0.0}/docs/Compilation Stages.ipynb

@@ -36,6 +36,7 @@
    "outputs": [],
    "source": [
     "import os\n",
+    "from math import pi\n",
     "from pprint import pprint\n",
     "from qiskit import QuantumCircuit, visualization\n",
     "from qiskit.compiler import transpile\n",
@@ -258,7 +259,7 @@
    },
    "outputs": [],
    "source": [
-    "from iqm.cpc.interface.compiler import CircuitOperation\n",
+    "from iqm.pulse import CircuitOperation\n",
     "\n",
     "\n",
     "def add_leading_barrier(circuits, context):\n",
@@ -279,7 +280,7 @@
    "source": [
     "Note that the function takes data and context and returns data and context. It happens to neither use nor modify the context, but it should still provide it down to the next passes.\n",
     "\n",
-    "Ok, let's define another pass: this one would increase the phase of each `prx` operation by `0.25`. This may or may\n",
+    "Ok, let's define another pass: this one would increase the phase of each `prx` operation by `0.5 * pi`. This may or may\n",
     "not make practical sense, but bear with us for the purposes of illustration:"
    ]
   },
@@ -296,12 +297,12 @@
    "outputs": [],
    "source": [
     "def increase_phase(circuits, context):\n",
-    "    \"\"\"Add 0.25 to phase_t of each prx gate.\"\"\"\n",
+    "    \"\"\"Add 0.5*pi to phase of each prx gate.\"\"\"\n",
     "    for circuit in circuits:\n",
     "        for instruction in circuit.instructions:\n",
     "            if instruction.name == 'prx':\n",
     "                print(instruction.args)\n",
-    "                instruction.args['phase_t'] += 0.25\n",
+    "                instruction.args['phase'] += 0.5 * pi\n",
     "    return circuits, context"
    ]
   },

{iqm_pulla-10.0.0 → iqm_pulla-11.0.0}/docs/Custom Gates and Implementations.ipynb

@@ -560,12 +560,9 @@
     "class StretchedX(CompositeGate):\n",
     "    registered_gates = ('prx',)  # use the standard prx as a building block\n",
     "\n",
-    "    def __call__(self, angle_t: float, phase_t: float):\n",
+    "    def __call__(self, angle: float, phase: float):\n",
     "        normal_prx = self.build(\"prx\", self.locus)\n",
-    "        # convert args to radians, which is what prx uses on the schedule level\n",
-    "        phase = phase_t * 2 * np.pi\n",
-    "        angle = angle_t * 2 * np.pi\n",
-    "        if angle_t != 0.5:\n",
+    "        if angle != np.pi:\n",
     "            return normal_prx(angle, phase)\n",
     "\n",
     "        half = normal_prx(np.pi / 2, phase)\n",
@@ -589,7 +586,7 @@
    "outputs": [],
    "source": [
     "circuits, compiler = qiskit_to_pulla(p, backend, example_qiskit_circuit())\n",
-    "compiler.add_implementation('custom_x', 'StretchedX', StretchedX, quantum_op=QuantumOp('custom_x', params=('angle_t', 'phase_t')))\n",
+    "compiler.add_implementation('custom_x', 'StretchedX', StretchedX, quantum_op=QuantumOp('custom_x', params={'angle': (float,), 'phase': (float,)}))\n",
     "\n",
     "c = circuits[0]\n",
     "for inst in c.instructions:\n",

{iqm_pulla-10.0.0 → iqm_pulla-11.0.0}/docs/Example - Measuring T1.ipynb

@@ -129,7 +129,8 @@
     }
    ],
    "source": [
-    "from iqm.cpc.interface.compiler import Circuit, CircuitOperation as Op\n",
+    "from iqm.pulse import Circuit\n",
+    "from iqm.pulse import CircuitOperation as Op\n",
     "import numpy as np\n",
     "\n",
     "time_axis = np.linspace(0.0, 300e-6, 51) # In seconds\n",

{iqm_pulla-10.0.0 → iqm_pulla-11.0.0}/docs/Quick Start.ipynb

@@ -369,7 +369,7 @@
     "\n",
     "p = Pulla(quantum_computer_url, get_token_callback=lambda: f\"Bearer {api_token}\")\n",
     "provider = IQMProvider(quantum_computer_url, token=api_token)\n",
-    "backend = provider.get_backend()\n",
+    "backend = provider.get_backend(use_metrics=False)\n",
     "\n",
     "# From now on, the usage is same as for direct station control usage \n",
     "# qc = ...\n",

{iqm_pulla-10.0.0 → iqm_pulla-11.0.0}/requirements/base.txt

@@ -1,6 +1,6 @@
 iqm-exa-common>=26,<27
 iqm-station-control-client>=9,<10
-iqm-pulse>=11,<12
+iqm-pulse>=12,<13
 iqm-data-definitions >= 2.13, < 3.0
 pylatexenc == 2.10
 pydantic >= 2.10.4, < 3.0

{iqm_pulla-10.0.0 → iqm_pulla-11.0.0}/requirements/notebook.txt

@@ -1,6 +1,6 @@
 iqm-exa-common>=26,<27
 iqm-station-control-client>=9,<10
-iqm-pulse>=11,<12
+iqm-pulse>=12,<13
 notebook >= 6.4.11, < 7
 matplotlib >= 3.6.3, < 4
 nbclient~=0.5.10

{iqm_pulla-10.0.0 → iqm_pulla-11.0.0}/requirements/qir.txt

@@ -1,5 +1,5 @@
 iqm-exa-common>=26,<27
 iqm-station-control-client>=9,<10
-iqm-pulse>=11,<12
+iqm-pulse>=12,<13
 iqm-pyqir==0.12.0
 iqm-qiskit-qir==0.8.0

iqm_pulla-11.0.0/requirements/qiskit.txt

@@ -0,0 +1,5 @@
+iqm-exa-common>=26,<27
+iqm-station-control-client>=9,<10
+iqm-pulse>=12,<13
+iqm-client>=31,<32
+iqm-client[qiskit]>=31,<32

{iqm_pulla-10.0.0 → iqm_pulla-11.0.0}/src/iqm/cpc/compiler/standard_stages.py

@@ -763,7 +763,7 @@ def clean_schedule(schedules: Iterable[Schedule], builder: ScheduleBuilder) -> l
 @compiler_pass
 def build_playlist(schedules: Iterable[Schedule], builder: ScheduleBuilder) -> tuple[Playlist, dict[str, Any]]:
     """Build the playlist from the schedules."""
-    playlist = builder.build_playlist(schedules)
+    playlist = builder.build_playlist(schedules)[0]
     return playlist, {"schedules": schedules}  # save the schedules for building settings, debugging, etc
 
 

{iqm_pulla-10.0.0 → iqm_pulla-11.0.0}/src/iqm/cpc/interface/compiler.py

@@ -19,20 +19,10 @@ from enum import StrEnum
 from typing import TypeAlias
 
 from exa.common.data.setting_node import SettingNode
-from iqm.pulse.builder import CircuitOperation, Locus
+from iqm.pulse import Circuit
+from iqm.pulse.builder import Locus
 from iqm.pulse.playlist.playlist import Playlist
 
-
-@dataclass
-class Circuit:
-    """Quantum circuit to be executed."""
-
-    name: str
-    """name of the circuit"""
-    instructions: tuple[CircuitOperation, ...]
-    """operations comprising the circuit"""
-
-
 CircuitBatch: TypeAlias = list[Circuit]
 """Type that represents a list of quantum circuits to be executed together in a single batch."""
 

{iqm_pulla-10.0.0 → iqm_pulla-11.0.0}/src/iqm/pulla/interface.py

@@ -19,56 +19,11 @@ Many of these must be identical to those in iqm-client.
 
 from dataclasses import dataclass
 from enum import StrEnum
-from typing import Any, TypeAlias
+from typing import TypeAlias
 from uuid import UUID
 
-from pydantic import BaseModel, Field
-
 from exa.common.data.value import ObservationValue
-from iqm.cpc.interface.compiler import Circuit as CPC_Circuit
-from iqm.cpc.interface.compiler import CircuitOperation, Locus
-
-
-class Instruction(BaseModel):
-    """An instruction in a quantum circuit."""
-
-    name: str = Field(..., description="name of the quantum operation", examples=["measurement"])
-    """name of the quantum operation"""
-    implementation: str | None = Field(None, description="name of the implementation")
-    """name of the implementation"""
-    qubits: tuple[str, ...] = Field(
-        ...,
-        description="names of the logical qubits the operation acts on",
-        examples=[("alice",)],
-    )
-    """names of the logical qubits the operation acts on"""
-    args: dict[str, Any] = Field(
-        ...,
-        description="arguments for the operation",
-        examples=[{"key": "m"}],
-    )
-    """arguments for the operation"""
-
-    def to_dataclass(self) -> CircuitOperation:
-        """Convert the model to a dataclass."""
-        return CircuitOperation(name=self.name, implementation=self.implementation, locus=self.qubits, args=self.args)
-
-
-class Circuit(BaseModel):
-    """Quantum circuit to be executed."""
-
-    name: str = Field(..., description="name of the circuit", examples=["test circuit"])
-    """name of the circuit"""
-    instructions: tuple[Instruction, ...] = Field(..., description="instructions comprising the circuit")
-    """instructions comprising the circuit"""
-    metadata: dict[str, Any] | None = Field(None, description="arbitrary metadata associated with the circuit")
-    """arbitrary metadata associated with the circuit"""
-
-    def to_dataclass(self) -> CPC_Circuit:
-        """Convert the model to a dataclass."""
-        return CPC_Circuit(
-            name=self.name, instructions=tuple(instruction.to_dataclass() for instruction in self.instructions)
-        )
+from iqm.cpc.interface.compiler import Locus
 
 
 class CHADRetrievalException(Exception):

{iqm_pulla-10.0.0 → iqm_pulla-11.0.0}/src/iqm/pulla/utils_qir.py

@@ -39,7 +39,7 @@ from qiskit.providers import BackendV2
 
 from iqm.cpc.compiler.compiler import Compiler
 from iqm.cpc.interface.compiler import Circuit as CPC_Circuit
-from iqm.pulse.builder import CircuitOperation
+from iqm.pulse import CircuitOperation
 
 qir_logger = logging.getLogger(__name__)
 

{iqm_pulla-10.0.0 → iqm_pulla-11.0.0}/src/iqm/pulla/utils_qiskit.py

@@ -19,7 +19,6 @@ from collections import Counter
 from collections.abc import Collection, Sequence
 from typing import TYPE_CHECKING
 
-from iqm.iqm_client import Circuit
 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
@@ -27,13 +26,10 @@ from qiskit import QuantumCircuit
 from qiskit.providers import JobStatus, JobV1, Options
 from qiskit.result import Counts, Result
 
-from iqm.cpc.interface.compiler import Circuit as CPC_Circuit
-from iqm.cpc.interface.compiler import CircuitExecutionOptions, HeraldingMode
+from iqm.cpc.interface.compiler import Circuit, CircuitExecutionOptions, HeraldingMode
 from iqm.pulla.interface import StationControlResult, TaskStatus
-from iqm.pulse.builder import CircuitOperation
 
 if TYPE_CHECKING:
-    from iqm.iqm_client import Instruction
     from iqm.qiskit_iqm.iqm_backend import DynamicQuantumArchitecture
     from iqm.qiskit_iqm.iqm_provider import IQMBackend
 
@@ -41,29 +37,11 @@ if TYPE_CHECKING:
     from iqm.pulla.pulla import Pulla
 
 
-def _instruction_to_dataclass(instruction: Instruction) -> CircuitOperation:
-    """Convert the iqm-client model to an iqm-pulse dataclass."""
-    return CircuitOperation(
-        name=instruction.name,
-        implementation=instruction.implementation,
-        locus=instruction.qubits,
-        args=instruction.args,
-    )
-
-
-def _circuit_to_dataclass(circuit: Circuit) -> CPC_Circuit:
-    """Convert the iqm-client model to a CPC dataclass."""
-    return CPC_Circuit(
-        name=circuit.name,
-        instructions=tuple(_instruction_to_dataclass(instruction) for instruction in circuit.instructions),
-    )
-
-
 def qiskit_circuits_to_pulla(
     qiskit_circuits: QuantumCircuit | Sequence[QuantumCircuit],
     qubit_idx_to_name: dict[int, str],
     custom_gates: Collection[str] = (),
-) -> list[CPC_Circuit]:
+) -> list[Circuit]:
     """Convert Qiskit quantum circuits into IQM Pulse quantum circuits.
 
     Lower-level method, you may want to use :func:`qiskit_to_pulla` instead.
@@ -83,17 +61,14 @@ def qiskit_circuits_to_pulla(
         qiskit_circuits = [qiskit_circuits]
 
     return [
-        CPC_Circuit(
+        Circuit(
             name=qiskit_circuit.name,
             instructions=tuple(
-                map(
-                    _instruction_to_dataclass,
-                    serialize_instructions(
-                        qiskit_circuit,
-                        qubit_idx_to_name,
-                        custom_gates,
-                    ),
-                )
+                serialize_instructions(
+                    qiskit_circuit,
+                    qubit_idx_to_name,
+                    custom_gates,
+                ),
             ),
         )
         for qiskit_circuit in qiskit_circuits
@@ -104,7 +79,7 @@ def qiskit_to_pulla(
     pulla: Pulla,
     backend: IQMBackend,
     qiskit_circuits: QuantumCircuit | Sequence[QuantumCircuit],
-) -> tuple[list[CPC_Circuit], Compiler]:
+) -> tuple[list[Circuit], Compiler]:
     """Convert transpiled Qiskit quantum circuits to IQM Pulse quantum circuits.
 
     Also provides the Compiler object for compiling them, with the correct
@@ -140,8 +115,7 @@ def qiskit_to_pulla(
 
     # We can be certain run_request contains only Circuit objects, because we created it
     # right in this method with qiskit.QuantumCircuit objects
-    run_request_iqm_circuits: list[Circuit] = [c for c in run_request.circuits if isinstance(c, (Circuit))]
-    circuits = [_circuit_to_dataclass(c) for c in run_request_iqm_circuits]
+    circuits: list[Circuit] = [c for c in run_request.circuits if isinstance(c, Circuit)]
     return circuits, compiler
 
 

{iqm_pulla-10.0.0 → iqm_pulla-11.0.0}/src/iqm_pulla.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: iqm-pulla
-Version: 10.0.0
+Version: 11.0.0
 Summary: Client library for pulse-level access to an IQM quantum computer
 Author-email: IQM Finland Oy <developers@meetiqm.com>
 License:                                  Apache License
@@ -218,29 +218,29 @@ License-File: LICENSE.txt
 License-File: AUTHORS.rst
 Requires-Dist: iqm-exa-common<27,>=26
 Requires-Dist: iqm-station-control-client<10,>=9
-Requires-Dist: iqm-pulse<12,>=11
+Requires-Dist: iqm-pulse<13,>=12
 Requires-Dist: iqm-data-definitions<3.0,>=2.13
 Requires-Dist: pylatexenc==2.10
 Requires-Dist: pydantic<3.0,>=2.10.4
 Provides-Extra: notebook
 Requires-Dist: iqm-exa-common<27,>=26; extra == "notebook"
 Requires-Dist: iqm-station-control-client<10,>=9; extra == "notebook"
-Requires-Dist: iqm-pulse<12,>=11; extra == "notebook"
+Requires-Dist: iqm-pulse<13,>=12; extra == "notebook"
 Requires-Dist: notebook<7,>=6.4.11; extra == "notebook"
 Requires-Dist: matplotlib<4,>=3.6.3; extra == "notebook"
 Requires-Dist: nbclient~=0.5.10; extra == "notebook"
 Provides-Extra: qir
 Requires-Dist: iqm-exa-common<27,>=26; extra == "qir"
 Requires-Dist: iqm-station-control-client<10,>=9; extra == "qir"
-Requires-Dist: iqm-pulse<12,>=11; extra == "qir"
+Requires-Dist: iqm-pulse<13,>=12; extra == "qir"
 Requires-Dist: iqm-pyqir==0.12.0; extra == "qir"
 Requires-Dist: iqm-qiskit-qir==0.8.0; extra == "qir"
 Provides-Extra: qiskit
 Requires-Dist: iqm-exa-common<27,>=26; extra == "qiskit"
 Requires-Dist: iqm-station-control-client<10,>=9; extra == "qiskit"
-Requires-Dist: iqm-pulse<12,>=11; extra == "qiskit"
-Requires-Dist: iqm-client[qiskit]<31,>=30; extra == "qiskit"
-Requires-Dist: iqm-client<31,>=30; extra == "qiskit"
+Requires-Dist: iqm-pulse<13,>=12; extra == "qiskit"
+Requires-Dist: iqm-client<32,>=31; extra == "qiskit"
+Requires-Dist: iqm-client[qiskit]<32,>=31; extra == "qiskit"
 
 IQM Pulla
 #########

{iqm_pulla-10.0.0 → iqm_pulla-11.0.0}/src/iqm_pulla.egg-info/requires.txt

@@ -1,6 +1,6 @@
 iqm-exa-common<27,>=26
 iqm-station-control-client<10,>=9
-iqm-pulse<12,>=11
+iqm-pulse<13,>=12
 iqm-data-definitions<3.0,>=2.13
 pylatexenc==2.10
 pydantic<3.0,>=2.10.4
@@ -8,7 +8,7 @@ pydantic<3.0,>=2.10.4
 [notebook]
 iqm-exa-common<27,>=26
 iqm-station-control-client<10,>=9
-iqm-pulse<12,>=11
+iqm-pulse<13,>=12
 notebook<7,>=6.4.11
 matplotlib<4,>=3.6.3
 nbclient~=0.5.10
@@ -16,13 +16,13 @@ nbclient~=0.5.10
 [qir]
 iqm-exa-common<27,>=26
 iqm-station-control-client<10,>=9
-iqm-pulse<12,>=11
+iqm-pulse<13,>=12
 iqm-pyqir==0.12.0
 iqm-qiskit-qir==0.8.0
 
 [qiskit]
 iqm-exa-common<27,>=26
 iqm-station-control-client<10,>=9
-iqm-pulse<12,>=11
-iqm-client[qiskit]<31,>=30
-iqm-client<31,>=30
+iqm-pulse<13,>=12
+iqm-client<32,>=31
+iqm-client[qiskit]<32,>=31

iqm_pulla-11.0.0/version.txt

@@ -0,0 +1 @@
+11.0.0

iqm_pulla-10.0.0/requirements/qiskit.txt

@@ -1,5 +0,0 @@
-iqm-exa-common>=26,<27
-iqm-station-control-client>=9,<10
-iqm-pulse>=11,<12
-iqm-client[qiskit]>=30,<31
-iqm-client>=30,<31

iqm_pulla-10.0.0/version.txt

@@ -1 +0,0 @@
-10.0.0