tensorplay.functional.randint

tensorplay.functional.randint(low=0, high, size, \*, generator=None, out=None, dtype=None, layout=tensorplay.strided, device=None, requires_grad=False) → Tensor[source]

Returns a tensor filled with random integers generated uniformly between low (inclusive) and high (exclusive).

The shape of the tensor is defined by the variable argument size.

Note

With the global dtype default (tensorplay.float32), this function returns a tensor with dtype tensorplay.int64.

Parameters:

• low (int, optional) – Lowest integer to be drawn from the distribution. Default: 0.

• high (int) – One above the highest integer to be drawn from the distribution.

• size (tuple) – a tuple defining the shape of the output tensor.

Keyword Arguments:

• generator (tensorplay.Generator, optional) – a pseudorandom number generator for sampling

• out (Tensor, optional) – the output tensor.

• dtype (tensorplay.dtype, optional) – the desired data type of returned tensor. Default: if None, this function returns a tensor with dtype tensorplay.int64.

• layout (tensorplay.layout, optional) – the desired layout of returned Tensor. Default: tensorplay.strided.

• device (tensorplay.device, optional) – the desired device of returned tensor. Default: if None, uses the current device for the default tensor type (see tensorplay.set_default_device()). device will be the CPU for CPU tensor types and the current CUDA device for CUDA tensor types.

• requires_grad (bool, optional) – If autograd should record operations on the returned tensor. Default: False.

Example:

>>> tensorplay.randint(3, 5, (3,))
tensor([4, 3, 4])


>>> tensorplay.randint(10, (2, 2))
tensor([[0, 2],
        [5, 5]])


>>> tensorplay.randint(3, 10, (2, 2))
tensor([[4, 5],
        [6, 7]])