iqm-pulla 9.0.0__tar.gz → 9.2.0__tar.gz

{iqm_pulla-9.0.0 → iqm_pulla-9.2.0}/CHANGELOG.rst

@@ -2,6 +2,22 @@
 Changelog
 =========
 
+Version 9.2.0 (2025-07-31)
+==========================
+
+Features
+--------
+
+- Support iqm-client with QIR support
+
+Version 9.1.0 (2025-07-30)
+==========================
+
+Features
+--------
+
+- Require compiler instead of Pulla in qir_to_pulla
+
 Version 9.0.0 (2025-07-16)
 ==========================
 

{iqm_pulla-9.0.0 → iqm_pulla-9.2.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: iqm-pulla
-Version: 9.0.0
+Version: 9.2.0
 Summary: Client library for pulse-level access to an IQM quantum computer
 Author-email: IQM Finland Oy <developers@meetiqm.com>
 License:                                  Apache License
@@ -239,8 +239,8 @@ 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<11,>=10; extra == "qiskit"
-Requires-Dist: iqm-client<30,>=29; extra == "qiskit"
 Requires-Dist: iqm-client[qiskit]<30,>=29; extra == "qiskit"
+Requires-Dist: iqm-client<30,>=29; extra == "qiskit"
 
 IQM Pulla
 #########

{iqm_pulla-9.0.0 → iqm_pulla-9.2.0}/docs/Custom Gates and Implementations.ipynb

@@ -589,7 +589,7 @@
    "outputs": [],
    "source": [
     "circuits, compiler = qiskit_to_pulla(p, backend, example_qiskit_circuit())\n",
-    "compiler.add_implementation('custom_x', 'StretchedX', StretchedX, quantum_op=QuantumOp(params=('angle_t', 'phase_t')))\n",
+    "compiler.add_implementation('custom_x', 'StretchedX', StretchedX, quantum_op=QuantumOp('custom_x', params=('angle_t', 'phase_t')))\n",
     "\n",
     "c = circuits[0]\n",
     "for inst in c.instructions:\n",

{iqm_pulla-9.0.0 → iqm_pulla-9.2.0}/docs/Example - Executing QIR programs.ipynb

@@ -21,7 +21,7 @@
     "from iqm.qiskit_iqm import IQMProvider\n",
     "from iqm.pulla.pulla import Pulla\n",
     "from iqm.pulla.utils_qiskit import station_control_result_to_qiskit\n",
-    "from iqm.pulla.utils_qir import qir_to_pulla\n",
+    "from iqm.pulla.utils_qir import qir_to_pulla, generate_qiskit_qir_qubit_mapping\n",
     "from qiskit_qir import to_qir_module"
    ]
   },
