# screenshot: 1000x560
"""Картограмма «из коробки»: folium.Choropleth.

Одна функция делает всё: связывает таблицу с границами по ключу,
раскрашивает страны по классам и рисует легенду. Но у встроенной легенды
есть известная беда: это ЛИНЕЙНАЯ полоса от минимума до максимума, поэтому
при неравных интервалах подписи узких классов слипаются в кучу.
"""
import sys
from pathlib import Path

import folium
import geopandas as gpd
import pandas as pd

sys.path.insert(0, str(Path(__file__).resolve().parents[1]))
from maptools import add_title, plain_attribution

DATA = Path(__file__).resolve().parents[2] / "data"
world = gpd.read_file(DATA / "countries.geojson")
world = world[world["iso_a3"] != "ATA"]  # Антарктиду не показываем

# Неравные интервалы с «круглыми» границами — удобны для чтения
bins = [0, 10, 25, 50, 100, 250, 1250]

m = folium.Map(location=[30, 15], zoom_start=2, tiles="Esri.WorldGrayCanvas")
ch = folium.Choropleth(
    geo_data=world,                       # геометрия стран
    data=world,                           # таблица со значениями
    columns=["iso_a3", "pop_density"],    # [ключ, показатель]
    key_on="feature.properties.iso_a3",   # где искать ключ в GeoJSON
    bins=bins,
    fill_color="YlOrRd",                  # последовательная шкала ColorBrewer
    fill_opacity=0.85,
    line_color="white", line_weight=0.5,  # тонкие белые границы
    nan_fill_color="#cccccc",
    legend_name="Плотность населения, чел./км²",
    highlight=True,                       # подсветка при наведении
).add_to(m)
# Подсказка при наведении: название и значение
folium.GeoJsonTooltip(["name_ru", "pop_density"], aliases=["Страна:", "Чел./км²:"]).add_to(ch.geojson)

add_title(m, "folium.Choropleth «из коробки»",
          "посмотрите на легенду: подписи 0, 10, 25, 50, 100 слиплись", position="bottomleft")
plain_attribution(m)  # убираем флажок из подписи Leaflet
m.save("01_folium_choropleth.html")

# Сколько стран попало в каждый класс
counts = pd.cut(world["pop_density"], bins, include_lowest=True).value_counts(sort=False)
print("Класс, чел./км²   Стран")
for interval, n in counts.items():
    print(f"{str(interval):17s} {n:4d}")
