pu2wof / qat

QIR compiler tools and optimization passes for targeting QIR to different hardware backends

QIR Adaptor Tool

Table of Contents

• Purpose
• Building
• Getting started
• Documentation

Purpose and terminology

The purpose of the tool contained in this repository is to provide means to manipulate the intermediate representation (IR) of quantum programs. We refer to these IRs as quantum IRs (QIRs). The main tool provided here is QIR adaptor tool (QAT) which allows one to transform one QIR to another QIR that fulfils certain requirements.

When we refer to a QIR in any of the documentation related to this tool, we do so irrespective of whether we represent the QIR though human readable text, the more storage-efficient bit-code format or in-memory representation. We note that all of these representations are semantically identical and for that reason, QAT is designed to work with all of them.

Building

For full instructions on dependencies and how to build, follow these instructions. In summary, the executable is built using baslisk:

bazelisk run //qir/qat:qat --config generic_clang --config release

and the Ubuntu based Doker image can be built:

bazelisk run //qir/qat:qat-image --config generic_clang --config release  --platforms=@//:linux-x86

This command will cross compile the qat executable for linux-x86 and add it to a docker image named bazel/qir/qat:qat-image.

Getting started

Once the project is built (see next sections), you can transform a QIR according to a profile as follows:

./qir/qat/Apps/qat --apply --profile base -S path/to/example.ll

Likewise, you can validate that a QIR follows a specification by running (Note, not implemented yet):

./qir/qat/Apps/qat --validate --profile base -S path/to/example.ll

Documentation

You can access the documentation here.

Feedback

If you have feedback about the content in this repository, please let us know by filing a new issue!

Contributing

There are many ways in which you can contribute to QAT, whether by contributing a feature or by engaging in discussions; we value contributions in all shapes and sizes! We refer to this document for guidelines and ideas for how you can get involved.

Contributing a pull request to this repo requires to agree to a Contributor License Agreement (CLA) declaring that you have the right to, and actually do, grant us the rights to use your contribution. We are still working on setting up a suitable CLA-bot to automate this process. A CLA-bot will automatically determine whether you need to provide a CLA and decorate the PR appropriately. Once it is set up, simply follow the instructions provided by the bot. You will only need to do this once.

Code of Conduct

This project has adopted the community covenant Code of Conduct. Please contact [email protected] for Code of Conduct issues or inquires.