Vamp Test Plugin

h1. About the Vamp Test Plugin

{{>toc}}

The Vamp Test Plugin is a plugin that does no real work, does not analyse its input at all, and always returns the same results. (With one caveat: you should feed it at least 15 seconds of input audio, because it returns features across a 15-second span.)

It has several outputs, which are designed to test the host's handling of various aspects of the Vamp OutputDescriptor SampleType and SampleRate settings. Note that all output features have labels indicating the expected timing and (in some cases) values for the feature.

Think of it as the Vamp plugin equivalent of a TV test pattern or printer test page.

h2. Outputs

The plugin outputs are listed below, with a description and an example of Sonic Annotator's display of the output features. The output comes from the forthcoming Sonic Annotator v0.8 -- use of this plugin turned up a bug in 0.7 which 0.8 fixes!

h3. instants

The *instants* output is a @VariableSampleRate@ output containing ten instants explicitly timestamped at 1.5 second intervals. They are labelled by number and time.

<pre>

"test.wav",0.000000000,"1 of 10 at 0"

,1.500000000,"2 of 10 at 1.5"

,3.000000000,"3 of 10 at 3"

,4.500000000,"4 of 10 at 4.5"

,6.000000000,"5 of 10 at 6"

,7.500000000,"6 of 10 at 7.5"

,9.000000000,"7 of 10 at 9"

,10.500000000,"8 of 10 at 10.5"

,12.000000000,"9 of 10 at 12"

,13.500000000,"10 of 10 at 13.5"

</pre>

h3. curve-oss

The *curve-oss* output is a @OneSamplePerStep@ output containing 20 values from 0 to 0.95 in increments of 0.05. They have implicit timing, so their timestamps will depend on the process block size. The expected times are calculated by the plugin and returned in the feature labels.

<pre>

"test.wav",0.000000000,0,"1 of 20: 0 at 0"

,0.023219954,0.05,"2 of 20: 0.05 at 0.023"

,0.046439909,0.1,"3 of 20: 0.1 at 0.046"

,0.069659863,0.15,"4 of 20: 0.15 at 0.069"

,0.092879818,0.2,"5 of 20: 0.2 at 0.092"

,0.116099773,0.25,"6 of 20: 0.25 at 0.116"

,0.139319727,0.3,"7 of 20: 0.3 at 0.139"

,0.162539682,0.35,"8 of 20: 0.35 at 0.162"

,0.185759637,0.4,"9 of 20: 0.4 at 0.185"

,0.208979591,0.45,"10 of 20: 0.45 at 0.208"

,0.232199546,0.5,"11 of 20: 0.5 at 0.232"

,0.255419501,0.55,"12 of 20: 0.55 at 0.255"

,0.278639455,0.6,"13 of 20: 0.6 at 0.278"

,0.301859410,0.65,"14 of 20: 0.65 at 0.301"

,0.325079365,0.7,"15 of 20: 0.7 at 0.325"

,0.348299319,0.75,"16 of 20: 0.75 at 0.348"

,0.371519274,0.8,"17 of 20: 0.8 at 0.371"

,0.394739229,0.85,"18 of 20: 0.85 at 0.394"

,0.417959183,0.9,"19 of 20: 0.9 at 0.417"

,0.441179138,0.95,"20 of 20: 0.95 at 0.441"

</pre>

h3. curve-fsr

The *curve-fsr* output is a @FixedSampleRate@ output which contains 10 implicitly timed features with values from 0 to 0.9 in increments of 0.1. 

This output has a SampleRate of 2.5, so the features should appear at 0.4 second intervals.

<pre>

"test.wav",0.000000000,0,"1 of 10: 0 at 0"

,0.400000000,0.1,"2 of 10: 0.1 at 0.4"

,0.800000000,0.2,"3 of 10: 0.2 at 0.8"

,1.200000000,0.3,"4 of 10: 0.3 at 1.2"

,1.600000000,0.4,"5 of 10: 0.4 at 1.6"

,2.000000000,0.5,"6 of 10: 0.5 at 2"

,2.400000000,0.6,"7 of 10: 0.6 at 2.4"

,2.800000000,0.7,"8 of 10: 0.7 at 2.8"

,3.200000000,0.8,"9 of 10: 0.8 at 3.2"

,3.600000000,0.9,"10 of 10: 0.9 at 3.6"

</pre>

h3. curve-fsr-timed

The *curve-fsr-timed* output is a @FixedSampleRate@ output in which the features have explicit timestamps. The features have values from 0 to 0.9 in increments of 0.1. They are not, however, equally spaced.

