Awesome

<img src="http://ericdscott.com/NaturalLexiconLogo.png" alt="NaturalLexicon logo" :width=100 height=100/> ont-app/igraph-vocabulary

Support for creating keyword identifiers (KWIs) in IGraph-compliant graphs and aligning data in IGraph graphs to data in other formats.

Contents

• Dependencies
• Overview
• The mint-kwi method
• The resolve-namespace-prefixes function
• Supporting ontology
  • Default subsumed-by declarations
• License

<a name="h2-dependencies"></a>

Dependencies

Available at Clojars.

Require thus:

(ns ont-app.igraph-vocabulary.core-test
(:require 
  [
   [ont-app.igraph.core :as igraph]
   [ont-app.vocabulary.core :as voc]
   [ont-app.igraph-vocabulary.core :as igv]
   ))

<a name="h2-overview"></a>

Overview

ont-app/igraph and ont-app/vocabulary are independent libraries. The former defining a generic graph-based primitive container, and the latter defining a way of treating namespaced Keyword Identifies (KWIs) as though they were URIs comprising a public vocabulary, aligned to RDF namespaces. ont-app/igraph-vocabulary is responsible for basic functionality involving the intersection or these two, providing some basic ontological constructs that express common features of IGraph implementations.

For purposes of this discussion, the term URI and IRI will be used interchangably. In practice Clojure keywords are encoded as UTF-8, making them IRIs. The term URI has a much greater mind-share, to the extent that any of this stuff has mind-share at all.

A KWI is a qualified Clojure keyword used exactly the way a URI is used in RDF. Ideally URIs should be importable as KWIs and integrated into IGraph-based models, and conversely KWIs should be exportable as standard RDF-type URIs.

Since this is the lowest level at which both igraph and vocabulary are in play. This is the level that defines a small supporting ontology igraph-based graphs.

<a name="h2-the-mint-kwi-method"></a>

The mint-kwi method

When building a model in a graph representation, it's a common occurrence to need to create canonically named KWIs on the fly, especially to identify newly encountered instances of some class of entities. For example :employee/123, mappable to http://rdf.mycompany.com/employee#123.

The mint-kwi method returns a keyword identifier based on a head keyword (which typically names a class) and any number of other arguments (typically a set of predicate/value pairs). The method is dispatched on the head.

Best practice is to provide as many predicate/value pairs as are necessary to uniquely distinguish the thing being identified within whatever universe you're playing in.

Let's assume the following namespace declaration (note the metadata in the ns):

(ns ont-app.igraph-vocabulary.core-test
  {:vann/preferredNamespacePrefix "eg"
   :vann/preferredNamespaceUri "http://example.com/"
   }
 (require
 [ont-app.igraph.core :as igraph]
 [ont-app.igraph-vocabulary.core :as igv :refer [mint-kwi]]
 [ont-app.vocabulary.core :as voc]
 ))

The default method will simply concatenate the names of the keywords provided:

> (mint-kwi :eg/Example :eg/number 1)
:eg/Example_number_1
>

Since we have the proper metadata declared for core-test module, we can get RDF equivalents:

> (voc/qname-for :eg/Example_number_1)
"eg:Example_number_1"
>
> (voc/uri-for :eg/Example_number_1)
"http://example.com/Example_number_1"
> 

We can write a custom method dispatched on the head:

> (defmethod mint-kwi :eg/Example
    [head & {:keys [:eg/number]}]
    (keyword (namespace head)
      (str (name head)
         "_"
         number)))
#multifn[mint-kwi 0x535c5c20]
> (mint-kwi :eg/Example :eg/number 2)
:eg/Example_2
> 

<a name="h2-resolve-namespace-prefixes-function"></a>

The resolve-namespace-prefixes function

It may be the case that you are referencing a graph whose URIs may need translating into KWIs. In such cases, you can apply this function as a reduce-spo:

> (def g (igraph/reduce-spo resove-namespace-prefixes g))

This will reset the value of igraph g with its URIs translated into their equivalent KWIs, wherever the appropriate namespace metadata has been supplied.

<a name="h2-supporting-ontology"></a>

Supporting ontology

These declarations are defined as the constant igv/ontology, an instance of the simple IGraph implementation ont-app.igraph.graph/Graph.

The igraph namespace.

This dedicated to naming constructs pertinent to implementations of IGraph.

(voc/put-ns-meta!
 'ont-app.igraph.core
 {
  :vann/preferredNamespacePrefix "igraph"
  :vann/preferredNamespaceUri "http://rdf.naturallexicon.org/ont-app/igraph/ont#"
  }
 )

<a name="h3-default-subsumed-by"></a>

Default subsumedBy declarations

The following subsumedBy declarations are defined in ont-app.igraph-vocabulary.ont.cljc:

  [:rdf/type :rdfs/subPropertyOf :igraph/subsumedBy]
  [:rdfs/subClassOf :rdfs/subPropertyOf :igraph/subsumedBy]
  [:rdfs/subPropertyOf :rdfs/subPropertyOf :igraph/subsumedBy]

<a name="h2-license"></a>

License

Copyright © 2019-22 Eric D. Scott

Distributed under the Eclipse Public License either version 1.0 or (at your option) any later version.