Making True RDF Diagrams with rdfpuml

cona:456-thing crm:P12i_was_present_at cona:456-discovery-123.
cona:456-discovery-123 a crmx:Discovery;
  crm:P2_has_type <cona/production/discovery>;
  crm:P4_has_time-span cona:456-discovery-123-date.
cona:456-discovery-123-date a crm:E52_Time-Span;
  crm:P82a_begin_of_the_begin "1800"^^xsd:gYear;
  crm:P82b_end_of_the_end "1850"^^xsd:gYear.
########################################
<cona/production/discovery> a puml:Inline.

Namespace puml: are diagram control triples, explained further

Takes care of many hairy details, eg node name sanitization, property name & value collection, inlining, Association nodes, replacing () with [] (puml quirk), etc

@startuml
hide empty methods
hide empty attributes
hide circle
skinparam classAttributeIconSize 0
class cona_456_discovery_123 as "cona:456-discovery-123"
cona_456_discovery_123 : a crmx:Discovery
class cona_456_discovery_123_date as "cona:456-discovery-123-date"
cona_456_discovery_123 --> cona_456_discovery_123_date : crm:P4_has_time-span
cona_456_discovery_123 : crm:P2_has_type cona:production/discovery
cona_456_discovery_123_date : a crm:E52_Time-Span
cona_456_discovery_123_date : crm:P82a_begin_of_the_begin "1800"^^xsd:gYear
cona_456_discovery_123_date : crm:P82b_end_of_the_end "1850"^^xsd:gYear
class cona_456_thing as "cona:456-thing"
cona_456_thing --> cona_456_discovery_123 : crm:P12i_was_present_at
@enduml

Show object inlined in the subject node, not as separate node

• Types and literals are inlined automatically

• Inline resource: used often for lookup values

  <cona/event/competition> a puml:Inline.
    # Show URL in the subject node.
  cona_contrib:10000000 a puml:Inline; rdfs:label "VP".
    # Show the URL, and add a comment "# VP"
  
  

• Inline property: show all objects of a property inlined

  fn:annotationSetFrame a puml:InlineProperty. 
    # Show all objects (values) of fn:annotationSetFrame inline
  
  

• Multiple objects are collected and shown separated with commas

• rdfs:label of puml:Inline is used as comment after the value

  cona_source:2000015171 a puml:Inline; rdfs:label "Fletcher, History of Architecture [1975]".
  cona_source:2000052135 a puml:Inline; rdfs:label "Great Buildings Online [1997-]".
  

• puml:label adds a comment on non-Inlined node

  ia:1000042 a skos:Concept;
    puml:label "Hercules";
    dct:type <ia/type/Religion_Mythology_Legend>;
    ...
  ia:129 puml:label "Story of Hercules".
  tgn:7010720 puml:label "Argos".
  tgn:7029383 puml:label "Thebes".
  

• Multiple property instances between nodes are collected in one arrow and shown as several labels
• Inverse arrows work fine

Customize arrows using predicate of the form puml:$dir-$head-$line

• $dir: left, right, up, down (default)
• $head: none="", tri="|>", star="*", o="o" (default is normal arrow)
  • See PlantUML Object diagrams. Unfortunately PlantUML doesn't have bidirectional arrows
• $line: dashed (default is solid)
• (each part is optional)

Set arrow for all property instances:

nif:oliaLink puml:arrow puml:up.

Set arrow between two specific nodes:

cona:456-production puml:left cona:456-motivation-123.

Stereotype is UML lingo for those funny «guillemetted names» and colored circles (either is optional)

iso:ThesaurusArray puml:stereotype "(A,red)".
gvp:GuideTerm      puml:stereotype "(G,green)".
gvp:Concept        puml:stereotype "(C,lightblue)".

You can also use this on an individual node instead of a whole class.

• A statement <s> <p> <o> is also represented as a node with 3 addressing properties, and extra data is added

<node> a <ReificationClass>;
  <subjectProp>  <s>;
  <shortcutProp> <p>;
  <objectProp>   <o>;
  # extra data, eg dct:created, dct:creator

• RDF Reification is used most often (first row below)
• CIDOC CRM also has it (with extension crmx:property aka bmo:PX_property)
• Property Reification Vocabulary allows us to express this data formally:

• Automatically discover reifications as per the previous table and make PlantUML Association Class
• Show addressing properties with arrows (← : →) pointing to the subject, shortcut, object
• Limit: no more than 2 reifications per relation (and the second one is ugly). So use puml:noReify to avoid making reification

Aggressive URL shortening, collecting multiple values, value comments

Simple record about a person, including info about related people

Reconstructing the social network of a person, representing in CIDOC CRM and AgRelOn

Made with PlantUML "by hand", not rdfpuml. Uses PlantUML Packages

• Portland Common Data Model for metadata in institutional repositories (Fedora, Islandora, etc)
• Reference Diagrams for Comment lists a bunch of metadata layouts for different kinds of Works/Files
• These are made by hand, which takes a lot of time. Eg see diagram for a Postcard (simple kind of Work)
• Proposed making diagrams with rdfpuml (interest tracked as duraspace/pcdm#46):

Ontotext published as RDF the ICIJ Offshore Leaks database according to this model:

The model will be evolving as we unravel more of the data