polars.Series.explode#

Series.explode( *, empty_as_null: bool = True, keep_nulls: bool = True, ) → Series[source]#

Explode a list Series.

This means that every item is expanded to a new row.

Parameters:

empty_as_null: Explode an empty list into a null.
keep_nulls: Explode a null list into a null.

Returns:

Series: Series with the data type of the list elements.

See also

Series.list.explode: Explode a list column.

Examples

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