polars.Series.extend

Series.extend(
    other: Series,
) → Self

Дополняет память, используемую этой серией, значениями из другой серии.

В отличие от append, которая добавляет чанки из other к чанкам этой серии, extend добавляет данные из other в базовые области памяти и поэтому может вызвать перераспределение памяти (что требует больших затрат).

Если при этом not происходит перераспределение памяти, результирующая структура данных не будет содержать дополнительных чанков, что позволит выполнять запросы быстрее.

Используйте extend вместо append, если после единственного добавления вы собираетесь выполнить запрос. Например, при выполнении онлайн-операций, когда вы добавляете n строк и повторно выполняете запрос.

Используйте append вместо extend, если перед выполнением запроса вы собираетесь многократно добавлять данные. Например, если вы считываете несколько файлов и хотите сохранить их в одной Series. В последнем случае завершите последовательность операций append вызовом rechunk.

Параметры:

other

Серия, которой нужно дополнить эту серию.

Предупреждение

Этот метод изменяет серию на месте. Серия возвращается только для удобства.

См. также

append

Примеры

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

Результирующая серия будет состоять из одного чанка.

>>> a.n_chunks()
1