Data

Tools

Indexes

Applications

Experiments

Open Source Science

CityEnergyAnalyst

The 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.

https://github.com/architecture-building-systems/CityEnergyAnalyst

Science Score: 67.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
    Found 5 DOI reference(s) in README
  • ✓
    Academic publication links
    Links to: zenodo.org
  • ✓
    Committers with academic emails
    17 of 44 committers (38.6%) from academic institutions
  • ✓
    Institutional organization owner
    Organization architecture-building-systems has institutional domain (systems.arch.ethz.ch)
  • ○
    JOSS paper metadata
  • ○
    Scientific vocabulary similarity
    Low similarity (8.8%) to scientific vocabulary

Keywords

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

Keywords from Contributors

distributed
Last synced: 6 months ago · JSON representation

Repository

The 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.

Basic Info
Statistics
  • Stars: 231
  • Watchers: 20
  • Forks: 76
  • Open Issues: 105
  • Releases: 116
Topics
building-energy building-energy-modeling decarbonization gis open-source python simulation ubem urban-analytics urban-design
Created about 10 years ago · Last pushed 6 months ago
Metadata Files
Readme Changelog License

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

  • Name: Architecture and Building Systems
  • Login: architecture-building-systems
  • Kind: organization
  • Email: silvestri@arch.ethz.ch

GitHub Events

Total
  • Create event: 167
  • Release event: 22
  • Issues event: 131
  • Watch event: 35
  • Delete event: 156
  • Member event: 3
  • Issue comment event: 257
  • Push event: 1,023
  • Pull request review event: 316
  • Pull request review comment event: 348
  • Pull request event: 227
  • Fork event: 9
Last Year
  • Create event: 167
  • Release event: 22
  • Issues event: 131
  • Watch event: 35
  • Delete event: 156
  • Member event: 3
  • Issue comment event: 257
  • Push event: 1,023
  • Pull request review event: 316
  • Pull request review comment event: 348
  • Pull request event: 227
  • Fork event: 9

Committers

Last synced: 10 months ago

All Time
  • Total Commits: 11,067
  • Total Committers: 44
  • Avg Commits per committer: 251.523
  • Development Distribution Score (DDS): 0.749
Past Year
  • Commits: 361
  • Committers: 9
  • Avg Commits per committer: 40.111
  • Development Distribution Score (DDS): 0.349
Top Committers
Name Email Commits
Daren Thomas t****s@a****h 2,781
JIMENOFONSECA f****a@a****h 2,669
Reynold Mok r****d@h****m 1,614
shanshanhsieh h****h@a****h 1,010
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
Zhongming Shi d****m@h****m 219
MatNif n****n@g****m 205
Martín Mosteiro-Romero m****o@n****g 177
Jack-Hawthorne 3****e 156
Khayatian f****n@y****m 102
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
Bolie b****g@g****m 9
chenkianwee c****e@g****m 9
Maryam MeshkinKiya m****a@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
belloj88 b****8@g****m 4
justinfmccarty m****f@g****m 4
paulneitzel p****l@s****h 4
Amr Elesawy e****y@a****h 4
Lennart Rogenhofer l****r@g****m 4
Matthias Sulzer 5****r 3
and 14 more...
Committer Domains (Top 20 + Academic)
arch.ethz.ch: 9 ethz.ch: 3 student.ethz.ch: 2 gitter.im: 1 euler06.hpc-lca.ethz.ch: 1 pm.me: 1 codema.ie: 1 tum.de: 1 nus.edu.sg: 1

Issues and Pull Requests

Last synced: 6 months ago

All Time
  • Total issues: 2,451
  • Total pull requests: 1,568
  • Average time to close issues: 4 months
  • Average time to close pull requests: 7 days
  • Total issue authors: 187
  • Total pull request authors: 35
  • Average comments per issue: 2.6
  • Average comments per pull request: 1.99
  • Merged pull requests: 1,422
  • Bot issues: 0
  • Bot pull requests: 4
Past Year
  • Issues: 81
  • Pull requests: 271
  • Average time to close issues: 19 days
  • Average time to close pull requests: 2 days
  • Issue authors: 38
  • Pull request authors: 9
  • Average comments per issue: 0.62
  • Average comments per pull request: 0.93
  • Merged pull requests: 210
  • Bot issues: 0
  • Bot pull requests: 0
View more stats
Top Authors
Issue Authors
  • daren-thomas (488)
  • jimenofonseca (356)
  • gabriel-happle (224)
  • shanshanhsieh (213)
  • martin-mosteiro (182)
  • BhargavaKrishnaSreepathi (90)
  • amraladdin (85)
  • lguilhermers (85)
  • reyery (79)
  • ShiZhongming (46)
  • Jack-Hawthorne (41)
  • roglen (34)
  • shizhongming (34)
  • MatNif (31)
  • Khayatian (30)
Pull Request Authors
  • reyery (430)
  • daren-thomas (297)
  • jimenofonseca (194)
  • martin-mosteiro (131)
  • ShiZhongming (86)
  • shanshanhsieh (82)
  • gabriel-happle (68)
  • BhargavaKrishnaSreepathi (58)
  • MatNif (55)
  • Jack-Hawthorne (39)
  • roglen (19)
  • shizhongming (16)
  • yiqiaowang-arch (14)
  • lguilhermers (12)
  • Khayatian (11)
Top Labels
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 (39) 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)
Pull Request Labels
Must have (98) bug (83) enhancement (65) priority-must-have (44) easy peasy (21) is-bug (17) 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)

Packages

  • Total packages: 3
  • Total downloads:
    • pypi 680 last-month
  • Total dependent packages: 0
    (may contain duplicates)
  • Total dependent repositories: 0
    (may contain duplicates)
  • Total versions: 149
  • Total maintainers: 1
proxy.golang.org: github.com/architecture-building-systems/cityenergyanalyst
  • Versions: 66
  • Dependent Packages: 0
  • Dependent Repositories: 0
Rankings
Dependent repos count: 1.6%
Average: 4.1%
Dependent packages count: 6.5%
Last synced: about 1 year ago
proxy.golang.org: github.com/architecture-building-systems/CityEnergyAnalyst
  • Versions: 80
  • Dependent Packages: 0
  • Dependent Repositories: 0
Rankings
Dependent packages count: 7.0%
Average: 8.2%
Dependent repos count: 9.3%
Last synced: 6 months ago
pypi.org: cea-external-tools

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

  • Versions: 3
  • Dependent Packages: 0
  • Dependent Repositories: 0
  • Downloads: 680 Last month
Rankings
Stargazers count: 5.9%
Forks count: 6.1%
Dependent packages count: 8.7%
Average: 17.4%
Dependent repos count: 49.0%
Maintainers (1)
cityenergyanalyst
Last synced: 6 months ago

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.*