Data

Tools

Indexes

Applications

Experiments

Open Sustainable Technology

City Energy Analyst

Helps you to analyze the effects of building retrofits, land-use planning, district heating and cooling and renewable energy on the future costs, emissions and energy consumption of neighborhoods and districts.
https://github.com/architecture-building-systems/CityEnergyAnalyst

Category: Consumption
Sub Category: Buildings and Heating

Keywords

building-energy building-energy-modeling decarbonization gis open-source python simulation ubem urban-analytics urban-design

Keywords from Contributors

urban-building-energy-model

Last synced: about 18 hours ago
JSON representation

Repository metadata

City Energy Analyst (CEA) is an open-source urban building energy modeling (UBEM) platform and computation tool for the design of low-carbon and highly efficient cities.

README.rst 

          |license| |repo_size| |zenodo|

.. |license| image:: https://img.shields.io/badge/License-MIT-blue.svg
    :alt: GitHub license
.. |repo_size| image:: https://img.shields.io/github/repo-size/architecture-building-systems/CityEnergyAnalyst
    :alt: Repo Size
.. |zenodo| image:: https://zenodo.org/badge/DOI/10.5281/zenodo.14903253.svg
   :target: https://doi.org/10.5281/zenodo.14903253

.. image:: logo/cea_logo.png
    :scale: 25 %
    :alt: City Energy Analyst (CEA) logo
    :target: https://www.cityenergyanalyst.com

.. |repobeats| image:: https://repobeats.axiom.co/api/embed/31055fb15ba781904f1dcb1e51de1f17436a8816.svg
    :alt: Repo Contribuitions

.. |contrib.rocks| image:: https://contrib.rocks/image?repo=architecture-building-systems/CityEnergyAnalyst
    :target: https://github.com/architecture-building-systems/CityEnergyAnalyst/graphs/contributors
    :alt: Repo Contribuitions

.. |screenshot| image:: https://images.squarespace-cdn.com/content/v1/61e145bff396b63d6444554a/ac840e01-897b-49a5-bcf1-507bb7f51e7b/Screenshot+2025-03-13+at+16.40.31.jpg
    :target: https://github.com/architecture-building-systems/CityEnergyAnalyst-GUI
    :alt: CEA GUI Screenshot

City Energy Analyst (CEA)
--------------------------

The `City Energy Analyst (CEA) `_ is an urban building energy simulation platform and one of the first open-source initiatives of computation tools for the design of low-carbon and highly efficient cities. The CEA combines knowledge of urban planning and energy systems engineering in an integrated simulation platform. This allows to study of the effects, trade-offs, and synergies of urban design scenarios and energy infrastructure plans. At CEA we are committed to empowering practitioners and researchers to plan future low-carbon cities. 


* Click `here `__  for our documentation

* Click `here `__ to report an issue

* Click `here `__ to contact us


CEA Graphical User Interface
~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|screenshot|

Cite us
--------

The CEA Team. (2025). City Energy Analyst (v3.39.4). Zenodo. https://doi.org/10.5281/zenodo.14903253


Contributors
------------
|contrib.rocks|
|repobeats|

Owner metadata

GitHub Events

Total
Last Year

Committers metadata

Last synced: about 2 months ago

Total Commits: 13,433
Total Committers: 45
Avg Commits per committer: 298.511
Development Distribution Score (DDS): 0.767

Commits in past year: 2,280
Committers in past year: 10
Avg Commits per committer in past year: 228.0
Development Distribution Score (DDS) in past year: 0.368

Name Email Commits
Reynold Mok 3****y 3126
Daren Thomas t****s@a****h 2781
JIMENOFONSECA f****a@a****h 2669
shanshanhsieh h****h@a****h 1010
Zhongming Shi d****m@h****m 858
BhargavaKrishnaSreepathi s****i@a****h 758
martin-mosteiro m****o@a****h 525
Gabriel Happle h****e@a****h 328
Lenny Rogenhofer l****r@e****h 299
Mathias Niffeler n****n@g****m 274
Martín Mosteiro-Romero m****o@n****g 214
Jack-Hawthorne 3****e 156
Khayatian f****n@y****m 102
Yiqiao Wang w****7@g****m 98
Lenny Rogenhofer l****r@s****h 48
Emanuel Riegelbauer r****l@e****h 42
Amedeo Ceruti a****i@t****e 25
lguilhermers 5****s 18
Maryam MeshkinKiya m****a@g****m 16
chenkianwee c****e@g****m 9
Bolie b****g@g****m 9
justinfmccarty m****f@g****m 7
Anastasiya Popova p****a@a****h 7
Urbano Tataranni u****1@g****m 6
Jarunan Panyasantisuk j****n@e****h 6
Rowan Molony r****y@c****e 5
Lennart Rogenhofer l****r@g****m 4
Amr Elesawy e****y@a****h 4
paulneitzel p****l@s****h 4
belloj88 b****8@g****m 4
and 15 more...

Committer domains:

Issue and Pull Request metadata

Last synced: about 2 months ago

Total issues: 2,457
Total pull requests: 1,600
Average time to close issues: 4 months
Average time to close pull requests: 7 days
Total issue authors: 188
Total pull request authors: 37
Average comments per issue: 2.6
Average comments per pull request: 1.97
Merged pull request: 1,438
Bot issues: 0
Bot pull requests: 4

