Build status:
staq is a modern C++17 library for the synthesis, transformation, optimization and compilation of quantum circuits. It is usable either through the provided binary tools, or as a header-only library that can be included to provide direct support for parsing & manipulating circuits written in the OpenQASM circuit description language.
Inspired by Clang, staq is designed to manipulate OpenQASM syntax trees directly, rather than through an intermediate representation which makes retrieving the original source code impossible. In particular, OpenQASM circuits can be inspected and transformed (in most cases) without losing the original source structure. This makes staq ideally suited for source-to-source transformations, where only specific changes are desired. Likewise, this allows translations to other common circuit description languages and libraries to closely follow the OpenQASM source.
Check out the Wiki for more information about the library and included tools.
staq is distributed under the MIT license. Please see the
LICENSE file for more details.
staq uses CMake for its build system. To build both tool suite and the staq executable, execute under the root directory
mkdir build && cd build
cmake ..
make -j8To build only the staq tool suite, from the build directory, enter
make -j8 tools. To build only the staq executable, type make -j8 staq
Unit tests can be built with the command make -j8 unit_tests.
To (un)install, type
sudo make (un)installBuilding on Windows requires Visual Studio 2017 or later for cmake support. In Visual Studio, open CMakeLists.txt as a cmake project, then simply build as a regular Visual Studio project or, from a Developer Command Prompt, execute under the root directory
mkdir build && cd build
cmake ..
msbuild -m:8 -p:Configuration=Release staq.sln
assuming you are building from an out of source directory.
To (un)install, type
cmake --build . --target (UN)INSTALL
pystaq is a Python 3 wrapper for staq.
pystaq can be installed using pip:
pip install git+https://github.com/softwareQinc/staq
For more details, please see pystaq/README.md.
Thanks to the excellent EPFL logic synthesis libraries which are used to perform logic synthesis in staq, and in particular Bruno Schmitt's tweedledum library, from which the OpenQASM parser was adapted.