polars.Series.top_k_by

Series.top_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

bottom_k

bottom_k_by

Примеры

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