numpy.random.randint

numpy.random.randint(low, high=None, size=None, dtype=int)

Возвращает случайные целые числа от low (включительно) до high (исключительно).

Возвращает случайные целые числа из «дискретного равномерного» распределения указанного типа данных в «полуоткрытом» интервале [low, high). Если high равно None (по умолчанию), то результаты из [0, low).

Примечание

Новый код должен использовать метод integers экземпляра default_rng() вместо этого; см. random-quick-start.

Параметры

lowint or array-like of ints

Наименьшие (знаковые) целые числа, которые должны быть взяты из распределения (если high=None, в этом случае этот параметр на единицу больше наибольшего такого целого числа).

highint or array-like of ints, optional

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

sizeint or tuple of ints, optional

Форма выходных данных. Если заданная форма, например, (m, n, k), то m * n * k выборок будут извлечены. По умолчанию None, в этом случае возвращается одно значение.

dtypedtype, optional

Желаемый тип данных результата. Порядок байтов должен быть родным. Значение по умолчанию int.

Введено в версии 1.11.0.

Возвращает

outint or ndarray of ints

Массив формы size, содержащий случайные целые числа из соответствующего распределения, или одно такое случайное целое число, если size не задано.

См. также

random_integers

аналогично randint, только для замкнутого интервала [low, high], и 1 является наименьшим значением, если high опущено.

Generator.integers

который следует использовать для нового кода.

Примеры

>>> np.random.randint(2, size=10)
array([1, 0, 0, 0, 1, 1, 0, 0, 1, 0]) # random
>>> np.random.randint(1, size=10)
array([0, 0, 0, 0, 0, 0, 0, 0, 0, 0])

Генерация 2x4 массива целых чисел от 0 до 4 включительно:

>>> np.random.randint(5, size=(2, 4))
array([[4, 0, 2, 1], # random
       [3, 2, 2, 0]])

Генерация 1x3 массива с 3 различными верхними границами

>>> np.random.randint(1, [3, 5, 10])
array([2, 2, 9]) # random

Генерация 1x3 массива с 3 различными нижними границами

>>> np.random.randint([1, 5, 7], 10)
array([9, 8, 7]) # random

Генерация 2x4 массива с использованием трансляции с типом uint8

>>> np.random.randint([1, 3, 5, 7], [[10], [20]], dtype=np.uint8)
array([[ 8,  6,  9,  7], # random
       [ 1, 16,  9, 12]], dtype=uint8)