polars.Expr.sample

Expr.sample(
    n: int | IntoExprColumn | None = None,
    *,
    fraction: float | IntoExprColumn | None = None,
    with_replacement: bool = False,
    shuffle: bool | None = None,
    seed: int | None = None,
) → Expr

Выбрать выборку из этого выражения.

движок:В памяти

Параметры:

n

Количество элементов для возврата. Нельзя использовать вместе с fraction. По умолчанию равно 1, если fraction имеет значение None.

fraction

Доля элементов для возврата. Нельзя использовать вместе с n.

with_replacement

Разрешить выбирать значения более одного раза.

shuffle

Определяет порядок выбранных элементов. Если True, выбранные элементы явно перемешиваются. Если False, относительный порядок выбранных элементов сохраняется (то есть они появляются в том же порядке, что и исходные входные данные). Если None (по умолчанию), порядок не гарантируется; используется наиболее производительный алгоритм.

seed

Начальное значение для генератора случайных чисел. Если задано None (по умолчанию), для каждой операции выборки генерируется случайное начальное значение.

Примеры

>>> df = pl.DataFrame({"a": [1, 2, 3]})
>>> df.select(
...     pl.col("a").sample(
...         fraction=1.0, with_replacement=True, shuffle=False, seed=1
...     )
... )
shape: (3, 1)
┌─────┐
│ a   │
│ --- │
│ i64 │
╞═════╡
│ 3   │
│ 3   │
│ 1   │
└─────┘