Skip to content
John Graybeal edited this page Jul 30, 2014 · 36 revisions

Modeling

(See initial modeling discussion here)

We are basically going to implement the following conversion approach.

Unit class

An instance of the Unit class captures one main unit entry in the XML. It may have a primary name (via property hasName) and zero or more aliases (via hasAlias property).

hasDefinition property

This is a functional property to capture the <def> element from the XML description.

hasName property

This is a functional property that indicates the primary name of a given Unit instance. In particular, a unit may not have a primary name.

hasAlias property

Indicates an alternate name for a given Unit instance. A unit can have zero or more aliases associated.

hasSymbol property

Indicates a symbol associated with a given Unit instance. A unit can have zero or more symbols associated.

UnitName class

Instances of the UnitName class capture a name or alias associated with an instance of a class Unit.

namesUnit property

With UnitName as domain, this functional property indicates the Unit instance associated with the name.

hasCardinality property

With UnitName as domain, this functional property indicates whether the name is "singular" or "plural".

Remarks:

  • The approach clearly separates the concept of unit from any associated specific names/aliases.
  • Those names/aliases will have URIs per se (so they could be self-resolvable)

Prefix class

Instances of the Prefix class capture a prefix that can be used in front of any instance of class Unit.

hasValue property

This is a functional property to capture the <value> element from the XML description, which defines the mathematical value of the prefix..

hasPrefixName property

This property that indicates the name of a given Prefix instance; unlike hasName, the object of hasPrefixName is a string. (Prefix names are not presented as independent terms.)

hasSymbol property

Indicates a symbol associated with a given Prefix instance. A prefix can have one or more symbols associated.

Unit and UnitName identification

The Unit, UnitName, and Prefix instance URIs will share the same namespace. The id part for each UnitName instance will simply be the associated name itself; this is appropriate because these names are both user- and web-friendly.

The Unit case needs some extra handling. First, all units must have <def> strings, so we will use these strings as basis for an identification term. Although the primary names would be a good candidate for identification, some units lack such names. Moreover, even if such names were always available, we need to avoid collision with the corresponding UnitName instances that would also get those names for its identification, unless we put those on a different namespace.

So, for the generation of Unit instances, the conversion tool will apply an arbitrary but deterministic translation (md5 or sha hash) of the <def> string, and use the last 6 characters. If a collision results, the tool will add a '+' to the string and re-hash and repeat until a unique name results.

The Prefix case follows the Unit case, but using the <value> string as the basis for the identification term.

Example 1

The following entry from the original vocabulary:

        <unit>
            <def>'/60</def>
            <name><singular>arc_second</singular></name>
            <symbol>"</symbol>
            <symbol>&#x2033;</symbol>           <!-- DOUBLE PRIME -->
            <aliases>
                <name><singular>angular_second</singular></name>
                <name><singular>arcsecond</singular></name>
                <name><singular>arcsec</singular></name>
            </aliases>
        </unit>

will result in the RDF representation:

@prefix :        <http://mmisw.org/ont/mmitest/udunits2-accepted/> .
@prefix prop:    <http://mmisw.org/ont/mmitest/udunits2-prop/> .

:2a1369 
      a                      :Unit ;
      prop:hasDefinition     "'/60" ;
      prop:hasName           :arc_second ;
      prop:hasAlias          :arcsec, :angular_second, :arcsecond ;
      prop:hasSymbol         "\"", "″" ;

:arc_second
      a                      :UnitName ;
      prop:namesUnit         :2a1369;
      prop:hasCardinality    "singular";

:arcsec
      a                      :UnitName ;
      prop:namesUnit         :2a1369;
      prop:hasCardinality    "singular";

:angular_second
      a                      :UnitName ;
      prop:namesUnit         :2a1369;
      prop:hasCardinality    "singular";

:arcsecond
      a                      :UnitName ;
      prop:namesUnit         :2a1369;
      prop:hasCardinality    "singular";

Any other questions?

Clone this wiki locally