Branch	Status
master

These plugins for XACC provide an Accelerator implementation that leverages tensor network theory to simulate quantum circuits.

With the XACC framework installed, run the following

$ mkdir build && cd build
$ cmake .. -DXACC_DIR=$HOME/.xacc (or wherever you installed XACC)
$ make install

TNQVM can be built with ExaTN support, providing a tensor network processing backend that scales on Summit-like architectures. To enable this support, first follow the ExaTN README to build and install ExaTN. Now configure TNQVM with CMake and build/install

$ mkdir build && cd build
$ cmake .. -DXACC_DIR=$HOME/.xacc -DEXATN_DIR=$HOME/.exatn
$ make install

To switch tensor processing backends use

auto qpu = xacc::getAccelerator("tnqvm", {std::make_pair("tnqvm-visitor", "exatn")});

or in Python

qpu = xacc.getAccelerator('tnqvm', {'tnqvm-visitor':'exatn'})

TNQVM's exatn-mps visitor can support multi-node execution via MPI.

Prerequisites: ExaTN is built with MPI enabled, i.e., setting MPI_LIB and MPI_ROOT_DIR when configuring the ExaTN build.

To enable MPI in TNQVM, add -DTNQVM_MPI_ENABLED=TRUE to CMake along with other configuration variables.

A simulation executable which uses the exatn-mps visitor, e.g. via

auto qpu = xacc::getAccelerator("tnqvm", { std::make_pair("tnqvm-visitor", "exatn-mps")});

can be executed with MPI using mpiexec -np <number of processes> <executable>.

• XACC Website and Documentation

Questions, bug reporting and issue tracking are provided by GitHub. Please report all bugs by creating a new issue with the bug tag. You can ask questions by creating a new issue with the question tag.

TNQVM is licensed - BSD 3-Clause.

If you use TNQVM in your research, please use the following citation

@article{tnqvm,
    author = {McCaskey, Alexander AND Dumitrescu, Eugene AND Chen, Mengsu AND Lyakh, Dmitry AND Humble, Travis},
    journal = {PLOS ONE},
    publisher = {Public Library of Science},
    title = {Validating quantum-classical programming models with tensor network simulations},
    year = {2018},
    month = {12},
    volume = {13},
    url = {https://doi.org/10.1371/journal.pone.0206704},
    pages = {1-19},
    number = {12},
    doi = {10.1371/journal.pone.0206704}
}