binscatter 0.1.0

Cross-backend binscatter plots.

Dataframe agnostic binscatter plots

This package implements binscatter plots following:

Cattaneo, Crump, Farrell and Feng (2024)
"On Binscatter"
American Economic Review, 114(5), pp. 1488-1514
DOI: 10.1257/aer.20221576

• Uses narwhals as dataframe layer binscatter.
  • Currently supports: pandas, Polars, DuckDB, Dask, and PySpark
  • All other Narwhals backends fall back to a generic quantile handler if a native path is unavailable
• Lightweight - little dependencies
• Uses plotly as graphics backend - because: (1) its great (2) it uses narwhals as well, minimizing dependencies
• Pythonic alternative to the excellent binsreg package

---

Example

We made this noisy scatterplot:

This is how we make a nice binscatter plot, controlling for a set of features:

from binscatter import binscatter

p_binscatter_controls = binscatter(
    df,
    "mtr90_lag3",
    "lnpat",
    [
        "top_corp_lag3",
        "real_gdp_pc",
        "population_density",
        "rd_credit_lag3",
        "statenum",
        "year",
    ],
    num_bins=35,
)

The data originates from:

Akcigit, Ufuk; Grigsby, John; Nicholas, Tom; Stantcheva, Stefanie, 2021, "Replication Data for: 'Taxation and Innovation in the 20th Century'", https://doi.org/10.7910/DVN/SR410I, Harvard Dataverse, V1

Tests

• Run the full backend matrix, including PySpark: just test
• Use the faster run without PySpark: just test-fast