SPARCO

Michael P. Frieldlander, Ewout van den Berg
July 2008

GPL v3 MATLAB

HomePage Paper

Introduction

Sparco is a suite of problems for testing and benchmarking algorithms for sparse signal reconstruction. It is also an environment for creating new test problems, and a suite of standard linear operators is provided from which new problems can be assembled. Sparco is implemented entirely in Matlab and is self contained. (A few optional test problems are based on the CurveLab toolbox, which can be installed separately.)

At the core of the sparse recovery problem is the linear system

$$Ax + r = b$$

where \(A\) is an \(m \times n\) linear operator and the \(m\)-vector \(b\) is the observed signal. The goal is to find a sparse \(n\)-vector \(x\) such that \(r\) is small in norm.

This technical report gives an overview of the Sparco toolbox.

Quick Start

The main interface to the test problems is through the generateProblem script found at the top-level directory. To instantiate a particular test problem, simply call generateProblem with the problem's ID number. For instance, problem five generates a signal from a few atoms in a DCT-Dirac dictionary:

>> P = generateProblem(5);

this creates a rpboelm structure P which contains all the information needed to access this problem. The resulting structure contains many bits and pieces, including function handles and data vectors. For example,

P.A      % a function handle to the operator A
P.b      % the right-hand-side vector
P.sizeA  % is a tuple with the number of rows and columns in A

The function handle P.A behaves as follows:

z = P.A(x, mode)

gives:

It is also possible to use the classOp tool to instantiate the operator as an overloaded object, e.g.,

>> C = classOp(P.A); b = P.b;
>> g = C'*g;  % Equivalent to g = P.A(b, 2);
>> y = C *g;  % Equivalent to y = P.A(g, 1);

The best way ot get started is to browse the examples in the EXAMPLES subdirectory.

To get a full list of problem numbers, do:

>> plist = generateProblem('list');

L1 solvers:

Related software:

Resources:

Referencing SPARCO

@techreport{sparco:2007,
  Author = {E. {van den} Berg and M. P. Friedlander
            and G. Hennenfent and F. Herrmann
            and R. Saab and {\"O}. Y{\i}lmaz},
  Institution = {Dept. Computer Science},
  Address = {University of British Columbia, Vancouver},
  Number = {TR-2007-20},
  Title = {Sparco: {A} testing framework for sparse reconstruction},
  Month = {October},
  Year = {2007}
}

Credits

Sparco is distributed under the GNU Public License.

We would be delighted to hear from you if you find Sparco useful, or if you have any suggestions, contributions, or bug reports. Please send these to

This research is supported in part by an NSERC discovery grant and by an NSERC Collaborative Research and Development Grant (33480-05) that funds the DNOISE project.