NWQLib: Northwest Quantum Library

NWQLib applies quantum algorithms to scientific problems. You state the problem and choose a method, and NWQLib plans the construction, runs it on the backend you choose and returns the result with its resource counts and what is known about its error. Circuits are built with Qiskit.

Documentation: https://pnnl.github.io/NWQLib/

Installation

NWQLib requires Python 3.12 or later. Install the package with the local Aer simulator:

python -m pip install "nwqlib[aer]"

The base package, python -m pip install nwqlib, describes the methods, accepts inputs, plans LCHS with its default settings and runs the classical methods. Building and running circuits needs the extra of the chosen backend (aer, ibm, ionq, nexus), each of which includes Qiskit. Install and first result lists every extra, and Choose a backend explains what each backend supports. To work on NWQLib itself, see Set up, test and build.

First result

To solve du/dt = -A u with a small physical input:

from nwqlib import LinearDynamics, solve
from nwqlib.algorithms import LCHS

problem = LinearDynamics(
    A=[[0.4, 0.15], [0.05, 0.25]],
    initial_state=[1.0, 0.0],
    time=0.1,
)
result = solve(problem, method=LCHS())
print(result.solution)

[ 0.96006038-1.54102084e-12j -0.00513885+3.61167323e-13j]

The default returns an approximation of the physical solution using nine qubits in total. Install and first result compares it with an independent reference and shows how to change the approximation. Each method accepts its own input forms and conversions, which its algorithm guide describes.

The example notebooks solve complete scientific problems from input to result, error and circuit cost: molecular ground-state energy, a linear system, linear dynamics and optimization. One more notebook estimates the resources of a linear system, heat flow, two spin chains and a GCiM trial basis at 80 to 100 system qubits, where the largest circuit, LCHS for heat flow, has 109 qubits in total. It also estimates one QHD step on a three-variable grid of 32 points per variable, which takes 96 qubits in the one-hot encoding. The examples guide points you to the notebook that matches your problem. The mathematics page states the bounds, resource formulas and error budgets that NWQLib uses, each with its proof or source and the code that implements it.

Choose a task

Algorithms

Each method reports the quantity it obtained and any accuracy conditions that remain unresolved. A projected energy, a local statistical interval or a completed simulation does not by itself establish the full requested scientific claim. Limitations and open work lists current limitations. State preparation, block encoding, LCU, QSP/QSVT and evolution subroutines have their own API reference pages.

Backend support

A backend runs a method only when it supports that method's circuits and readout. Choose a backend gives the details.

Citation

If you use NWQLib in your work, please cite it through its Zenodo record, which resolves to the latest version:

@software{nwqlib,
  author  = {Zheng, Muqing and Liu, Chenxu and Song, Zhixin and Wu, Zeguan and Li, Xiangyu and Li, Mingze and Bauman, Nicholas P. and Stein, Samuel A. and M{\"u}lmenst{\"a}dt, Johannes and Chen, Yousu and Wiebe, Nathan and Li, Ang and Kowalski, Karol},
  title   = {NWQLib},
  year    = {2026},
  version = {1.0.0},
  doi     = {10.5281/zenodo.23074265},
  url     = {https://github.com/pnnl/NWQLib}
}

The references page lists the papers behind each algorithm and subroutine, with the equations NWQLib implements.

Authors and Developers

For questions, bug reports or collaboration, contact Muqing Zheng (muqing.zheng@pnnl.gov).

Affiliations are those at the time of contribution.

• Muqing Zheng, Pacific Northwest National Laboratory
• Chenxu Liu, Pacific Northwest National Laboratory
• Zhixin Song, Pacific Northwest National Laboratory and Georgia Institute of Technology
• Zeguan Wu, Pacific Northwest National Laboratory and University of Pittsburgh
• Xiangyu Li, Pacific Northwest National Laboratory
• Mingze Li, Pacific Northwest National Laboratory
• Nicholas P. Bauman, Pacific Northwest National Laboratory
• Samuel A. Stein, Pacific Northwest National Laboratory
• Johannes Mülmenstädt, Pacific Northwest National Laboratory
• Yousu Chen, Pacific Northwest National Laboratory
• Nathan Wiebe, Pacific Northwest National Laboratory and University of Toronto
• Ang Li, Pacific Northwest National Laboratory and University of Washington
• Karol Kowalski, Pacific Northwest National Laboratory

Acknowledgements

This work was supported by Pacific Northwest National Laboratory's Quantum Algorithms and Architecture for Domain Science (QuAADS) Laboratory Directed Research and Development (LDRD) Initiative. This material is based upon work supported by the U.S. Department of Energy, Office of Science, National Quantum Information Science Research Centers, Quantum Science Center (QSC). The Pacific Northwest National Laboratory is operated by Battelle for the U.S. Department of Energy under Contract DE-AC05-76RL01830.

NWQLib is released under the BSD 2-Clause License; see LICENSE. Information release number PNNL-SA-227989.