@@ -158,21 +158,7 @@
    "outputs": [],
    "source": [
     "# qiskit-qir has a bug, which causes qubit pointers to not be generated correctly\n",
-    "# according to the final_layout. So we replicate this logic here and generate a new mapping.\n",
-    "# Then we assign qiskit-qir index to the qiskit logic qubit idx.\n",
-    "\n",
-    "# For simplicity, reverse the mapping\n",
-    "layout_reverse_mapping = {bit: idx for idx, bit in qc_transpiled.layout.final_layout.get_physical_bits().items()}\n",
-    "qiskit_qir_mapping = {}\n",
-    "# Replicate qiskit-qir logic for defining qubit pointer indices\n",
-    "for register in qc_transpiled.qregs:\n",
-    "    qiskit_qir_mapping.update(\n",
-    "        {layout_reverse_mapping[bit]: n + len(qiskit_qir_mapping) for n, bit in enumerate(register)}\n",
-    ")\n",
-    "\n",
-    "# In the generated QIR qubit pointers will use qiskit-qir qubit labels,\n",
-    "# but we already know how to map them to IQM physical qubits, through qiskit logical qubit indices.\n",
-    "qubits_mapping = {qiskit_qir_mapping[i]: backend.index_to_qubit_name(i) for i in range(qc_transpiled.num_qubits)}"
+    "qubits_mapping = generate_qiskit_qir_qubit_mapping(qc_transpiled, backend)"
    ]
   },
   {
@@ -221,7 +207,7 @@
     "p = Pulla(station_control_url)\n",
     "# Pass qubit mapping to qir_to_pulla coverter to correctly interpret opaque qubit pointer indices in QIR\n",
     "# and convert them to physical IQM qubit names.\n",
-    "circuits, compiler = qir_to_pulla(p, qir, qubits_mapping)\n",
+    "circuits, compiler = qir_to_pulla(p.get_standard_compiler(), qir, qubits_mapping)\n",
     "\n",
     "playlist, context = compiler.compile(circuits)\n",
     "\n",

{iqm_pulla-9.0.0 → iqm_pulla-9.2.0}/requirements/qiskit.txt

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

{iqm_pulla-9.0.0 → iqm_pulla-9.2.0}/src/iqm/pulla/utils_qir.py

@@ -34,10 +34,11 @@ from pyqir import (
     required_num_results,
     result_id,
 )
+from qiskit import QuantumCircuit
+from qiskit.providers import BackendV2
 
 from iqm.cpc.compiler.compiler import Compiler
 from iqm.cpc.interface.compiler import Circuit as CPC_Circuit
-from iqm.pulla.pulla import Pulla
 from iqm.pulse.builder import CircuitOperation
 
 qir_logger = logging.getLogger(__name__)
@@ -147,19 +148,20 @@ def _parse_double(value: str) -> float:
 
 
 def qir_to_pulla(  # noqa: PLR0915, PLR0912
-    pulla: Pulla, qir: str | bytes, qubit_mapping: dict[int, str] | None = None
+    compiler: Compiler, qir: str | bytes, qubit_mapping: dict[str, str] | None = None
 ) -> tuple[list[CPC_Circuit], Compiler]:
     """Convert a QIR module to a CPC circuit.
 
     Args:
-        pulla: The Pulla instance to get compiler from.
+        compiler: compiler to use
         qir: The QIR source or bitcode to convert to a circuit.
         qubit_mapping: A dictionary mapping QIR qubit indexes to physical qubit names,
                        None will assume opaque pointers match physical names.
 
     Returns:
         str: The QIR program name,
-        tuple[CircuitOperation, ...]: The circuit operations extracted from the QIR code.
+        tuple[list[Circuit], Compiler]:
+            Circuits extracted from the QIR module and the compiler with updated component_mapping
 
     Raises:
         ValueError: If the QIR program has more than one basic block.
@@ -240,14 +242,11 @@ def qir_to_pulla(  # noqa: PLR0915, PLR0912
     circuits = [CPC_Circuit(name=name, instructions=circuit_instructions)]
     qir_logger.debug("Converted circuit: %s", circuits)
 
-    # Create a compiler containing all the required station information
-    compiler = pulla.get_standard_compiler()
-
     if qubit_mapping:
         # QIR programs reference to qubits as opaque pointer indexes,
         # however, for example qiskit is using logical names for qubits,
         # so we need to map these indexes to physical qubit names
-        compiler.component_mapping = {f"{i}": qubit_mapping[i] for i in range(_required_num_qubits)}
+        compiler.component_mapping = {f"{i}": qubit_mapping[str(i)] for i in range(_required_num_qubits)}
     else:
         # QIR programs reference to qubits as opaque pointer indexes,
         # we expect these indexes to match physical qubit names,
@@ -256,3 +255,33 @@ def qir_to_pulla(  # noqa: PLR0915, PLR0912
         compiler.component_mapping = {f"{i}": f"QB{i + 1}" for i in range(_required_num_qubits)}
 
     return circuits, compiler
+
+
+def generate_qiskit_qir_qubit_mapping(qiskit_circuit: QuantumCircuit, qiskit_backend: BackendV2) -> dict[str, str]:
+    """qiskit-qir has a bug, which causes qubit pointers to not be generated correctly
+    according to the final_layout. So we replicate this logic here and generate a new mapping.
+    Then we assign qiskit-qir index to the qiskit logic qubit idx.
+
+    Args:
+        qiskit_circuit: Qiskit circuit to generate the mapping for.
+        qiskit_backend: Qiskit backend object to be used for qubit name generation.
+
+    Returns:
+        A dictionary mapping Qiskit qubit indices to QIR qubit pointers.
+
+    """
+    # For simplicity, reverse the mapping
+    layout_reverse_mapping = {bit: idx for idx, bit in qiskit_circuit.layout.final_layout.get_physical_bits().items()}
+    qiskit_qir_mapping: dict[int, int] = {}
+
+    # Replicate qiskit-qir logic for defining qubit pointer indices
+    for register in qiskit_circuit.qregs:
+        qiskit_qir_mapping.update(
+            {layout_reverse_mapping[bit]: n + len(qiskit_qir_mapping) for n, bit in enumerate(register)}
+        )
+
+    # In the generated QIR qubit pointers will use qiskit-qir qubit labels,
+    # but we already know how to map them to IQM physical qubits, through qiskit logical qubit indices.
+    return {
+        str(qiskit_qir_mapping[i]): str(qiskit_backend.index_to_qubit_name(i)) for i in range(qiskit_circuit.num_qubits)
+    }

{iqm_pulla-9.0.0 → iqm_pulla-9.2.0}/src/iqm/pulla/utils_qiskit.py

@@ -19,6 +19,7 @@ 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
@@ -32,7 +33,7 @@ from iqm.pulla.interface import StationControlResult, TaskStatus
 from iqm.pulse.builder import CircuitOperation
 
 if TYPE_CHECKING:
-    from iqm.iqm_client import Circuit, Instruction
+    from iqm.iqm_client import Instruction
     from iqm.qiskit_iqm.iqm_backend import DynamicQuantumArchitecture
     from iqm.qiskit_iqm.iqm_provider import IQMBackend
 
@@ -137,7 +138,10 @@ def qiskit_to_pulla(
         else {m.logical_name: m.physical_name for m in run_request.qubit_mapping}
     )
 
-    circuits = [_circuit_to_dataclass(c) for c in run_request.circuits]
+    # 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]
     return circuits, compiler
 
 

{iqm_pulla-9.0.0 → iqm_pulla-9.2.0}/src/iqm_pulla.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: iqm-pulla
-Version: 9.0.0
+Version: 9.2.0
 Summary: Client library for pulse-level access to an IQM quantum computer
 Author-email: IQM Finland Oy <developers@meetiqm.com>
 License:                                  Apache License
@@ -239,8 +239,8 @@ 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<11,>=10; extra == "qiskit"
-Requires-Dist: iqm-client<30,>=29; extra == "qiskit"
 Requires-Dist: iqm-client[qiskit]<30,>=29; extra == "qiskit"
+Requires-Dist: iqm-client<30,>=29; extra == "qiskit"
 
 IQM Pulla
 #########

iqm_pulla-9.2.0/version.txt

@@ -0,0 +1 @@
+9.2.0

iqm_pulla-9.0.0/version.txt

@@ -1 +0,0 @@
-9.0.0

{iqm_pulla-9.0.0 → iqm_pulla-9.2.0}/src/iqm_pulla.egg-info/requires.txt

@@ -24,5 +24,5 @@ iqm-qiskit-qir==0.8.0
 iqm-exa-common<27,>=26
 iqm-station-control-client<10,>=9
 iqm-pulse<11,>=10
-iqm-client<30,>=29
 iqm-client[qiskit]<30,>=29
+iqm-client<30,>=29