map-nl 0.0.4

Quickly create maps of the Netherlands in Python

map-nl

map-nl is a Python package to help you quickly create PC4 maps of the Netherlands. While that is already possible without map-nl, this package aims to make the process a lot easier. It automatically downloads the geojson files, so all you need to provide is a dataset with two columns: One containing PC4 codes and one with a related value to plot on the map. map_nl then uses folium to plot the map.

For an example map created with map-nl, see here.

---

Documentation - Contributing

---

Quickstart

Installation

To add map-nl to your project, run one of the following commands:

# Install with poetry
poetry add map-nl

# Install with pip
pip install map-nl

Usage

To create a choropleth map of the average WOZ-value in the Netherlands, you could run the following:

import pandas as pd
from map_nl import ChoroplethMapNL

df = pd.read_csv("https://raw.githubusercontent.com/fpgmaas/map-nl/main/data/woz-pc4.csv")

m = ChoroplethMapNL(geojson_simplify_tolerance=0.0001).plot(
    df, pc4_column_name="pc4", value_column_name="WOZ", legend_name="Average WOZ Value"
)
m.save("map.html")

This will download the geojson file to the .map_nl directory, simplify the geojson file to reduce the disk size of the plot, plot the map and save it to disk.

For more details, see the documentation.

---

Repository initiated with fpgmaas/cookiecutter-poetry.