A collection of guidelines to run quantum optimization algorithms on superconducting qubits with Qiskit, using as reference the Quantum Approximate Optimization Algorithm (QAOA) workflow.
This repository shows how to combine methods employed in the QAOA literature to get good results on hardware [1], such as SWAP strategies [2], SAT mapping [3], pulse-efficient transpilation and dynamical-decoupling [coming soon]. In the future, it will be expanded to include a broader range of quantum algorithms for combinatorial optimization.
The qopt_best_practices
directory contains a series of reference implementations for the key
strategies mentioned in the description. These are not intended to be feature-complete, they are
prototypes that should be easy to test and try out in different settings
(that's why the library is pip-installable!) and can also serve as a guide for your
own advanced implementations of these techniques.
The how-tos
directory contains a series of notebooks you can run to see these techniques in action.
In many cases, the helper methods provided for a specific task (for example, swap mapping), are just
light wrappers over already-available Qiskit utilities (transpiler passes). How-tos that focus
on a specific tasks will probably show direct use of the Qiskit code, while how-tos that lay out a full
workflow will likely rely on the provided wrappers for a more general overview of the steps to follow.
This is only a relatively polished repository. If you see any bug or feature you'd like to add, this is a community effort, contributions are welcome. Don't hesitate to open an issue or a PR.
- run
git clone https://github.com/qiskit-community/q-optimization-best-practices.git
in your local environment - do
pip install -r requirements.txt
- do
pip install .
- navigate to the
how-tos
section and run the notebook of your choice!
The contents of the qopt_best_practices
package are structured around the key strategies that
can be applied to best run quantum optimization algorithms on real hardware:
- Qubit Selection ->
qubit_selection
- SAT Mapping ->
sat_mapping
- Application of SWAP strategies ->
swap_strategies
- QAOA cost function ->
cost_function
The convention in this repository is that the (depth-one) QAOA should create an Ansatz of the form:
to minimize the energy of
As cost operator we apply:
where the sum runs over
At the circuit level, these definitions imply that the exponential of the mixer is built
with
- Sack, S. H., & Egger, D. J. (2023). Large-scale quantum approximate optimization on non-planar graphs with machine learning noise mitigation. arXiv preprint arXiv:2307.14427. Link.
- Weidenfeller, J., Valor, L. C., Gacon, J., Tornow, C., Bello, L., Woerner, S., & Egger, D. J. (2022). Scaling of the quantum approximate optimization algorithm on superconducting qubit based hardware. Quantum, 6, 870. Link.
- Matsuo, A., Yamashita, S., & Egger, D. J. (2023). A SAT approach to the initial mapping problem in SWAP gate insertion for commuting gates. IEICE Transactions on Fundamentals of Electronics, Communications and Computer Sciences, 2022EAP1159. Link.