polars-distr 0.1.0

Native Polars expressions for histogram distribution statistics

polars-distr

Native Polars expressions for statistics over histogram distributions. The plugin computes means, CDF values, quantiles, and exact CRPS inside lazy and streaming query plans without Python UDFs. histogram() gives the unchanged Struct{counts, edges} storage a logical histogram dtype that survives lazy plans and Parquet round trips.

Install with uv add polars-distr or pip install polars-distr.

import polars as pl
import polars_distr as pld  # registers the Histogram dtype

result = (
    pl.scan_parquet("histograms.parquet")
    .select(
        pld.quantiles("distribution", [0.1, 0.5, 0.9]).alias("quantiles"),
        pld.crps("distribution", "observation").alias("crps"),
    )
    .collect(engine="streaming")
)

Create distribution from raw columns with pld.histogram("counts", "edges"); once written to Parquet, it loads back as a histogram column.

• Semantics
• Architecture
• Benchmarks