geometrics 0.1.0__tar.gz

geometrics-0.1.0/.gitignore

@@ -0,0 +1,29 @@
+# Python
+__pycache__/
+*.py[cod]
+*.egg-info/
+dist/
+build/
+.venv/
+.python-version.local
+
+# Tooling caches
+.pytest_cache/
+.ruff_cache/
+.mypy_cache/
+.coverage
+coverage.xml
+htmlcov/
+
+# Quarto (keep committed _freeze execution results; ignore rendered site)
+docs/_site/
+docs/.quarto/
+docs/reference/
+!docs/reference/_sidebar.yml
+/.quarto/
+
+# Jupyter
+.ipynb_checkpoints/
+
+# OS
+.DS_Store

geometrics-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.

geometrics-0.1.0/PKG-INFO

@@ -0,0 +1,159 @@
+Metadata-Version: 2.4
+Name: geometrics
+Version: 0.1.0
+Summary: Regional growth, convergence, and inequality analysis on the PySAL stack.
+Project-URL: Homepage, https://github.com/quarcs-lab/geometrics
+Project-URL: Documentation, https://quarcs-lab.github.io/geometrics/
+Project-URL: Repository, https://github.com/quarcs-lab/geometrics
+Project-URL: Issues, https://github.com/quarcs-lab/geometrics/issues
+Author: Carlos Mendez
+License: MIT
+License-File: LICENSE
+Keywords: convergence,geopandas,inequality,plotly,pysal,regional science,spatial analysis,spatial econometrics
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Science/Research
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Scientific/Engineering
+Classifier: Topic :: Scientific/Engineering :: GIS
+Requires-Python: >=3.11
+Requires-Dist: esda>=2.5
+Requires-Dist: geopandas>=1.0
+Requires-Dist: great-tables>=0.16
+Requires-Dist: inequality>=1.0
+Requires-Dist: libpysal>=4.9
+Requires-Dist: mapclassify>=2.6
+Requires-Dist: mgwr>=2.2
+Requires-Dist: numpy>=1.26
+Requires-Dist: pandas>=2.1
+Requires-Dist: plotly>=5.24
+Requires-Dist: pooch>=1.8
+Requires-Dist: scipy>=1.11
+Requires-Dist: spreg>=1.8
+Requires-Dist: statsmodels>=0.14
+Provides-Extra: all
+Requires-Dist: giddy>=2.3; extra == 'all'
+Requires-Dist: kaleido>=1.0; extra == 'all'
+Provides-Extra: dynamics
+Requires-Dist: giddy>=2.3; extra == 'dynamics'
+Provides-Extra: png
+Requires-Dist: kaleido>=1.0; extra == 'png'
+Description-Content-Type: text/markdown
+
+# geometrics
+
+[![CI](https://github.com/quarcs-lab/geometrics/actions/workflows/ci.yml/badge.svg)](https://github.com/quarcs-lab/geometrics/actions/workflows/ci.yml)
+[![Docs](https://img.shields.io/badge/docs-quarcs--lab.github.io%2Fgeometrics-blue)](https://quarcs-lab.github.io/geometrics/)
+[![PyPI](https://img.shields.io/pypi/v/geometrics.svg)](https://pypi.org/project/geometrics/)
+[![Python](https://img.shields.io/badge/python-3.11%2B-blue)](https://pypi.org/project/geometrics/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
+[![Ruff](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json)](https://github.com/astral-sh/ruff)
+[![Open In Colab](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/github/quarcs-lab/geometrics/blob/main/notebooks/quickstart.ipynb)
+
+**geometrics** studies **regional growth, convergence, and inequality** with explicit
+spatial methods. It builds on the excellent [PySAL](https://pysal.org) family —
+[libpysal](https://pysal.org/libpysal/), [esda](https://pysal.org/esda/),
+[giddy](https://pysal.org/giddy/), [inequality](https://pysal.org/inequality/),
+[mapclassify](https://pysal.org/mapclassify/), [spreg](https://pysal.org/spreg/), and
+[mgwr](https://mgwr.readthedocs.io/) — and wraps the standard analyses of the regional
+convergence literature into illustrative, easy-to-apply functions that return
+interactive [Plotly](https://plotly.com/python/) figures,
+[Great Tables](https://posit-dev.github.io/great-tables/), and tidy DataFrames.
+
+It follows the design language of [expdpy](https://github.com/cmg777/expdpy): every
+function returns a typed result object with `.df`, `.fig`, plain-language
+`.interpret()`, and concept `.explain()`.
+
+## The data model: three inputs
+
+| Input | What it is | How it enters |
+|---|---|---|
+| `gdf` | Geometry with **only the entity ID** — shapefile, zipped shapefile, GeoJSON, or GeoPackage (or a GeoDataFrame) | `gm.read_gdf("districts.gpkg", entity="district_id")` |
+| `df` | A **long-form panel** — one row per (entity, time) | `gm.set_panel(df, entity="district_id", time="year")` |
+| `df_dict` | A **data dictionary** — `var_name, var_def, label, type, role, can_be_na` | `gm.set_labels(df, df_dict, set_panel=True)` |
+
+## Installation
+
+```bash
+pip install geometrics                 # core
+pip install "geometrics[dynamics]"     # + Markov / spatial Markov (giddy)
+pip install "geometrics[all]"          # everything, incl. PNG export
+```
+
+## Quickstart: the Indian case study
+
+The bundled case study covers 520 Indian districts observed by satellite nighttime
+lights (1996-2010), from
+[Mendez, Kabiraj & Li (quarcs-lab/project2025s-py)](https://github.com/quarcs-lab/project2025s-py).
+
+```python
+import geometrics as gm
+
+gdf, df, df_dict = gm.data.load_india()      # ID-only geometry, long panel, dictionary
+df = gm.set_labels(df, df_dict, set_panel=True)
+
+gm.explore_choropleth_map(df, "ntl_total", gdf=gdf, period=2010).fig
+w = gm.make_weights(gdf, method="knn", k=6)
+gm.explore_lisa_cluster_map(df, "log_ntl_pc_1996", gdf=gdf, w=w).fig
+
+res = gm.analyze_beta_convergence(
+    df, "ntl_total", model="sdm", gdf=gdf, w=w
+)
+print(res.interpret())                       # plain-language reading
+res.fig                                      # convergence scatter
+```
+
+## Features
+
+- **Maps & ESDA** — classified/animated choropleths (`explore_choropleth_map`), weights
+  connectivity (`explore_connectivity_map`), Moran scatterplots, LISA cluster maps,
+  Moran over time
+- **Space-time dynamics** — cross-sectional distribution evolution
+  (`explore_distribution_over_time`), entity-by-time heatmaps
+- **Convergence** — β-convergence with OLS or spatial (SAR/SEM/SLX/SDM) estimators and
+  LeSage-Pace impact decomposition, σ-convergence, Phillips-Sul convergence clubs with
+  club maps
+- **Spatial econometrics** — the spreg suite (`analyze_spatial_model`), LM diagnostics
+  with a model recommendation (`analyze_spatial_diagnostics`), alternative-weights
+  robustness (`analyze_spatial_model_by_weights`)
+- **Distribution dynamics** — Markov and spatial Markov transition analysis
+  (`analyze_markov_transitions`, `analyze_spatial_markov`)
+- **Inequality** — Gini/Theil trends with spatial decomposition
+  (`analyze_inequality_over_time`), Theil between/within decomposition
+  (`analyze_theil_decomposition`)
+- **Local models** — GWR and multiscale GWR with mapped local coefficients
+  (`analyze_gwr`, `analyze_mgwr`)
+
+## Documentation
+
+- Website: https://quarcs-lab.github.io/geometrics/
+- The India case study article and Colab notebooks: see `docs/` and `notebooks/`
+
+## Development
+
+```bash
+git clone https://github.com/quarcs-lab/geometrics
+cd geometrics
+uv sync --locked --all-extras --group dev --group docs
+make test && make lint && make typecheck
+```
+
+## Citation
+
+If you use geometrics in your research, please cite the repository (see
+`CITATION.cff`) and the underlying PySAL packages.
+
+## Acknowledgments
+
+Developed at the [QuaRCS Lab](https://quarcs-lab.org) (Quantitative Regional and
+Computational Science). geometrics stands on the shoulders of the
+[PySAL](https://pysal.org) project, [geopandas](https://geopandas.org),
+[Plotly](https://plotly.com/python/), and
+[Great Tables](https://posit-dev.github.io/great-tables/).
+
+## License
+
+MIT

geometrics-0.1.0/README.md

@@ -0,0 +1,114 @@
+# geometrics
+
+[![CI](https://github.com/quarcs-lab/geometrics/actions/workflows/ci.yml/badge.svg)](https://github.com/quarcs-lab/geometrics/actions/workflows/ci.yml)
+[![Docs](https://img.shields.io/badge/docs-quarcs--lab.github.io%2Fgeometrics-blue)](https://quarcs-lab.github.io/geometrics/)
+[![PyPI](https://img.shields.io/pypi/v/geometrics.svg)](https://pypi.org/project/geometrics/)
+[![Python](https://img.shields.io/badge/python-3.11%2B-blue)](https://pypi.org/project/geometrics/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
+[![Ruff](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json)](https://github.com/astral-sh/ruff)
+[![Open In Colab](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/github/quarcs-lab/geometrics/blob/main/notebooks/quickstart.ipynb)
+
+**geometrics** studies **regional growth, convergence, and inequality** with explicit
+spatial methods. It builds on the excellent [PySAL](https://pysal.org) family —
+[libpysal](https://pysal.org/libpysal/), [esda](https://pysal.org/esda/),
+[giddy](https://pysal.org/giddy/), [inequality](https://pysal.org/inequality/),
+[mapclassify](https://pysal.org/mapclassify/), [spreg](https://pysal.org/spreg/), and
+[mgwr](https://mgwr.readthedocs.io/) — and wraps the standard analyses of the regional
+convergence literature into illustrative, easy-to-apply functions that return
+interactive [Plotly](https://plotly.com/python/) figures,
+[Great Tables](https://posit-dev.github.io/great-tables/), and tidy DataFrames.
+
+It follows the design language of [expdpy](https://github.com/cmg777/expdpy): every
+function returns a typed result object with `.df`, `.fig`, plain-language
+`.interpret()`, and concept `.explain()`.
+
+## The data model: three inputs
+
+| Input | What it is | How it enters |
+|---|---|---|
+| `gdf` | Geometry with **only the entity ID** — shapefile, zipped shapefile, GeoJSON, or GeoPackage (or a GeoDataFrame) | `gm.read_gdf("districts.gpkg", entity="district_id")` |
+| `df` | A **long-form panel** — one row per (entity, time) | `gm.set_panel(df, entity="district_id", time="year")` |
+| `df_dict` | A **data dictionary** — `var_name, var_def, label, type, role, can_be_na` | `gm.set_labels(df, df_dict, set_panel=True)` |
+
+## Installation
+
+```bash
+pip install geometrics                 # core
+pip install "geometrics[dynamics]"     # + Markov / spatial Markov (giddy)
+pip install "geometrics[all]"          # everything, incl. PNG export
+```
+
+## Quickstart: the Indian case study
+
+The bundled case study covers 520 Indian districts observed by satellite nighttime
+lights (1996-2010), from
+[Mendez, Kabiraj & Li (quarcs-lab/project2025s-py)](https://github.com/quarcs-lab/project2025s-py).
+
+```python
+import geometrics as gm
+
+gdf, df, df_dict = gm.data.load_india()      # ID-only geometry, long panel, dictionary
+df = gm.set_labels(df, df_dict, set_panel=True)
+
+gm.explore_choropleth_map(df, "ntl_total", gdf=gdf, period=2010).fig
+w = gm.make_weights(gdf, method="knn", k=6)
+gm.explore_lisa_cluster_map(df, "log_ntl_pc_1996", gdf=gdf, w=w).fig
+
+res = gm.analyze_beta_convergence(
+    df, "ntl_total", model="sdm", gdf=gdf, w=w
+)
+print(res.interpret())                       # plain-language reading
+res.fig                                      # convergence scatter
+```
+
+## Features
+
+- **Maps & ESDA** — classified/animated choropleths (`explore_choropleth_map`), weights
+  connectivity (`explore_connectivity_map`), Moran scatterplots, LISA cluster maps,
+  Moran over time
+- **Space-time dynamics** — cross-sectional distribution evolution
+  (`explore_distribution_over_time`), entity-by-time heatmaps
+- **Convergence** — β-convergence with OLS or spatial (SAR/SEM/SLX/SDM) estimators and
+  LeSage-Pace impact decomposition, σ-convergence, Phillips-Sul convergence clubs with
+  club maps
+- **Spatial econometrics** — the spreg suite (`analyze_spatial_model`), LM diagnostics
+  with a model recommendation (`analyze_spatial_diagnostics`), alternative-weights
+  robustness (`analyze_spatial_model_by_weights`)
+- **Distribution dynamics** — Markov and spatial Markov transition analysis
+  (`analyze_markov_transitions`, `analyze_spatial_markov`)
+- **Inequality** — Gini/Theil trends with spatial decomposition
+  (`analyze_inequality_over_time`), Theil between/within decomposition
+  (`analyze_theil_decomposition`)
+- **Local models** — GWR and multiscale GWR with mapped local coefficients
+  (`analyze_gwr`, `analyze_mgwr`)
+
+## Documentation
+
+- Website: https://quarcs-lab.github.io/geometrics/
+- The India case study article and Colab notebooks: see `docs/` and `notebooks/`
+
+## Development
+
+```bash
+git clone https://github.com/quarcs-lab/geometrics
+cd geometrics
+uv sync --locked --all-extras --group dev --group docs
+make test && make lint && make typecheck
+```
+
+## Citation
+
+If you use geometrics in your research, please cite the repository (see
+`CITATION.cff`) and the underlying PySAL packages.
+
+## Acknowledgments
+
+Developed at the [QuaRCS Lab](https://quarcs-lab.org) (Quantitative Regional and
+Computational Science). geometrics stands on the shoulders of the
+[PySAL](https://pysal.org) project, [geopandas](https://geopandas.org),
+[Plotly](https://plotly.com/python/), and
+[Great Tables](https://posit-dev.github.io/great-tables/).
+
+## License
+
+MIT

geometrics-0.1.0/pyproject.toml

@@ -0,0 +1,177 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "geometrics"
+version = "0.1.0"
+description = "Regional growth, convergence, and inequality analysis on the PySAL stack."
+readme = "README.md"
+license = { text = "MIT" }
+requires-python = ">=3.11"
+authors = [{ name = "Carlos Mendez" }]
+keywords = [
+    "spatial econometrics",
+    "regional science",
+    "convergence",
+    "inequality",
+    "pysal",
+    "geopandas",
+    "spatial analysis",
+    "plotly",
+]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Intended Audience :: Science/Research",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Scientific/Engineering",
+    "Topic :: Scientific/Engineering :: GIS",
+]
+dependencies = [
+    "pandas>=2.1",
+    "numpy>=1.26",
+    "scipy>=1.11",
+    "geopandas>=1.0",
+    "libpysal>=4.9",
+    "esda>=2.5",
+    "inequality>=1.0",
+    "mapclassify>=2.6",
+    "spreg>=1.8",
+    "mgwr>=2.2",
+    "statsmodels>=0.14",
+    "plotly>=5.24",
+    "great-tables>=0.16",
+    "pooch>=1.8",
+]
+
+[project.optional-dependencies]
+# Distribution dynamics (Markov / Spatial Markov) via giddy. Kept out of core because the
+# giddy -> quantecon -> numba chain has no recent wheels on some platforms (macOS x86_64);
+# core `pip install geometrics` must never fall back to an sdist build.
+dynamics = [
+    "giddy>=2.3",
+]
+# Static PNG export of Plotly figures (tile-free maps export deterministically; tile maps
+# need kaleido>=1.0's Chromium engine).
+png = [
+    "kaleido>=1.0",
+]
+all = [
+    "geometrics[dynamics,png]",
+]
+
+[project.urls]
+Homepage = "https://github.com/quarcs-lab/geometrics"
+Documentation = "https://quarcs-lab.github.io/geometrics/"
+Repository = "https://github.com/quarcs-lab/geometrics"
+Issues = "https://github.com/quarcs-lab/geometrics/issues"
+
+[dependency-groups]
+dev = [
+    "pytest>=8",
+    "pytest-cov>=5",
+    "pytest-xdist>=3",
+    "hypothesis>=6",
+    "ruff>=0.6",
+    "mypy>=1.10",
+    "pandas-stubs",
+    "pre-commit>=3.7",
+]
+docs = [
+    "quartodoc>=0.11",
+    "griffe<1",
+    "jupyter",
+    "nbformat>=5.9",
+]
+
+[tool.uv]
+# giddy -> quantecon -> numba: without a floor the resolver escapes numba's numpy cap
+# by walking down to ancient sdist-only releases (numba 0.53 / llvmlite 0.36) that
+# cannot build on Python 3.11+. The global floor forces a wheel-bearing numba and lets
+# numpy resolve downward instead. On Intel macs the last numba with wheels is 0.60,
+# which caps numpy at 2.0.x there.
+constraint-dependencies = [
+    "numba>=0.60",
+    "numba<0.61; sys_platform == 'darwin' and platform_machine == 'x86_64'",
+    "numpy<2.1; sys_platform == 'darwin' and platform_machine == 'x86_64'",
+    # Without these floors the resolver escapes numba's numpy cap by selecting an
+    # ancient quantecon (0.3.x declares no numba dependency and breaks at import).
+    "quantecon>=0.7",
+    "giddy>=2.3.5",
+]
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/geometrics"]
+
+[tool.hatch.build.targets.sdist]
+include = [
+    "src/geometrics",
+    "tests",
+    "README.md",
+    "LICENSE",
+]
+
+# ----------------------------------------------------------------------------
+# Tooling
+# ----------------------------------------------------------------------------
+[tool.ruff]
+line-length = 88
+target-version = "py311"
+src = ["src", "tests"]
+
+[tool.ruff.lint]
+select = ["E", "F", "W", "I", "UP", "B", "SIM", "D", "RUF"]
+ignore = [
+    "D100", # missing docstring in public module
+    "D104", # missing docstring in public package
+    "D105", # missing docstring in magic method
+    "D107", # missing docstring in __init__
+    "E501", # line length handled by formatter
+    "B008", # function call in default argument (intentional for np.nanmean etc.)
+    "RUF022", # __all__ is intentionally grouped by topic, not sorted
+]
+# Greek symbols used in scientific prose/labels (β and λ are not flagged; σ is confusable
+# with o, so it must be allowed explicitly to read as "σ-convergence" alongside
+# "β-convergence"; ρ is the spatial autoregressive parameter, γ the SLX lag coefficients,
+# α the significance level).
+allowed-confusables = ["σ", "ρ", "γ", "α"]
+
+[tool.ruff.lint.pydocstyle]
+convention = "numpy"
+
+[tool.ruff.lint.per-file-ignores]
+"tests/*" = ["D"]
+"docs/*" = ["D"]
+"tools/*" = ["D"]
+
+[tool.mypy]
+# 3.12, not the 3.11 package floor: numpy >= 2.5 ships PEP 695 `type` statements in its
+# stubs, which mypy only parses at target 3.12+. Runtime 3.11 compatibility is covered
+# by ruff's py311 target and the 3.11 cells of the CI test matrix.
+python_version = "3.12"
+warn_unused_configs = true
+ignore_missing_imports = true
+files = ["src/geometrics"]
+
+[tool.pytest.ini_options]
+minversion = "8.0"
+addopts = "--strict-markers --strict-config"
+testpaths = ["tests"]
+markers = [
+    "network: tests that download the real case-study data from GitHub",
+    "dynamics: tests that require the optional giddy (distribution dynamics) extra",
+    "slow: long-running tests (GWR on the full case study, large Monte-Carlo draws)",
+]
+filterwarnings = ["ignore::DeprecationWarning"]
+
+[tool.coverage.run]
+source = ["geometrics"]
+branch = true
+
+[tool.coverage.report]
+show_missing = true
+exclude_lines = ["pragma: no cover", "raise NotImplementedError", "if TYPE_CHECKING:"]

geometrics-0.1.0/src/geometrics/__init__.py

@@ -0,0 +1,147 @@
+"""geometrics: regional growth, convergence, and inequality on the PySAL stack.
+
+geometrics wraps the standard analyses of the regional convergence literature —
+exploratory spatial data analysis, β/σ/club convergence, spatial econometric models,
+distribution dynamics, inequality decomposition, and local (GWR) models — into
+illustrative, easy-to-apply functions built on libpysal, esda, giddy, inequality,
+mapclassify, spreg, and mgwr.
+
+Three inputs drive everything: a geometry with only the entity ID (``read_gdf``),
+a long-form panel (``set_panel`` / ``set_labels``), and a data dictionary
+(``df_dict``, inferable with ``build_data_dict``). Every public function returns a
+frozen result dataclass with ``.df``, ``.fig`` and/or ``.gt``, plain-language
+``.interpret()``, and a concept ``.explain()``.
+"""
+
+from geometrics import data
+from geometrics._data_dict import build_data_dict
+from geometrics._geo import read_gdf
+from geometrics._labels import resolve_label, set_labels
+from geometrics._panel import resolve_panel, set_panel
+from geometrics._roles import set_roles
+from geometrics._theme import get_palette, set_palette
+from geometrics._types import (
+    BetaConvergenceResult,
+    ChoroplethMapResult,
+    ConnectivityMapResult,
+    ConvergenceClubsResult,
+    DistributionOverTimeResult,
+    GWRResult,
+    InequalityOverTimeResult,
+    LisaClusterMapResult,
+    MarkovTransitionsResult,
+    MGWRResult,
+    MoranOverTimeResult,
+    MoranPlotResult,
+    SigmaConvergenceResult,
+    SpacetimeHeatmapResult,
+    SpatialDiagnosticsResult,
+    SpatialMarkovResult,
+    SpatialModelResult,
+    TheilDecompositionResult,
+    WeightsRobustnessResult,
+)
+from geometrics.clubs import analyze_convergence_clubs
+from geometrics.convergence import (
+    analyze_beta_convergence,
+    analyze_sigma_convergence,
+    growth_cross_section,
+)
+from geometrics.dependence import (
+    explore_lisa_cluster_map,
+    explore_moran_over_time,
+    explore_moran_plot,
+)
+from geometrics.distribution_dynamics import (
+    analyze_markov_transitions,
+    analyze_spatial_markov,
+)
+from geometrics.gwr import analyze_gwr, analyze_mgwr
+from geometrics.maps import explore_choropleth_map
+from geometrics.pedagogy import Explainer, explain, list_topics
+from geometrics.regional_inequality import (
+    analyze_inequality_over_time,
+    analyze_theil_decomposition,
+)
+from geometrics.spacetime import (
+    explore_distribution_over_time,
+    explore_spacetime_heatmap,
+)
+from geometrics.spatial_models import (
+    analyze_spatial_diagnostics,
+    analyze_spatial_model,
+    analyze_spatial_model_by_weights,
+)
+from geometrics.weights import explore_connectivity_map, make_weights
+
+__version__ = "0.1.0"
+
+__all__ = [
+    # ===== EXPLORE =====
+    # maps
+    "explore_choropleth_map",
+    # spatial weights
+    "explore_connectivity_map",
+    # spatial dependence (ESDA)
+    "explore_moran_plot",
+    "explore_lisa_cluster_map",
+    "explore_moran_over_time",
+    # space-time dynamics
+    "explore_distribution_over_time",
+    "explore_spacetime_heatmap",
+    # ===== ANALYZE =====
+    # convergence
+    "analyze_beta_convergence",
+    "analyze_sigma_convergence",
+    "analyze_convergence_clubs",
+    # spatial econometric models (spreg)
+    "analyze_spatial_model",
+    "analyze_spatial_diagnostics",
+    "analyze_spatial_model_by_weights",
+    # distribution dynamics (giddy)
+    "analyze_markov_transitions",
+    "analyze_spatial_markov",
+    # regional inequality (PySAL inequality)
+    "analyze_inequality_over_time",
+    "analyze_theil_decomposition",
+    # local models (mgwr)
+    "analyze_gwr",
+    "analyze_mgwr",
+    # ===== UTILITIES =====
+    "read_gdf",
+    "make_weights",
+    "growth_cross_section",
+    "set_panel",
+    "resolve_panel",
+    "set_labels",
+    "resolve_label",
+    "set_roles",
+    "build_data_dict",
+    "set_palette",
+    "get_palette",
+    "explain",
+    "list_topics",
+    "Explainer",
+    # ===== DATA =====
+    "data",
+    # ===== RESULT TYPES =====
+    "ChoroplethMapResult",
+    "ConnectivityMapResult",
+    "MoranPlotResult",
+    "LisaClusterMapResult",
+    "MoranOverTimeResult",
+    "DistributionOverTimeResult",
+    "SpacetimeHeatmapResult",
+    "BetaConvergenceResult",
+    "SigmaConvergenceResult",
+    "ConvergenceClubsResult",
+    "SpatialModelResult",
+    "SpatialDiagnosticsResult",
+    "WeightsRobustnessResult",
+    "MarkovTransitionsResult",
+    "SpatialMarkovResult",
+    "InequalityOverTimeResult",
+    "TheilDecompositionResult",
+    "GWRResult",
+    "MGWRResult",
+]