Metadata-Version: 2.4
Name: cenergy
Version: 1.0.1
Summary: This Python library automates the generation of digital 3D urban energy model from open data. We synthesize data from OpenTopography, OpenStreetMap, and Overture Maps in generating 3D models. The rendered model visualizes and contextualizes distribution power grids alongside the built environment and transportation networks.
Author-email: Shiliang Zhang <shiliangz@ieee.org>
License: MIT License
        
        Copyright (c) 2018 The Python Packaging Authority
        
        Permission is hereby granted, free of charge, to any person obtaining a copy
        of this software and associated documentation files (the "Software"), to deal
        in the Software without restriction, including without limitation the rights
        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
        copies of the Software, and to permit persons to whom the Software is
        furnished to do so, subject to the following conditions:
        
        The above copyright notice and this permission notice shall be included in all
        copies or substantial portions of the Software.
        
        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
        SOFTWARE.
        
Project-URL: Homepage, https://sites.google.com/view/cenergy3/home
Project-URL: Source, https://github.com/slzhang-git/cenergy
Project-URL: Issues, https://github.com/slzhang-git/cenergy/issues
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Requires-Python: >=3.12
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: bmi-topography
Requires-Dist: osmnx
Requires-Dist: geopandas
Requires-Dist: rasterio
Requires-Dist: matplotlib
Requires-Dist: contextily
Requires-Dist: plotly==6.5.0
Requires-Dist: kaleido==0.2.1
Requires-Dist: overturemaps
Requires-Dist: trimesh
Requires-Dist: mapbox-earcut
Requires-Dist: manifold3d
Requires-Dist: triangle
Dynamic: license-file

# Cenergy

This is our developed approach and openly released software that automate the generation of digital 3D urban energy model from open data. We synthesize data from OpenTopography, OpenStreetMap, and Overture Maps in generating 3D models. The rendered model visualizes and contextualizes distribution power grids alongside the built environment and transportation networks. Our developed software, including an open python library and a free [API](https://arxiv.org/pdf/2512.06459), provides interactive figures for the 3D models. The rendered models are essential for analyzing infrastructure alignment and spatially linking energy demand nodes (buildings) with energy supply (utility grids). The developed API leverages standard Web Mercator coordinates (EPSG:3857) and JSON serialization to ensure interoperability within smart city and energy simulation platforms. We also provide a [graphic user interface (GUI)](https://sites.google.com/view/cenergy3/home) where end-users can access our API via a cloud-based server, regardless of their programming skills and what devices and platforms their are using.
