methodatlas
Run SheetKnowledge ModelingOntology / Knowledge Graph Modeling

NeOn Methodology

KomplexitätHigh
ZeitMehrere Wochen bis Monate
Teilnehmende2-10
FormatBoth
MaturityEstablished
01

Vorbedingung

Was vorher fertig sein muss

Vorher abschließenCompetency Questions

Ein erstes Competency-Question-Set mit must-have-Fragen und priorisierten Use Cases liegt vor, an dem sich Szenario-Auswahl und Akzeptanztests orientieren.

Ohne: Ohne Fragenset wählt das Team Szenarien spekulativ, der Reuse-Plan trifft an den Use Cases vorbei.
Vorher abschließenStakeholder Mapping

Eine Übersicht über Domain Experts, Konsumenten, Owner bestehender Vokabulare und Maintainer ist erstellt, damit Reviews und Reuse-Verhandlungen planbar sind.

Ohne: Ohne diese Übersicht versanden Reuse-Versuche, Reviews werden zu spät terminiert, das Projekt verliert Tempo.
02

Vorbereitung

Was vor Start vorliegen muss

Materialien

Projektplan-Template; NeOn-Szenarien-Übersicht (1-9) als Card-Deck oder Liste; Reuse-Recherche-Tabelle; Ontology-Editor (Protégé, TopBraid, VocBench); Versionskontrolle (Git mit RDF-Diff); Issue-Tracker.

Personen / Rollen

Ein Ontology Engineer (lead); ein bis drei Domain Experts; ein bis zwei Reuse-Scouts (recherchieren existierende Vokabulare); ein Evaluator (prüft gegen Competency Questions); ein Maintenance-Owner für die Post-Launch-Phase.

Vorabinfos

Competency Questions; Stakeholder-Map; bekannte Standard-Vokabulare im Domänenkontext; Lizenz- und Governance-Regeln; Toolchain-Entscheidung; geplanter Lifecycle (waterfall vs. iterativ).

Zeitbedarf

Mehrere Wochen bis Monate, in Iterationen

Setup

Repository mit Struktur (sources/, modules/, tests/, docs/) anlegen. Szenarien-Auswahl als Entscheidungsdokument vorbereiten. Iterations-Cadence festlegen (z. B. 2-Wochen-Iteration mit Review am Ende).

03

Kernfrage

Die eine Frage, die diese Methode beantwortet

Welche der neun NeOn-Szenarien sind für dieses Ontology-Projekt relevant, und welche Aktivitäten, Reuse-Quellen und Reviews ergeben sich daraus?

04

Ablauf

Marker: Phase

