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 digital-twin geometry parallel-computing observational serialize charts

Last synced: about 11 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: 1 day ago

Total Commits: 13,048
Total Committers: 57
Avg Commits per committer: 228.912
Development Distribution Score (DDS): 0.798

Commits in past year: 1,917
Committers in past year: 12
Avg Commits per committer in past year: 159.75
Development Distribution Score (DDS) in past year: 0.39

Name Email Commits
JIMENOFONSECA f****a@a****h 2642
Daren Thomas t****s@a****h 2574
Reynold Mok 3****y@u****m 1966
shanshanhsieh h****h@a****h 1010
Reynold Mok r****d@h****m 843
BhargavaKrishnaSreepathi s****i@a****h 758
Zhongming Shi d****m@h****m 728
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 250
Daren Thomas d****s@u****m 141
Martín Mosteiro-Romero m****o@n****g 128
Jack-Hawthorne 3****e@u****m 109
Khayatian f****n@y****m 102
Yiqiao Wang w****7@g****m 89
daren-thomas d****h@g****m 66
Zhongming Shi s****i@a****h 56
Martin Mosteiro Romero m****o@u****m 49
Lenny Rogenhofer l****r@s****h 48
Jack-Hawthorne j****7@g****m 47
Emanuel Riegelbauer r****l@e****h 42
Martín Mosteiro Romero m****o@t****l 37
Jimeno Fonseca f****o@g****m 27
Reynold Mok me@r****m 26
Amedeo Ceruti a****i@t****e 25
lguilhermers 5****s@u****m 18
Maryam MeshkinKiya m****a@g****m 16
MatNif 9****f@u****m 12
Bolie b****g@g****m 9
and 27 more...

Committer domains:

Issue and Pull Request metadata

Last synced: 3 days ago

Total issues: 2,454
Total pull requests: 1,580
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.98
Merged pull request: 1,425
Bot issues: 0
Bot pull requests: 4

Past year issues: 78
Past year pull requests: 279
Past year average time to close issues: 17 days
Past year average time to close pull requests: 3 days
Past year issue authors: 35
Past year pull request authors: 11
Past year average comments per issue: 0.74
Past year average comments per pull request: 0.95
Past year merged pull request: 210
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 (183)
  • BhargavaKrishnaSreepathi (90)
  • lguilhermers (85)
  • amraladdin (85)
  • reyery (79)
  • ShiZhongming (47)
  • Jack-Hawthorne (41)
  • shizhongming (34)
  • roglen (34)
  • MatNif (31)
  • Khayatian (30)

Top Pull Request Authors

  • reyery (435)
  • daren-thomas (297)
  • jimenofonseca (194)
  • martin-mosteiro (132)
  • ShiZhongming (88)
  • shanshanhsieh (82)
  • gabriel-happle (68)
  • BhargavaKrishnaSreepathi (58)
  • MatNif (55)
  • Jack-Hawthorne (39)
  • roglen (19)
  • shizhongming (16)
  • yiqiaowang-arch (14)
  • 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 (40)
  • help wanted (34)
  • priority-must-have (31)
  • priority-should-have (28)
  • about-interface (19)
  • question (18)
  • Epic (10)
  • Potential M.Sc Topic (10)
  • feature-data-management (8)
  • should-have (7)
  • Research (6)
  • feature-optimisation (6)
  • feature-demand (5)
  • 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 about 2 months ago)
  • Last Synced: 2025-10-01T03:48:21.630Z (1 day ago)
  • Versions: 3
  • Dependent Packages: 0
  • Dependent Repositories: 0
  • Downloads: 253 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: 15.403431430336106