numpy.random.randint

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

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

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

Примечание

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

Параметры

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)