cannam@135: dpastor@155: cannam@135: cannam@135: Vamp Plugins Ontology cannam@135: Vamp Plugins Ontology cannam@135: cannam@147: Vamp Ontology. This ontology includes the following descriptions: cannam@136: cannam@147: - OWL description of the Vamp API cannam@147: - OWL description of the Transform environment necessary to set up the execution of any plugin cannam@136: cannam@136: This Ontology provides semantics to describe and control Vamp plugins in RDF. Any "RDF-speaker" host is therefore able to cannam@136: use this ontology to read, set up and execute plugins. cannam@147: The extracted features are expressed in terms of the Audio Features Ontology: http://purl.org/ontology/af/. cannam@147: For more information, please visit the Vamp Plugins website: http://www.vamp-plugins.org/ cannam@135: cannam@135: Chris Cannam cannam@135: Chris Sutton cannam@135: Yves Raimond cannam@135: David Pastor Escuredo cannam@135: $Date: 2008/05/21 17:05:11 $ cannam@135: cannam@135: dpastor@155: cannam@135: Vamp Plugin cannam@135: cannam@147: A Vamp plugin is an implementation of an audio feature extraction algorithm using the Vamp API. cannam@135: cannam@135: stable cannam@135: dpastor@155: cannam@135: Vamp Plugin Library cannam@135: cannam@147: Library of Vamp Plugins. This may need to include rights. cannam@135: cannam@135: stable cannam@135: dpastor@155: dpastor@155: Vamp Plugin Parameter cannam@135: cannam@147: 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. cannam@135: cannam@135: stable cannam@135: dpastor@155: dpastor@155: Quantized Parameter dpastor@155: cannam@150: dpastor@155: 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. cannam@150: cannam@150: stable cannam@150: dpastor@155: cannam@135: Vamp Plugin output descriptor cannam@135: cannam@147: 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. cannam@135: cannam@135: unstable cannam@135: dpastor@155: cannam@150: Quantized Output dpastor@155: cannam@150: cannam@150: Descriptor of an output that does have quantized values. cannam@150: cannam@150: stable cannam@150: dpastor@155: cannam@150: Known Extents Output dpastor@155: cannam@150: cannam@150: Descriptor of an output that does have known extents. cannam@150: cannam@150: stable cannam@150: dpastor@155: dpastor@155: cannam@136: Dense output cannam@135: cannam@147: 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. cannam@135: cannam@135: unstable cannam@135: dpastor@155: cannam@136: Sparse output dpastor@155: cannam@135: cannam@147: Specific output type for data that consist of features that require their own individual temporal information. cannam@135: cannam@135: unstable cannam@135: dpastor@155: cannam@136: track level output dpastor@155: cannam@135: cannam@147: 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. cannam@135: cannam@135: unstable cannam@135: dpastor@155: cannam@135: Plugin program cannam@135: cannam@147: 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. cannam@135: cannam@136: unstable cannam@135: dpastor@155: cannam@135: Vamp Feature cannam@135: This may be removed mighty soon as we rely on the Audio Features Ontology for this cannam@135: deprecated cannam@135: dpastor@155: cannam@135: Plugin input domain cannam@136: cannam@147: 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. cannam@136: cannam@135: stable cannam@135: dpastor@155: cannam@135: sample type cannam@136: cannam@147: The sample type specifies the temporal information of the plugin output. This information should be combined with the output type for a correct interpretation. cannam@136: cannam@135: stable cannam@135: dpastor@155: cannam@135: cannam@135: parameter descriptor cannam@135: cannam@147: Links each parameter descriptor to the plugin. cannam@135: dpastor@155: dpastor@155: dpastor@155: cannam@135: stable dpastor@155: dpastor@155: cannam@135: dpastor@155: output cannam@135: cannam@147: Links each output type to the plugin. cannam@135: dpastor@155: dpastor@155: dpastor@155: cannam@135: stable cannam@135: dpastor@155: cannam@135: cannam@135: available plugin cannam@135: cannam@147: Available plugins in the library cannam@135: dpastor@155: dpastor@155: cannam@135: stable cannam@135: dpastor@155: cannam@135: cannam@135: plugin identifier cannam@135: cannam@147: Machine-readable identifier for a Vamp plugin within the scope of its library, or for a plugin descriptor within the scope of the plugin. cannam@135: dpastor@155: dpastor@155: dpastor@155: dpastor@155: dpastor@155: dpastor@155: cannam@135: stable cannam@135: dpastor@155: cannam@135: cannam@135: plugin name cannam@135: cannam@135: Human-readable identifier for the plugin. cannam@135: dpastor@155: cannam@135: stable cannam@135: dpastor@155: cannam@135: cannam@135: vamp API version cannam@135: cannam@147: Version of the Vamp API used to implement this plugin. cannam@135: dpastor@155: cannam@135: stable cannam@135: dpastor@155: cannam@135: cannam@135: input domain cannam@135: cannam@147: Input domain required by the plugin (time or frequency). cannam@135: dpastor@155: dpastor@155: cannam@135: stable cannam@135: dpastor@155: cannam@135: cannam@135: cannam@135: max value cannam@136: cannam@136: Maximum value of the parameter range cannam@136: dpastor@155: dpastor@155: cannam@135: unstable cannam@135: dpastor@155: cannam@135: cannam@135: cannam@135: min value cannam@136: cannam@136: Minimum value of the parameter range cannam@136: dpastor@155: dpastor@155: cannam@135: unstable cannam@135: dpastor@155: cannam@135: cannam@135: cannam@135: default value cannam@136: cannam@136: Default value of the parameter cannam@136: dpastor@155: cannam@135: unstable cannam@135: dpastor@155: cannam@150: cannam@135: cannam@150: quantized step cannam@136: cannam@150: Quantize step. Only defined if is_quantized is true cannam@136: dpastor@155: dpastor@155: cannam@138: unstable cannam@138: dpastor@155: cannam@135: cannam@135: cannam@135: unit cannam@136: cannam@136: Unit of the output/parameter. A string type cannam@136: dpastor@155: dpastor@155: cannam@135: unstable cannam@135: dpastor@155: cannam@150: cannam@150: value names cannam@150: cannam@150: List of value names if available cannam@150: dpastor@155: cannam@150: unstable cannam@150: dpastor@155: cannam@150: cannam@150: fixed bin count cannam@150: cannam@150: Fixed bin count. A boolean type. cannam@150: dpastor@155: cannam@150: unstable cannam@150: dpastor@155: cannam@135: cannam@135: sample rate cannam@136: cannam@136: Sample rate of the output if any. Should be read depending on SampleType and Output classes. cannam@136: dpastor@155: cannam@135: unstable cannam@135: cannam@135: cannam@135: cannam@135: sample rate cannam@135: stable cannam@135: cannam@135: Specifies the sample rate if it is not constant. cannam@135: dpastor@155: cannam@135: dpastor@155: cannam@135: cannam@135: bin count cannam@136: cannam@136: Number of elements of the bin output. This information is necessary to define the output as belonging to a specific subclass of Plugin Output. cannam@136: dpastor@155: cannam@135: unstable cannam@135: dpastor@155: cannam@135: cannam@135: bin names cannam@136: cannam@150: List of bin names if available. cannam@136: dpastor@155: cannam@135: unstable cannam@135: dpastor@155: cannam@135: cannam@135: cannam@135: sample type cannam@136: cannam@136: The sample type specifies the temporal information of the output. cannam@136: dpastor@155: dpastor@155: cannam@135: unstable cannam@135: dpastor@155: cannam@135: cannam@135: feature type cannam@135: cannam@136: Feature Types output by the plugin. Links the vamp ontology to the audio features ontology. cannam@135: dpastor@155: dpastor@155: cannam@135: unstable cannam@135: dpastor@155: cannam@138: cannam@138: event type cannam@138: cannam@138: Event Type output by the plugin. cannam@138: dpastor@155: dpastor@155: cannam@138: unstable cannam@138: dpastor@155: dpastor@155: dpastor@155: dpastor@155: dpastor@155: dpastor@155: cannam@136: Transform cannam@135: stable cannam@135: cannam@147: The Transform defines the environment of any audio processing computation. cannam@135: cannam@135: dpastor@155: dpastor@155: Parameter binding cannam@135: unstable cannam@135: dpastor@155: Parameter setting used by the plugin transform to set up the plugin. cannam@135: cannam@135: dpastor@155: cannam@136: Configuration cannam@136: unstable cannam@136: cannam@147: For extension (key/value data provided to DSSI plugins, not relevant to Vamp) cannam@136: cannam@136: dpastor@155: cannam@136: Transform Type cannam@136: unstable cannam@136: cannam@136: Specifies the type of transform. May be feature extraction, effect... cannam@136: cannam@136: dpastor@155: cannam@136: Feature Extraction cannam@136: unstable cannam@136: cannam@136: Feature extraction transform. This may be just a subclass of Transform... cannam@136: cannam@136: dpastor@155: cannam@136: Effect cannam@136: unstable cannam@136: cannam@136: Effect transform. This may be just a subclass of Transform... cannam@136: cannam@136: dpastor@155: cannam@135: cannam@135: plugin cannam@135: stable cannam@135: cannam@147: Specifies the sort of plugin in execution. This is an extension to use Transform with other plugin libraries cannam@135: dpastor@155: dpastor@155: cannam@135: dpastor@155: cannam@135: cannam@135: cannam@135: program cannam@135: stable cannam@135: cannam@147: 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? cannam@135: dpastor@155: dpastor@155: dpastor@155: dpastor@155: cannam@136: cannam@136: cannam@136: program cannam@136: stable cannam@136: cannam@147: Extension for configuration. cannam@136: dpastor@155: dpastor@155: cannam@136: dpastor@155: cannam@136: cannam@136: parameter cannam@136: stable cannam@136: cannam@136: Specifies the parameter to set the plugin in execution. cannam@136: dpastor@155: dpastor@155: cannam@135: dpastor@155: cannam@135: cannam@135: cannam@135: step size cannam@135: stable cannam@135: cannam@135: Specifies the step size for the framing. cannam@135: dpastor@155: cannam@135: dpastor@155: cannam@135: cannam@135: cannam@135: block size cannam@135: stable cannam@135: cannam@135: Specifies the block size for the framing. cannam@135: dpastor@155: cannam@135: dpastor@155: cannam@136: cannam@135: cannam@135: transform type cannam@135: unstable cannam@135: cannam@136: Specifies the transform type (we could do this by subclassin transform instead of using a property). cannam@135: dpastor@155: cannam@135: dpastor@155: cannam@135: cannam@135: cannam@135: window type cannam@135: unstable cannam@135: cannam@135: Specifies the window type (they should be individuals and clearly not here). cannam@135: dpastor@155: cannam@136: dpastor@155: cannam@136: cannam@136: cannam@136: start cannam@136: unstable cannam@136: cannam@136: Specifies temporal information when processing a data stream. cannam@136: dpastor@155: cannam@136: dpastor@155: cannam@136: cannam@136: cannam@136: start cannam@136: unstable cannam@136: cannam@136: Specifies temporal information when processing a data stream. cannam@136: dpastor@155: cannam@135: dpastor@155: cannam@135: cannam@135: cannam@135: value cannam@135: stable cannam@135: cannam@135: Specifies the current value of the parameter. cannam@135: dpastor@155: cannam@135: cannam@135: dpastor@155: