# LV2 Units Extension
# Copyright 2009-2011 David Robillard
# Copyright 2007 Steve Harris
#
# Permission to use, copy, modify, and/or distribute this software for any
# purpose with or without fee is hereby granted, provided that the above
# copyright notice and this permission notice appear in all copies.
#
# THIS SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
# WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
# MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
# ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
# WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
# ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
# OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.

@prefix units: <http://lv2plug.in/ns/extensions/units#> .
@prefix lv2:   <http://lv2plug.in/ns/lv2core#> .
@prefix rdf:   <http://www.w3.org/1999/02/22-rdf-syntax-ns#> .
@prefix rdfs:  <http://www.w3.org/2000/01/rdf-schema#> .
@prefix doap:  <http://usefulinc.com/ns/doap#> .
@prefix foaf:  <http://xmlns.com/foaf/0.1/> .
@prefix xsd:   <http://www.w3.org/2001/XMLSchema#> .
@prefix dcs:   <http://ontologi.es/doap-changeset#> .

<http://plugin.org.uk/swh.xrdf#me>
    a foaf:Person ;
    foaf:name "Steve Harris" ;
    foaf:homepage <http://plugin.org.uk/> ;
    rdfs:seeAlso <http://plugin.org.uk/swh.xrdf> .

<http://drobilla.net/drobilla#me>
    a foaf:Person ;
    foaf:name "David Robillard" ;
    foaf:homepage <http://drobilla.net/> ;
    foaf:mbox <mailto:d@drobilla.net> ;
    rdfs:seeAlso <http://drobilla.net/drobilla> .

<http://lv2plug.in/ns/extensions/units>
    a lv2:Specification ;
    doap:name "LV2 Units" ;
    doap:shortdesc "Units for LV2 values." ;
    doap:created "2007-02-06" ;
    doap:homepage <http://lv2plug.in/ns/extensions/units> ;
    doap:license <http://opensource.org/licenses/isc-license> ;
    doap:release [
        doap:revision "5.4" ;
        doap:created "2011-11-20" ;
        dcs:blame <http://drobilla.net/drobilla#me> ;
        dcs:changeset [
            dcs:item [
                rdfs:label "Define used but undefined resources (units:name, units:render, units:symbol, units:Conversion, units:conversion, units:prefixConversion, units:to, and units:factor)."
            ] , [
				rdfs:label "Update packaging."
			] , [
				rdfs:label "Improve documentation."
			]
        ]
    ] ;
    doap:maintainer [
        a foaf:Person ;
        rdfs:seeAlso <http://plugin.org.uk/swh.xrdf> ;
        foaf:homepage <http://plugin.org.uk/> ;
        foaf:mbox_sha1sum "44bc4fed584a2d1ac8fc55206db67656165d67fd" ;
        foaf:name "Steve Harris"
    ], [
        a foaf:Person ;
        rdfs:seeAlso <http://drobilla.net/drobilla.rdf> ;
        foaf:homepage <http://drobilla.net/> ;
        foaf:name "David Robillard"
    ] ;
    lv2:documentation """
<p>This extension defines a number of units for use in audio processing.</p>

<p>For example, to say that a gain port's value is in decibels (units:db)</p>
<pre class="turtle-code">
@prefix units: &lt;http://lv2plug.in/ns/extensions/units#&gt; .
@prefix eg:    &lt;http://example.org/&gt; .

eg:plugin lv2:port [
    a            lv2:ControlRateInputPort ;
    lv2:datatype lv2:Float ;
    lv2:index    0 ;
    lv2:symbol   "gain" ;
    lv2:name     "gain" ;
    units:unit   units:db
] .
</pre>

<p>Using the same form, plugins may also specify one-off units inline, to give
better display hints to hosts:</p>
<pre class="turtle-code">
eg:plugin lv2:port [
    a            lv2:ControlRateInputPort ;
    lv2:datatype lv2:Float ;
    lv2:index    0 ;
    lv2:symbol   "frob" ;
    lv2:name     "frob level" ;
    units:unit [
        a            units:Unit ;
        units:name   "frobnication" ;
        units:symbol "fr" ;
        units:render "%f f"
    ]
] .
</pre>

<p>It is also possible to define conversions between various units, which makes
it possible for hosts to automatically and generically convert from a given
unit to a desired unit.  The units defined in this extension include conversion
definitions where it makes sense to do so.</p>
""" .

