Ontology

/semantica:ontology

Manage ontology definitions and validation. Usage: /semantica:ontology <task> [args]

Entry points: OntologyEngine (authoring, export, alignments) and OntologyValidator (consistency checking).

concepts <scheme_uri>

List SKOS concepts in a vocabulary scheme.

from semantica.ontology import OntologyEngine
from semantica.triplet_store import TripletStore

store = TripletStore(backend="oxigraph")   # needs semantica[tripletstore-oxigraph]
engine = OntologyEngine(store=store)       # list_concepts/list_vocabularies need a
                                            # configured store — raises ProcessingError without one
concepts = engine.list_concepts(scheme_uri)
vocabs = engine.list_vocabularies()

validate <ontology>

Check an ontology for consistency and satisfiability.

from semantica.ontology import OntologyValidator

validator = OntologyValidator(check_consistency=True, check_satisfiability=True)
result = validator.validate(ontology)   # dict or path to an ontology file
# result.valid, result.errors, result.warnings

For SHACL shape validation of instance data use SHACLGenerator / SHACLValidationReport:

from semantica.ontology import SHACLGenerator

build <text|data>

Generate an ontology from unstructured text or structured records.

engine = OntologyEngine()          # LLM-assisted (needs an llm-* extra + API key)       # deterministic, from structured data

export <ontology> <path> [--format turtle]

engine.export_owl(onto, path, format="turtle")
engine.export_shacl(onto, path, format="turtle")

align <source_uri> <target_uri> <predicate>

engine.create_alignment(source_uri, target_uri, predicate)
engine.get_alignments(entity_uri)
engine.list_alignments()

evaluate <ontology>

Quality-gate an ontology (OntologyEvaluator / OntologyQualityReport under the hood).

report = engine.evaluate(onto)