Metadata-Version: 2.4
Name: odc
Version: 0.1.4
Summary: This package streamlines spatial analysis processes by integrating various libraries and developing first-party functions. It is designed as a low-code solution for spatial analysis.
Author-email: Observatorio de Ciudades <observatoriodeciudades.tec@gmail.com>
License-Expression: GPL-3.0-only
Requires-Python: >=3.12
Description-Content-Type: text/markdown
Requires-Dist: func-timeout>=4.3.5
Requires-Dist: geoalchemy2>=0.20.0
Requires-Dist: geopandas>=1.1.4
Requires-Dist: h3>=4.5.0
Requires-Dist: igraph>=1.0.0
Requires-Dist: matplotlib>=3.11.1
Requires-Dist: networkx>=3.6.1
Requires-Dist: numpy>=2.5.1
Requires-Dist: osmnx>=2.1.1
Requires-Dist: pandas>=3.0.5
Requires-Dist: planetary-computer>=1.0.0
Requires-Dist: psycopg2-binary>=2.9.12
Requires-Dist: pymannkendall>=1.4.3
Requires-Dist: pyproj>=3.7.2
Requires-Dist: pystac>=1.15.2
Requires-Dist: pystac-client>=0.9.0
Requires-Dist: python-dateutil>=2.9.0.post0
Requires-Dist: python-dotenv>=1.2.2
Requires-Dist: rasterio>=1.5.0
Requires-Dist: scikit-learn>=1.9.0
Requires-Dist: scipy>=1.18.0
Requires-Dist: shapely>=2.1.2
Requires-Dist: sqlalchemy>=2.0.51
Requires-Dist: tqdm>=4.70.0

![PyPI](https://img.shields.io/pypi/v/odc)
![Downloads](https://img.shields.io/pypi/dm/odc)

# OdC

The Cities Observatory ([_Observatorio de Ciudades_](https://observatoriodeciudades.mx/), OdC) is an urban science laboratory focused on innovation in the collection, processing, analysis and visualization of spatial data related to urban dynamics.
This Python package provides a low-code toolkit for spatial analysis. It integrates well-known geospatial libraries and adds first-party functions developed for faster, reproducible workflows.

------------

# Installing the package

```python
pip install odc
```
------------

# Spatial analysis processes demonstrations

Three demo files were prepared to display the basic usage of some package functions and classes. These are the developed demos:

* [Demo 01 - Proximity analysis](demos/Demo_01-Proximity_analysis.ipynb)
  * Calculates and displays how close or accessible certain locations are to others within a defined area.
  * Input files required: Area of interest and points of interest.
  
  ![Package preview](data/demo_files/outputs_proximity/proximity_analysis.png)
  
* [Demo 02 - NDVI raster analysis](demos/Demo_02-NDVI_raster_analysis.ipynb)
  * Calculates and displays a Normalized Difference Vegetation Index (NDVI) analysis, a spectral index that measures vegetation greenness and vigor.
  * Input files required: Area of interest.

  ![Package preview](data/demo_files/outputs_ndvi/ndvi_analysis.png)
  
* [Demo 03 - Land Surface Temperature analysis](demos/Demo_03-Land_Surface_Temperature_raster_analysis.ipynb)
  * Calculates and displays a Land Surface Temperature (LST) analysis, representing the thermal emission from the Earth's surface. Indicates how hot the surface of the land would feel to the touch.
  * Input files required: Area of interest.

  ![Package preview](data/demo_files/outputs_temperature/temperature_analysis.png)

The demos can be found on the [demo](demos/) folder, while the used input and outputs can be found on the [data/demo_files](data/demo_files/) folder.

------------
