nvidia.dali.fn.coin_flip

nvidia.dali.fn.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)

Warning

This operator is now deprecated. Use random.coin_flip() instead.

Generates random boolean values following a bernoulli distribution.

The probability of generating a value 1 (true) is determined by the probability argument.

The shape of the generated data can be either specified explicitly with a shape argument, or chosen to match the shape of the input, if provided. If none are present, a single value per sample is generated.

Supported backends

• ‘cpu’

• ‘gpu’

Parameters:

__shape_like (TensorList, optional) – Shape of this input will be used to infer the shape of the output, if provided.

Keyword Arguments:

• bytes_per_sample_hint (int or list of int, optional, default = [0]) –

  Output size hint, in bytes per sample.

  If specified, the operator’s outputs residing in GPU or page-locked host memory will be preallocated to accommodate a batch of samples of this size.

• dtype (nvidia.dali.types.DALIDataType, optional) –

  Output data type.

  Note

  The generated numbers are converted to the output data type, rounding and clamping if necessary.

• preserve (bool, optional, default = False) – Prevents the operator from being removed from the graph even if its outputs are not used.

• probability (float or TensorList of float, optional, default = 0.5) – Probability of value 1.

• seed (int, optional, default = -1) – Random seed; if not set, one will be assigned automatically.

• shape (int or list of int or TensorList of int, optional) – Shape of the output data.