numpy.random.randint

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

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

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

Примечание

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

Параметры

lowint или массив-подобный тип данных int

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

highint или массив-подобный тип данных int, необязательно

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

sizeint или кортеж из целых чисел, необязательно

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

dtypedtype, необязательно

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

В версии 1.11.0.

Возвращает

outint или ndarray из целых чисел

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)