geo4bolivia 0.1.0__tar.gz

geo4bolivia-0.1.0/.gitignore

@@ -0,0 +1,30 @@
+# R
+.Rproj.user
+.Rhistory
+.RData
+.Ruserdata
+
+# Python
+__pycache__/
+*.py[cod]
+*.egg-info/
+/dist/
+.pytest_cache/
+/build/
+
+# Virtual environment (UV)
+.venv/
+
+# Jupyter
+.ipynb_checkpoints/
+
+# OS
+.DS_Store
+
+# Reference clones used to start this project (never committed)
+/geo4cambodia/
+/ds4bolivia/
+
+# Files written by running the notebooks
+/notebooks/my_data/
+/notebooks/*.tif

geo4bolivia-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Carlos Mendez
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

geo4bolivia-0.1.0/PKG-INFO

@@ -0,0 +1,164 @@
+Metadata-Version: 2.5
+Name: geo4bolivia
+Version: 0.1.0
+Summary: Subnational development data for Bolivia across spatial scales (GeoDevelopment Observatory of Bolivia)
+Project-URL: Homepage, https://quarcs-lab.github.io/geo4bolivia/
+Project-URL: Documentation, https://github.com/quarcs-lab/geo4bolivia/blob/main/docs/data-infrastructure.md
+Project-URL: Repository, https://github.com/quarcs-lab/geo4bolivia
+Project-URL: Issues, https://github.com/quarcs-lab/geo4bolivia/issues
+Author: Carlos Mendez
+License: MIT
+License-File: LICENSE
+Keywords: bolivia,gadm,geospatial,municipalities,panel data,regional development,remote sensing,sdgs,subnational data
+Classifier: Intended Audience :: Science/Research
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: Scientific/Engineering :: GIS
+Requires-Python: >=3.11
+Requires-Dist: geopandas>=0.14
+Requires-Dist: numpy>=1.24
+Requires-Dist: pandas>=2.0
+Requires-Dist: pyarrow>=15
+Requires-Dist: pyyaml>=6.0
+Requires-Dist: requests>=2.31
+Provides-Extra: raster
+Requires-Dist: rasterio>=1.3; extra == 'raster'
+Description-Content-Type: text/markdown
+
+# geo4bolivia
+
+**Subnational development data for Bolivia, ready to analyse, at every spatial scale.**
+
+`geo4bolivia` is the Python package of the [GeoDevelopment Observatory of Bolivia](https://quarcs-lab.github.io/geo4bolivia/). It loads the observatory's indicators for Bolivia's 339 municipalities (population, night-time lights, 64 indicators of the Municipal Atlas of the SDGs, satellite embeddings...) as tidy panels, with boundaries for every scale. It also lets you **build your own indicators**: link your tables to the same unit IDs, summarise rasters over units, move data across scales and combine datasets. It works out of the box in Google Colab: every example below runs in a new Colab notebook (replace the placeholder files, such as your own table or raster, with yours).
+
+```python
+!pip install -q geo4bolivia mapclassify             # mapclassify: for scheme="quantiles"
+import geo4bolivia as geo
+
+geo.datasets()                                       # what is available, at which scale and years
+gdf = geo.load("sdg", variables="sdg1_2_mpi", years=2012, geometry=True)   # 339 municipalities
+gdf.plot(column="sdg1_2_mpi", scheme="quantiles", k=5, legend=True)
+```
+
+[![Open in Colab](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/notebooks/empty.ipynb)
+
+## What it does
+
+| Task | Functions |
+| --- | --- |
+| **Load** panels (one row per unit and year), names and boundaries | `datasets`, `dictionary`, `load`, `units`, `boundaries`, `crosswalk` |
+| **Link** your own tables by unit names or codes (INE, DS4Bolivia), whatever the spelling | `link`, `check` |
+| **Extract** indicators from rasters (Earth Engine exports, WorldPop, ...) | `zonal` |
+| **Move** data up the hierarchy or onto grids and custom zones | `aggregate`, `overlay`, `overlay_weights` |
+| **Combine** datasets at one scale and **save** new ones in the same format | `combine`, `save` |
+| **Analyse** with [expdpy](https://cmg777.github.io/expdpy/) (panel exploration, fixed and random effects) and [geometrics](https://quarcs-lab.github.io/geometrics/) (convergence, spatial dependence, inequality) | `for_expdpy`, `for_geometrics` |
+
+## One ID for every unit, at every scale
+
+Every unit has a **geo ID** that nests by prefix (GADM 4.1 hierarchy): municipality `BO-04-17-04` (La Paz) lies in province `BO-04-17` (Murillo), which lies in department `BO-04` (La Paz), which lies in Bolivia `BO`. INE codes and DS4Bolivia's `asdf_id` are kept as columns of `geo.units()`. Each dataset is a long panel keyed by `geo_id` and `year`.
+
+| Scale | Units | Example |
+| --- | --- | --- |
+| `country` | 1 | `BO` |
+| `department` | 9 | `BO-04` |
+| `province` | 112 | `BO-04-17` |
+| `municipality` | 339 | `BO-04-17-04` |
+
+## Build your own indicator in five lines
+
+```python
+!pip install -q geo4bolivia
+import pandas as pd
+import geo4bolivia as geo
+
+mine = pd.read_csv("schools_by_municipality.csv")                 # e.g. columns mun_id (INE code), year, schools
+mine = geo.link(mine, scale="municipality", on="mun_id", key="mun_id")   # 20101 -> BO-04-17-04
+panel = geo.combine(["pop"], scale="municipality", extra=[mine])
+panel["schools_per_10k"] = panel["schools"] / panel["pop"] * 1e4
+geo.save(panel, "schools", scale="municipality", directory="my_data")
+```
+
+[![Open in Colab](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/notebooks/empty.ipynb)
+
+From a raster:
+
+```python
+!pip install -q "geo4bolivia[raster]"             # [raster] adds rasterio
+import geo4bolivia as geo
+
+lights = geo.zonal("viirs_2020.tif", scale="municipality", stats=["sum", "mean"], name="ntl", year=2020)
+```
+
+[![Open in Colab](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/notebooks/empty.ipynb)
+
+Then explore and model the panel with expdpy:
+
+```python
+!pip install -q geo4bolivia expdpy
+import numpy as np
+import geo4bolivia as geo
+import expdpy as ex
+
+panel = geo.combine(["ntl", "pop"], scale="municipality", years=(2012, 2020))
+panel["ln_pop"] = np.log(panel["pop"])
+df, df_def = geo.for_expdpy(panel, labels={"ln_pop": "Log of population"})
+df = ex.set_labels(df, df_def, set_panel=True)
+ex.analyze_panel_table(df, "ln_NTLpc", ["ln_pop"])        # pooled, between, fixed and random effects
+```
+
+[![Open in Colab](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/notebooks/empty.ipynb)
+
+Or analyse it spatially with geometrics:
+
+```python
+!pip install -q geo4bolivia geometrics
+import numpy as np
+import geo4bolivia as geo
+import geometrics as gm
+
+ntl = geo.load("ntl")
+ntl["NTLpc"] = np.exp(ntl["ln_NTLpc"])
+gdf, df, df_dict = geo.for_geometrics(ntl, labels={"NTLpc": "Night-time lights per capita"})
+df = gm.set_labels(df, df_dict, set_panel=True)
+gm.analyze_beta_convergence(df, "NTLpc", gdf=gdf, w=gm.make_weights(gdf)).interpret()   # levels: logged internally
+```
+
+[![Open in Colab](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/notebooks/empty.ipynb)
+
+## Without the package
+
+Every file is also a plain URL, readable with pandas alone (preinstalled in Colab, so nothing to install):
+
+```python
+import pandas as pd
+df = pd.read_csv("https://raw.githubusercontent.com/quarcs-lab/geo4bolivia/main/data/municipality/ntl.csv")
+```
+
+[![Open in Colab](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/notebooks/empty.ipynb)
+
+## Installation
+
+In a Google Colab cell:
+
+```python
+!pip install -q geo4bolivia                     # core: pandas, numpy, geopandas, pyarrow, requests, pyyaml (Colab has them)
+!pip install -q "geo4bolivia[raster]"           # + rasterio, for zonal()
+!pip install -q git+https://github.com/quarcs-lab/geo4bolivia   # development version
+```
+
+[![Open in Colab](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/notebooks/empty.ipynb)
+
+Python 3.11 or later. The data are not inside the package. It reads them from the [GitHub repository](https://github.com/quarcs-lab/geo4bolivia), so installation is quick and you always get the files the website links to. For reproducible research, pin a release of the data with `geo.load(..., ref="v0.1.0")` or the environment variable `GEO4BOLIVIA_REF=v0.1.0`.
+
+## Documentation
+
+- [How the data infrastructure works](https://github.com/quarcs-lab/geo4bolivia/blob/main/docs/data-infrastructure.md): scales, IDs, metadata, aggregation rules, and recipes for building indicators
+- [Dataset pages](https://github.com/quarcs-lab/geo4bolivia/tree/main/docs/datasets): variable dictionaries, coverage, sources and citations
+- [Website](https://quarcs-lab.github.io/geo4bolivia/): indicators, notebooks, web apps and insights
+
+## Citation
+
+Mendez, C. (2026). *GeoDevelopment Observatory of Bolivia*. https://quarcs-lab.github.io/geo4bolivia/
+
+MIT License. Original data sources are credited on each dataset page.

geo4bolivia-0.1.0/docs/python-package.md

@@ -0,0 +1,136 @@
+# geo4bolivia
+
+**Subnational development data for Bolivia, ready to analyse, at every spatial scale.**
+
+`geo4bolivia` is the Python package of the [GeoDevelopment Observatory of Bolivia](https://quarcs-lab.github.io/geo4bolivia/). It loads the observatory's indicators for Bolivia's 339 municipalities (population, night-time lights, 64 indicators of the Municipal Atlas of the SDGs, satellite embeddings...) as tidy panels, with boundaries for every scale. It also lets you **build your own indicators**: link your tables to the same unit IDs, summarise rasters over units, move data across scales and combine datasets. It works out of the box in Google Colab: every example below runs in a new Colab notebook (replace the placeholder files, such as your own table or raster, with yours).
+
+```python
+!pip install -q geo4bolivia mapclassify             # mapclassify: for scheme="quantiles"
+import geo4bolivia as geo
+
+geo.datasets()                                       # what is available, at which scale and years
+gdf = geo.load("sdg", variables="sdg1_2_mpi", years=2012, geometry=True)   # 339 municipalities
+gdf.plot(column="sdg1_2_mpi", scheme="quantiles", k=5, legend=True)
+```
+
+[![Open in Colab](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/notebooks/empty.ipynb)
+
+## What it does
+
+| Task | Functions |
+| --- | --- |
+| **Load** panels (one row per unit and year), names and boundaries | `datasets`, `dictionary`, `load`, `units`, `boundaries`, `crosswalk` |
+| **Link** your own tables by unit names or codes (INE, DS4Bolivia), whatever the spelling | `link`, `check` |
+| **Extract** indicators from rasters (Earth Engine exports, WorldPop, ...) | `zonal` |
+| **Move** data up the hierarchy or onto grids and custom zones | `aggregate`, `overlay`, `overlay_weights` |
+| **Combine** datasets at one scale and **save** new ones in the same format | `combine`, `save` |
+| **Analyse** with [expdpy](https://cmg777.github.io/expdpy/) (panel exploration, fixed and random effects) and [geometrics](https://quarcs-lab.github.io/geometrics/) (convergence, spatial dependence, inequality) | `for_expdpy`, `for_geometrics` |
+
+## One ID for every unit, at every scale
+
+Every unit has a **geo ID** that nests by prefix (GADM 4.1 hierarchy): municipality `BO-04-17-04` (La Paz) lies in province `BO-04-17` (Murillo), which lies in department `BO-04` (La Paz), which lies in Bolivia `BO`. INE codes and DS4Bolivia's `asdf_id` are kept as columns of `geo.units()`. Each dataset is a long panel keyed by `geo_id` and `year`.
+
+| Scale | Units | Example |
+| --- | --- | --- |
+| `country` | 1 | `BO` |
+| `department` | 9 | `BO-04` |
+| `province` | 112 | `BO-04-17` |
+| `municipality` | 339 | `BO-04-17-04` |
+
+## Build your own indicator in five lines
+
+```python
+!pip install -q geo4bolivia
+import pandas as pd
+import geo4bolivia as geo
+
+mine = pd.read_csv("schools_by_municipality.csv")                 # e.g. columns mun_id (INE code), year, schools
+mine = geo.link(mine, scale="municipality", on="mun_id", key="mun_id")   # 20101 -> BO-04-17-04
+panel = geo.combine(["pop"], scale="municipality", extra=[mine])
+panel["schools_per_10k"] = panel["schools"] / panel["pop"] * 1e4
+geo.save(panel, "schools", scale="municipality", directory="my_data")
+```
+
+[![Open in Colab](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/notebooks/empty.ipynb)
+
+From a raster:
+
+```python
+!pip install -q "geo4bolivia[raster]"             # [raster] adds rasterio
+import geo4bolivia as geo
+
+lights = geo.zonal("viirs_2020.tif", scale="municipality", stats=["sum", "mean"], name="ntl", year=2020)
+```
+
+[![Open in Colab](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/notebooks/empty.ipynb)
+
+Then explore and model the panel with expdpy:
+
+```python
+!pip install -q geo4bolivia expdpy
+import numpy as np
+import geo4bolivia as geo
+import expdpy as ex
+
+panel = geo.combine(["ntl", "pop"], scale="municipality", years=(2012, 2020))
+panel["ln_pop"] = np.log(panel["pop"])
+df, df_def = geo.for_expdpy(panel, labels={"ln_pop": "Log of population"})
+df = ex.set_labels(df, df_def, set_panel=True)
+ex.analyze_panel_table(df, "ln_NTLpc", ["ln_pop"])        # pooled, between, fixed and random effects
+```
+
+[![Open in Colab](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/notebooks/empty.ipynb)
+
+Or analyse it spatially with geometrics:
+
+```python
+!pip install -q geo4bolivia geometrics
+import numpy as np
+import geo4bolivia as geo
+import geometrics as gm
+
+ntl = geo.load("ntl")
+ntl["NTLpc"] = np.exp(ntl["ln_NTLpc"])
+gdf, df, df_dict = geo.for_geometrics(ntl, labels={"NTLpc": "Night-time lights per capita"})
+df = gm.set_labels(df, df_dict, set_panel=True)
+gm.analyze_beta_convergence(df, "NTLpc", gdf=gdf, w=gm.make_weights(gdf)).interpret()   # levels: logged internally
+```
+
+[![Open in Colab](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/notebooks/empty.ipynb)
+
+## Without the package
+
+Every file is also a plain URL, readable with pandas alone (preinstalled in Colab, so nothing to install):
+
+```python
+import pandas as pd
+df = pd.read_csv("https://raw.githubusercontent.com/quarcs-lab/geo4bolivia/main/data/municipality/ntl.csv")
+```
+
+[![Open in Colab](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/notebooks/empty.ipynb)
+
+## Installation
+
+In a Google Colab cell:
+
+```python
+!pip install -q geo4bolivia                     # core: pandas, numpy, geopandas, pyarrow, requests, pyyaml (Colab has them)
+!pip install -q "geo4bolivia[raster]"           # + rasterio, for zonal()
+!pip install -q git+https://github.com/quarcs-lab/geo4bolivia   # development version
+```
+
+[![Open in Colab](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/notebooks/empty.ipynb)
+
+Python 3.11 or later. The data are not inside the package. It reads them from the [GitHub repository](https://github.com/quarcs-lab/geo4bolivia), so installation is quick and you always get the files the website links to. For reproducible research, pin a release of the data with `geo.load(..., ref="v0.1.0")` or the environment variable `GEO4BOLIVIA_REF=v0.1.0`.
+
+## Documentation
+
+- [How the data infrastructure works](https://github.com/quarcs-lab/geo4bolivia/blob/main/docs/data-infrastructure.md): scales, IDs, metadata, aggregation rules, and recipes for building indicators
+- [Dataset pages](https://github.com/quarcs-lab/geo4bolivia/tree/main/docs/datasets): variable dictionaries, coverage, sources and citations
+- [Website](https://quarcs-lab.github.io/geo4bolivia/): indicators, notebooks, web apps and insights
+
+## Citation
+
+Mendez, C. (2026). *GeoDevelopment Observatory of Bolivia*. https://quarcs-lab.github.io/geo4bolivia/
+
+MIT License. Original data sources are credited on each dataset page.

geo4bolivia-0.1.0/project.yaml

@@ -0,0 +1,28 @@
+# Project identity. See TEMPLATE.md and docs/data-infrastructure.md.
+# Everything generic in the package reads its settings from here.
+
+name: GeoDevelopment Observatory of Bolivia
+short_name: GDO-Bolivia
+
+# Python package (import name), CLI command and prefix of the environment
+# variables (GEO4BOLIVIA_DATA_DIR, GEO4BOLIVIA_BASE_URL, GEO4BOLIVIA_REF).
+package: geo4bolivia
+
+# GitHub repository holding the published files, and the git ref an installed
+# package reads from by default (a release tag freezes the data).
+repository: quarcs-lab/geo4bolivia
+default_ref: main
+
+website: https://quarcs-lab.github.io/geo4bolivia/
+
+country:
+  name: Bolivia
+  iso2: BO     # prefix of every geo_id
+  iso3: BOL    # GADM country code (GID_0)
+
+# Equal-area projection for areas, crosswalk weights and overlays.
+# An Albers equal-area projection fitted to Bolivia (standard parallels 11°S and 21°S).
+equal_area_crs: "+proj=aea +lat_0=-16.5 +lon_0=-64.5 +lat_1=-11 +lat_2=-21 +datum=WGS84 +units=m +no_defs"
+
+# Generated table listing every variable of every dataset.
+catalog: definitions_gdo-bolivia.csv

geo4bolivia-0.1.0/pyproject.toml

@@ -0,0 +1,98 @@
+[project]
+name = "geo4bolivia"
+version = "0.1.0"
+description = "Subnational development data for Bolivia across spatial scales (GeoDevelopment Observatory of Bolivia)"
+readme = "docs/python-package.md"
+license = {text = "MIT"}
+requires-python = ">=3.11"
+authors = [
+    {name = "Carlos Mendez"},
+]
+
+dependencies = [
+    # Kept small so `pip install geo4bolivia` is quick: Google Colab already has all of these
+    "pandas>=2.0",
+    "numpy>=1.24",
+    "requests>=2.31",
+    "geopandas>=0.14",
+    "pyarrow>=15",
+    "pyyaml>=6.0",
+]
+
+keywords = ["bolivia", "geospatial", "regional development", "subnational data", "panel data", "gadm", "municipalities", "sdgs", "remote sensing"]
+classifiers = [
+    "Programming Language :: Python :: 3",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: OS Independent",
+    "Intended Audience :: Science/Research",
+    "Topic :: Scientific/Engineering :: GIS",
+]
+
+[project.optional-dependencies]
+raster = ["rasterio>=1.3"]   # geo4bolivia.zonal(): summarise rasters (GeoTIFF) over units
+
+[project.scripts]
+geo4bolivia = "geo4bolivia.cli:main"
+
+[project.urls]
+Homepage = "https://quarcs-lab.github.io/geo4bolivia/"
+Documentation = "https://github.com/quarcs-lab/geo4bolivia/blob/main/docs/data-infrastructure.md"
+Repository = "https://github.com/quarcs-lab/geo4bolivia"
+Issues = "https://github.com/quarcs-lab/geo4bolivia/issues"
+
+[dependency-groups]
+analysis = [
+    # Visualization
+    "matplotlib>=3.7",
+    "seaborn>=0.12",
+    "plotly>=5.15",
+    "folium>=0.12",            # interactive maps (GeoDataFrame.explore), as in Colab
+    # Spatial analysis
+    "contextily>=1.4",
+    "rasterio>=1.3",
+    "libpysal>=4.9",
+    "mapclassify>=2.6",
+    "esda>=2.5",
+    "splot>=1.1",
+    "mgwr>=2.2",
+    "inequality>=1.0",
+    # Econometrics and machine learning
+    "statsmodels>=0.14",
+    "scikit-learn>=1.3",
+    "xgboost>=2.0",
+    # Jupyter
+    "jupyter>=1.0",
+    "notebook>=7.0",
+    "jupytext>=1.19.1",
+    "geometrics>=0.1.3",
+    "expdpy>=0.5.2",
+]
+dev = [
+    "pytest>=8.0",
+]
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/geo4bolivia"]
+
+# Ship project.yaml inside the package, so an installed copy knows its repository
+[tool.hatch.build.targets.wheel.force-include]
+"project.yaml" = "geo4bolivia/project.yaml"
+
+# The source distribution holds the code only; data are read from GitHub
+[tool.hatch.build.targets.sdist]
+only-include = ["src", "project.yaml", "pyproject.toml", "docs/python-package.md", "LICENSE"]
+
+[tool.uv]
+package = true
+default-groups = ["analysis", "dev"]
+constraint-dependencies = [
+    "numba>=0.60,<0.62",
+    "llvmlite>=0.44,<0.45",
+]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]

geo4bolivia-0.1.0/src/geo4bolivia/__init__.py

@@ -0,0 +1,26 @@
+"""Load, link, aggregate and create geo-referenced development data across spatial scales.
+
+>>> import geo4bolivia as geo
+>>> geo.datasets()                               # what is available, at which scales and years
+>>> df = geo.load("ntl")                         # panel: geo_id, year, variables
+>>> gdf = geo.load("pop", geometry=True)         # with boundaries
+>>> geo.aggregate(geo.load("pop"), to="department", dataset="pop")   # up the hierarchy
+>>> mine = geo.link(my_table, scale="municipality", on="mun_id", key="mun_id")  # your data -> geo_id
+>>> geo.combine(["ntl", "pop"], scale="municipality", extra=[mine])  # one panel, one scale
+>>> gdf, df, df_dict = geo.for_geometrics("ntl")                     # ready for the geometrics package
+>>> df, df_def = geo.for_expdpy("ntl", groups=["department"])        # ready for the expdpy package
+
+See docs/data-infrastructure.md in the repository for the full guide.
+"""
+
+from .aggregate import aggregate, overlay, overlay_weights
+from .bridge import for_expdpy, for_geometrics
+from .create import check, combine, link, save, zonal
+from .io import boundaries, crosswalk, datasets, dictionary, load, units
+from .project import PACKAGE, config
+from .scales import ancestors, scale_of
+from .scales import table as scales
+
+__all__ = ["aggregate", "ancestors", "boundaries", "check", "combine", "config", "crosswalk", "datasets", "dictionary",
+           "for_expdpy", "for_geometrics", "link", "load", "overlay", "overlay_weights", "save", "scale_of", "scales", "units", "zonal"]
+__version__ = "0.1.0"