polars.Series.scatter

Series.scatter(
    indices: Series | Iterable[int] | int | np.ndarray[Any,
    Any],
    values: Series | Iterable[PythonLiteral] | PythonLiteral | None,
) → Series

Установить значения в указанных позициях индекса.

Параметры:

indices

Целые числа, обозначающие позиции индекса.

values

Значения для замены.

Примечания

Использование этой функции часто считается антипаттерном, поскольку оно может препятствовать оптимизации (проталкиванию предикатов и т. д.). Вместо этого рассмотрите возможность использования pl.when(predicate).then(value).otherwise(self).

Примеры

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

Лучше реализовать это следующим образом:

>>> s.to_frame().with_row_index().select(
...     pl.when(pl.col("index") == 1).then(10).otherwise(pl.col("a"))
... )
shape: (3, 1)
┌─────────┐
│ literal │
│ ---     │
│ i64     │
╞═════════╡
│ 1       │
│ 10      │
│ 3       │
└─────────┘