wroclawtaxonomy 0.0.3

Function for creating dendrite using Wroclaw taxonomy

wroclaw_taxonomy package

About

This package consists of one class called Dendrite which enables user to create dendrite out of set of points based on Wroclaw taxonomy method. It uses euclidean distance to group objects into possibly similar groups. In the next steps, each group is merged with the other closest group until the whole dataset is combined into one coherent dendrite.

User can export results to GeoJSON file or visualise them using plot() and animate().

Installation

You can install this package from PyPI by typing in terminal:

pip install wroclawtaxonomy

Or download it directly from source repo:

pip install git+https://github.com/TomekMatuszek/wroclaw_taxonomy.git

Example

Basic workflow:

from wroclaw_taxonomy.Dendrite import Dendrite

dendrite = Dendrite(src='data/citiesPL_pop.geojson')
dendrite.calculate(columns=['lat', 'lon'], normalize=False)

dendrite.export_objects(out_file='dendrite_points.geojson')
dendrite.export_dendrite(out_file='dendrite.geojson')

dendrite.plot()

Customizing plot:

dendrite.plot(
    level=1, lines=True,
    style = {
        "markersize": 20,
        "cmap": 'gist_rainbow',
        "line_color": '#000000',
        "object_color": '#0000ff'
    }
)

Animation showing every stage of the dendrite creation:

dendrite.animate(out_file='dendrite.gif', frame_duration=1)

More examples can be found in file examples.ipynb