polars.Expr.hist

Expr.hist(
    bins: IntoExpr | None = None,
    *,
    bin_count: int | None = None,
    include_category: bool = False,
    include_breakpoint: bool = False,
) → Expr

Разбивает значения по интервалам и подсчитывает количество вхождений.

движок:В памяти

Предупреждение

Эта функциональность считается нестабильной. Она может быть изменена в любой момент без того, чтобы это считалось нарушающим обратную совместимость изменением.

Параметры:

bins

Границы интервалов. Если не указаны, границы определяются на основе данных.

bin_count

Если bins не указан, создаются bin_count равномерных интервалов, полностью охватывающих данные.

include_breakpoint

Добавить столбец, указывающий верхнюю границу интервала.

include_category

Добавить столбец, в котором интервалы представлены в виде категорий.

Возвращает:

DataFrame

Примеры

>>> df = pl.DataFrame({"a": [1, 3, 8, 8, 2, 1, 3]})
>>> df.select(pl.col("a").hist(bins=[1, 2, 3]))
shape: (2, 1)
┌─────┐
│ a   │
│ --- │
│ u32 │
╞═════╡
│ 3   │
│ 2   │
└─────┘
>>> df.select(
...     pl.col("a").hist(
...         bins=[1, 2, 3], include_breakpoint=True, include_category=True
...     )
... )
shape: (2, 1)
┌──────────────────────┐
│ a                    │
│ ---                  │
│ struct[3]            │
╞══════════════════════╡
│ {2.0,"[1.0, 2.0]",3} │
│ {3.0,"(2.0, 3.0]",2} │
└──────────────────────┘