How tudelft-cda-lab/catma works
CATMA compares a static DFD model with dynamic state-machine models inferred from runtime logs. Its CLI loads configuration and models, detects static and dynamic non-conformances, generates per-finding interpretations, and produces an architecture visualization plus HTML interpretation pages. The graph follows the documented workflow and shown calls; the supplied excerpts do not expose every interpretation-generation detail, so those internal links are limited to evidenced relationships.
Main entry points: CATMA.py CATMA CLI · non_conformance_visualizer.py Architecture visualizer · utils.py Model utilities · model_processor.py Model processor
Components 15
Inputs and orchestration
- CATMA CLI
CATMA.py - Run configuration
config/config.json - Interpretation text
interpretation_texts/interpretation_texts.json - Static DFD
- Dynamic models
Model analysis
- Model processor
src/model_processor.py - Model utilities
src/utils.py - Non-conformance detector
src/non_conformance_detector.py
Interpretation
- Interpretation generator
src/interpretation_generator.py
Outputs
- Architecture visualizer
src/non_conformance_visualizer.py - HTML visualizer
src/interpretation_visualizer.py - Architecture diagram
- Interpretation pages
Other components
- Analyst
- PlantUML server
Connections 16
- Analyst → CATMA CLI: runs
README.md - Static DFD → CATMA CLI: provides model
README.md - Dynamic models → CATMA CLI: provides models
README.md - Run configuration → CATMA CLI: configures
CATMA.py - Interpretation text → CATMA CLI: provides text
CATMA.py - CATMA CLI → Model processor: reads models
CATMA.py - Model processor → Model utilities: loads and cleans
src/model_processor.py - CATMA CLI → Non-conformance detector: detects discrepancies
CATMA.py - Non-conformance detector → Model utilities: extracts links
src/non_conformance_detector.py - CATMA CLI → Interpretation generator: generates interpretations
CATMA.py - Interpretation generator → Model utilities: processes models
src/interpretation_generator.py - CATMA CLI → Architecture visualizer: visualizes findings
CATMA.py - Architecture visualizer → Architecture diagram: writes diagram
src/non_conformance_visualizer.py - Architecture visualizer → PlantUML server: renders diagram
src/non_conformance_visualizer.py - CATMA CLI → HTML visualizer: renders interpretations
CATMA.py - HTML visualizer → Interpretation pages: writes HTML
src/interpretation_visualizer.py