polars.Series.clip

Series.clip(
    lower_bound: NumericLiteral | TemporalLiteral | IntoExprColumn | None = None,
    upper_bound: NumericLiteral | TemporalLiteral | IntoExprColumn | None = None,
) → Series

Заменяет значения за пределами заданных границ значением ближайшей границы.

Параметры:

lower_bound

Нижняя граница. Принимает выражение. Входные данные, не являющиеся выражениями, интерпретируются как литералы. Если указано None (значение по умолчанию), нижняя граница не применяется.

upper_bound

Верхняя граница. Принимает выражение. Входные данные, не являющиеся выражениями, интерпретируются как литералы. Если указано None (значение по умолчанию), верхняя граница не применяется.

См. также

when

Примечания

Этот метод работает только с числовыми и временными столбцами. Чтобы ограничить значения других типов данных, рассмотрите возможность написания выражения when-then-otherwise. См. when().

Примеры

Указание нижней и верхней границ:

>>> s = pl.Series([-50, 5, 50, None])
>>> s.clip(1, 10)
shape: (4,)
Series: '' [i64]
[
    1
    5
    10
    null
]

Указание только одной границы:

>>> s.clip(upper_bound=10)
shape: (4,)
Series: '' [i64]
[
    -50
    5
    10
    null
]