The ClioPatria Semantic Web Toolkit

About

ClioPatria is an extension of the SWI-Prolog RDF infrastructure (semweb package) that provides you with a ready-to-run web-server that can be extended into a full-fledged Semantic Web application. The semweb package provides reading and writing RDF (XML and Turtle), storage and querying by means of rdf(Subject, Predicate, Object). ClioPatria adds the following:

• A SPARQL server This processes HTTP SPARQL requests. The server also includes support for SeRQL and the Sesame (rdf4j.org) HTTP protocol.
• Reasoning libraries Called entailment modules. See entailment/README.txt
• User administration Create users, provide OpenID services, use external OpenID authorization and connect users to right-tokens.
• A web-based developers front-end This provides provides browsing the RDF, loading and unloading graphs, testing queries interactively, browsing the documentation of HTTP services and source-code.
• Web-page generation components Server-side components to render an RDF resource or literals with a link to the development UI, render simple graphs, etc.
• Additional libraries These are additional components to the http and semweb libraries that may become part of SWI-Prolog in the future. Examples are lib/semweb/rdf_optimise.pl to optimise rdf-control-structures and lib/semweb/rdf_abstract.pl to transform graphs represented as rdf(S,P,O) terms.

Installation

Basic installation merely requires installing a recent version of SWI-Prolog and unpacking ClioPatria (see Downloading below). Next, you can deploy it in two ways:

Installation as application

Running ClioPatria as an application requires a few steps:

1. Create the start-file run.pl from run.pl.in. On Unix, this is achieved by running `./configure` from the top directory. On Windows by double-clicking win-config.exe.
2. Optionally, pull in additional configuration files according to config-enabled/README.txt. This can also be done later.
3. Start run.pl as `./run.pl` on Unix or double-clicking run.pl on Windows and direct your browser to the indicated address (default is http://localhost:3020/. If this is the first time, you will be asked to enter an admin password. This protects some web-operations, such as managing settings and loading/unloading RDF.

If you want to extend the application, there are two options. One is to put a Prolog file with the desired extensions in config-enabled. Another is to run configure/setup from another directory. This creates run.pl and config-enabled in the current working directory, after which the extensions can be placed in config-enabled.

Windows notes

If the file name extension that is associated to SWI-Prolog is pl, you may install the system by double-clicking setup.pl rather win-config.exe.

If the file name extension that is associated to SWI-Prolog is not pl, win-config.exe is needed to open SWI-Prolog on setup.pl. The installation will create a run script with the appropriate extension (typically pro).

Use as library

To use ClioPatria as a library, one can simply compile cliopatria.pl. The file run.pl as generated from installation as an application gives additional actions you may want to setup. The web-server is started by cp_server/0, but the system runs happily if the Prolog HTTP server is started in another way, as long as the server uses http_dispatch/1 for dispatching HTTP requests.

Downloading

Currently, ClioPatria can only be downloaded through GIT. The commands for downloading the system are:

git clone https://github.com/ClioPatria/ClioPatria.git
cd ClioPatria
git submodule update --init web/yasqe
git submodule update --init web/yasr

Further reading

We published an article in the Semantic Web Journal that explains the rationale behind ClioPatria. Please cite this when you are using ClioPatria in your research (full reference below).

Many of the design issues around handling the Semantic Web in Prolog are described and motivated in Jan Wielemaker's PhD thesis (PDF) as well as various articles. RoadMap.txt explains the basic layout of the sources.

Feel free to join the ClioPatria mailing list at https://listserver.vu.nl/mailman/listinfo/cliopatria.few

Authors:

• Jan Wielemaker
• Wouter Beek
• Jacco van Ossenbruggen
• Michiel Hildebrand

  @article{DBLP:journals/semweb/WielemakerBHO15,
    author    = {Jan Wielemaker and
                 Wouter Beek and
                 Michiel Hildebrand and
                 Jacco van Ossenbruggen},
  title     = {ClioPatria: {A} SWI-Prolog infrastructure for the Semantic Web},
  journal   = {Semantic Web},
  volume    = {7},
  number    = {5},
  pages     = {529--541},
  year      = {2016},
  url       = {http://dx.doi.org/10.3233/SW-150191},
  doi       = {10.3233/SW-150191},
  timestamp = {Mon, 12 Dec 2016 16:21:50 +0100},
  biburl    = {http://dblp2.uni-trier.de/rec/bib/journals/semweb/WielemakerBHO15},
  bibsource = {dblp computer science bibliography, http://dblp.org}
  }

Prolog files

cliopatria.pl  -- ClioPatria main module
cp_after_load/1	Register Goal to be executed after reloading the RDF persistent DB.
cp_server/0	Start the HTTP server.
cp_server/1	Start the HTTP server.
cp_welcome/0	Print welcome banner.
create_pool/1	Create a thread-pool on-demand.
hooks.pl  -- ClioPatria hooks
parms.pl  -- ClioPatria parameters

ClioPatria wishlist

Tools

• Compute labels from resources (per graph)

Quality Assurance

Browser facilities

• Predicate analysis
  • Functional predicates
  • Near functional predicates: what are the exceptions?

LOD Support

• Load unresolved resources through LOD (per graph)

RDF Management

• Make it possible for code to demand RDF (from the library)
• Make it possible for RDF libraries to depend on other library by `token' (or, at least not by Manifest path).

Config

• Extend config frontend to deal with CPACK