Metadata-Version: 2.1
Name: ObjectNat
Version: 0.0.3
Summary: 
Author: Danila
Author-email: 63115678+DDonnyy@users.noreply.github.com
Requires-Python: >=3.10,<4.0
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Requires-Dist: dongraphio (>=0.2.5,<0.3.0)
Requires-Dist: geopandas (>=0.14.3,<0.15.0)
Requires-Dist: momepy (>=0.7.0,<0.8.0)
Requires-Dist: networkit (>=11.0,<12.0)
Requires-Dist: networkx (>=3.2.1,<4.0.0)
Requires-Dist: numpy (>=1.23.5,<2.0.0)
Requires-Dist: osm2geojson (>=0.2.4,<0.3.0)
Requires-Dist: osmnx (>=1.9.1,<2.0.0)
Requires-Dist: pandas (>=2.2.0,<3.0.0)
Requires-Dist: population-restorator (>=0.2.3,<0.3.0)
Requires-Dist: provisio (>=0.1.5,<0.2.0)
Requires-Dist: pydantic (>=2.6.1,<3.0.0)
Requires-Dist: tqdm (>=4.66.2,<5.0.0)
Description-Content-Type: text/markdown

# ObjectNat - Meta Library

[![Code style: black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/psf/black)


<p align="center">
<img src="./docs/img/logo.png" alt="test-logo" width="400"></a>
</p>

**ObjectNat** is an open-source library created for geospatial analysis created by IDU team

## ObjectNat Components

- [dongraphio](https://github.com/DDonnyy/dongraphio) : `dongraphio` provides graph functions
- [provisio](https://github.com/DDonnyy/provisio) : `provisio` provides main provisio fuctions
- [population-restorator](https://github.com/kanootoko/population-restorator) : `restorator` provides city resettlement

## Features and how to use

1. [City graph from OSM](./examples/graph_generator.ipynb) - Function to assemble a road, pedestrian, and public
   transport graph from OpenStreetMap (OSM) and creating Intermodal graph.

   <img src="./docs/img/graphTara.png" alt="city_graph" width="300"></a>
   
2. [Adjacency matrix](./examples/calculate_adjacency_matrix.ipynb) - Calculate adjacency matrix based on the provided
   graph and edge weight type (time or distance). The intermodal graph can be obtained using the previous example.
3. [Isochrones,transport accessibility](./examples/isochrone_generator.ipynb) - Function for generating isochrones to
   analyze transportation accessibility from specified starting coordinates. Isochrones can be constructed based on
   pedestrian, automobile, or public transport graphs, or a combination thereof.

   <img src="./docs/img/isochronesTara.png" alt="isochrones" width="300"></a>

4. [Population restoration](./examples/restore_population.ipynb) - Function for resettling population into the provided
   layer of residential buildings. This function distributes people among dwellings based on the total city population
   and the living area of each house.
5. [Service provision](./examples/calculate_provision.ipynb) - Function for calculating the provision of residential
   buildings and population with services. In case of missing data, this function utilizes previously described
   functionality to retrieve the necessary information.

   <img src="./docs/img/provisioTara.png" alt="isochrones" width="300"></a>

## Installation

**ObjectNat** soon ~~can be installed with~~ ``pip``:

```
pip install ObjectNat
```

## Contacts

## Publications

