Fast Approximate Block Encoding Circuits
Project description
Fast Approximate BLock Encodings (FABLE)
FABLE can synthesize quantum circuits for approximate block-encodings of matrices. A block-encoding is the embedding of a matrix in the leading block of of a larger unitary matrix.
FABLE is a quantum representation for dense, unstructured matrices. The gate complexity of FABLE circuits scales linear in the number of matrix elements, which is optimal for the unstructured case. FABLE includes a circuit compression algorithm that can significantly reduce the gate complexity and works particularly well if there is certain structure available in the matrix to be block encoded.
We provide two reference implementations of the FABLE algorithm:
Qiskit - Python Implementation
FABLE can be installed from PyPI as follows:
pip install fable-circuits
After installation, it can be loaded and used as follows:
from fable import fable
import numpy as np
from qiskit import Aer
simulator = Aer.get_backend("unitary_simulator")
# generate a random matrix and block encode it
n = 3
N = 2**n
A = np.random.randn(N, N)
circ, alpha = fable(A, 0)
result = simulator.run(circ).result()
unitary = result.get_unitary(circ)
np.linalg.norm(alpha * N * unitary.data[0:N, 0:N] - A)/np.linalg.norm(A)
QCLAB - MATLAB Implementation
In order to run the MATLAB implementation of FABLE:
- Install QCLAB
- Clone FABLE and add
fable-qclab
directory to your MATLAB path.
After installation, FABLE can be run for a target matrix A
as either:
logging = true ;
[circuit, OA, alpha, info] = fable( A, 'cutoff', 1e-4, logging ) ;
[circuit, OA, alpha, info] = fable( A, 'percentage', 80, logging ) ;
The first option ('cutoff'
) ignores coefficients smaller than 1e-4
in absolute value, the second option
('percentage'
) applies an 80% compression and only retains the 20% largest coefficients. The 'percentage'
and logging
options are only available in the MATLAB version of FABLE.
Reference
Cite the following reference for FABLE:
FABLE: Fast Approximate Quantum Circuits for Block-Encodings, Daan Camps, Roel Van Beeumen, 2022 2022 IEEE International Conference on Quantum Computing and Engineering (QCE), arXiv:2205.00081.
Developers - Lawrence Berkeley National Laboratory
About
FABLE Copyright (c) 2022, The Regents of the University of California, through Lawrence Berkeley National Laboratory (subject to receipt of any required approvals from the U.S. Dept. of Energy). All rights reserved.
If you have questions about your rights to use or distribute this software, please contact Berkeley Lab's Intellectual Property Office at IPO@lbl.gov.
NOTICE. This Software was developed under funding from the U.S. Department of Energy and the U.S. Government consequently retains certain rights. As such, the U.S. Government has been granted for itself and others acting on its behalf a paid-up, nonexclusive, irrevocable, worldwide license in the Software to reproduce, distribute copies to the public, prepare derivative works, and perform publicly and display publicly, and to permit others to do so.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for fable_circuits-1.0.1-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 0609f531f587a07c1c068adb6d11b77419e490958122b649b96f2b20d2a17138 |
|
MD5 | 540feea4dcc62c104496feacbe1f55e4 |
|
BLAKE2b-256 | f46ed637aa54d6d44b0b3739a128ba0f9c3ddf17ff7bd282c51df092ec52924a |