Skip to content

README.md

Latest commit

 

History

History
66 lines (49 loc) · 4.21 KB

README.md

File metadata and controls

66 lines (49 loc) · 4.21 KB
Raw

Logo

UniForeXT

Zenodo GitHub Release Ontology spec ULiège Lines of Code

This repository contains the code and resources of UniForeXT, a master's thesis project. The project focuses on semantic mapping of heterogeneous event/log data to a unified model. To do so, it defines an ontology (UniForeXT) and associated SHACL shapes, implements a Java-based semantic mapper to convert various input formats to triples conforming to the ontology annd provides a JavaFX-based viewer to explore the resulting knowledge graph.

Repository layout

  • ontology/: contains the ontology files used by the project
    • ontology.rdf: the main ontology (RDF/XML)
    • shapes.ttl, astrea-shapes.ttl: SHACL shapes and constraints used for validation
  • semantic-mapper/: maven Java project that performs mapping from input formats to the ontology and produces RDF output
    • README.md: module-specific instructions and details
  • ontology-viewer/: maven Java/JavaFX project that provides an interactive viewer for knowledge graphs
    • README.md: module-specific instructions and details
  • ingestion-config/: example mappers/configurations used by the semantic-mapper for different input sources
    • README.md: details on the example configurations and how to use them

Ontology

The ontology is located at ontology/ontology.rdf. Its specification generated by WIDOCO can be consulted here.

SHACL shapes

shacl play

shapes.ttl contains the SHACL shapes used for data validation. It is composed of manually built shapes and shapes automatically generated by Astrea. Its specification can be consulted by consulting this SHACL Play! specification.

Semantic mapper

The semantic mapper is a Java application that takes various input formats (CSV, JSON, XML, etc.) and maps them to RDF triples conforming to the UniForeXT ontology. It uses configuration files to define the mapping rules and can be extended to support new formats or mapping logic.

Ontology viewer

The viewer includes pages for:

  • Event explorer
  • Graph view
  • Query view
  • Timelines and undated events

Note

This project is known to work on Windows

Versioning

The project follows semantic versioning. Major changes that break backward compatibility (in terms of configuration or UI changes) will increment the major version, while minor features and bug fixes will increment the minor and patch versions respectively.

It follows this template for versioning:

vX.Y.Z

Where:

  • X is the major version (incremented for breaking changes)
  • Y is the minor version (incremented for new features)
  • Z is the patch version (incremented for bug fixes)