units:Unit a rdfs:Class ;
    rdfs:comment "A unit for LV2 port data" .

units:unit
    a rdf:Property ;
    rdfs:domain lv2:Port ;
    rdfs:range units:Unit ;
    rdfs:comment "Relates a port to the unit of its data" .

units:name
    a rdf:Property ;
    rdfs:domain units:Unit ;
    rdfs:range xsd:string ;
    rdfs:comment "A display name for the unit (e.g. decibels)." .

units:render
    a rdf:Property ;
    rdfs:domain units:Unit ;
    rdfs:range xsd:string ;
    rdfs:comment "A printf format string for rendering a value (eg. \"%f dB\")." .

units:symbol
    a rdf:Property ;
    rdfs:domain units:Unit ;
    rdfs:range xsd:string ;
    rdfs:comment "The abbreviated symbol for the unit (e.g. dB)." .

units:Conversion
    a rdfs:Class ;
    rdfs:comment "A conversion from one unit to another." .

units:conversion
    a rdf:Property ;
    rdfs:domain units:Unit ;
    rdfs:range units:Conversion ;
    rdfs:comment "A conversion from this unit to another." .

units:prefixConversion
    a rdf:Property ;
    rdfs:subPropertyOf units:conversion ;
    rdfs:domain units:Unit ;
    rdfs:range units:Conversion ;
    rdfs:comment """
A conversion from this unit to the same unit but with a different SI prefix
(e.g. Hz to kHz).
""" .

units:to
    a rdf:Property ;
    rdfs:domain units:Conversion ;
    rdfs:range units:Unit ;
    rdfs:comment "The target unit this conversion converts to." .

units:factor
    a rdf:Property ;
    rdfs:domain units:Conversion ;
    rdfs:range units:Unit ;
    rdfs:comment """
The factor to multiple the source value by in order to convert
to the target unit.
""" .

units:s a units:Unit ;
    units:conversion [
        units:factor 0.0166666666 ;
        units:to units:min
    ] ;
    units:name "second" ;
    units:prefixConversion [
        units:factor 1000 ;
        units:to units:ms
    ] ;
    units:render "%f s" ;
    units:symbol "s" .

units:ms a units:Unit ;
    units:name "millisecond" ;
    units:prefixConversion [
        units:factor 0.001 ;
        units:to units:s
    ] ;
    units:render "%f ms" ;
    units:symbol "ms" .

units:min a units:Unit ;
    units:conversion [
        units:factor 60.0 ;
        units:to units:s
    ] ;
    units:name "minute" ;
    units:render "%f mins" ;
    units:symbol "min" .

units:bar a units:Unit ;
    units:name "bar" ;
    units:render "%f bars" ;
    units:symbol "bars" .

units:beat a units:Unit ;
    units:name "beat" ;
    units:render "%f beats" ;
    units:symbol "beats" .

units:m a units:Unit ;
    units:conversion [
        units:factor 39.37 ;
        units:to units:inch
    ] ;
    units:name "metre" ;
    units:prefixConversion [
        units:factor 100 ;
        units:to units:cm
    ], [
        units:factor 1000 ;
        units:to units:mm
    ], [
        units:factor 0.001 ;
        units:to units:km
    ] ;
    units:render "%f m" ;
    units:symbol "m" .

units:cm a units:Unit ;
    units:conversion [
        units:factor 0.3937 ;
        units:to units:inch
    ] ;
    units:name "centimetre" ;
    units:prefixConversion [
        units:factor 0.01 ;
        units:to units:m
    ], [
        units:factor 10 ;
        units:to units:mm
    ], [
        units:factor 0.00001 ;
        units:to units:km
    ] ;
    units:render "%f cm" ;
    units:symbol "cm" .

