geo4bolivia geo4bolivia geo4bolivia
  • Get started
  • Explore
  • Analyze
  • Articles
    • All articles

    • The data model
    • Exploring the data
    • Maps and spatial dependence
    • Convergence: β, σ and clubs
    • Transitions and mobility
    • Regional inequality
    • Regression, panel and spatial models
    • Spatial heterogeneity: MGWR
    • Case study: the Sustainable Development Index
    • Building your own indicators
  • For AI / LLMs
  • Reference
  • Changelog
  • Observatory

geo4bolivia

geo4bolivia: spatial data science for Bolivia's subnational development data. Beside the title, the Sustainable Development Goals wheel and the Andes and the Altiplano at night seen from orbit: city lights on the high plateau and on the eastern lowlands, a satellite sensing them, a faint hexagon grid aggregating the lights into cells, and a panel of charts (a scatter plot with a fitted line, a Lorenz curve and a trend)

Get started → ▶ Open in Colab Function reference The observatory

geo4bolivia is the Python package of the GeoDevelopment Observatory of Bolivia. It gives you the observatory’s data for 343 municipalities, 113 provinces and 9 departments, and the standard analyses of spatial data science, each in one call: maps, spatial dependence, convergence, transitions, inequality, regression and multiscale geographically weighted regression.

!pip install -q geo4bolivia
import geo4bolivia as geo

geo.lisa("sdg", "index_sdg", year=2024)     # where are the clusters of sustainable development?

Local Moran statistics (LISA) locate where Sustainable Development Index, IDS (0-100) in 2024 clusters or stands out, under queen contiguity (1 island(s) attached to nearest neighbor), row-standardized, n=343. The accompanying global Moran’s I is 0.468 (pseudo p = 0.001), consistent with overall clustering of similar values.

At the 0.05 significance level, 116 of 343 units show significant local association: 60 High-High hot spots (high values surrounded by high neighbors) and 45 Low-Low cold spots (low surrounded by low) mark clustering, while 6 High-Low and 5 Low-High units are spatial outliers that break with their surroundings. The remaining 227 units are not significant — their local pattern is compatible with randomness.

LISA pseudo p-values are computed unit by unit without a multiple-testing adjustment, so treat borderline clusters cautiously and read the map as descriptive of where dependence concentrates.

These are associations, not causal effects. A causal reading needs a research design.

One package, three steps

Find and load

A catalog you can search, documentation for every dataset, and panels with one row per unit and year, with names, boundaries and labels.

datasets · search · info · load · describe · change · aggregate

Explore

A first look before any model: distributions, the highest and lowest units, correlations, trends, and maps in classes you can compare across years.

distribution · extremes · correlation · scatter · trend · map

Analyze

The fundamental analyses of regional data, with the boundaries and spatial weights found for you and a reading of every result in words.

moran · lisa · beta_convergence · rank_mobility · inequality · spatial_model · mgwr

What you can do with it

You want to know Functions Article
What data are there, and what do they mean? datasets, search, info, dictionary, reference_years, cite The data model
What does a variable look like? describe, distribution, extremes, correlation, scatter, trend Exploring the data
Is it clustered in space, and where? map, weights, connectivity, moran, lisa Maps and spatial dependence
Are the units that started lower catching up? beta_convergence, sigma_convergence, convergence_clubs Convergence
Who moved up or down, and do neighbours matter? rank_mobility, lisa_transitions, transitions, spatial_transitions Transitions and mobility
How unequal are the units, and between or within which groups? inequality, theil_decomposition Regional inequality
What goes with what, once space is accounted for? regression, panel_model, spatial_diagnostics, spatial_model Regression, panel and spatial models
Does an association change from place to place? mgwr Spatial heterogeneity: MGWR
How do I bring my own table or raster? link, check, zonal, aggregate, combine, overlay, save Building your own indicators

Every analysis function takes a dataset id or a table with a geo_id column, finds the boundaries, the spatial weights and the labels itself, and returns a result object: .fig (an interactive Plotly figure), .df (the table behind it), .gt (a formatted table where one helps), the numbers by name, and .interpret(), a reading in words that describes associations and never claims causes.

Articles

An Altiplano town at dawn with a school with a solar roof, a water tower and street lamps, quinoa fields in front

