Gespeichert in:
Bibliographische Detailangaben
Hauptverfasser: Cardinal, Julien, Benzarti, Imen, boussaidi, Ghizlane El, Pere, Christophe
Format: Preprint
Veröffentlicht: 2025
Schlagworte:
Online-Zugang:https://arxiv.org/abs/2512.08245
Tags: Tag hinzufügen
Keine Tags, Fügen Sie den ersten Tag hinzu!
_version_ 1866918239594872832
author Cardinal, Julien
Benzarti, Imen
boussaidi, Ghizlane El
Pere, Christophe
author_facet Cardinal, Julien
Benzarti, Imen
boussaidi, Ghizlane El
Pere, Christophe
contents Migrating quantum algorithms across evolving frameworks introduces subtle behavioral changes that affect accuracy and reproducibility. This paper reports our experience converting the Quantum Approximate Optimization Algorithm (QAOA) from Qiskit Algorithms with Qiskit 1.x (v1 primitives) to a custom implementation using Qiskit 2.x (v2 primitives). Despite identical circuits, optimizers, and Hamiltonians, the new version produced drastically different results. A systematic analysis revealed the root cause: the sampling budget -- the number of circuit executions (shots) per iteration. The library's implicit use of unlimited shots yielded dense probability distributions, whereas the v2 default of 10 000 shots captured only 23% of the state space. Increasing shots to 250 000 restored library-level accuracy. This study highlights how hidden parameters at the quantum-classical interaction level can dominate hybrid algorithm performance and provides actionable recommendations for developers and framework designers to ensure reproducible results in quantum software migration.
format Preprint
id arxiv_https___arxiv_org_abs_2512_08245
institution arXiv
publishDate 2025
record_format arxiv
spellingShingle Migrating QAOA from Qiskit 1.x to 2.x: An experience report
Cardinal, Julien
Benzarti, Imen
boussaidi, Ghizlane El
Pere, Christophe
Software Engineering
Migrating quantum algorithms across evolving frameworks introduces subtle behavioral changes that affect accuracy and reproducibility. This paper reports our experience converting the Quantum Approximate Optimization Algorithm (QAOA) from Qiskit Algorithms with Qiskit 1.x (v1 primitives) to a custom implementation using Qiskit 2.x (v2 primitives). Despite identical circuits, optimizers, and Hamiltonians, the new version produced drastically different results. A systematic analysis revealed the root cause: the sampling budget -- the number of circuit executions (shots) per iteration. The library's implicit use of unlimited shots yielded dense probability distributions, whereas the v2 default of 10 000 shots captured only 23% of the state space. Increasing shots to 250 000 restored library-level accuracy. This study highlights how hidden parameters at the quantum-classical interaction level can dominate hybrid algorithm performance and provides actionable recommendations for developers and framework designers to ensure reproducible results in quantum software migration.
title Migrating QAOA from Qiskit 1.x to 2.x: An experience report
topic Software Engineering
url https://arxiv.org/abs/2512.08245