conversion:keys

What is first

• The owl:keys enhancement is a qualification that restricts the behavior of conversion:links_via.

What we will cover

Let's get to it

This conversion:Enhancement is loosely analogous to owl:key.

Example 1 - input

The following example uses the same identifiers to refer to two different things. The distinguishing factor here is the type of thing being referenced. So, the "state CA" is distinguished enough from the "company CA".

bash-3.2$ cat manual/test.csv contains:

name,state,company
susy,CA,CA
paul,MA,MA

Example 1 - links-via graph

The graph shown below has descriptions for states and companies with the identifiers "CA" and "MA". We'll use this graph and the conversion:keys enhancement to refer to the correct thing when converting the strings "CA" and "MA".

bash-3.2$ cat manual/links-via.ttl contains:

@prefix dcterms: <http://purl.org/dc/terms/> .

<http://dbpedia.org/resource/M._A._Hanna_Company> 
   a <http://dbpedia.org/ontology/Company>;
   dcterms:identifier "MA" .

<http://logd.tw.rpi.edu/id/us/state/Massachusetts> 
   a <http://dbpedia.org/class/yago/StatesOfTheUnitedStates>.

<http://dbpedia.org/resource/Computer_Associates> 
   a <http://dbpedia.org/ontology/Company>;
   dcterms:identifier "CA" .

<http://logd.tw.rpi.edu/id/us/state/California> 
   a <http://dbpedia.org/class/yago/StatesOfTheUnitedStates>.

without owl:keys qualification to conversion:links_via, we get undesirable sameAs (the state and the company are both sameAs the state and the company):

Example 1 - initial (undesired) output

value_of_state:CA
   dcterms:identifier "CA" ;
   rdfs:label "CA" ;
   owl:sameAs dbpedia:Computer_Associates, <http://logd.tw.rpi.edu/id/us/state/California> .

value_of_company:CA
   dcterms:identifier "CA" ;
   rdfs:label "CA" ;
   owl:sameAs dbpedia:Computer_Associates , <http://logd.tw.rpi.edu/id/us/state/California> .

Example 1 - qualifying conversion:links_via with conversion:keys

Update the eparams to specify additional restrictions that the target Resource must satisfy in order to link:

      conversion:enhance [
         ov:csvCol          2;
         ...
         conversion:links_via <links-via.ttl>;
         conversion:keys [
            # The resources that we try to link to MUST also be described with each predicate-object in this collection.
            dcterms:hasPart [
              conversion:predicate rdf:type;
              conversion:object <http://dbpedia.org/class/yago/StatesOfTheUnitedStates>;
            ], [
              conversion:predicate rdf:type; # More than one predicate-object pair could be specified, 
                                             # this example is being redundant.
              conversion:object <http://dbpedia.org/class/yago/StatesOfTheUnitedStates>;
            ];
         ];
      ];
      ...
      conversion:enhance [
         ov:csvCol          3;
         ...
         conversion:links_via <links-via.ttl>;
         conversion:keys [
            # The resources that we try to link to MUST also be described with each predicate-object in this collection.
            dcterms:hasPart [
              conversion:predicate rdf:type;
              conversion:object <http://dbpedia.org/ontology/Company>;
            ], [
              conversion:predicate rdf:type; # More than one predicate-object pair could be specified,
                                             # this example is being redundant.
              conversion:object <http://dbpedia.org/ontology/Company>;
            ];
         ];
      ];

What is next