pygal-maps-ua 1.0.2

Ukraine maps for pygal

pygal_maps_ua

Ukraine maps for pygal

🇺🇦 Читати українською

Ukraine map plugin for Pygal

Allows you to create first level division administrative map of Ukraine

At the first level Ukraine is divided into 27 regions: 24 oblasts (regions), 1 autonomous republic (Crimea) and 2 cities with special status (Kyiv, Sevastopol)

Install

pip install pygal_maps_ua

Usage

This package is a plugin for an open-source data visualization library Pygal, so please refer the Pygal and Pygal / Chart types / Maps documentation for deeper understanding of the code below

from pygal.maps.ua import Regions

map = Regions()
map.title = 'Regions with highly confused name'
map.add('Cherkasy', ['cherkasy'])
map.add('Сhernihiv', ['chernihiv'])
map.add('Сhernivtsi', ['chernivtsi'])

map.render_to_png('chart.png')

Result:

You can also specify a value for the region

from pygal_maps_ua.maps import Regions, REGIONS_UA

map = Regions()
map.title = 'Number of letters in the region name'
map.add(
    "Letters count", 
    {x: len(y) for x, y in REGIONS_UA.items()}
)

map.render_to_png('chart.png')

Result:

Temporarily occupied territories

It is possible to render a map with the schematic visualization of temporarily occupied territories of Donetsk and Luhansk regions (known as ORDLO). This area refers to territories occupied by Russia in the 2014 year) and don't refer to territories, occupied by Russia during full-scale Russian invasion of Ukraine in 2022

You can use such a template by calling the RegionsOrdlo class and refer the occupied regions area and ordlo key respectively

from pygal.maps.ua import RegionsOrdlo

map = RegionsOrdlo()

⚠ Warning

It should be a valid reason to use such a map template instead of Regions template

The straight use-case is to visualize some statistical data from 2014 and clearly display that you have no data from the temporarily occupied territories

It is strictly forbidden to use this map template to dispute in any way the sovereignty and territorial integrity of Ukraine (including marking occupied territories as "disputed", "unrecognised", "self-proclaimed" or using any other formulations except "occupied" or "temporarily occupied" according to the UN resolutions 73/194, ES-11/4 and common sense).

The example of using the RegionsOrdlo for the use-case of visualizing the population of Ukraine on 1 Jan 2020 is provided below:

(data source)

from pygal.maps.ua import RegionsOrdlo

population_2020_by_region = {
    "vinnytsia" :1545416,
    "volyn" :1031421,
    "dnipropetrovsk" :3176648,
    "donetsk" :4131808,
    "zhytomir" :1208212,
    "zakarpattia" :1253791,
    "zaporizhzhia" :1687401,
    "ivano-frankivsk" :1368097,
    "kyiv" :1781044,
    "kirovohrad" :933109,
    "luhansk" :2135913,
    "lviv" :2512084,
    "mykolaiv" :1119862,
    "odesa" :2377230,
    "poltava" :1386978,
    "rivne" :1152961,
    "sumy" :1068247,
    "ternopil" :1038695,
    "kharkiv" :2658461,
    "kherson" :1027913,
    "khmelnitskyi" :1254702,
    "cherkasy" :1192137,
    "chernivtsi" :901632,
    "chernihiv" :991294,
    "kyivcity" :2967360,
}


map = RegionsOrdlo(legend_at_bottom=True)

map.title = 'Population by region on 01 Jan 2020'
map.add('Population', population_2020_by_region)
map.add('Temporarily occupied territories', ['ordlo', 'crimea', 'sevastopolcity'])

map.render_to_png('chart.png')

Result:

List of available regions

List of available regions is set as variables REGIONS_UA and REGIONS_ENG respectively and listed below:

key	description [ua]	description [en]
cherkasy	Черкаська область	Cherkasy Oblast
chernihiv	Чернігівська область	Chernihiv Oblast
chernivtsi	Чернівецька область	Chernivtsi Oblast
crimea	Автономна Республіка Крим	Autonomous Republic of Crimea
dnipropetrovsk	Дніпропетровська область	Dnipropetrovsk Oblast
donetsk	Донецька область	Donetsk Oblast
ivano-frankivsk	Івано-Франківська область	Ivano-Frankivsk Oblast
kharkiv	Харківська область	Kharkiv Oblast
kherson	Херсонська область	Kherson Oblast
khmelnitskyi	Хмельницька область	Khmelnytskyi Oblast
kyiv	Київська область	Kyiv Oblast
kyivcity	Київ	Kyiv
kirovohrad	Кіровоградська область	Kirovohrad Oblast
lviv	Львівська область	Lviv Oblast
luhansk	Луганська область	Luhansk Oblast
mykolaiv	Миколаївська область	Mykolaiv Oblast
odesa	Одеська область	Odesa Oblast
poltava	Полтавська область	Poltava Oblast
rivne	Рівненська область	Rivne Oblast
sevastopolcity	Севастополь	Sevastopol
sumy	Сумська область	Sumy Oblast
ternopil	Тернопільська область	Ternopil Oblast
vinnytsia	Вінницька область	Vinnytsia Oblast
volyn	Волинська область	Volyn Oblast
zakarpattia	Закарпатська область	Zakarpattia Oblast
zaporizhzhia	Запорізька область	Zaporizhzhia Oblast
zhytomir	Житомирська область	Zhytomyr Oblast

If you need to update the region names for your purposes (e.g. use only city names), use the set_regions or set_regions_eng functions

If you would like to support the author consider donating to the United24 charity foundation

Data Source for Ukraine ADM1 borders:

Hijmans, Robert J.. University of California, Berkeley. Museum of Vertebrate Zoology. First-level Administrative Divisions, Ukraine, 2015. [Shapefile]. University of California, Berkeley. Museum of Vertebrate Zoology. Retrieved from https://maps.princeton.edu/catalog/stanford-gg870xt4706