Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Vamp Plugins Ontology Chris@12: Chris@12: Chris@12: Vamp Plugins Ontology Chris@12: Chris@12: Chris@12: Chris@12: Vamp Ontology. This ontology includes the following descriptions: Chris@12: Chris@12: - OWL description of the Vamp API Chris@12: - OWL description of the Transform environment necessary to set up the execution of any plugin Chris@12: Chris@12: This Ontology provides semantics to describe and control Vamp plugins in RDF. Any "RDF-speaker" host is therefore able to Chris@12: use this ontology to read, set up and execute plugins. Chris@12: The extracted features are expressed in terms of the Audio Features Ontology: http://purl.org/ontology/af/. Chris@12: For more information, please visit the Vamp Plugins website: http://www.vamp-plugins.org/ Chris@12: Chris@12: Chris@12: Chris@12: Chris Cannam Chris@12: Chris@12: Chris@12: Chris Sutton Chris@12: Chris@12: Chris@12: Yves Raimond Chris@12: Chris@12: Chris@12: David Pastor Escuredo Chris@12: Chris@12: Chris@12: $Date: 2008/05/21 17:05:11 $ Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Vamp Plugin Chris@12: Chris@12: Chris@12: Chris@12: A Vamp plugin is an implementation of an audio feature extraction algorithm using the Vamp API. Chris@12: Chris@12: Chris@12: Chris@12: stable Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Vamp Plugin Library Chris@12: Chris@12: Chris@12: Chris@12: Library of Vamp Plugins. This may need to include rights. Chris@12: Chris@12: Chris@12: Chris@12: stable Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Vamp Plugin Parameter Chris@12: Chris@12: Chris@12: Chris@12: Descriptor for a plugin parameter. Hosts need to know about the specific type and form of the parameters of a particular plugin for a correct transform setup. Chris@12: Chris@12: Chris@12: Chris@12: stable Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Quantized Parameter Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Descriptor of a parameter that does have quantized values. The property quantize_step is just defined for this subclass and not for the general Parameter. Chris@12: Chris@12: Chris@12: Chris@12: stable Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Vamp Plugin output descriptor Chris@12: Chris@12: Chris@12: Chris@12: Descriptor for an output of a plugin. This descriptor provides information that is necessary to correctly interpret the output features. The output type will determine how to read the temporal information of the extracted features and how to manage the burden of ouput data. Chris@12: Chris@12: Chris@12: Chris@12: unstable Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Quantized Output Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Descriptor of an output that does have quantized values. Chris@12: Chris@12: Chris@12: Chris@12: stable Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Known Extents Output Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Descriptor of an output that does have known extents. Chris@12: Chris@12: Chris@12: Chris@12: stable Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Dense output Chris@12: Chris@12: Chris@12: Chris@12: Specific output type for data evenly spaced in time, which may be of high volume and which it is usually desirable to represent in a compact form. Chris@12: Chris@12: Chris@12: Chris@12: unstable Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Sparse output Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Specific output type for data that consist of features that require their own individual temporal information. Chris@12: Chris@12: Chris@12: Chris@12: unstable Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: track level output Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Specific output type for track level information. The Vamp API does not provide for this sort of output directly, so this will require a "hacky" interpretation of the feature timestamp to establish that it reflects track metadata instead of temporal data. Chris@12: Chris@12: Chris@12: Chris@12: unstable Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Plugin program Chris@12: Chris@12: Chris@12: Chris@12: The program is a predefined context of parameters. We may not need a concept for this and just a property linking a string representing the program name. Chris@12: Chris@12: Chris@12: Chris@12: unstable Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Vamp Feature Chris@12: Chris@12: Chris@12: This may be removed mighty soon as we rely on the Audio Features Ontology for this Chris@12: Chris@12: Chris@12: deprecated Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Plugin input domain Chris@12: Chris@12: Chris@12: Chris@12: Plugins declare the input domain they require, so the host can convert the input data properly. Hosts using the Vamp SDK PluginAdapter to wrap plugins should see this work done for them automatically - see the Vamp documentation. Chris@12: Chris@12: Chris@12: Chris@12: stable Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: sample type Chris@12: Chris@12: Chris@12: Chris@12: The sample type specifies the temporal information of the plugin output. This information should be combined with the output type for a correct interpretation. Chris@12: Chris@12: Chris@12: Chris@12: stable Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: parameter descriptor Chris@12: Chris@12: Chris@12: Chris@12: Links each parameter descriptor to the plugin. Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: stable Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: output Chris@12: Chris@12: Chris@12: Chris@12: Links each output type to the plugin. Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: stable Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: available plugin Chris@12: Chris@12: Chris@12: Chris@12: Available plugins in the library Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: stable Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: plugin identifier Chris@12: Chris@12: Chris@12: Chris@12: Machine-readable identifier for a Vamp plugin within the scope of its library, or for a plugin descriptor within the scope of the plugin. Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: stable Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: plugin name Chris@12: Chris@12: Chris@12: Chris@12: Human-readable identifier for the plugin. Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: stable Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Vamp API version Chris@12: Chris@12: Chris@12: Chris@12: Version of the Vamp API used to implement this plugin. Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: stable Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: input domain Chris@12: Chris@12: Chris@12: Chris@12: Input domain required by the plugin (time or frequency). Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: stable Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: max value Chris@12: Chris@12: Chris@12: Chris@12: Maximum value of the parameter range Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: unstable Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: min value Chris@12: Chris@12: Chris@12: Chris@12: Minimum value of the parameter range Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: unstable Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: default value Chris@12: Chris@12: Chris@12: Chris@12: Default value of the parameter Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: unstable Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: quantized step Chris@12: Chris@12: Chris@12: Chris@12: Quantize step. Only defined for quantized outputs Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: unstable Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: has duration Chris@12: Chris@12: Chris@12: Chris@12: True if features on this output are known to have durations Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: unstable Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: unit Chris@12: Chris@12: Chris@12: Chris@12: Unit of the output/parameter. A string type Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: unstable Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: value names Chris@12: Chris@12: Chris@12: Chris@12: List of value names if available Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: unstable Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: fixed bin count Chris@12: Chris@12: Chris@12: Chris@12: Fixed bin count. A boolean type. Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: unstable Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: sample rate Chris@12: Chris@12: Chris@12: Chris@12: Sample rate of the output if any. Should be read depending on SampleType and Output classes. Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: unstable Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: bin count Chris@12: Chris@12: Chris@12: Chris@12: Number of elements of the bin output. This information is necessary to define the output as belonging to a specific subclass of Plugin Output. Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: unstable Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: bin names Chris@12: Chris@12: Chris@12: Chris@12: List of bin names if available. Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: unstable Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: sample type Chris@12: Chris@12: Chris@12: Chris@12: The sample type specifies the temporal information of the output. Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: unstable Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: event type Chris@12: Chris@12: Chris@12: Chris@12: Associates a plugin output with its corresponding event type (for example, in the Audio Features ontology). Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: unstable Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: feature type Chris@12: Chris@12: Chris@12: Chris@12: Associates a plugin output with the attribute connecting the event to its value data. Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: unstable Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: signal type Chris@12: Chris@12: Chris@12: Chris@12: Associates a dense plugin output with its corresponding signal type (for example, in the Audio Features ontology). Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: unstable Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Transform Chris@12: Chris@12: Chris@12: stable Chris@12: Chris@12: Chris@12: Chris@12: The Transform defines the environment of any audio processing computation. Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Parameter binding Chris@12: Chris@12: Chris@12: unstable Chris@12: Chris@12: Chris@12: Chris@12: Parameter setting used by the plugin transform to set up the plugin. Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Configuration Chris@12: Chris@12: Chris@12: unstable Chris@12: Chris@12: Chris@12: Chris@12: For extension (key/value data provided to DSSI plugins, not relevant to Vamp) Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Transform Type Chris@12: Chris@12: Chris@12: unstable Chris@12: Chris@12: Chris@12: Chris@12: Specifies the type of transform. May be feature extraction, effect... Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Feature Extraction Chris@12: Chris@12: Chris@12: unstable Chris@12: Chris@12: Chris@12: Chris@12: Feature extraction transform. This may be just a subclass of Transform... Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Effect Chris@12: Chris@12: Chris@12: unstable Chris@12: Chris@12: Chris@12: Chris@12: Effect transform. This may be just a subclass of Transform... Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: plugin Chris@12: Chris@12: Chris@12: stable Chris@12: Chris@12: Chris@12: Chris@12: Specifies the sort of plugin in execution. This is an extension to use Transform with other plugin libraries Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: program Chris@12: Chris@12: Chris@12: stable Chris@12: Chris@12: Chris@12: Chris@12: Specifies the program to set the plugin in execution. Here the plugin program matches with the one in the plugin descriptor. There is not descriptor required for the program (just a string), is it? Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: program Chris@12: Chris@12: Chris@12: stable Chris@12: Chris@12: Chris@12: Chris@12: Extension for configuration. Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: parameter Chris@12: Chris@12: Chris@12: stable Chris@12: Chris@12: Chris@12: Chris@12: Specifies the parameter to set the plugin in execution. Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: step size Chris@12: Chris@12: Chris@12: stable Chris@12: Chris@12: Chris@12: Chris@12: Specifies the step size for the framing. Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: block size Chris@12: Chris@12: Chris@12: stable Chris@12: Chris@12: Chris@12: Chris@12: Specifies the block size for the framing. Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: sample rate Chris@12: Chris@12: Chris@12: stable Chris@12: Chris@12: Chris@12: Chris@12: Specifies the sample rate if it is not constant. Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: transform type Chris@12: Chris@12: Chris@12: unstable Chris@12: Chris@12: Chris@12: Chris@12: Specifies the transform type (we could do this by subclassin transform instead of using a property). Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: window type Chris@12: Chris@12: Chris@12: unstable Chris@12: Chris@12: Chris@12: Chris@12: Specifies the window type (they should be individuals and clearly not here). Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: start Chris@12: Chris@12: Chris@12: unstable Chris@12: Chris@12: Chris@12: Chris@12: Specifies temporal information when processing a data stream. Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: start Chris@12: Chris@12: Chris@12: unstable Chris@12: Chris@12: Chris@12: Chris@12: Specifies temporal information when processing a data stream. Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: summary type Chris@12: Chris@12: Chris@12: unstable Chris@12: Chris@12: Chris@12: Chris@12: Specifies a summary type to be used (for averaging etc) on transform results. Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: value Chris@12: Chris@12: Chris@12: stable Chris@12: Chris@12: Chris@12: Chris@12: Specifies the current value of the parameter. Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: computed by Chris@12: Chris@12: Chris@12: Chris@12: Associates an audio feature with the transform that was used to compute it. Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: Chris@12: unstable Chris@12: Chris@12: