polars.Series.bottom_k_by

Series.bottom_k_by(
    by: IntoExpr | Iterable[IntoExpr],
    k: int = 5,
    *,
    reverse: bool | Sequence[bool] = False,
) → Series

Возвращает k наименьших элементов столбца by.

Элементы, отличные от null, всегда имеют приоритет над элементами null независимо от значения reverse. Порядок вывода не гарантируется; вызовите sort() после этой функции, если хотите отсортировать результат.

Временная сложность:

\[O(n \log{n})\]

Параметры:

by

Столбец, используемый для определения наименьших элементов. Принимает выражение. Строки интерпретируются как имена столбцов.

k

Количество возвращаемых элементов.

reverse

Рассматривать k наибольших элементов столбца by (вместо k наименьших). Это можно указать отдельно для каждого столбца, передав последовательность логических значений.

См. также

top_k

top_k_by

bottom_k

Примеры

>>> s = pl.Series("a", [2, 5, 1, 4, 3])
>>> s.bottom_k_by("a", 3)
shape: (3,)
Series: 'a' [i64]
[
    1
    2
    3
]