How isislab-unisa/kgheartbeat works
KGHeartBeat periodically measures knowledge-graph quality from registered datasets or a supplied SPARQL endpoint, computes dimension and overall scores, and emits CSV results. Its web app lets users search/select graphs and inspect scores, rankings, and quality histories; an Express API serves stored analyses from MongoDB. The README documents broad quality coverage and FAIRness evaluation. Several metric pages and API routes are unsampled, so those are represented as capability groups without speculative internal call chains.
Main entry points: manager.py Analysis runner · App.js Web application · Aggregator.py Metadata aggregator · db.js Analysis queries
Components 21
Analysis engine
- Analysis runner
src/manager.py - Quality metrics
src/QualityDimensions - Scoring
src/score.py - CSV results
src/OutputCSV.py - SPARQL queries
src/query.py
KG discovery
- Metadata aggregator
src/API/Aggregator.py - Metadata sources
src/API - KG network
src/Graph.py
Web experience
- Web application
WebApp/front-end/kg-heartbeat/src/App.js - KG search
WebApp/front-end/kg-heartbeat/src/pages/Search.js - Search results
WebApp/front-end/kg-heartbeat/src/components/SearchResults.js - Quality views
WebApp/front-end/kg-heartbeat/src/pages - Score view
WebApp/front-end/kg-heartbeat/src/pages/Score.js - Rankings
WebApp/front-end/kg-heartbeat/src/pages/Ranking.js - Analysis upload
WebApp/front-end/kg-heartbeat/src/pages/UploadAnalysis.js
Web API and storage
- HTTP server
WebApp/back-end/server.js - Analysis routes
WebApp/back-end/routes - Analysis queries
WebApp/back-end/db.js - MongoDB
Other components
- Operator
- Knowledge graph endpoint
Connections 21
- Operator → Analysis runner: runs analysis
- Analysis runner → Metadata aggregator: resolves metadata
src/manager.py - Metadata aggregator → Metadata sources: queries sources
src/API/Aggregator.py - KG network → Metadata aggregator: uses metadata
src/Graph.py - KG network → Metadata sources: queries registry
src/Graph.py - Analysis runner → Knowledge graph endpoint: accepts endpoint
- SPARQL queries → Knowledge graph endpoint: sends queries
src/query.py - Analysis runner → Quality metrics: runs measurements
- Analysis runner → Scoring: computes scores
src/manager.py - Analysis runner → CSV results: writes results
src/manager.py - Operator → Web application: views results
- Web application → KG search: routes to
WebApp/front-end/kg-heartbeat/src/App.js - Web application → Quality views: routes to
WebApp/front-end/kg-heartbeat/src/App.js - Web application → Score view: routes to
WebApp/front-end/kg-heartbeat/src/App.js - Web application → Rankings: routes to
WebApp/front-end/kg-heartbeat/src/App.js - Web application → Analysis upload: routes to
WebApp/front-end/kg-heartbeat/src/App.js - KG search → Search results: renders results
WebApp/front-end/kg-heartbeat/src/pages/Search.js - HTTP server → Analysis routes: mounts routes
WebApp/back-end/server.js - Analysis routes → Analysis queries: queries analyses
WebApp/back-end/routes/contextual.js - HTTP server → Analysis queries: connects database
WebApp/back-end/server.js - Analysis queries → MongoDB: reads analyses
WebApp/back-end/db.js