Wiki » History » Version 20

« Previous - Version 20/23 (diff) - Next » - Current version
Chris Cannam, 2013-04-30 02:35 PM


About the Vamp Test Plugin

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.

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!

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.

"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" 

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.

"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" 

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.

"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" 

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, "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. The guide doesn't say whether timestamps should be rounded down or to the closest sample; this plugin assumes rounding to the closest sample. It also isn't clear whether a half-way point should round down or up; I would expect up.

This output tests the basics of this 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:

"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" 

curve-vsr

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

"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" 

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".

"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" 

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.

"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" 

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).

"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"