https://github.com/rdfostrich/semantic-ostrich

💭 A proof of concept for semantic versioning based on an OSTRICH store
https://github.com/rdfostrich/semantic-ostrich

Last synced: 5 days ago
JSON representation

💭 A proof of concept for semantic versioning based on an OSTRICH store

• Host: GitHub
• URL: https://github.com/rdfostrich/semantic-ostrich
• Owner: rdfostrich
• License: other
• Created: 2018-05-15T07:28:27.000Z (over 6 years ago)
• Default Branch: master
• Last Pushed: 2020-04-29T06:26:08.000Z (over 4 years ago)
• Last Synced: 2024-10-01T12:04:32.597Z (about 1 month ago)
• Language: JavaScript
• Homepage:
• Size: 271 KB
• Stars: 2
• Watchers: 2
• Forks: 0
• Open Issues: 1
• Metadata Files:
  • Readme: README.md
  • License: LICENSE.txt

Awesome Lists containing this project

• awesome-starred - rdfostrich/semantic-ostrich - 💭 A proof of concept for semantic versioning based on an OSTRICH store (others)

README

        
# Semantic OSTRICH

[![Build Status](https://travis-ci.org/rdfostrich/semantic-ostrich.svg?branch=master)](https://travis-ci.org/rdfostrich/semantic-ostrich)

[![npm version](https://badge.fury.io/js/semantic-ostrich.svg)](https://www.npmjs.com/package/semantic-ostrich)

This is a prototypical proof-of-concept implementation for semantic versioned querying.

It is implemented on top of the versioned triple store, [OSTRICH](https://github.com/rdfostrich/ostrich/).

An additional layer is able to perform inferencing based on a set of rules.

## Run on command line

This package ships with a command line tool to execute semantic triple pattern queries against

OSTRICH dataset and language stores, based on a set of inference rules. 

The following executes a semantic version materialization on dataset version 88 and language version 0

for the triple pattern `  ?o`.

This will use the [N3 rules](https://en.wikipedia.org/wiki/Notation3) from `rules.n3`.

```

$ semantic-ostrich bin/semantic-ostrich data/evalrun-bearb-day-data.ostrich/ data/evalrun-bearb-day-language.ostrich/ rules.n3 --vd 88 --vl 0 --qvm '  ?o'

```

For example, a rules file could contain this:

```

{

  ?c  ?d.

  ?x a ?c.

} => {

  ?x a ?d.

}.

```

For more information on the command line tool, call `semantic-ostrich --help`.

## Use in an application

```javascript

// Initialize

const SemanticOstrich = require('semantic-ostrich');

ostrichStore = new SemanticOstrich();

await ostrichStore.init('path/to/datastore.ostrich', 'path/to/languagestore.ostrich', true); // The last parameter sets it to the more performant readonly mode

const rules = SemanticOstrich.readRules('path/to/rules.n3');

// Query one version

const subject = 'http://dbpedia.org/resource/Doctor_Who_(series_9)';

const predicate = 'http://www.w3.org/1999/02/22-rdf-syntax-ns#type';

const object = null; // variable

triples = await ostrichStore.semanticSearchTriplesVersionMaterialized(rules, subject, predicate, object, { version: 88 }, { version: 0 });

```

See [`bin/semantic-ostrich`](https://github.com/rdfostrich/semantic-ostrich/blob/master/bin/semantic-ostrich)

for a more extensive example of the usage of [`SemanticOstrich`](https://github.com/rdfostrich/semantic-ostrich/blob/master/lib/SemanticOstrich.js).

## License

This software is written by [Ruben Taelman](http://rubensworks.net/).

This code is copyrighted by [Ghent University – imec](http://idlab.ugent.be/)

and released under the [MIT license](http://opensource.org/licenses/MIT).