polars.DataFrame.gather

DataFrame.gather(
    indices: int | Sequence[int] | IntoExpr | Series | np.ndarray[Any,
    Any],
    *,
    null_on_oob: bool = False,
) → DataFrame

Выбирает строки этого DataFrame по указанным индексам.

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

Эта функциональность является экспериментальной. Она может быть изменена в любой момент без необходимости считать это несовместимым изменением.

Параметры:

indices

Индексы выбираемых строк.

null_on_oob

Если значение равно true и индекс выходит за допустимые границы, вместо ошибки будет создана строка со значениями null.

Примеры

>>> df = pl.DataFrame({"x": [2, 1, 0], "s": ["foo", "bar", "baz"]})
>>> df.gather([2, 0, 0])
shape: (3, 2)
┌─────┬─────┐
│ x   ┆ s   │
│ --- ┆ --- │
│ i64 ┆ str │
╞═════╪═════╡
│ 0   ┆ baz │
│ 2   ┆ foo │
│ 2   ┆ foo │
└─────┴─────┘

>>> df.gather([0, 10, 1], null_on_oob=True)
shape: (3, 2)
┌──────┬──────┐
│ x    ┆ s    │
│ ---  ┆ ---  │
│ i64  ┆ str  │
╞══════╪══════╡
│ 2    ┆ foo  │
│ null ┆ null │
│ 1    ┆ bar  │
└──────┴──────┘