nvidia.dali.fn.random.coin_flip#
- nvidia.dali.fn.random.coin_flip(__shape_like=None, /, *, bytes_per_sample_hint=[0], dtype=None, preserve=False, probability=0.5, seed=-1, shape=None, device=None, name=None)#
生成遵循伯努利分布的随机布尔值。
生成值 1 (true) 的概率由
probability
参数确定。生成数据的形状可以通过
shape
参数显式指定,也可以选择与提供的__shape_like
输入的形状匹配。如果两者都不存在,则每个样本生成一个值。- 支持的后端
‘cpu’
‘gpu’
- 参数:
__shape_like¶ (TensorList, 可选) – 如果提供,则此输入的形状将用于推断输出的形状。
- 关键字参数:
bytes_per_sample_hint¶ (int 或 list of int, 可选, 默认 = [0]) –
每个样本的输出大小提示(以字节为单位)。
如果指定,则驻留在 GPU 或页锁定主机内存中的操作符输出将被预先分配,以容纳此大小的样本批次。
dtype¶ (
nvidia.dali.types.DALIDataType
, 可选) –输出数据类型。
注意
生成的数字将转换为输出数据类型,并在必要时进行舍入和钳位。
preserve¶ (bool, 可选, 默认 = False) – 阻止操作符从图中删除,即使其输出未使用。
probability¶ (float 或 TensorList of float, 可选, 默认 = 0.5) – 值 1 的概率。
seed¶ (int, 可选, 默认 = -1) – 随机种子;如果未设置,将自动分配一个。
shape¶ (int 或 list of int 或 TensorList of int, 可选) – 输出数据的形状。