esgdata / README.md
darisdzakwanhoesien's picture
Hybrid stage (7 + 8 + 10)
fb57c89 unverified
---
title: ESG Ontology-Based Sentiment Mapping
emoji: 🌱
colorFrom: green
colorTo: blue
sdk: gradio
app_file: app.py
pinned: false
---
# Advanced ESG Analysis & Interpretability Dashboard
This project provides a powerful, interactive dashboard for in-depth analysis of Environmental, Social, and Governance (ESG) reports. It goes beyond simple keyword matching by leveraging a custom ontology, advanced NLP models, and a suite of analytical tools to uncover nuanced insights, detect sentiment drift, and identify potential greenwashing.
The application is built with Gradio and integrates several advanced features, from section-aware context modeling to knowledge graph generation and bias analysis.
## Key Features
The dashboard integrates a multi-stage pipeline to deliver deep, explainable insights:
* **Ontology-Powered Aspect Mapping**: Maps text from ESG reports to a custom, hierarchical ESG ontology (`esg_ontology.owl`), ensuring that analysis is grounded in a structured, domain-specific framework.
* **Section-Aware Context Modeling**: Intelligently distinguishes between different sections of a report (e.g., "Commitments" vs. "Results") and applies contextual weights to mitigate optimism bias in forward-looking statements.
* **Cross-Document Consistency Analysis**: Compares two documents (e.g., reports from consecutive years) to automatically detect *sentiment drift* for specific ESG aspects, flagging potential inconsistencies or greenwashing.
* **Weakly Supervised Aspect Expansion**: Uses `KeyBERT` to discover emerging ESG topics and keywords from the input text that are not yet in the ontology, suggesting them for future inclusion.
* **Knowledge Graph Generation**: Exports the analysis results into a machine-readable RDF Turtle file (`esg_knowledge_graph.ttl`), representing documents, aspects, and sentiments as a semantic graph.
* **Fine-Tuning Ready**: The architecture is designed to seamlessly integrate a fine-tuned sentence transformer model for improved domain adaptation and mapping accuracy. A training script template (`train_finetune.py`) is provided.
* **Interpretability Dashboard**:
* **Sentiment Distribution**: Visualizes the breakdown of positive, negative, and neutral sentiments across documents.
* **Bias & Confidence Analysis**: A scatter plot that correlates "Optimism Bias" with "Mapping Confidence" to help users critically evaluate the sentiment associated with each aspect.
* **Ontology Viewer**: Displays the structure of the ESG ontology directly in the dashboard.
Hybrid stage (7 + 8 + 10)
* The ontology backbone (Stage 7) structures the ESG knowledge.
* The weakly supervised extraction (Stage 8) expands it dynamically.
* The dashboard layer (Stage 10) communicates interpretability metrics.
* Once you fine-tune embeddings on ESG corpora (Stage 9), your system will reach full maturity β€” improving confidence and semantic clustering precision.