polars.LazyFrame.bottom_k

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

Возвращает k строк с наименьшими значениями.

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

движок:В памятиПотоковая обработкаРаспределённая обработка

Изменено в версии 1.0.0: Параметр descending переименован в reverse.

Параметры:

k

Количество строк для возврата.

by

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

reverse

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

См. также

top_k

Примеры

>>> lf = pl.LazyFrame(
...     {
...         "a": ["a", "b", "a", "b", "b", "c"],
...         "b": [2, 1, 1, 3, 2, 1],
...     }
... )

Получить строки, содержащие 4 наименьших значения в столбце b.

>>> lf.bottom_k(4, by="b").collect()
shape: (4, 2)
┌─────┬─────┐
│ a   ┆ b   │
│ --- ┆ --- │
│ str ┆ i64 │
╞═════╪═════╡
│ b   ┆ 1   │
│ a   ┆ 1   │
│ c   ┆ 1   │
│ a   ┆ 2   │
└─────┴─────┘

Получить строки, содержащие 4 наименьших значения при сортировке по столбцам a и b.

>>> lf.bottom_k(4, by=["a", "b"]).collect()
shape: (4, 2)
┌─────┬─────┐
│ a   ┆ b   │
│ --- ┆ --- │
│ str ┆ i64 │
╞═════╪═════╡
│ a   ┆ 1   │
│ a   ┆ 2   │
│ b   ┆ 1   │
│ b   ┆ 2   │
└─────┴─────┘