Metadata-Version: 2.1
Name: osmsc
Version: 0.1.2
Summary: Construct semantic city models from OpenStreetMap
Home-page: https://github.com/ruirzma/osmsc
Author: Rui Ma
Author-email: rui.rz.ma@gmail.com
License: MIT
Platform: UNKNOWN
Requires-Dist: geopandas (==0.9.0)
Requires-Dist: pandas (==1.2.0)
Requires-Dist: networkx (==2.5)
Requires-Dist: numpy (==1.20.3)
Requires-Dist: matplotlib (==3.3.3)
Requires-Dist: pyproj (==3.1.0)
Requires-Dist: requests (==2.25.1)
Requires-Dist: Rtree (>=0.9)
Requires-Dist: shapely (==1.7.1)
Requires-Dist: osmnx (==1.0.0)
Requires-Dist: cjio (==0.6.6)
Requires-Dist: pydeck (==0.6.1)
Requires-Dist: contextily (==1.1.0)


OSMsc 
=====
*updated 30 Nov 2021*

<font color=green size=4> This repo created an easy-to-use Python package, named OSMsc, to improve the availability, consistency and generalizability of urban semantic data.</font>



![](abigail-keenan-RaVcslj475Y-unsplash.jpg)

<p align = "center"> 
Photo by <a href="https://unsplash.com/@akeenster?utm_source=unsplash&utm_medium=referral&utm_content=creditCopyText">Abigail  Keenan</a> on <a href="https://unsplash.com/?utm_source=unsplash&utm_medium=referral&utm_content=creditCopyText">Unsplash</a>
</p>


The main contributions of OSMsc are reflected in the following aspects:
* Construct semantic city objects based on the public dataset (OpenStreetMap), apply geometric operations to build the incomplete objects, and store them in their respective data layers.
* Fuse 3D and tag information from multiple data sources through the spatial analysis between OSMsc layers and other non-OSM data layers.
* Supplement the spatial semantics and geometric properties to city objects through object layer analysis.
* Utilize each data layer as a unit to output the final CityJSON semantic objects



![workflow](osmsc_workflow.png "workflow")
<p align = "center"> OSMsc workflow</p>


### Installation

Install from [PyPi](https://pypi.org/project/osmsc/)

`pip install osmsc`

Install from [Github](https://github.com/ruirzma/osmsc)

`git clone https://github.com/ruirzma/osmsc.git`

`cd osmsc/`

`pip install .` or `python setup.py install`

### Examples
[OSMsc demonstration notebooks](https://github.com/ruirzma/osmsc/tree/main/examples)

### Reference
    1. Geoff Boeing, OSMnx, https://github.com/gboeing/osmnx
    2. Nick Bristow, OSMuf, https://github.com/AtelierLibre/osmuf
    3. Joris Van den Bossche, GeoPandas, https://github.com/geopandas/geopandas



