Quick Summary
IEQ-BERT classifies building occupant feedback concerning indoor environmental quality.
Model Details
Model Description
The IEQ-BERT model is a fine-tuned variant of the BERT (Bidirectional Encoder Representations from Transformers) architecture, adapted for the task of multilabel text classification in the context of Indoor Environmental Quality (IEQ). IEQ refers to the physical characteristics of indoor spaces, such as thermal comfort, acoustic comfort, visual comfort, and indoor air quality (IAQ), which directly impact occupant well-being, productivity, and satisfaction. The IEQ-BERT model is designed to analyze and classify occupant feedback into one or more of the following categories: "Acoustic," "IAQ," "Thermal," "Visual," and "No IEQ." The "No IEQ" category is reserved for feedback that uses language resembling the IEQ domain but does not pertain to indoor environmental quality, ensuring the model can distinguish between relevant and irrelevant content.
- Developed by: Researchers at Deakin Unievrsity (Australia) and Northwestern University (US)
- Funded by: Deakin University, School of Architecture and Built Environment
- Model type: Multilable Text Classification
- Language: English
- Finetuned from model: bert-base-uncased
Model Sources
- Repository: This model repository
- Paper: Sadick, A.-M., & Chinazzo, G. (2025). What did the occupant say? Fine-tuning and evaluating a language model for efficient analysis of multi-domain indoor environmental quality feedback. Building and Environment, 112735. https://doi.org/10.1016/j.buildenv.2025.112735
- Demo: https://ieq-ieq-text-classifier-app.hf.space
Uses
Direct Use
This model has a wide range of potential use cases, including:
- Building Design and Architecture: Analyzing feedback to identify recurring issues related to thermal comfort, lighting, or acoustics, which can inform design improvements to enhance occupant satisfaction.
- Building Management and Facility Planning: Monitoring feedback in real-time to address specific IEQ concerns, such as HVAC performance or lighting issues, and prioritize interventions.
- Post-Occupancy Evaluation (POE): Classifying open-ended feedback from occupant surveys to assess the effectiveness of building designs and operational strategies.
- Integration into Building Automation Systems: Processing occupant feedback alongside sensor data to provide actionable insights for optimizing indoor environments.
Out-of-Scope Use
Please use this model for the intended purposes stated above.
How to Get Started with the Model
Use the code below to get started with the model.
from transformers import AutoTokenizer, AutoModelForSequenceClassification
tokenizer = AutoTokenizer.from_pretrained("ieq/IEQ-BERT")
model = AutoModelForSequenceClassification.from_pretrained("ieq/IEQ-BERT")
Training Details
Training Data
The training data consists of 14,622 filtered texts from Glassdoor job reviews and X posts about work environments during the COVID-19 pandemic. Five labellers manually labeled each feedback item using Labelbox to ensure accuracy, and they further checked for consistency using Cleanlab Studio.
Evaluation
Metrics
- Accuracy: 0.93
- F1: 0.93
Citation
If you use this model, please cite the journal article below:
APA: Sadick, A.-M., & Chinazzo, G. (2025). What did the occupant say? Fine-tuning and evaluating a large language model for efficient analysis of multi-domain indoor environmental quality feedback. Building and Environment, 112735. https://doi.org/10.1016/j.buildenv.2025.112735
Model Card Contact
Dr Abdul-Manan Sadick - [email protected]
Dr Giorgia Chinazzo - [email protected]
- Downloads last month
- 10