Choropleth Map
Signature
sp.build_choropleth(
title: str,
labels: list[str],
values: list[float],
*,
iso_codes: list[str] | None = None,
color_low: int = 0,
color_high: int = 0,
palette: list[int] | None = None,
width: int = 1000,
height: int = 600,
background: str | None = None,
hover_json: str | None = None,
show_legend: bool = True,
null_color: int = 0xdddddd,
) -> Chart
Aliases: sp.choropleth
Description
Choropleth (filled map) — country or region polygons colored by a scalar value.
Countries without data receive the null_color. Provide iso_codes (ISO-3166 alpha-3) to match countries automatically.
Parameters
| Parameter | Type | Default | Description |
|---|---|---|---|
title | str | required | Chart title |
labels | list[str] | required | Country |
values | list[float] | required | Values to color by |
iso_codes | list[str] | None | None | ISO-3166 alpha-3 codes |
color_low | int | auto | Low value color |
color_high | int | auto | High value color |
null_color | int | 0xdddddd | Color for countries with no data |
width | int | 1000 | Canvas width |
height | int | 600 | Canvas height |
show_legend | bool | True | Show color scale legend |
hover_json | str | None | None | Custom hover JSON |
Returns
Chart
Examples
Unemployment rate choropleth
import seraplot as sp
chart = sp.build_choropleth(
"Unemployment Rate by Country",
labels=["FRA", "DEU", "ESP", "ITA", "PRT"],
values=[7.1, 3.0, 11.8, 6.7, 6.2],
)const sp = require('seraplot');
const chart = sp.build_choropleth("Unemployment Rate by Country",
["FRA", "DEU", "ESP", "ITA", "PRT"],
{
values: [7.1, 3.0, 11.8, 6.7, 6.2]
})import * as sp from 'seraplot';
const chart = sp.build_choropleth("Unemployment Rate by Country",
["FRA", "DEU", "ESP", "ITA", "PRT"],
{
values: [7.1, 3.0, 11.8, 6.7, 6.2]
})▶ Live Preview
See also
Signature
sp.build_choropleth(
title: str,
labels: list[str],
values: list[float],
*,
iso_codes: list[str] | None = None,
color_low: int = 0,
color_high: int = 0,
palette: list[int] | None = None,
width: int = 1000,
height: int = 600,
background: str | None = None,
hover_json: str | None = None,
show_legend: bool = True,
null_color: int = 0xdddddd,
) -> Chart
Aliases: sp.choropleth
Description
Carte choro-plèthe — polygones de pays/régions colorés par une valeur scalaire. Les pays sans données reçoivent la null_color. Fournissez des iso_codes (ISO-3166 alpha-3) pour associer les pays automatiquement.
Paramètres
| Paramètre | Type | Défaut | Description |
|---|---|---|---|
title | str | requis | Titre du graphique |
labels | list[str] | requis | Pays |
values | list[float] | requis | Valeurs pour la colorisation |
iso_codes | list[str] | None | None | Codes ISO-3166 alpha-3 |
color_low | int | auto | Couleur pour les valeurs basses |
color_high | int | auto | Couleur pour les valeurs hautes |
null_color | int | 0xdddddd | Couleur des pays sans données |
width | int | 1000 | Largeur du canvas |
height | int | 600 | Hauteur du canvas |
show_legend | bool | True | Afficher l'échelle de couleur |
hover_json | str | None | None | JSON d'infobulle personnalisée |
Retourne
Chart
Exemples
import seraplot as sp
chart = sp.build_choropleth(
"Taux de chômage par pays",
labels=["FRA", "DEU", "ESP", "ITA", "PRT"],
values=[7.1, 3.0, 11.8, 6.7, 6.2],
)