Metadata-Version: 2.4
Name: odc
Version: 0.1.3
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.
License: GPLv3
Author: Observatorio de Ciudades
Author-email: observatoriodeciudades.tec@gmail.com
Requires-Python: >=3.10,<4.0
Classifier: License :: Other/Proprietary License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Requires-Dist: GeoAlchemy2 (>=0.15.2,<0.16.0)
Requires-Dist: SQLAlchemy (>=2.0.35,<3.0.0)
Requires-Dist: func-timeout (>=4.3.5,<5.0.0)
Requires-Dist: geopandas (>=1.0.1,<2.0.0)
Requires-Dist: h3 (>=4.1.2,<5.0.0)
Requires-Dist: igraph (>=0.11.6,<0.12.0)
Requires-Dist: matplotlib (>=3.9.2,<4.0.0)
Requires-Dist: networkx (>=3.3,<4.0)
Requires-Dist: numpy (>=2.1.1,<3.0.0)
Requires-Dist: osmnx (==2.0.6)
Requires-Dist: pandas (>=2.2.2,<3.0.0)
Requires-Dist: planetary-computer (>=1.0.0,<2.0.0)
Requires-Dist: psycopg2-binary (>=2.9.9,<3.0.0)
Requires-Dist: pymannkendall (>=1.4.3,<2.0.0)
Requires-Dist: pyproj (>=3.6.1,<4.0.0)
Requires-Dist: pystac (>=1.10.1,<2.0.0)
Requires-Dist: pystac-client (>=0.8.3,<0.9.0)
Requires-Dist: python-dateutil (>=2.9.0.post0,<3.0.0)
Requires-Dist: python-dotenv (>=1.0.1,<2.0.0)
Requires-Dist: rasterio (>=1.3.11,<2.0.0)
Requires-Dist: scikit-learn (>=1.5.2,<2.0.0)
Requires-Dist: scipy (>=1.14.1,<2.0.0)
Requires-Dist: shapely (>=2.0.6,<3.0.0)
Requires-Dist: tqdm (>=4.66.5,<5.0.0)
Description-Content-Type: text/markdown

![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 analyisis processess 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.

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

