How jorge-martinez-gil/root-cause-analysis works
This is an explainable transformer fault-diagnosis product: users provide measurements or use the sample fleet, then receive diagnoses with standards-based evidence and optional RDF/PROV-O output. The main route runs through the CLI and reasoning engine; separate branches support SPARQL screening and a compatibility classifier. The README documents these capabilities, while edges are limited to relationships shown in the sampled source or documented workflow.
Main entry points: reasoning.py Diagnosis engine · cli.py Command-line interface · querying.py SPARQL screening · ontology.py Transformer ontology
Components 15
User entry
- Command-line interface
src/root_cause_analysis/cli.py - Sample measurements
src/root_cause_analysis/datasets.py - Compatibility classifier
src/root_cause_analysis/classification.py
Diagnosis
- Diagnosis engine
src/root_cause_analysis/reasoning.py - IEC and advisory rules
src/root_cause_analysis/rules.py - Diagnosis and trace
src/root_cause_analysis/reasoning.py - Markdown report
src/root_cause_analysis/reasoning.py
Knowledge graph
- Transformer ontology
src/root_cause_analysis/ontology.py - Ontology serializations
data/ontology - RDF knowledge graph
src/root_cause_analysis/ontology.py - PROV-O provenance
src/root_cause_analysis/reasoning.py
Screening
- SPARQL screening
src/root_cause_analysis/querying.py - Flagged assets
src/root_cause_analysis/querying.py
Other components
- Operator
- Measurement CSV
Connections 17
- Operator → Command-line interface: runs diagnosis
README.md - Measurement CSV → Command-line interface: supplies CSV
README.md - Command-line interface → Sample measurements: loads defaults
src/root_cause_analysis/cli.py - Command-line interface → Diagnosis engine: runs pipeline
src/root_cause_analysis/cli.py - Diagnosis engine → IEC and advisory rules: evaluates rules
src/root_cause_analysis/reasoning.py - Diagnosis engine → Diagnosis and trace: produces
src/root_cause_analysis/reasoning.py - Diagnosis engine → Transformer ontology: materializes graph
src/root_cause_analysis/reasoning.py - Diagnosis engine → PROV-O provenance: records evidence
src/root_cause_analysis/reasoning.py - Diagnosis engine → Markdown report: formats results
src/root_cause_analysis/reasoning.py - Command-line interface → Compatibility classifier: runs compatibility path
src/root_cause_analysis/cli.py - Transformer ontology → RDF knowledge graph: builds graph
src/root_cause_analysis/ontology.py - Transformer ontology → Ontology serializations: serializes schema
README.md - Operator → SPARQL screening: requests screening
README.md - Command-line interface → SPARQL screening: screens assets
src/root_cause_analysis/cli.py - SPARQL screening → Transformer ontology: builds graph from measurements
src/root_cause_analysis/querying.py - SPARQL screening → RDF knowledge graph: queries graph
src/root_cause_analysis/querying.py - SPARQL screening → Flagged assets: returns matches
src/root_cause_analysis/querying.py