Case study: the Sustainable Development Index, ~2012 to ~2024

One complete analysis with geo4bolivia: how the Sustainable Development Index of Bolivia’s 343 municipalities changed between two periods, which goals moved, whether…

Agricultural terraces on Isla del Sol at dusk, nested in levels edged with turquoise light, above Lake Titicaca

The data model: scales, geo IDs, datasets and metadata

How the observatory’s data are organised (spatial scales, geo IDs, panels and metadata) and how the package reads them.

Rolls of Andean aguayo textiles of different heights standing side by side like the bars of a chart

Exploring the data

A question-driven exploration of multidimensional poverty in Bolivia’s municipalities, and the pitfalls of these data that a newcomer should know.

The Altiplano at night with village lights gathered in a rose cluster and a turquoise cluster, a volcano behind

Maps and spatial dependence

From a map to a test: classed maps, spatial weights, global Moran’s I and LISA clusters of multidimensional poverty in Bolivia’s municipalities, and how far the conclusions…

Meandering rose and turquoise rivers of the Bolivian lowlands joining into one wide river at dawn

Convergence: β, σ and clubs

Three questions about catching up, and the method for each: do units that start lower grow faster, is dispersion falling, and do units head for one path or for several?

Cable-car cabins lit rose and turquoise gliding over La Paz at dusk, with Illimani behind

Transitions and mobility

How units move inside a distribution: changes of rank between two years, moves between spatial cluster types, and Markov transition matrices with and without the neighbours.

La Paz at night from the rim of El Alto: a bright dense core of lights and dim, sparse lights on the slopes

Regional inequality

How unequal Bolivia’s municipalities are, whether that is changing, and whether the inequality lies between departments or inside them: Gini, Theil, the Lorenz curve and…

A straight turquoise line drawn through the stars above the Cordillera Real, beside a small observatory dome

Regression, panel and spatial models

Three kinds of regression model for subnational data, what each one compares and when it is the right tool: least squares with fixed effects and clustered errors, panel…

A panorama from the Andes to the lowlands whose light shifts from rose over the highlands to turquoise over the cloud forest

Spatial heterogeneity: MGWR

Multiscale geographically weighted regression asks whether an association differs from place to place and at what spatial scale it operates: how to run it with geo.mgwr and…

An Andean loom with threads in turquoise, rose and sand joining into one woven pattern

Building your own indicators

From a table or a raster of your own to an analysis: link it to the geo IDs, compute zonal statistics, move it across scales, save it and analyse it.

No matching items

The data

The package reads the observatory’s published files from quarcs-lab/gdo4bolivia: nothing to download by hand, and a release tag (ref="v0.7.0") freezes them for reproducible work.

Dataset What Units and years
sdg, sdg01 to sdg17 Atlas de los ODS en Bolivia 2026 (Andersen & Argandoña, SDSN Bolivia): the Sustainable Development Index, 15 goal indices and 81 indicators 343 municipalities, about 2012 and about 2024
pop Population (WorldPop) and population density 333 municipalities, 2001 to 2020
ntl Night-time lights per capita (VIIRS) 333 municipalities, 2012 to 2020
emb, embpw Satellite embeddings, 64 dimensions 333 municipalities, 2017

The boundaries are SDSN Bolivia’s municipal map of 2025, used with its permission. geo.info(dataset) gives each dataset’s sources and licenses, and geo.cite(dataset) the citation and the credits they require.

Sister packages

geo4bolivia covers the fundamentals. Two sister packages go further, and geo.for_expdpy() and geo.for_geometrics() hand any panel over to them:

  • expdpy: panel exploration and econometrics (instrumental variables, event studies, correlated random effects).
  • geometrics: regional convergence and spatial econometrics with teaching sandboxes; geo4bolivia’s analysis engine is ported from it.

Cite

Mendez, C. (2026). geo4bolivia: spatial data science for Bolivia’s subnational development data (version 0.7.0). https://quarcs-lab.github.io/geo4bolivia/

Please also cite the sources of the datasets you use: print(geo.cite("sdg")).

geo4bolivia · code MIT · part of the GeoDevelopment Observatory of Bolivia

 
  • Report an issue
  • Edit this page

Built with Quarto and quartodoc