Mercurial > hg > vamp-simple-cepstrum

annotate simple-cepstrum.n3 @ 46:a17bca16933a tip

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Add minimal README and COPYING
author Chris Cannam
date Fri, 06 Mar 2020 11:01:17 +0000
parents 745627478cf9
children
rev   line source
Chris@42 1 @prefix rdfs: <http://www.w3.org/2000/01/rdf-schema#> .
Chris@42 2 @prefix xsd: <http://www.w3.org/2001/XMLSchema#> .
Chris@42 3 @prefix vamp: <http://purl.org/ontology/vamp/> .
Chris@42 4 @prefix plugbase: <http://vamp-plugins.org/rdf/plugins/simple-cepstrum#> .
Chris@42 5 @prefix owl: <http://www.w3.org/2002/07/owl#> .
Chris@42 6 @prefix dc: <http://purl.org/dc/elements/1.1/> .
Chris@42 7 @prefix af: <http://purl.org/ontology/af/> .
Chris@42 8 @prefix foaf: <http://xmlns.com/foaf/0.1/> .
Chris@42 9 @prefix doap: <http://usefulinc.com/ns/doap#> .
Chris@42 10 @prefix cc: <http://web.resource.org/cc/> .
Chris@42 11 @prefix : <#> .
Chris@42 12
Chris@42 13
Chris@42 14 ## Properties of this document
Chris@42 15
Chris@42 16 <> a vamp:PluginDescription ;
Chris@42 17 foaf:maker <http://vamp-plugins.org/rdf/template-generator> ;
Chris@42 18 foaf:primaryTopic <http://vamp-plugins.org/rdf/plugins/simple-cepstrum> .
Chris@42 19
Chris@42 20
Chris@42 21 ## Maker of the whole plugin library
Chris@42 22
Chris@42 23 :library_maker
Chris@42 24 foaf:name "Chris Cannam" ;
Chris@42 25 foaf:logo <http://vamp-plugins.org/rdf/plugins/makers/qm.png> ;
Chris@42 26 foaf:page <http://c4dm.eecs.qmul.ac.uk/> .
Chris@42 27
Chris@42 28
Chris@42 29 ## Properties of the plugin library, and references to the plugins it contains
Chris@42 30
Chris@42 31 plugbase:library a vamp:PluginLibrary ;
Chris@42 32 vamp:identifier "simple-cepstrum" ;
Chris@42 33 foaf:maker :library_maker ;
Chris@42 34 vamp:available_plugin plugbase:simple-cepstrum ;
Chris@42 35 dc:title "Simple Cepstrum" ;
Chris@42 36 dc:description """A simple Vamp plugin to calculate and return cepstrum values from DFT bins. Useful as a preliminary tool for looking at cepstral data for simple pitch or envelope methods.""" ;
Chris@42 37 foaf:page <http://code.soundsoftware.ac.uk/projects/vamp-simple-cepstrum> ;
Chris@42 38 # doap:download-page <> ; # Place download HTML page URL here and uncomment
Chris@42 39 vamp:has_source true ;
Chris@42 40 .
Chris@42 41
Chris@42 42
Chris@42 43 ## Properties of the Simple Cepstrum plugin
Chris@42 44
Chris@42 45 plugbase:simple-cepstrum a vamp:Plugin ;
Chris@42 46 dc:title "Simple Cepstrum" ;
Chris@42 47 vamp:name "Simple Cepstrum" ;
Chris@42 48 dc:description """Return simple cepstral data from DFT bins. This plugin is intended for casual inspection of cepstral data. It returns a lot of different sorts of data and is quite slow; it's not a good way to extract a single feature rapidly.""" ;
Chris@42 49 foaf:maker :library_maker ;
Chris@42 50 dc:rights """Freely redistributable (BSD license)""" ;
Chris@42 51 # cc:license <Place plugin license URI here and uncomment> ;
Chris@42 52 vamp:identifier "simple-cepstrum" ;
Chris@42 53 vamp:vamp_API_version vamp:api_version_2 ;
Chris@42 54 owl:versionInfo "1" ;
Chris@42 55 vamp:input_domain vamp:FrequencyDomain ;
Chris@42 56
Chris@42 57 vamp:parameter plugbase:simple-cepstrum_param_fmin ;
Chris@42 58 vamp:parameter plugbase:simple-cepstrum_param_fmax ;
Chris@42 59 vamp:parameter plugbase:simple-cepstrum_param_histlen ;
Chris@42 60 vamp:parameter plugbase:simple-cepstrum_param_vflen ;
Chris@42 61 vamp:parameter plugbase:simple-cepstrum_param_method ;
Chris@42 62 vamp:parameter plugbase:simple-cepstrum_param_clamp ;
Chris@42 63
Chris@42 64 vamp:output plugbase:simple-cepstrum_output_raw_cepstral_peak ;
Chris@42 65 vamp:output plugbase:simple-cepstrum_output_interpolated_peak ;
Chris@42 66 vamp:output plugbase:simple-cepstrum_output_variance ;
Chris@42 67 vamp:output plugbase:simple-cepstrum_output_peak ;
Chris@42 68 vamp:output plugbase:simple-cepstrum_output_peak_to_rms ;
Chris@42 69 vamp:output plugbase:simple-cepstrum_output_peak_proportion ;
Chris@42 70 vamp:output plugbase:simple-cepstrum_output_peak_to_second_peak ;
Chris@42 71 vamp:output plugbase:simple-cepstrum_output_total ;
Chris@42 72 vamp:output plugbase:simple-cepstrum_output_cepstrum ;
Chris@42 73 vamp:output plugbase:simple-cepstrum_output_am ;
Chris@42 74 vamp:output plugbase:simple-cepstrum_output_env ;
Chris@42 75 vamp:output plugbase:simple-cepstrum_output_es ;
Chris@42 76 .
Chris@42 77 plugbase:simple-cepstrum_param_fmin a vamp:Parameter ;
Chris@42 78 vamp:identifier "fmin" ;
Chris@42 79 dc:title "Minimum frequency" ;
Chris@42 80 dc:format "Hz" ;
Chris@42 81 vamp:min_value 46.875 ;
Chris@42 82 vamp:max_value 24000 ;
Chris@42 83 vamp:unit "Hz" ;
Chris@42 84 vamp:default_value 50 ;
Chris@42 85 vamp:value_names ();
Chris@42 86 .
Chris@42 87 plugbase:simple-cepstrum_param_fmax a vamp:Parameter ;
Chris@42 88 vamp:identifier "fmax" ;
Chris@42 89 dc:title "Maximum frequency" ;
Chris@42 90 dc:format "Hz" ;
Chris@42 91 vamp:min_value 46.875 ;
Chris@42 92 vamp:max_value 24000 ;
Chris@42 93 vamp:unit "Hz" ;
Chris@42 94 vamp:default_value 1000 ;
Chris@42 95 vamp:value_names ();
Chris@42 96 .
Chris@42 97 plugbase:simple-cepstrum_param_histlen a vamp:QuantizedParameter ;
Chris@42 98 vamp:identifier "histlen" ;
Chris@42 99 dc:title "Mean filter history length" ;
Chris@42 100 dc:format "" ;
Chris@42 101 vamp:min_value 1 ;
Chris@42 102 vamp:max_value 10 ;
Chris@42 103 vamp:unit "" ;
Chris@42 104 vamp:quantize_step 1 ;
Chris@42 105 vamp:default_value 1 ;
Chris@42 106 vamp:value_names ();
Chris@42 107 .
Chris@42 108 plugbase:simple-cepstrum_param_vflen a vamp:QuantizedParameter ;
Chris@42 109 vamp:identifier "vflen" ;
Chris@42 110 dc:title "Vertical filter length" ;
Chris@42 111 dc:format "" ;
Chris@42 112 vamp:min_value 1 ;
Chris@42 113 vamp:max_value 11 ;
Chris@42 114 vamp:unit "" ;
Chris@42 115 vamp:quantize_step 2 ;
Chris@42 116 vamp:default_value 1 ;
Chris@42 117 vamp:value_names ();
Chris@42 118 .
Chris@42 119 plugbase:simple-cepstrum_param_method a vamp:QuantizedParameter ;
Chris@42 120 vamp:identifier "method" ;
Chris@42 121 dc:title "Cepstrum transform method" ;
Chris@42 122 dc:format "" ;
Chris@42 123 vamp:min_value 0 ;
Chris@42 124 vamp:max_value 4 ;
Chris@42 125 vamp:unit "" ;
Chris@42 126 vamp:quantize_step 1 ;
Chris@42 127 vamp:default_value 0 ;
Chris@42 128 vamp:value_names ( "Inverse symmetric" "Inverse asymmetric" "Inverse complex" "Forward magnitude" "Forward difference");
Chris@42 129 .
Chris@42 130 plugbase:simple-cepstrum_param_clamp a vamp:QuantizedParameter ;
Chris@42 131 vamp:identifier "clamp" ;
Chris@42 132 dc:title "Clamp negative values in cepstrum at zero" ;
Chris@42 133 dc:format "" ;
Chris@42 134 vamp:min_value 0 ;
Chris@42 135 vamp:max_value 1 ;
Chris@42 136 vamp:unit "" ;
Chris@42 137 vamp:quantize_step 1 ;
Chris@42 138 vamp:default_value 0 ;
Chris@42 139 vamp:value_names ();
Chris@42 140 .
Chris@42 141 plugbase:simple-cepstrum_output_raw_cepstral_peak a vamp:DenseOutput ;
Chris@42 142 vamp:identifier "raw_cepstral_peak" ;
Chris@42 143 dc:title "Frequency corresponding to raw cepstral peak" ;
Chris@42 144 dc:description """Return the frequency whose period corresponds to the quefrency with the maximum bin value within the specified range of the cepstrum""" ;
Chris@42 145 vamp:fixed_bin_count "true" ;
Chris@42 146 vamp:unit "Hz" ;
Chris@42 147 a vamp:KnownExtentsOutput ;
Chris@42 148 vamp:min_value 50 ;
Chris@42 149 vamp:max_value 1000 ;
Chris@42 150 vamp:bin_count 1 ;
Chris@42 151 # vamp:computes_event_type <Place event type URI here and uncomment> ;
Chris@42 152 # vamp:computes_feature <Place feature attribute URI here and uncomment> ;
Chris@42 153 # vamp:computes_signal_type <Place signal type URI here and uncomment> ;
Chris@42 154 .
Chris@42 155 plugbase:simple-cepstrum_output_interpolated_peak a vamp:DenseOutput ;
Chris@42 156 vamp:identifier "interpolated_peak" ;
Chris@42 157 dc:title "Interpolated peak frequency" ;
Chris@42 158 dc:description """Return the frequency whose period corresponds to the quefrency with the maximum bin value within the specified range of the cepstrum, using parabolic interpolation to estimate the peak quefrency to finer than single bin resolution""" ;
Chris@42 159 vamp:fixed_bin_count "true" ;
Chris@42 160 vamp:unit "Hz" ;
Chris@42 161 a vamp:KnownExtentsOutput ;
Chris@42 162 vamp:min_value 50 ;
Chris@42 163 vamp:max_value 1000 ;
Chris@42 164 vamp:bin_count 1 ;
Chris@42 165 # vamp:computes_event_type <Place event type URI here and uncomment> ;
Chris@42 166 # vamp:computes_feature <Place feature attribute URI here and uncomment> ;
Chris@42 167 # vamp:computes_signal_type <Place signal type URI here and uncomment> ;
Chris@42 168 .
Chris@42 169 plugbase:simple-cepstrum_output_variance a vamp:DenseOutput ;
Chris@42 170 vamp:identifier "variance" ;
Chris@42 171 dc:title "Variance of cepstral bins in range" ;
Chris@42 172 dc:description """Return the variance of bin values within the specified range of the cepstrum""" ;
Chris@42 173 vamp:fixed_bin_count "true" ;
Chris@42 174 vamp:unit "" ;
Chris@42 175 vamp:bin_count 1 ;
Chris@42 176 # vamp:computes_event_type <Place event type URI here and uncomment> ;
Chris@42 177 # vamp:computes_feature <Place feature attribute URI here and uncomment> ;
Chris@42 178 # vamp:computes_signal_type <Place signal type URI here and uncomment> ;
Chris@42 179 .
Chris@42 180 plugbase:simple-cepstrum_output_peak a vamp:DenseOutput ;
Chris@42 181 vamp:identifier "peak" ;
Chris@42 182 dc:title "Value at peak" ;
Chris@42 183 dc:description """Return the value found in the maximum-valued bin within the specified range of the cepstrum""" ;
Chris@42 184 vamp:fixed_bin_count "true" ;
Chris@42 185 vamp:unit "" ;
Chris@42 186 vamp:bin_count 1 ;
Chris@42 187 # vamp:computes_event_type <Place event type URI here and uncomment> ;
Chris@42 188 # vamp:computes_feature <Place feature attribute URI here and uncomment> ;
Chris@42 189 # vamp:computes_signal_type <Place signal type URI here and uncomment> ;
Chris@42 190 .
Chris@42 191 plugbase:simple-cepstrum_output_peak_to_rms a vamp:DenseOutput ;
Chris@42 192 vamp:identifier "peak_to_rms" ;
Chris@42 193 dc:title "Peak-to-RMS distance" ;
Chris@42 194 dc:description """Return the difference between maximum and root mean square bin values within the specified range of the cepstrum""" ;
Chris@42 195 vamp:fixed_bin_count "true" ;
Chris@42 196 vamp:unit "" ;
Chris@42 197 vamp:bin_count 1 ;
Chris@42 198 # vamp:computes_event_type <Place event type URI here and uncomment> ;
Chris@42 199 # vamp:computes_feature <Place feature attribute URI here and uncomment> ;
Chris@42 200 # vamp:computes_signal_type <Place signal type URI here and uncomment> ;
Chris@42 201 .
Chris@42 202 plugbase:simple-cepstrum_output_peak_proportion a vamp:DenseOutput ;
Chris@42 203 vamp:identifier "peak_proportion" ;
Chris@42 204 dc:title "Energy around peak" ;
Chris@42 205 dc:description """Return the proportion of total energy that is found in the bins around the peak bin (as far as the nearest local minima), within the specified range of the cepstrum""" ;
Chris@42 206 vamp:fixed_bin_count "true" ;
Chris@42 207 vamp:unit "" ;
Chris@42 208 vamp:bin_count 1 ;
Chris@42 209 # vamp:computes_event_type <Place event type URI here and uncomment> ;
Chris@42 210 # vamp:computes_feature <Place feature attribute URI here and uncomment> ;
Chris@42 211 # vamp:computes_signal_type <Place signal type URI here and uncomment> ;
Chris@42 212 .
Chris@42 213 plugbase:simple-cepstrum_output_peak_to_second_peak a vamp:DenseOutput ;
Chris@42 214 vamp:identifier "peak_to_second_peak" ;
Chris@42 215 dc:title "Peak to second-peak difference" ;
Chris@42 216 dc:description """Return the difference between the value found in the peak bin within the specified range of the cepstrum, and that found in the next highest peak""" ;
Chris@42 217 vamp:fixed_bin_count "true" ;
Chris@42 218 vamp:unit "" ;
Chris@42 219 vamp:bin_count 1 ;
Chris@42 220 # vamp:computes_event_type <Place event type URI here and uncomment> ;
Chris@42 221 # vamp:computes_feature <Place feature attribute URI here and uncomment> ;
Chris@42 222 # vamp:computes_signal_type <Place signal type URI here and uncomment> ;
Chris@42 223 .
Chris@42 224 plugbase:simple-cepstrum_output_total a vamp:DenseOutput ;
Chris@42 225 vamp:identifier "total" ;
Chris@42 226 dc:title "Total energy" ;
Chris@42 227 dc:description """Return the total energy found in all bins within the specified range of the cepstrum""" ;
Chris@42 228 vamp:fixed_bin_count "true" ;
Chris@42 229 vamp:unit "" ;
Chris@42 230 vamp:bin_count 1 ;
Chris@42 231 # vamp:computes_event_type <Place event type URI here and uncomment> ;
Chris@42 232 # vamp:computes_feature <Place feature attribute URI here and uncomment> ;
Chris@42 233 # vamp:computes_signal_type <Place signal type URI here and uncomment> ;
Chris@42 234 .
Chris@42 235 plugbase:simple-cepstrum_output_cepstrum a vamp:DenseOutput ;
Chris@42 236 vamp:identifier "cepstrum" ;
Chris@42 237 dc:title "Cepstrum" ;
Chris@42 238 dc:description """The unprocessed cepstrum bins within the specified range""" ;
Chris@42 239 vamp:unit "" ;
Chris@42 240 # vamp:computes_event_type <Place event type URI here and uncomment> ;
Chris@42 241 # vamp:computes_feature <Place feature attribute URI here and uncomment> ;
Chris@42 242 # vamp:computes_signal_type <Place signal type URI here and uncomment> ;
Chris@42 243 .
Chris@42 244 plugbase:simple-cepstrum_output_am a vamp:DenseOutput ;
Chris@42 245 vamp:identifier "am" ;
Chris@42 246 dc:title "Cepstrum bins relative to RMS" ;
Chris@42 247 dc:description """The cepstrum bins within the specified range, expressed as a value relative to the root mean square bin value in the range, with values below the RMS clamped to zero""" ;
Chris@42 248 # vamp:computes_event_type <Place event type URI here and uncomment> ;
Chris@42 249 # vamp:computes_feature <Place feature attribute URI here and uncomment> ;
Chris@42 250 # vamp:computes_signal_type <Place signal type URI here and uncomment> ;
Chris@42 251 .
Chris@42 252 plugbase:simple-cepstrum_output_env a vamp:DenseOutput ;
Chris@42 253 vamp:identifier "env" ;
Chris@42 254 dc:title "Spectral envelope" ;
Chris@42 255 dc:description """Envelope calculated from the cepstral values below the specified minimum""" ;
Chris@42 256 # vamp:computes_event_type <Place event type URI here and uncomment> ;
Chris@42 257 # vamp:computes_feature <Place feature attribute URI here and uncomment> ;
Chris@42 258 # vamp:computes_signal_type <Place signal type URI here and uncomment> ;
Chris@42 259 .
Chris@42 260 plugbase:simple-cepstrum_output_es a vamp:DenseOutput ;
Chris@42 261 vamp:identifier "es" ;
Chris@42 262 dc:title "Spectrum without envelope" ;
Chris@42 263 dc:description """Magnitude of spectrum values divided by calculated envelope values, to deconvolve the envelope""" ;
Chris@42 264 # vamp:computes_event_type <Place event type URI here and uncomment> ;
Chris@42 265 # vamp:computes_feature <Place feature attribute URI here and uncomment> ;
Chris@42 266 # vamp:computes_signal_type <Place signal type URI here and uncomment> ;
Chris@42 267 .
Chris@42 268