polars.DataFrame.bottom_k

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

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

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

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

Параметры:

k

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

by

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

reverse

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

См. также

top_k

Примеры

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

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

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

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

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