CBE Clima Tool

A web-based application built to support the need of architects and engineers interested in climate-adapted design.
https://github.com/centerforthebuiltenvironment/clima

Category: Consumption
Sub Category: Buildings and Heating

Keywords

building-design clima climate-analysis epw epw-files python

Keywords from Contributors

air-temperature comfort pmv pmv-prediction thermal-comfort

Last synced: about 20 hours ago
JSON representation

Repository metadata

The CBE Clima Tool is a web-based application built to support the need of architects and engineers interested in climate-adapted design. It allows users to analyze the climate data of more than 27,500 locations worldwide using the data contained in EPW files.

README.md

CBE Clima Tool

The CBE Clima Tool is a web-based application built to support climate analysis specifically designed to support the need of architects and engineers interested in climate-adapted design. It can be freely accessed at clima.cbe.berkeley.edu.

It allows users to analyze the climate data of more than 27,500 locations worldwide from both Energy Plus and Climate.One.Building.org. You can, however, also choose to upload your own EPW weather file.

Our tool can be used to analyze and visualize data contained in EnergyPlus Weather (EPW) files. It furthermore calculates a number of climate-related values (i.e. solar azimuth and altitude, Universal Thermal Climate Index (UTCI), comfort indices, etc.) that are not contained in the EPW files but can be derived from the information therein contained.

Key Features

  • Interactive Climate Analysis: Visualize EPW weather data through a variety of interactive charts.
  • Extensive Weather Data: Access weather files for over 27,500 locations from EnergyPlus and Climate.One.Building.org.
  • Custom Data Upload: Analyze your own custom .epw weather files.
  • Advanced Calculations: Computes derived metrics like solar positions, UTCI, and various thermal comfort indices.
  • Data Export: Download charts, data, and psychrometric chart overlays.

Documentation

The official documentation for the tool can be found here.

Citation

If you use this tool in your research or work, please cite our paper:

Betti, G., Tartarini, F. & Schiavon, S. CBE Clima Tool: a free and open-source web application for climate analysis for architects and building engineers. Build. Simul. (2023). https://doi.org/10.1007/s12273-023-1090-5

Getting Support

For any questions, feedback, or bug reports, please use the GitHub Discussions section.

Authors

Built with

  • Dash - Main web framework
  • Plotly Python - Interactive scientific graphing
  • Pandas - Data analysis and manipulation

Owner metadata


GitHub Events

Total
Last Year

Committers metadata

Last synced: 14 days ago

Total Commits: 984
Total Committers: 21
Avg Commits per committer: 46.857
Development Distribution Score (DDS): 0.492

Commits in past year: 243
Committers in past year: 11
Avg Commits per committer in past year: 22.091
Development Distribution Score (DDS) in past year: 0.547

Name Email Commits
FedericoTartarini f****i@g****m 500
Christine Nguyen c****l@b****u 185
yluo0664 1****n 39
mccalluc m****c 37
Eric j****8@g****m 34
Wenshu Lyu w****7@u****u 29
g_betti g****i@h****m 27
phuongdoan13 m****t@g****m 19
Yixun Quan 7****n 18
t2the0bi 4****i 18
Tianchi Liu t****0@u****u 13
Yunzhu y****9@g****m 12
yluo0664 y****4@u****u 12
FengW01 w****g@1****m 11
Ziqi Liu z****7@g****m 8
Kira-Liu00 l****5@g****m 6
Su Hyang Kim s****g@b****u 5
Wenshu Lyu l****u@o****m 4
danielh7-cs9 d****6@g****m 4
t-kramer t****r@b****u 2
dhar4386 1****9 1

Committer domains:


Issue and Pull Request metadata

Last synced: about 1 month ago

Total issues: 191
Total pull requests: 54
Average time to close issues: 4 months
Average time to close pull requests: 4 days
Total issue authors: 27
Total pull request authors: 14
Average comments per issue: 2.16
Average comments per pull request: 2.35
Merged pull request: 36
Bot issues: 0
Bot pull requests: 0

Past year issues: 15
Past year pull requests: 15
Past year average time to close issues: 29 days
Past year average time to close pull requests: 6 days
Past year issue authors: 9
Past year pull request authors: 5
Past year average comments per issue: 1.27
Past year average comments per pull request: 4.73
Past year merged pull request: 6
Past year bot issues: 0
Past year bot pull requests: 0

More stats: https://issues.ecosyste.ms/repositories/lookup?url=https://github.com/centerforthebuiltenvironment/clima

Top Issue Authors

  • giobetti (85)
  • FedericoTartarini (53)
  • stefanoschiavon (10)
  • praftery (9)
  • yunzhu1229 (4)
  • JoseAliPorras-Salazar (3)
  • mccalluc (3)
  • phuongdoan13 (2)
  • RobeRugani (2)
  • danielh7-cs9 (2)
  • Marcello975 (2)
  • VincentHKG (1)
  • PDrury-lboro (1)
  • chrlng (1)
  • Ecosopher64 (1)

Top Pull Request Authors

  • mccalluc (13)
  • phuongdoan13 (7)
  • Ericlee0128 (6)
  • LeoLuosifen (5)
  • Sallie00 (5)
  • danielh7-cs9 (3)
  • FedericoTartarini (3)
  • yunzhu1229 (3)
  • YixunQuan (2)
  • abdullahEds (2)
  • Kira-Liu00 (2)
  • mostaphaRoudsari (1)
  • FengW01 (1)
  • teja5zz (1)

