SMALLbox

h1. FAQ

h2. Q1: What is SMALLbox?

*A1:* *SMALLbox* is an evaluation framework for processing signals using adaptive sparse structured representations. SMALLbox is built within FP7 EU FET project called "SMALL" that is exploring new provably good methods to obtain inherently data-driven sparse models, which are able to cope with large-scale and complicated data. The main focus of research in the area of *sparse representations* is in developing reliable algorithms with provable performance and bounded complexity. There exist many applications for which it was proven beneficial to sparsely represent the data in some transform domain (i.e. "dictionary"). Moreover, the success of sparse models heavily depends on the choice of a “dictionary” to reflect the natural structures of a class of data. *Dictionary learning for sparse representation* deals with inferring such a dictionary from training data and is a key to the extension of sparse models for new exotic types of data.

SMALLbox provides an easy way to evaluate these methods against state-of-the art alternatives in a variety of standard signal processing problems. This is achieved trough a unifying interface that enables a seamless connection between the three types of modules: problems, dictionary learning algorithms and sparse solvers. In addition, it provides interoperability between existing state-of-the-art toolboxes. 

As an open source MATLAB toolbox, the SMALLbox can be seen as not only as a evaluation and educational tool, but as a tool for reproducible research in the sparse representations research community.

h2. Q2: How to obtain SMALLbox?

The SMALLbox project is maintained by people at the "Centre for Digital Music at SEECS, Queen Mary University of London":http://www.elec.qmul.ac.uk/digitalmusic/. To access the SMALLbox project page follow the link bellow:

https://code.soundsoftware.ac.uk/projects/smallbox/

If you want to try the latest stable public release please go to *Downloads* section. If you want to check the latest development and to contribute to the project then please first register to soundsoftware.ac.uk following the link in the upper right corner of the page. 

The code repository hosted at soundsoftware.ac.uk is using Mercurial distributed version control, so you will need mercurial installed on your system.  If you are new to mercurial the easiest way to start is to install EasyMercurial, which you can find at https://code.soundsoftware.ac.uk/projects/easyhg.

To check out SMALLbox repository please hg clone the following URL, or provide this URL to your preferred Mercurial client (e.g. EasyMercurial):

https://code.soundsoftware.ac.uk/hg/smallbox

h2. Q3: How to install SMALLbox?

h2. Q4: What are the Problem, solver, and DL structures in SMALLbox?

h2. Q5: What is included in SMALLbox?

h2. Q6: How do I contribute?

h2. Q7: I want to add my solver to SMALLbox. How?

h2. Q8: I want to add my dictionary learning algorithm to SMALLbox. How?

h2. Q9: I want to add a new sparse representation problem. How? 

h2. Q10: I want to add a new problem for dictionary learning. How?