This repository is the computational appendix of the following paper:
Kyle Cormier, Riccardo Di Sipio, Peter Wittek . Unfolding as quantum annealing. arXiv:1908.08519, 2019.
Check out package with git clone https://github.com/rdisipio/quantum_unfolding.git. The required packages are list in requirements.txt. For the baseline results, you will also need RooUnfold; see the instructions below.
At the heart of unfolding is a matrix inversion. This problem is mapped to regularized, constrained least-squares fit that is numerically more stable even on classical hardware. In turn, we convert it to a quadratic unconstrained binary optimization problem to solve it on a quantum annealer.
In the file tests/toy_unfolding_classical.py you can modify the definition of xedges, of the truth-level vector (x) and the response matrix (R). The code compares the product Rx=y carried out with decimal and binary representation, the latter to be used for the quantum computation.
The response matrix is converted to binary by recognizing that the linear vector space is spanned by (n_cols X n_bits) standard basis vectors v, i.e.:
( 0, 0, ..., 1 )
( 0, 1, ..., 0 )
( 1, 0, ..., 0 )
Multiplying Rv "extracts" the column corresponding to the non-zero element, e.g. R x (1,0,...,0)^T returns the first column of R. By iteration, we can convert R from decimal to binary.
The matrix-vector multiplication is carried out as usual, with the only exception that the carry bit has to be taken into account.
python tests/test_matrix_multiplication.py
To test the unfolding:
python tests/toy_unfolding_classical.py
Test QUBO unfolding using the dimod package:
python experiments/unfolding_qubo.py -l 0 # no regularization
python experiments/unfolding_qubo.py -l 1 # regularization strength = 1
python experiments/unfolding_qubo.py -l 2 # regularization strength = 2
# etc..
Chose your backend wisely!
python experiments/unfolding_qubo.py -l 0 -b cpu # use CPU
python experiments/unfolding_qubo.py -l 0 -b sim -n 2000 # use simulated annealer NEAL
python experiments/unfolding_qubo.py -l 0 -b qpu -n 2000 # use real QPU: you need a DWave Leap token
Using e.g. a 5x5 matrix:
python experiments/unfolding_qubo.py -l 0 -n 10000 -b sim
Install RooUnfold:
cd $HOME/development
svn co https://svnsrv.desy.de/public/unfolding/RooUnfold/trunk RooUnfold
cd RooUnfold
make
This will create a library called libRooUnfold.so . You need to create
links to this library and the directory with the headers:
cd -
ln -s $HOME/development/RooUnfold/libRooUnfold.so .
ln -s $HOME/development/RooUnfold/src/ .
Then run:
python experiments/unfolding_baseline.py
With systematics:
python experiments/unfolding_baseline_syst.py # this gives you D'Agostini etc.
# Neal
python experiments/unfolding_qubo_syst.py -n 5000 -b sim -l 0.0
python experiments/unfolding_qubo_syst.py -n 5000 -b sim -l 0.5
python experiments/unfolding_qubo_syst.py -n 5000 -b sim -l 1.0
# QPU
python experiments/unfolding_qubo_syst.py -n 5000 -b qpu -l 0.0
python experiments/unfolding_qubo_syst.py -n 5000 -b qpu -l 0.5
python experiments/unfolding_qubo_syst.py -n 5000 -b qpu -l 1.0
To speed up:
for i in $(seq 20) ; do python experiments/unfolding_qubo.py -b qpu -l 0 | tail -n 1 ; done
for i in $(seq 20) ; do python experiments/unfolding_qubo.py -b qpu -l 1 | tail -n 1 ; done
or equivalently:
experiments/unfold_qubo.sh -b qpu -n 20 -l 0
experiments/unfold_qubo.sh -b qpu -n 20 -l 1
Make plots:
python plots/plot_unfolded.py # unfolded only nominal, no systematics
python plots/plot_unfolded_syst.py # unfolded w/ systematics
DWAVE_HYBRID_LOG_LEVEL=INFO python experiments/unfolding_qubo.py -b hyb