According to the "Vamp Plugin Programmers' Guide":http://vamp-plugins.org/guide.pdf, "The host may round the timestamp according to the sample rate given in the output descriptor's sampleRate field". In my view this is the right thing for a host to do, although it's technically optional. This output tests that behaviour by providing features at timestamps that do not lie on sample boundaries, along with a label indicating what the host would be expected to snap them to (always the nearest sample boundary).

The output has a SampleRate of 2.5, so the features should be snapped to 0.4 second boundaries.

Thus:

<pre>

"test.wav",0.000000000,0,"1 of 10: 0 at 0 snap to 0"

,0.000000000,0.1,"2 of 10: 0.1 at 0 snap to 0"

,0.000000000,0.2,"3 of 10: 0.2 at 0.166 snap to 0"

,0.400000000,0.3,"4 of 10: 0.3 at 0.333 snap to 0.4"

,2.000000000,0.4,"5 of 10: 0.4 at 2 snap to 2"

,2.000000000,0.5,"6 of 10: 0.5 at 2 snap to 2"

,2.000000000,0.6,"7 of 10: 0.6 at 2.166 snap to 2"

,2.400000000,0.7,"8 of 10: 0.7 at 2.333 snap to 2.4"

,4.000000000,0.8,"9 of 10: 0.8 at 4 snap to 4"

,4.000000000,0.9,"10 of 10: 0.9 at 4 snap to 4"

</pre>

h3. curve-vsr

The *curve-vsr* output is a @VariableSampleRate@ output which contains 10 explicitly timed features at 0.25 second intervals with values from 0 to 0.9 in increments of 0.1. 

<pre>

"test.wav",0.000000000,0,"1 of 10: 0 at 0"

,0.750000000,0.1,"2 of 10: 0.1 at 0.75"

,1.500000000,0.2,"3 of 10: 0.2 at 1.5"

,2.250000000,0.3,"4 of 10: 0.3 at 2.25"

,3.000000000,0.4,"5 of 10: 0.4 at 3"

,3.750000000,0.5,"6 of 10: 0.5 at 3.75"

,4.500000000,0.6,"7 of 10: 0.6 at 4.5"

,5.250000000,0.7,"8 of 10: 0.7 at 5.25"

,6.000000000,0.8,"9 of 10: 0.8 at 6"

,6.750000000,0.9,"10 of 10: 0.9 at 6.75"

</pre>

h3. grid-oss

The *grid-oss* output is a @OneSamplePerStep@ output containing 20 consecutive features of 10 values each, with values ranging from 0 at "bottom left" to (nearly) 1 at "top right".

<pre>

"test.wav",0.000000000,0.0666667,0.1,0.133333,0.166667,0.2,0.233333,0.266667,0.3,0.333333,0.366667,"1 of 20 at 0"

,0.023219954,0.1,0.133333,0.166667,0.2,0.233333,0.266667,0.3,0.333333,0.366667,0.4,"2 of 20 at 0.023"

,0.046439909,0.133333,0.166667,0.2,0.233333,0.266667,0.3,0.333333,0.366667,0.4,0.433333,"3 of 20 at 0.046"

,0.069659863,0.166667,0.2,0.233333,0.266667,0.3,0.333333,0.366667,0.4,0.433333,0.466667,"4 of 20 at 0.069"

,0.092879818,0.2,0.233333,0.266667,0.3,0.333333,0.366667,0.4,0.433333,0.466667,0.5,"5 of 20 at 0.092"

,0.116099773,0.233333,0.266667,0.3,0.333333,0.366667,0.4,0.433333,0.466667,0.5,0.533333,"6 of 20 at 0.116"

,0.139319727,0.266667,0.3,0.333333,0.366667,0.4,0.433333,0.466667,0.5,0.533333,0.566667,"7 of 20 at 0.139"

,0.162539682,0.3,0.333333,0.366667,0.4,0.433333,0.466667,0.5,0.533333,0.566667,0.6,"8 of 20 at 0.162"

,0.185759637,0.333333,0.366667,0.4,0.433333,0.466667,0.5,0.533333,0.566667,0.6,0.633333,"9 of 20 at 0.185"

,0.208979591,0.366667,0.4,0.433333,0.466667,0.5,0.533333,0.566667,0.6,0.633333,0.666667,"10 of 20 at 0.208"

,0.232199546,0.4,0.433333,0.466667,0.5,0.533333,0.566667,0.6,0.633333,0.666667,0.7,"11 of 20 at 0.232"

,0.255419501,0.433333,0.466667,0.5,0.533333,0.566667,0.6,0.633333,0.666667,0.7,0.733333,"12 of 20 at 0.255"

