RDF by Example: rdfpuml for True RDF Diagrams, rdf2rml for R2RML Generation

Everyone likes screenshots!

• There are some shots that illustrate each feature in the documentation (rdfpuml.md or rdfpuml.html).
• There are more shots in individual tests in folder test.
• I'm planning to create a Gallery of all shots in tests

But until I do it, here are a couple of shots.

Declarative model (left) vs generated SPARQL Update for OntoRefine (right two):

• sort is added at various places to make the tool more deterministic, i.e. independent of order of RDF statements in the input file. However, this will interfere with the ability to control the layout, especially of disconnected components (see layout_new_line)
• Some regression tests are added.

In the case Y-P-X described above:

• Also need to record ?y puml:property ?p so this prop name can be added to ?y's subject map
• When making ?map, take puml:property into account
• But ?map is made many times, and copy-paste is no good…
• Also, this should be done in some cases but not others…
• So it's better to record ?y puml:map ?map …

Add ttl with non-ASCII chars: Accented, Cyrillic, French, etc.

• Accented: "Rudolf Mössbauer" in ./test/TRR/societyMember.ttl

Now it only supports Turtle, because it concatenates prefixes.ttl to the main file. If it can collect all prefixes from RDF files, such concatenation won't be needed

Issue #1: plantuml is slow to start up, so we'd like to process a bunch of puml files at once. The best way is to have a smarter script or Makefile that uses the following http://plantuml.com/command-line features:

• Keep the intermediate puml files (the current Makefile doesn't preserve them)
• Run plantuml on a whole folder (with -r[ecurse] it can even recurse through subfolders)
• Use -checkmetadata to skip png files that don't need to be regenerated. (The whole puml text is stored in the png, so plantuml can quickly check that there are no changes)
• The Makefile should start plantuml only once, if some of the puml files is newer than its respective png file

Trine (Perl RDF) is end of life. Attean is the new generation

Write Turtle, see diagram (easy to do)

See ./ideas

• See arrows arrows-2 from https://github.com/anoff/blog/tree/master/static/assets/plantuml/diagrams:

• Arrow styles and colors (bold, dashed etc): https://mrhaki.blogspot.com/2016/12/plantuml-pleasantness-get-plantuml.html
• plantuml -pattern regexes:

dotted|dashed|plain|bold|hidden|norank|single|thickness

Local layout options are described in Help on Layout:

• "hidden" makes a constraint between two nodes, but does not draw the link (rdfpuml already implements this)
• norank ignores a link for layout purposes (same as graphviz constraint=false)
• "together" groups classes as if they were in the same package (i.e. puts them in a graphviz cluster)

Global options include (eg see this diagram):

And there are a lot more undocumented features: https://forum.plantuml.net/7095

Ability to describe custom reification situations using the Property Reification Vocabulary (PRV)

Plantuml now has MindMap and WBS (or OBS) diagrams that use a simple bulleted syntax to draw hierarchies.

It would be nice to use this to draw hierarchies of individuals, in particular taxonomies.

Here are examples of the two styles:

• Mindmap
• WBS

A new tool rdf2soml to generate Ontotext Platform SOML from RDF examples.

What's missing? Most importantly: property cardinality and virtual inverses.

PlantUML can show arrow cardinalities, and this simple and natural PlantUML code:

X "0:1" -left-> "1:m" Y : prop/\ninvProp

Is depicted as follows:

We have two options how to express this in triples:

Issue #8: discussion with Thomas Francart of Sparna

I developed this SHACL to PlantUML converter, in Java, based on TopQuadrant SHACL lib, and the result is at https://shacl-play.sparna.fr/play/draw and code at https://github.com/sparna-git/shacl-play/tree/master/shacl-diagram

I don't have a strong opinion on the example you provide, an alternative idea that comes to my mind is

:node1 :link [
  rdf:value :node2;
  puml:min 1 ;
  puml:max 2 ;
]

But this changes the structure of the example graph itself, which might not be convenient

R2RML works great for RDBMS, but how about other sources? Extend rdf2rml to generate:

• RML: extends R2RML to handle RDB, XML, JSON, CSV
• XSPARQL: extends XQuery with SPARQL construct and JSON input
• DONE tarql: handles TSV/CSV with SPARQL construct
• DONE OntoRefine: transformation of TSV/CSV and direct loading to GraphDB with SPARQL Update