README.md

ObjectNat - Meta Library

• РИДМИ (Russian)

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

ObjectNat Components

• IduEdu : IduEdu provides graph functions
• population-restorator : restorator provides city resettlement

Features and how to use

1. City graph from OSM (IduEdu) - Functions to assemble a road, pedestrian, and public transport graph from OpenStreetMap (OSM) and creating Intermodal graph.

   

2. Adjacency matrix - 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 - 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.

   

4. Population restoration - 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 - Function for calculating the provision of residential buildings and population with services.

   

6. Visibility analysis - Function to get a quick estimate of visibility from a given point(s) to buildings within a given distance. Also, there is a visibility catchment area calculator for a large urban area. This function is designed to work with at least 1000 points spaced 10-20 meters apart for optimal results. Points can be generated using a road graph and random point distribution along edges.

   

7. Noise simulation - Simulates noise propagation from a set of source points considering obstacles, trees, and environmental factors. Detailed information in Wiki

   

8. Point clusterization - Function to generate cluster polygons for given points based on a specified minimum distance and minimum points per cluster. Optionally, calculate the relative ratio between types of services within the clusters.

   

9. Living buildings from OSM - This function downloads building geometries from OpenStreetMap (OSM) for a specified territory and assigns attributes to each building. Specifically, it determines whether a building is residential (is_living attribute) and estimates the approximate number of inhabitants (approximate_pop attribute).

   

Installation

ObjectNat can be installed with pip:

pip install ObjectNat

Configuration changes

from objectnat import config

config.set_timeout(10)  # Timeout for overpass queries
config.change_logger_lvl('INFO')  # To mute all debug msgs
config.set_enable_tqdm(False)  # To mute all tqdm's progress bars
config.set_overpass_url('http://your.overpass-api.de/interpreter/URL')

Contacts

• NCCR - National Center for Cognitive Research
• IDU - Institute of Design and Urban Studies
• Natalya Chichkova - project manager
• Danila Oleynikov (Donny) - lead software engineer

Publications