SchrittDauerAktionHinweis
1Phase 1: Szenario-Auswahl
1 TagAlle neun Szenarien durchgehen (z. B. Reuse Ontological Resources, Reengineering Non-Ontological Resources, Merge, Restructure, Localize). Pro Szenario: relevant oder nicht, mit Begründung. Auswahl dokumentieren.Wenn alle neun als relevant markiert werden, ist Scope zu groß oder Auswahl nicht ehrlich. Maximal 3-4 Szenarien als Hauptachsen, andere als Folgekandidaten parken.
2Phase 2: Ontology Requirements Specification (ORSD)
3-5 TagePurpose, Scope, Functional Requirements (Competency Questions), Non-Functional Requirements (Performance, Lizenz, Sprache), bestehende Ressourcen und Pre-Glossary in einem ORSD-Dokument bündeln.ORSD ist das vertragsähnliche Dokument zwischen Auftraggebern und Modellierern. Wenn es schwammig bleibt, kommt Streit später bei der Abnahme.
3Phase 3: Reuse-Recherche und Selection
3-7 TageBestehende Ontologien, Vokabulare und Patterns identifizieren (z. B. via LOV, BioPortal, FAIRsharing). Pro Kandidat bewerten: Coverage, Qualität, Maintenance, Lizenz. Auswahl und Begründung dokumentieren.Reuse zu früh festlegen verzerrt das Modell auf eine fremde Ontologie. Reuse zu spät erzeugt Eigenkonstruktionen, die später Übersetzungs-Mappings brauchen.
4Phase 4: Modellierungs-Iterationen
Mehrere Iterationen à 1-2 WochenPro Iteration: Klassen, Properties, Constraints modellieren (oft mit Ontology Design Patterns); gegen Competency Questions testen; Review mit Domain Experts; Versionierung im Repo.Ohne Tests gegen Competency Questions wird das Modell akademisch. Mindestens 50% der Top-CQs müssen pro Iteration durch Test-Queries beantwortbar sein.
5Phase 5: Evaluation, Documentation, Publication
1-2 WochenVollständige Coverage-Prüfung gegen ORSD und CQs. Domain-Expert-Review. Dokumentation automatisiert generieren (z. B. WIDOCO, pyLODE). Veröffentlichung mit Persistent IRI, Lizenz, Changelog.Wenn 100% Coverage erzwungen wird, kippen Iterationen in Overengineering. 80-90% Coverage mit dokumentierten Lücken ist solider als geschönte 100%.
6Phase 6: Maintenance-Plan
1 TagOwner, Update-Cadence, Deprecation-Policy, Change-Request-Prozess, Versionsschema (SemVer für Ontologien) festlegen. Plan dokumentieren und Owner verbindlich benennen.Ohne Maintenance-Owner stirbt die Ontology innerhalb von Monaten. Wenn niemand den Owner-Hut aufsetzt, ist das ein Killkriterium.
05

Artefakt

Was am Ende rauskommt

Form

Repository mit ORSD, Szenario-Entscheidungsdokument, Reuse-Selection-Report, modularen Ontology-Files (TTL/OWL), CQ-Test-Suite, automatisch generierter Doku, Evaluation-Report und Maintenance-Plan.

Tool-Alternativen
  • Git mit RDF-Diff (z. B. mit rdflib-Skripten) als Repo
  • Protégé oder TopBraid Composer für Modellierung
  • VocBench für kollaborative Pflege
  • WIDOCO oder pyLODE für Doku-Generierung
Versionierung / Ownership

SemVer für Ontology-Releases (Major bei Breaking Changes, Minor bei Erweiterungen). Changelog pro Release. Deprecated Klassen mit owl:deprecated markiert, nicht gelöscht. ORSD wächst mit, alte Versionen archiviert.

markdown

NeOn Methodology Arbeitsvorlage

Kompakte Arbeitsvorlage für NeOn Methodology mit Kontext, Input, Ergebnisartefakten und nächstem Schritt.

# NeOn Methodology Arbeitsvorlage

## Ziel

Szenario-basiertes Vorgehen für modulare Ontology-Entwicklung mit gezieltem Reuse.

## Kontext

Wann und wofür nutzen wir diese Methode?

## Input

Welche Daten, Beobachtungen, Entscheidungen oder Materialien liegen vor?

## Durchführung

Kurze Notizen entlang des Run Sheets.

## Ergebnisartefakte
- Ontology Requirements Specification:
- Reuse Plan:
- Ontology Modules:
- Evaluation Report:

## Annahmen und offene Fragen

- ...

## Entscheidung / Nächster Schritt

Owner, Datum und Erfolgssignal.
06

Beispielausgabe

Konkret gefülltes Szenario

neon-methodology-beispiel.md
markdown
## NeOn-Projekt — Knowledge Graph „Klinische Pfade“ (Phase 2 abgeschlossen, 18.05.2026)

**Ausgewählte Szenarien**: Szenario 1 (Reuse Ontological Resources), Szenario 3 (Reengineering Non-Ontological Resources — bestehender SNOMED-Auszug), Szenario 5 (Restructure), Szenario 7 (Localize DE/EN).

**ORSD-Auszug**:
- Purpose: Suche und Reasoning über klinische Pfade in Onkologie.
- Scope: Diagnosen, Therapien, Leitlinien, Patient-Kohorten (ohne Pharmakokinetik in v1).
- Lizenz: CC-BY-SA 4.0.
- CQs: 38 must-have.

