SimuQ

SimuQ is a domain-specific language for quantum simulation with analog compilation.

Our project website includes use cases and documentation of SimuQ.

We illustrate our design and benefits in our arXiv paper.

Installation

We recommend Python 3.9 or greater since many optional dependencies have requirements for Python version.

We encourage using pip for SimuQ installation. To install the core components of SimuQ, run the following command in shell:

Note We haven't uploaded the repo to PyPI yet, so please download/clone the repository, enter the (unzipped) folder, and follow the following instructions by substituting . for simuq, i.e., pip install .. If installing extras (for example, pip install "simuq[dev]"), remember to include quotes around the target (for local installations, this means pip install ".[dev]"). To install in editable mode, run pip install with the -e flag: pip install -e ".[dev]".

pip install simuq

Multiple platforms are supported by SimuQ through different APIs and you may optionally install them based on your needs. You may install all optional dependencies, though not recommended, by

pip install "simuq[all]"

Amazon Braket

SimuQ supports compilation to IonQ's trapped-ion devices and QuEra's neutral atom devices through Amazon Braket.

To enable these backends, you may install the dependencies via

pip install "simuq[braket]"

If running on QPUs, make sure that your AWS account is onboarded to Amazon Braket, as per the instructions here (this isn't necessary for running on the local simulator).

IonQ Quantum Cloud

SimuQ supports compilation to IonQ's trapped-ion devices through IonQ Quantum Cloud.

To enable these backends, you may install the dependencies via

pip install "simuq[ionq]"

To run through IonQ Quantum Cloud, you must obtain an API key from IonQ.

When creating IonQ providers in SimuQ, you must provide the API key either through a string or a file storing the key.

Qiskit

SimuQ supports compilation to IBM's superconducting devices through Qiskit and IBM Quantum.

To enable these backends, you may install the dependencies via

pip install "simuq[qiskit]"

To run through IBM Quantum, you must obtain an API token from IBM.

Examples

For examples of SimuQ usage, refer to the notebooks in the tutorials folder.

Project Structure

notebooks/: Example notebooks of running SimuQ and obtaining results.

simuq/: The core compiler and language implementation of SimuQ.

simuq/aais/: AAIS of many backends in AAIS Specification Language.

simuq/backends/: The translation to API languages of different machine backends.

simuq/systems/: Hamiltonian evolution implemented in Hamiltonian Modeling Language.

simuq/systems/benchmark/: A small benchmark of quantum Hamiltonian simulation as reported in our arXiv paper.