,0.278639455,0.466667,0.5,0.533333,0.566667,0.6,0.633333,0.666667,0.7,0.733333,0.766667,"13 of 20 at 0.278"

,0.301859410,0.5,0.533333,0.566667,0.6,0.633333,0.666667,0.7,0.733333,0.766667,0.8,"14 of 20 at 0.301"

,0.325079365,0.533333,0.566667,0.6,0.633333,0.666667,0.7,0.733333,0.766667,0.8,0.833333,"15 of 20 at 0.325"

,0.348299319,0.566667,0.6,0.633333,0.666667,0.7,0.733333,0.766667,0.8,0.833333,0.866667,"16 of 20 at 0.348"

,0.371519274,0.6,0.633333,0.666667,0.7,0.733333,0.766667,0.8,0.833333,0.866667,0.9,"17 of 20 at 0.371"

,0.394739229,0.633333,0.666667,0.7,0.733333,0.766667,0.8,0.833333,0.866667,0.9,0.933333,"18 of 20 at 0.394"

,0.417959183,0.666667,0.7,0.733333,0.766667,0.8,0.833333,0.866667,0.9,0.933333,0.966667,"19 of 20 at 0.417"

,0.441179138,0.7,0.733333,0.766667,0.8,0.833333,0.866667,0.9,0.933333,0.966667,1,"20 of 20 at 0.441"

</pre>

h3. grid-fsr

The *grid-fsr* output is a @FixedSampleRate@ output which contains 10 implicitly timed features with 10 values each. 

This output has a SampleRate of 2.5, so the features should appear at 0.4 second intervals.

<pre>

"test.wav",0.000000000,0.1,0.15,0.2,0.25,0.3,0.35,0.4,0.45,0.5,0.55,"1 of 10 at 0"

,0.400000000,0.15,0.2,0.25,0.3,0.35,0.4,0.45,0.5,0.55,0.6,"2 of 10 at 0.4"

,0.800000000,0.2,0.25,0.3,0.35,0.4,0.45,0.5,0.55,0.6,0.65,"3 of 10 at 0.8"

,1.200000000,0.25,0.3,0.35,0.4,0.45,0.5,0.55,0.6,0.65,0.7,"4 of 10 at 1.2"

,1.600000000,0.3,0.35,0.4,0.45,0.5,0.55,0.6,0.65,0.7,0.75,"5 of 10 at 1.6"

,2.000000000,0.35,0.4,0.45,0.5,0.55,0.6,0.65,0.7,0.75,0.8,"6 of 10 at 2"

,2.400000000,0.4,0.45,0.5,0.55,0.6,0.65,0.7,0.75,0.8,0.85,"7 of 10 at 2.4"

,2.800000000,0.45,0.5,0.55,0.6,0.65,0.7,0.75,0.8,0.85,0.9,"8 of 10 at 2.8"

,3.200000000,0.5,0.55,0.6,0.65,0.7,0.75,0.8,0.85,0.9,0.95,"9 of 10 at 3.2"

,3.600000000,0.55,0.6,0.65,0.7,0.75,0.8,0.85,0.9,0.95,1,"10 of 10 at 3.6"

</pre>

h3. notes-regions

The *notes-regions* output is a @VariableSampleRate@ output which contains 10 explicitly timed features at 1 second intervals with values from 0 to 0.9 in increments of 0.1. The features have durations of 1.75 and 0.5 seconds respectively (repeated 5 times).

<pre>

"test.wav",0.000000000,1.750000000,0,"1 of 10: 0 at 0 dur. 1.75"

,1.000000000,0.500000000,0.1,"2 of 10: 0.1 at 1 dur. 0.5"

,2.000000000,1.750000000,0.2,"3 of 10: 0.2 at 2 dur. 1.75"

,3.000000000,0.500000000,0.3,"4 of 10: 0.3 at 3 dur. 0.5"

,4.000000000,1.750000000,0.4,"5 of 10: 0.4 at 4 dur. 1.75"

,5.000000000,0.500000000,0.5,"6 of 10: 0.5 at 5 dur. 0.5"

,6.000000000,1.750000000,0.6,"7 of 10: 0.6 at 6 dur. 1.75"

,7.000000000,0.500000000,0.7,"8 of 10: 0.7 at 7 dur. 0.5"

,8.000000000,1.750000000,0.8,"9 of 10: 0.8 at 8 dur. 1.75"

,9.000000000,0.500000000,0.9,"10 of 10: 0.9 at 9 dur. 0.5"

</pre>