Top Issue Labels

  • enhancement (26)
  • High Priority (19)
  • v1.0.0 Requirement (10)
  • bug (9)
  • easy fix (9)
  • Graphics (4)
  • cannot fix (3)
  • wontfix (3)
  • documentation (1)

Top Pull Request Labels


Dependencies

Pipfile pypi
  • bump2version * develop
  • cleanpy * develop
  • pytest * develop
  • dash ==2.4.1
  • dash-bootstrap-components ==1.2.0
  • dash-extensions *
  • dash-mantine-components *
  • flask-caching ==1.10.1
  • gunicorn ==20.1.0
  • pvlib ==0.9.1
  • pythermalcomfort *
Pipfile.lock pypi
  • atomicwrites ==1.4.0 develop
  • attrs ==21.4.0 develop
  • bump2version ==1.0.1 develop
  • cleanpy ==0.3.1 develop
  • colorama ==0.4.5 develop
  • iniconfig ==1.1.1 develop
  • packaging ==21.3 develop
  • pluggy ==1.0.0 develop
  • py ==1.11.0 develop
  • pyparsing ==3.0.9 develop
  • pytest ==7.1.2 develop
  • tomli ==2.0.1 develop
  • brotli ==1.0.9
  • certifi ==2022.6.15
  • charset-normalizer ==2.1.0
  • click ==8.1.3
  • colorama ==0.4.5
  • dash ==2.4.1
  • dash-bootstrap-components ==1.2.0
  • dash-core-components ==2.0.0
  • dash-extensions ==0.1.3
  • dash-html-components ==2.0.0
  • dash-mantine-components ==0.10.2
  • dash-table ==5.0.0
  • editorconfig ==0.12.3
  • flask ==2.1.2
  • flask-caching ==1.10.1
  • flask-compress ==1.12
  • gunicorn ==20.1.0
  • h5py ==3.7.0
  • idna ==3.3
  • importlib-metadata ==4.12.0
  • itsdangerous ==2.1.2
  • jinja2 ==3.1.2
  • jos3 ==0.3.1
  • jsbeautifier ==1.14.4
  • llvmlite ==0.38.1
  • markupsafe ==2.1.1
  • more-itertools ==8.13.0
  • numba ==0.55.2
  • numpy ==1.22.4
  • pandas ==1.4.3
  • plotly ==5.9.0
  • pvlib ==0.9.1
  • pythermalcomfort ==2.5.2
  • python-dateutil ==2.8.2
  • pytz ==2022.1
  • requests ==2.28.1
  • scipy ==1.8.1
  • setuptools ==62.6.0
  • six ==1.16.0
  • tenacity ==8.0.1
  • urllib3 ==1.26.9
  • werkzeug ==2.1.2
  • zipp ==3.8.0
.github/workflows/deploy.yml actions
  • actions/checkout v2 composite
  • actions/setup-python v4 composite
  • google-github-actions/deploy-cloudrun main composite
  • google-github-actions/setup-gcloud v0 composite
Dockerfile docker
  • python 3.9-slim build
requirements.txt pypi
  • Brotli ==1.0.9
  • EditorConfig ==0.12.3
  • Flask ==2.2.2
  • Flask-Caching ==1.10.1
  • Flask-Compress ==1.13
  • Jinja2 ==3.1.2
  • MarkupSafe ==2.1.1
  • Werkzeug ==2.2.2
  • certifi ==2022.12.7
  • charset-normalizer ==2.1.1
  • click ==8.1.3
  • dash ==2.4.1
  • dash-bootstrap-components ==1.2.0
  • dash-core-components ==2.0.0
  • dash-extensions ==0.1.3
  • dash-html-components ==2.0.0
  • dash-mantine-components ==0.10.2
  • dash-table ==5.0.0
  • gunicorn ==20.1.0
  • h5py ==3.7.0
  • idna ==3.4
  • importlib-metadata ==5.1.0
  • itsdangerous ==2.1.2
  • jos3 ==0.4.0
  • jsbeautifier ==1.14.7
  • llvmlite ==0.39.1
  • more-itertools ==8.14.0
  • numba ==0.56.4
  • numpy ==1.23.5
  • pandas ==1.5.2
  • plotly ==5.11.0
  • pvlib ==0.9.1
  • pythermalcomfort ==2.5.4
  • python-dateutil ==2.8.2
  • pytz ==2022.6
  • requests ==2.28.1
  • scipy ==1.9.3
  • six ==1.16.0
  • tenacity ==8.1.0
  • urllib3 ==1.26.13
  • zipp ==3.11.0
.github/workflows/cypress.yml actions
  • actions/checkout v4 composite
  • actions/setup-node v4 composite
  • actions/setup-python v4 composite
  • actions/upload-artifact v3 composite
.github/workflows/python.yml actions
  • actions/checkout v4 composite
  • actions/setup-python v4 composite
tests/node/package-lock.json npm
  • 184 dependencies
tests/node/package.json npm
  • cypress ^13.5.1 development

Score: 7.598399329323964