- Series.append(other: Series, *, append_chunks: bool | None = None) Self #
Append a Series to this one.
Series to append.
Deprecated since version 0.18.8: This argument will be removed and
appendwill change to always behave like
append_chunks=True(the previous default). For the behavior of
If set to
Truethe append operation will add the chunks from
otherto self. This is super cheap.
If set to
Falsethe append operation will do the same as
DataFrame.extendwhich extends the memory backed by this
Serieswith the values from
extendappends the data from
otherto the underlying memory locations and thus may cause a reallocation (which are expensive).
If this does not cause a reallocation, the resulting data structure will not have any extra chunks and thus will yield faster queries.
append_chunkswhen you want to do a query after a single append. For instance during online operations where you add
nrows and rerun a query.
extendwhen you want to append many times before doing a query. For instance when you read in multiple files and when to store them in a single
Series. In the latter case, finish the sequence of
append_chunksoperations with a
This method modifies the series in-place. The series is returned for convenience only.
>>> a = pl.Series("a", [1, 2, 3]) >>> b = pl.Series("b", [4, 5]) >>> a.append(b) shape: (5,) Series: 'a' [i64] [ 1 2 3 4 5 ]
The resulting series will consist of multiple chunks.
>>> a.n_chunks() 2