ml-generative-energy-design

ML-assisted generative design for energy-efficient buildings

https://github.com/rossedward-arch/ml-generative-energy-design

Science Score: 44.0%

This score indicates how likely this project is to be science-related based on various indicators:

  • CITATION.cff file
    Found CITATION.cff file
  • codemeta.json file
    Found codemeta.json file
  • .zenodo.json file
    Found .zenodo.json file
  • DOI references
  • Academic publication links
  • Academic email domains
  • Institutional organization owner
  • JOSS paper metadata
  • Scientific vocabulary similarity
    Low similarity (10.7%) to scientific vocabulary
Last synced: 7 months ago · JSON representation ·

Repository

ML-assisted generative design for energy-efficient buildings

Basic Info
  • Host: GitHub
  • Owner: rossedward-arch
  • License: mit
  • Language: Jupyter Notebook
  • Default Branch: main
  • Size: 516 KB
Statistics
  • Stars: 1
  • Watchers: 0
  • Forks: 0
  • Open Issues: 0
  • Releases: 0
Created 10 months ago · Last pushed 8 months ago
Metadata Files
Readme License Citation

README.md

ML for Sustainable Architecture: A Research Portfolio

⚙️ Integrated ML & Generative Design for Climate-Adapted Energy-Efficient Buildings

  • A research-driven project integrating reinforcement learning, explainable AI, generative design, and energy performance simulation to support early-stage architectural decision-making for climate-adapted, Passivhaus, and net-zero buildings.--

🚧 Project Status

This project is under active development as part of a personal research portfolio, showcasing my continuous learning and practical application of Machine Learning for a potential PhD application at institutions like Edinburgh University..

🎯 Goals

  • To automate early-stage building layout generation using generative design and reinforcement learning optimization
  • To integrate site conditions (EPW weather, solar orientation, etc.) and climate adaptation data.
  • To optimise designs based on energy use intensity (EUI), thermal comfort, and resilience metrics.
  • To evelop explainable AI models to provide transparent, interpretable energy performance predictions.
  • To provide a decision-support tool for architects and designers with feedback-driven iterative design.

🛠️ Technologies & Tools

  • Python (Pandas, Scikit-learn, TensorFlow, stable-baselines3 for reinforcement learning, SHAP/LIME for explainability)
  • Grasshopper + Ladybug Tools
  • Revit (geometry extraction + BIM data)
  • Streamlit (interactive design interface)
  • EnergyPlus / OpenStudio (performance simulation)
  • Git for version control

🔬 Research Themes

This work is informed by research in: - Reinforcement learning for adaptive generative design optimization - Explainable AI techniques for model transparency and decision support - Generative design for architecture and layout planning - Machine learning models for energy prediction - Early-stage performance-based design - Passivhaus and zero-energy building standards

📖 See docs/literature_review.md for citations and background readings.


📚 Learning Roadmap & Skills

This project is also part of a structured self-learning journey to prepare for PhD-level research. Key learning milestones:

| Stage | Topic | Tools / Books | Outcome | |-------|----------------------------|--------------------------|---------| | 1 | Python Fundamentals | Python Fundamentals | Basic scripting and data types | | 2 | Data Analysis | Python for Data Analysis | Manipulate EPW, CSV data | | 3 | Data Visualisation | Matplotlib / Seaborn | Visualise temp, loads, EUI | | 4 | Machine Learning (Scikit) | Hands-On ML by Géron | Train energy prediction models | | 5 | Generative Design | DEAP, Grasshopper | Optimise layouts with GA | | 6 | Simulation Integration | Ladybug, OpenStudio | Link ML to real energy engines | | 7 | UI / App Interface | Streamlit / Dash | Design explorer prototype |

📁 See project notebooks and docs/dev_log.md for progress.


📁 Repo Structure

```text ml-generative-energy-design/ │ ├── data/ ← Raw & processed datasets (CSV, JSON, EPW) ├── notebooks/ ← Jupyter Notebooks for ML and analysis ├── src/ ← Core Python modules ├── results/ ← Model outputs, charts, and metrics ├── tools/ ← Scripts for Grasshopper/Ladybug/Revit ├── docs/ ← Research logs, literature review, dev notes ├── learning_roadmap/ ← Books, projects, tutorials, learning logs ├── app/ ← Optional UI with Streamlit or Dash │ ├── .gitignore ├── environment.yml ← Conda environment ├── LICENSE ├── README.md ├── CITATION.cff

```

📚 References

See docs/literature_review.md for citations and background readings.

👤 Author

Ross Edward — MSc in Architectural Technology and Energy Performance, Edinburgh Napier University

🧪 Citation

Please cite this repo using the CITATION.cff file if used in publications.

Owner

  • Name: Ross Edward
  • Login: rossedward-arch
  • Kind: user
  • Location: Edinburgh

Citation (CITATION.cff)

cff-version: 1.2.0
message: "If you use this repository, please cite it as below."
title: "ML-Driven Generative Design for Energy-Efficient Architecture"
authors:
  - family-names: Edward
    given-names: Ross
    orcid: "https://orcid.org/0009-0007-6509-5943"
date-released: 2025-06-19
version: 0.1.0
repository-code: "https://github.com/rossedward-arch/ml-generative-energy-design"
license: MIT
keywords:
  - machine learning
  - generative design
  - energy performance
  - architecture
  - simulation
  - early-stage design
abstract: >
  This project explores how machine learning and generative algorithms can support architects in 
  designing energy-efficient buildings during early design stages. It integrates site constraints, 
  user requirements, and energy simulation feedback to iteratively propose optimized spatial layouts.

GitHub Events

Total
  • Watch event: 1
  • Push event: 137
  • Create event: 1
Last Year
  • Watch event: 1
  • Push event: 137
  • Create event: 1

Dependencies

app/requirements.txt pypi
environment.yml pypi
  • ladybug-core *