Past year issues: 75
Past year pull requests: 291
Past year average time to close issues: 20 days
Past year average time to close pull requests: 2 days
Past year issue authors: 32
Past year pull request authors: 11
Past year average comments per issue: 0.69
Past year average comments per pull request: 1.01
Past year merged pull request: 216
Past year bot issues: 0
Past year bot pull requests: 0

More stats: https://issues.ecosyste.ms/repositories/lookup?url=https://github.com/architecture-building-systems/CityEnergyAnalyst

Top Issue Authors

  • daren-thomas (488)
  • jimenofonseca (356)
  • gabriel-happle (224)
  • shanshanhsieh (213)
  • martin-mosteiro (184)
  • BhargavaKrishnaSreepathi (90)
  • lguilhermers (85)
  • amraladdin (85)
  • reyery (79)
  • ShiZhongming (48)
  • Jack-Hawthorne (41)
  • shizhongming (34)
  • roglen (34)
  • MatNif (31)
  • Khayatian (30)

Top Pull Request Authors

  • reyery (442)
  • daren-thomas (297)
  • jimenofonseca (194)
  • martin-mosteiro (132)
  • ShiZhongming (93)
  • shanshanhsieh (82)
  • gabriel-happle (68)
  • MatNif (58)
  • BhargavaKrishnaSreepathi (58)
  • Jack-Hawthorne (39)
  • roglen (19)
  • yiqiaowang-arch (18)
  • shizhongming (16)
  • lguilhermers (12)
  • Khayatian (11)

Top Issue Labels

  • Must have (877)
  • bug (618)
  • Should have (231)
  • Won't have (221)
  • enhancement (206)
  • documentation (159)
  • easy peasy (121)
  • Interface (108)
  • User Support (103)
  • known issue (95)
  • refactoring (43)
  • is-bug (41)
  • help wanted (34)
  • priority-must-have (32)
  • priority-should-have (28)
  • about-interface (19)
  • question (18)
  • Epic (10)
  • Potential M.Sc Topic (10)
  • feature-data-management (8)
  • should-have (7)
  • feature-demand (6)
  • Research (6)
  • feature-optimisation (6)
  • feature-renewable (5)
  • plugin (5)
  • feature-new (5)
  • feature-visualisation (4)
  • about-documentation (4)
  • ux (3)

Top Pull Request Labels

  • Must have (98)
  • bug (83)
  • enhancement (65)
  • priority-must-have (44)
  • easy peasy (21)
  • is-bug (18)
  • feature-new (14)
  • documentation (13)
  • about-interface (10)
  • Should have (7)
  • refactoring (7)
  • feature-database (6)
  • Interface (5)
  • feature-visualisation (4)
  • feature-demand (4)
  • Won't have (3)
  • help wanted (3)
  • Research (2)
  • feature-utilities (2)
  • feature-data-management (2)
  • User Support (1)
  • known issue (1)
  • about-documentation (1)

Package metadata

proxy.golang.org: github.com/architecture-building-systems/cityenergyanalyst

proxy.golang.org: github.com/architecture-building-systems/CityEnergyAnalyst

pypi.org: cea-external-tools

External tools for City Energy Analyst, mainly containing C++ components e.g. DAYSIM and CRAX

  • Homepage: https://cityenergyanalyst.com
  • Documentation: https://cea-external-tools.readthedocs.io/
  • Licenses: mit
  • Latest release: 0.2.1 (published 4 months ago)
  • Last Synced: 2025-12-14T07:36:44.385Z (10 days ago)
  • Versions: 3
  • Dependent Packages: 0
  • Dependent Repositories: 0
  • Downloads: 144 Last month
  • Rankings:
    • Stargazers count: 5.937%
    • Forks count: 6.125%
    • Dependent packages count: 8.691%
    • Average: 17.432%
    • Dependent repos count: 48.975%
  • Maintainers (1)

Dependencies

.github/workflows/main.yml actions
  • actions/checkout v3 composite
  • mamba-org/provision-with-micromamba main composite
  • peaceiris/actions-gh-pages v3 composite
  • shadowmoose/GHA-LoC-Badge 1.0.0 composite
.github/workflows/pull.request.yml actions
  • actions/checkout v3 composite
  • mamba-org/provision-with-micromamba main composite
.github/workflows/setup_build.yml actions
  • actions/cache v3 composite
  • actions/checkout v3 composite
  • actions/upload-artifact v3 composite
  • mamba-org/provision-with-micromamba main composite
Dockerfile docker
  • condaforge/mambaforge latest build
  • ubuntu focal build
  • ubuntu latest build
setup.py pypi
docs/environment.yml conda
  • geopandas
  • mock
  • numba 0.42.0.*
  • pillow
  • python 2.7.*
  • sphinx
  • sphinx_rtd_theme
environment.yml conda
  • blosc <=1.21.0
  • deap
  • ephem
  • fiona
  • flask
  • flask-cors
  • flask-restx
  • geopandas <0.14
  • gevent
  • gevent-websocket
  • ipykernel
  • ipython
  • matplotlib-base
  • networkx <3
  • notebook
  • numba
  • numpy <1.24
  • numpy-financial
  • openpyxl
  • osmnx <1.4
  • pandas <2
  • pip
  • plotly
  • psutil
  • pvlib-python
  • pysal 2.1.0.*
  • python >=3.7
  • python-cufflinks
  • pythonocc-core 7.4.1.*
  • pytz
  • pyyaml
  • scipy
  • setuptools
  • shapely <2
  • sphinx
  • sympy
  • timezonefinder
  • utm
  • werkzeug 2.0.*
  • wntr 0.2.2.1.*

Score: 14.661132013970533