glam/schemas/20251121/rdf

Heritage Custodian Ontology - RDF Exports

Version: 0.1.0
Generated: 2025-11-21 (20:26)
Source: ../linkml/01_custodian_name_modular.yaml

This directory contains RDF/OWL exports of the Heritage Custodian Observation and Reconstruction Pattern ontology in 8 serialization formats.

---

Current Schema (Production)

Custodian Observation & Reconstruction Pattern

The schema implements a three-layer pattern inspired by PiCo (Persons in Context):

1. CustodianObservation: Source-based references (emic/etic perspectives as recorded in documents)
2. CustodianName: Standardized emic names (accepted by institution in daily operations)
3. CustodianReconstruction: Formal legal entities (derived from multiple observations)

Key Features:

• Hyper-modular LinkML schema (78 files: 12 classes + 5 enums + 59 slots)
• Direct module imports (no aggregators)
• Integrates 7 base ontologies (CPOV, TOOI, Schema.org, CIDOC-CRM, RiC-O, PROV-O, PiCo)
• Supports ISO 20275 legal form codes

Available Formats (8 total):

Format	File	Size	Use Case
Turtle	01_custodian_name.owl.ttl	77KB	Human-readable, Git-friendly
N-Triples	01_custodian_name.nt	233KB	Streaming, line-oriented processing
JSON-LD	01_custodian_name.jsonld	191KB	Web APIs, JavaScript
RDF/XML	01_custodian_name.rdf	165KB	Legacy Java tools
Notation3	01_custodian_name.n3	77KB	Logic rules, reasoning
TriG	01_custodian_name.trig	103KB	Named graphs
TriX	01_custodian_name.trix	348KB	XML named graphs
N-Quads	01_custodian_name.nq	288KB	Quad stores

Total Size: ~1.4MB

---

Archived Schemas (Obsolete)

Previous iterations archived to ../archive/rdf_obsolete/:

Schema 01_name_entity (Archived)

• Generated: 2025-11-21 (09:34-12:22)
• Status: ❌ Obsolete - early experiment
• Files: 7 formats

Schema 02_organization_observation_reconstruction (Archived)

• Generated: 2025-11-21 (15:27-15:28)
• Status: ❌ Obsolete - mid-iteration
• Files: 8 formats

⚠️ Do not use archived schemas - they are from obsolete versions

Format Descriptions

Format	Extension	Description	Use Case
Turtle	.ttl	Human-readable RDF syntax	Manual editing, documentation
OWL Turtle	.owl.ttl	OWL ontology in Turtle format	Ontology tools (Protégé, etc.)
RDF/XML	.rdf	XML serialization of RDF	Legacy tools, Java applications
N-Triples	.nt	Line-based triple format	Streaming, large-scale processing
N3	.n3	Notation3 (superset of Turtle)	Rules, logic programming
JSON-LD	.jsonld	JSON with linked data context	Web APIs, JavaScript applications
TriG	.trig	Named graphs extension of Turtle	Multi-graph databases, versioning

Ontology Alignment

The Heritage Custodian ontology integrates with multiple base ontologies:

Schema 1 (Name Entity)

• SKOS (skos:Concept): Names as concepts in knowledge organization systems
• CIDOC-CRM (crm:E41_Appellation): Names as appellations
• Wikidata (wd:Q82799): Nominal reference pattern
• Dublin Core (dct:*): Metadata properties

Schema 2 (Organization)

• PROV-O (prov:Entity, prov:Activity, prov:Agent): Provenance tracking
• PiCo (Persons in Context): Observation/reconstruction pattern
• CPOV (EU Core Public Organisation Vocabulary): Legal entities
• W3C ORG (org:Organization): Organizational structures
• Schema.org (schema:Organization): Web semantics
• FOAF (foaf:Agent, foaf:name): Agent descriptions
• RiC-O (Records in Contexts): Archival relationships

Generation Method

Files generated using LinkML toolchain:

1. LinkML YAML schemas → OWL Turtle (gen-owl tool)
2. OWL Turtle → Multiple RDF formats (rdflib Python library)

Generation date: 2025-11-21

Usage Examples

Load in Python (rdflib)

from rdflib import Graph

# Load Turtle format
g = Graph()
g.parse("01_name_entity.ttl", format="turtle")

print(f"Loaded {len(g)} triples")

# Query with SPARQL
query = """
PREFIX skos: <http://www.w3.org/2004/02/skos/core#>
SELECT ?name ?prefLabel
WHERE {
    ?name a skos:Concept ;
          skos:prefLabel ?prefLabel .
}
LIMIT 10
"""
for row in g.query(query):
    print(row)

Load in SPARQL Endpoint

# Using Apache Jena Fuseki
tdbloader --loc=/path/to/tdb 01_name_entity.nt 02_organization_observation_reconstruction.nt

Import in Protégé

1. Open Protégé
2. File → Open → Select .owl.ttl file
3. Ontology will be loaded with full class hierarchy and properties

Use in JavaScript

// Using JSON-LD format
const context = await fetch('01_name_entity.jsonld');
const data = await context.json();

// Process with JSON-LD library
const jsonld = require('jsonld');
const expanded = await jsonld.expand(data);

References

• LinkML Documentation: https://linkml.io/
• RDF Primer: https://www.w3.org/TR/rdf11-primer/
• OWL 2 Primer: https://www.w3.org/TR/owl2-primer/
• SKOS Reference: https://www.w3.org/TR/skos-reference/
• PROV-O: https://www.w3.org/TR/prov-o/
• PiCo (Persons in Context): https://personsincontext.org/

License

CC0 1.0 Universal (Public Domain Dedication)

See /LICENSE for details.