ohrie / openhousepopulator Goto Github PK

OpenHousePopulator

This tool can be used to estimate the inhabitant count per house in an area with a known population using OpenStreetMap data. The result is based on a very simple heuristic, so low accuracy should be expected.

Arch based:

$ sudo pacman -S rust

Debian based:

$ sudo apt-get update
$ sudo apt-get upgrade
$ sudo apt-get install rust

For use under Windows / MacOS install rust using the default installer from the official website: www.rust-lang.org

$ chmod 755 setup.sh
$ ./setup.sh

To execute the CLI run:

cd bin

// Show help
./OpenHousePopulator --help

// Populate example area
./OpenHousePopulator populate -f "./res/Gmunden.osm.pbf" -i 7602 --centroid

Where -i (mandatory) describes the number of inhabitants in the area of the .osm.pbf file. The --centroid (optional) parameter puts the data in a GeoJSON Point geometry instead into the buildings geometry.

Output: A GeoJson with all buildings including the additional fields 'pop' (population), 'flats' (household estimation)

You can configure the following parameters in the config.json file:

• reroll_threshold: The minimum population count to start rerolling (populate next building).
• reroll_probability: The probability to reroll a building (over threshold).
• level_factor: The factor to multiply the level count with (if multi-storey).
• housenumber_factor: The factor to multiply the house number count with.
• exclude_landuse: Areas to exclude buildings in. (e.g. ["industrial", "commercial"]).
• exclude_tags: Areas to exclude by tag (e.g. ["amenity", "leisure"]).
• single_home_list: List of building values to be considered single home houses (e.g. ["house", "detached"]).
• apartment_list: List of buildings values to be considered apartments (e.g. ["apartments", "residential"]).
• unspecified_list: List of buildings values to be considered unspecified (e.g. ["terrace", "semidetached_house"]).