units:mm a units:Unit ;
    units:conversion [
        units:factor 0.03937 ;
        units:to units:inch
    ] ;
    units:name "millimetre" ;
    units:prefixConversion [
        units:factor 0.001 ;
        units:to units:m
    ], [
        units:factor 0.1 ;
        units:to units:cm
    ], [
        units:factor 0.000001 ;
        units:to units:km
    ] ;
    units:render "%f mm" ;
    units:symbol "mm" .

units:km a units:Unit ;
    units:conversion [
        units:factor 0.62138818 ;
        units:to units:mile
    ] ;
    units:name "kilometre" ;
    units:prefixConversion [
        units:factor 1000 ;
        units:to units:m
    ], [
        units:factor 100000 ;
        units:to units:cm
    ], [
        units:factor 1000000 ;
        units:to units:mm
    ] ;
    units:render "%f km" ;
    units:symbol "km" .

units:inch a units:Unit ;
    units:conversion [
        units:factor 2.54 ;
        units:to units:cm
    ] ;
    units:name "inch" ;
    units:render "%f\"" ;
    units:symbol "in" .

units:mile a units:Unit ;
    units:conversion [
        units:factor 1.6093 ;
        units:to units:km
    ] ;
    units:name "mile" ;
    units:render "%f mi" ;
    units:symbol "mi" .

units:db a units:Unit ;
    units:name "decibel" ;
    units:render "%f dB" ;
    units:symbol "dB" .

units:pc a units:Unit ;
    units:conversion [
        units:factor 0.01 ;
        units:to units:coef
    ] ;
    units:name "percent" ;
    units:render "%f%%" ;
    units:symbol "%" .

units:coef a units:Unit ;
    units:conversion [
        units:factor 100 ;
        units:to units:pc
    ] ;
    units:name "coefficient" ;
    units:render "* %f" ;
    units:symbol "" .

units:hz a units:Unit ;
    units:name "hertz" ;
    units:prefixConversion [
        units:factor 0.001 ;
        units:to units:khz
    ], [
        units:factor 0.000001 ;
        units:to units:mhz
    ] ;
    units:render "%f Hz" ;
    units:symbol "Hz" .

units:khz a units:Unit ;
    units:name "kilohertz" ;
    units:prefixConversion [
        units:factor 1000 ;
        units:to units:hz
    ], [
        units:factor 0.001 ;
        units:to units:mhz
    ] ;
    units:render "%f kHz" ;
    units:symbol "kHz" .

units:mhz a units:Unit ;
    units:name "megahertz" ;
    units:prefixConversion [
        units:factor 1000000 ;
        units:to units:hz
    ], [
        units:factor 0.001 ;
        units:to units:khz
    ] ;
    units:render "%f MHz" ;
    units:symbol "MHz" .

units:bpm a units:Unit ;
    units:name "beats per minute" ;
    units:prefixConversion [
        units:factor 0.0166666666 ;
        units:to units:hz
    ] ;
    units:render "%f BPM" ;
    units:symbol "BPM" .

units:oct a units:Unit ;
    units:conversion [
        units:factor 12.0 ;
        units:to units:semitone12TET
    ] ;
    units:name "octaves" ;
    units:render "%f octaves" ;
    units:symbol "oct" .

units:cent a units:Unit ;
    units:conversion [
        units:factor 0.01 ;
        units:to units:semitone12TET
    ] ;
    units:name "cent" ;
    units:render "%f ct" ;
    units:symbol "ct" .

units:semitone12TET a units:Unit ;
    units:conversion [
        units:factor 0.083333333 ;
        units:to units:oct
    ] ;
    units:name "semitone" ;
    units:render "%f semi" ;
    units:symbol "semi" .

units:degree a units:Unit ;
    units:name "degree" ;
    units:render "%f deg" ;
    units:symbol "deg" .

units:midiNote a units:Unit ;
    units:name "MIDI note" ;
    units:render "MIDI note %d" ;
    units:symbol "note" .