**Reuse-Auswahl**: SNOMED CT (Subset Onkologie), HL7 FHIR R5 Konzepte, NCIt für Tumortypen, BFO als Top-Level. SNOMED-Lizenz geklärt mit IHTSDO.

**Iteration 3 Coverage**: 28 von 38 must-have-CQs beantwortbar. Lücken: Therapie-Sequenz (CQ 22-24), Owner @lisa, Sprint 4.

**Maintenance**: Owner @marcus (Ontology Engineer), Quartals-Release, Change-Request via Issue mit Label `cr`. Deprecation-Frist 12 Monate.
07

Stolperfallen

Symptome erkennen, gegensteuern

Falle

Alle Szenarien als relevant markiert

Symptom

Szenario-Liste hat 9 Häkchen, niemand kann sagen, welches Szenario Priorität hat.

Was tun

Strikt 3-4 Hauptszenarien wählen. Andere parken oder begründet streichen. Wer alle Szenarien füllen will, baut ein Lehrbuch statt ein Projekt.

Falle

ORSD bleibt schwammig

Symptom

Scope und Non-Functional Requirements stehen als Allgemeinplätze, Abnahme später strittig.

Was tun

ORSD mit Auftraggeber wie einen Vertrag durchgehen. Jeder Punkt muss konkret messbar oder klar abgrenzbar sein. Unklare Punkte als offene Frage markieren.

Falle

Reuse-Recherche zu kurz

Symptom

Modell wird von Null gebaut, später entdeckt jemand etabliertes Vokabular, das alles abgedeckt hätte.

Was tun

Mindestens 2 Tage Reuse-Recherche pflichtig vor Modellierungsstart. LOV, BioPortal, branchenspezifische Register systematisch durchgehen. Negativ-Befund auch dokumentieren.

Falle

Tests gegen CQs fehlen

Symptom

Modell wächst, niemand prüft, ob CQs damit beantwortbar sind. Coverage-Report fehlt.

Was tun

Pro Iteration eine CQ-Test-Suite mit SPARQL-Queries laufen lassen. Coverage-Metrik in Release-Notes. Lücken als Backlog-Items mit Sprint-Ziel.

Falle

Kein Maintenance-Owner

Symptom

Ontology wird veröffentlicht, nach 3 Monaten gibt es kein Update, Issues bleiben unbeantwortet.

Was tun

Maintenance-Plan vor Veröffentlichung mit benanntem Owner. Wenn kein Owner findbar, Veröffentlichung verschieben oder Scope verkleinern bis Maintenance leistbar.

Falle

Domain Experts nur am Anfang

Symptom

Experts werden in Phase 2 eingebunden, in Phase 4 nicht mehr, Modell drifted in Modellierersprache.

Was tun

Domain-Review als feste Aktivität pro Iteration einplanen. Mindestens 1 Stunde pro 2-Wochen-Iteration. Bei Verzicht: Iteration nicht als done markieren.

08

Abbruchkriterien

Done-Signale, in unter einer Minute prüfbar

Kein klarer Use Case mit benannten Konsumenten, NeOn-Aufwand nicht rechtfertigbar.
Bestehende Standard-Ontologie deckt den Bedarf bereits, Eigenbau wäre Duplikation.
Kein Ontology Engineer im Team, Methodologie überfordert Personen ohne Erfahrung.
Domain Experts stehen nicht über Wochen verfügbar, Reviews wären reine Modelliererdiskussion.
Maintenance-Owner für die Post-Launch-Phase ist nicht zusagbar.
Projektzeit unter 4 Wochen, Iterationen plus Evaluation nicht durchführbar.
Anforderungen ändern sich wöchentlich, ORSD wäre instabil und keine Verhandlungsbasis.

Run Sheet durchgearbeitet?

Zum Steckbrief für Zweck, ähnliche Methoden und Quellen — oder direkt zur nächsten Methode im Katalog.