comparison rdf/vamp.n3 @ 148:afd60ff5ceef

* Commit updates from David to deal with quantized outputs and
known-range outputs

 		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.
 	""";
 	vs:term_status "stable";
 	.
 
+vamp:QuantizedParameterDescriptor
+	a owl:Class;
+	rdfs:label "QuantizedParameter Descriptor";
+	rdfs:subClassOf	vamp:ParameterDescriptor;
+	rdfs:comment """
+			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 Descriptor.
+	""";
+	vs:term_status "stable";
+	.
+
 vamp:PluginOutput
 	a owl:Class;
 	rdfs:label "Vamp Plugin output descriptor";
 	rdfs:comment """
 		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.
 	""";
 	vs:term_status "unstable";
+	.
+
+#3 classifications of outputs: 
+#-density of data
+#-quantised
+#-known extents
+
+#there is not classification for fix_bin_count
+
+vamp:QuantizedOutput
+	a owl:Class;
+	rdfs:label "Quantized Output";
+	rdfs:subClassOf	vamp:PluginOutput;
+	rdfs:comment """
+			Descriptor of an output that does have quantized values.
+	""";
+	vs:term_status "stable";
+	.
+
+vamp:KnownExtentsOutput
+	a owl:Class;
+	rdfs:label "Known Extents Output";
+	rdfs:subClassOf	vamp:PluginOutput;
+	rdfs:comment """
+			Descriptor of an output that does have known extents.
+	""";
+	vs:term_status "stable";
 	.
 
 vamp:DenseOutput
 	a owl:Class;
 	rdfs:subClassOf vamp:PluginOutput;

 	vs:term_status "stable";
 	.
 
 # Note that other properties like maker can be linked to the plugin descriptor using other namespaces
 
-##### Parameter Descriptor properties
+##### Parameter Descriptor properties (and some common with PluginOutput)
 
 # Note: Identifier has been already defined
 
 vamp:max_value
 	a rdf:Property;

 	rdfs:label "max value";
 	rdfs:comment """
 		Maximum value of the parameter range
 	""";
 	rdfs:range vamp:ParameterDescriptor;
-	rdfs:range vamp:PluginOutput;
+	rdfs:range vamp:KnownExtentsOutput;
 	vs:term_status "unstable";
 	.
 
 vamp:min_value
 	a rdf:Property;

 	rdfs:label "min value";
 	rdfs:comment """
 		Minimum value of the parameter range
 	""";
 	rdfs:range vamp:ParameterDescriptor;
-	rdfs:range vamp:PluginOutput;
+	rdfs:range vamp:KnownExtentsOutput;
 	vs:term_status "unstable";
 	.
 
 vamp:default_value
 	a rdf:Property;

 	""";
 	rdfs:range vamp:ParameterDescriptor;
 	vs:term_status "unstable";
 	.
 
+vamp:quantize_step
+	a rdf:Property;
+	a owl:FunctionalProperty;
+	a owl:DatatypeProperty;
+	rdfs:label "quantized step";
+	rdfs:comment """
+		Quantize step. Only defined if is_quantized is true
+	""";
+	rdfs:domain vamp:QuantizedOutput;
+	rdfs:domain vamp:QuantizedParameterDescriptor;
+	vs:term_status "unstable";
+	.
+
+vamp:unit 
+	a rdf:Property;
+	a owl:DatatypeProperty;
+	a owl:FunctionalProperty;
+	rdfs:label "unit";
+	rdfs:comment """
+		Unit of the output/parameter. A string type
+	""";
+	rdfs:domain vamp:PluginOutput;
+	rdfs:domain vamp:ParameterDescriptor;
+	vs:term_status "unstable";
+	.
+
+vamp:value_names  
+	a rdf:Property;
+	a owl:DatatypeProperty;
+	rdfs:label "value names";
+	rdfs:comment """
+		List of value names if available
+	""";
+	rdfs:domain vamp:ParameterDescriptor;
+	vs:term_status "unstable";
+	.
+
 ########Output Descriptor properties
 
 vamp:fixed_bin_count 
 	a rdf:Property;
 	a owl:DatatypeProperty;

 	""";
 	rdfs:domain vamp:PluginOutput;
 	vs:term_status "unstable";
 	.
 
-vamp:is_quantized
-	a rdf:Property;
-	a owl:DatatypeProperty;
-	rdfs:label "is quantized";
-	rdfs:comment """
-		Quantized. A boolean type.
-	""";
-	rdfs:domain vamp:PluginOutput;
-	vs:term_status "unstable";
-	.
-
-vamp:unit 
-	a rdf:Property;
-	a owl:DatatypeProperty;
-	a owl:FunctionalProperty;
-	rdfs:label "unit";
-	rdfs:comment """
-		Unit of the output/parameter. A string type
-	""";
-	rdfs:domain vamp:PluginOutput;
-	rdfs:domain vamp:ParameterDescriptor;
-	vs:term_status "unstable";
-	.
-
 vamp:sample_rate
 	a rdf:Property;
 	a owl:DatatypeProperty;
 	rdfs:label "sample rate";
 	rdfs:comment """
 		Sample rate of the output if any. Should be read depending on SampleType and Output classes.
 	""";
 	rdfs:domain vamp:PluginOutput;
-	vs:term_status "unstable";
-	.
-
-vamp:quantize_step
-	a rdf:Property;
-	a owl:FunctionalProperty;
-	a owl:DatatypeProperty;
-	rdfs:label "quantized step";
-	rdfs:comment """
-		Quantize step. Only defined if is_quantized is true
-	""";
-	rdfs:domain vamp:PluginOutput;
-	rdfs:domain vamp:ParameterDescriptor;
 	vs:term_status "unstable";
 	.
 	
 vamp:bin_count      
 	a rdf:Property;

 vamp:bin_names  
 	a rdf:Property;
 	a owl:DatatypeProperty;
 	rdfs:label "bin names";
 	rdfs:comment """
-		List of bin names if available
+		List of bin names if available.
 	""";
 	rdfs:domain vamp:PluginOutput;
 	vs:term_status "unstable";
 	.
 

 	""";
 	rdfs:domain vamp:PluginOutput;
 	rdfs:range vamp:SampleType;
 	vs:term_status "unstable";
 	.
+
+#These last 2 properties are included to match the Audio Features Ontology (not estrictly from the Vamp API).
 
 vamp:computes_feature_type
 	a rdf:Property;
 	a owl:ObjectProperty;
 	rdfs:label "feature type";