nestli

Benchmarking building automation and control systems

https://github.com/hues-platform/nestli

Science Score: 36.0%

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

  • CITATION.cff file
  • codemeta.json file
    Found codemeta.json file
  • .zenodo.json file
    Found .zenodo.json file
  • DOI references
  • Academic publication links
    Links to: arxiv.org
  • Committers with academic emails
  • Institutional organization owner
  • JOSS paper metadata
  • Scientific vocabulary similarity
    Low similarity (10.6%) to scientific vocabulary

Keywords

benchmarking co-simulation digital-twin energyplus fmu hvac-control open-source
Last synced: 6 months ago · JSON representation

Repository

Benchmarking building automation and control systems

Basic Info
  • Host: GitHub
  • Owner: hues-platform
  • License: agpl-3.0
  • Language: Python
  • Default Branch: main
  • Homepage:
  • Size: 178 MB
Statistics
  • Stars: 17
  • Watchers: 1
  • Forks: 2
  • Open Issues: 0
  • Releases: 2
Topics
benchmarking co-simulation digital-twin energyplus fmu hvac-control open-source
Created about 4 years ago · Last pushed about 3 years ago
Metadata Files
Readme License Citation

README.md

nestli (Neighborhood Energy System Testing towards Large-scale Integration)

nestli is the virtual sister of the NEST demonstrator at Empa. It is a co-simulation environment for benchmarking the performance of BACS (building automation and control systems). In its core, nestli is a calibrated EnergyPlus model of the UMAR living lab. see: https://www.empa.ch/web/nest/urban-mining

Picture1

The calibrated EnergyPlus model is wrapped into an FMU (fucntional mock-up unit) using the EnergyPlusToFMU tool. see: https://simulationresearch.lbl.gov/fmu/EnergyPlus/export/

The model is calibrated on measurements that are collected at 1-minute intervals, and thus runs at the same temporal resolution. The HVAC system can be controlled by overriding the setpoint temperature in each room. It is also possible to evaluate the robustness of the controller by manipulating weather conditions and building operation.

Picture3

Installation

The installation consists of 3 Steps.

  1. install EnergyPlus
  2. install Python
  3. install the nestli package

Further installation informations are in the pdf documentation. Container-based implementation is also provided using Docker.

Usage

A simple example of how to use the package is given in the example folder. Just run the file nestliexamplerun.py where the config example_config.yml specifies all the parameters.

Citation

If you use our tool for your work, please cite the following paper:

Khayatian, F.; Cai, H.; Bojarski, A.; Heer, P.; Bollinger A.; Benchmarking HVAC controller performance with a digital twin. Applied Energy Symposium: Clean Energy towards Carbon Neutrality (CEN2022). https://www.enerarxiv.org/page/thesis.html?id=3819

Owner

  • Name: HUES Platform
  • Login: hues-platform
  • Kind: organization

GitHub Events

Total
  • Watch event: 1
Last Year
  • Watch event: 1

Committers

Last synced: about 2 years ago

All Time
  • Total Commits: 91
  • Total Committers: 4
  • Avg Commits per committer: 22.75
  • Development Distribution Score (DDS): 0.429
Past Year
  • Commits: 5
  • Committers: 4
  • Avg Commits per committer: 1.25
  • Development Distribution Score (DDS): 0.6
Top Committers
Name Email Commits
Aaron Bojarski a****i@e****h 52
Fazel Khayatian f****n@y****m 25
boaa-empa 6****a 13
hacai44 h****i@g****m 1
Committer Domains (Top 20 + Academic)
empa.ch: 1

Issues and Pull Requests

Last synced: about 2 years ago

All Time
  • Total issues: 0
  • Total pull requests: 1
  • Average time to close issues: N/A
  • Average time to close pull requests: 1 minute
  • Total issue authors: 0
  • Total pull request authors: 1
  • Average comments per issue: 0
  • Average comments per pull request: 0.0
  • Merged pull requests: 1
  • Bot issues: 0
  • Bot pull requests: 0
Past Year
  • Issues: 0
  • Pull requests: 0
  • Average time to close issues: N/A
  • Average time to close pull requests: N/A
  • Issue authors: 0
  • Pull request authors: 0
  • Average comments per issue: 0
  • Average comments per pull request: 0
  • Merged pull requests: 0
  • Bot issues: 0
  • Bot pull requests: 0
Top Authors
Issue Authors
Pull Request Authors
  • Khayatian (1)
Top Labels
Issue Labels
Pull Request Labels

Dependencies

.github/workflows/python-app.yml actions
  • actions/checkout v2 composite
  • actions/setup-python v2 composite
Dockerfile docker
  • ubuntu 20.04 build
setup.py pypi
  • fmpy ==0.3.12
  • h5py ==3.7.0
  • mosaik ==3.0.2
  • pandas ==1.5.1
  • pytest ==7.1.3
  • pyyaml ==6.0
  • requests ==2.28.1
  • requests_ntlm ==1.1.0
  • scipy ==1.9.3
  • tables ==3.7.0