- français
- English
The Basis Pursuit DeQuantization toolbox
The BPDQ Toolbox
Menu:
- Introduction
- Download the BPDQ toolbox
- Install
- Demonstration files
- Documentation
- Archive structure
- GPL License
- Referencing the BPDQ toolbox
- Special Thanks
- Authors
Introduction:
This web page provides support for the Basis Pursuit DeQuantizer (BPDQ) Toolbox.
This toolbox aims at demonstrating the power of the Basis Pursuit Dequantizers for recovery of sparse signals from quantized random measurements, as described in the two papers:
- "Dequantizing Compressed Sensing : When Oversampling and Non-Gaussian Constraints Combine" (preprint) by Laurent Jacques, David Hammond, M. Jalal Fadili, May 2009. (submitted to IEEE Transactions on Signal Processing)
- "Dequantizing Compressed Sensing with Non-Gaussian Constraints" by Laurent Jacques, David Hammond, M. Jalal Fadili, ICIP'09, Cairo, Egypt.
More precisely, this toolbox provides a set of matlab and C/C++ routines solving numerically the two following convex optimization frameworks:
In other words, the L1-based and the Total Variation (TV) based Basis Pursuit Dequantizers. For more details about the symbols used, see the companion paper cited above.
Download the BPDQ toolbox:
The version 1.0 of the BPDQ Toolbox is available here :
https://wiki.epfl.ch/bpdq/documents/bpdq_toolbox.zip
Install:
To use, first compile the cpp code implementing the mex version of
lp-ball projection by running
>> bpdq_make_mex
Then, run
>> bpdq_setpath
to add all subpaths to the matlab path.
Demonstration files:
Once installed, try running the demo's
>> bpdq_demo_1d
>> bpdq_demo_2d
which each run (a single case) of the numerical experiments described in Jacques et al.
HTML reports of these demonstrations (automatically generated by Matlab 7.5) are also available here:
Documentation:
A HTML documentation aumtomatically generated from the sources with the script m2html is availble here:
https://wiki.epfl.ch/bpdq/documents/help
Archive Structure:
bpdq_toolbox/ - root directory, contains demo files
bpdq_toolbox/one_d/ - code for one dimensional simulations
bpdq_toolbox/two_d/ - code for two dimensional simulations
bpdq_toolbox/common/ - code common between one and two dimensions
bpdq_toolbox/mex/ - mex source code
bpdq_toolbox/doc/ - html documentation, view
bpdq_toolbox/doc/index.html with your favourite web browser
GPL License:
The BPDQ Toolbox is a GPL Matlab/C/C++ Library.
The BPDQ Toolbox is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.
The BPDQ Toolbox is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.
You should have received a copy of the GNU General Public License
along with The BPDQ Toolbox. If not, see <http://www.gnu.org/licenses/>.
Referencing the BPDQ toolbox:
When referencing the BPDQ toolbox, please cite the following:
@misc{bpdqtbx,title={{The Basis Pursuit DeQuantizer (BPDQ) toolbox}},
author={D. K. Hammond, L. Jacques, M.J. Fadili, G. Puy and P. Vandergheynst},
Institution = {Signal Processing Laboratory (LTS2), EPFL, Lausanne, Switzerland},
Month = {July}, url = {https://wiki.epfl.ch/bpdq},
Year = {2009}
}
Special Thanks:
The BPDQ Toolbox team warmly thanks:
- Gilles Puy who kindly shared with us the code of the TV prox written in C from the work of Durand S., Fadili J. and Nikolova M
- Michael Lustig, Ewout van den Berg, and Michael Friedlander who kindly allowed us to use the file GENERATEANGIOGRAM.m, part of the GPL Sparco Toolbox and renamed here bpdq_generate_angiogram.m
BPDQ Main Authors:
Feel free to submit us by email the (unavoidable) bugs (please, provide then an explicit report of the bug with the full error message you got), remarks or wishes relatively to this toolbox.
The BPDQ Toolbox Team - EPFL - 2009