API · NumPy

Python Numpy.random.rand() 함수

numpy.random.rand() 함수는 임의의 값으로 지정된 모양의 배열을 생성합니다.

이 페이지의 내용

numpy.random.rand()는 스칼라나 배열 형태로 난수를 생성합니다. 원하는 배열 모양을 지정하려면 차원을 위치 인수로 전달하고, 스칼라 하나를 얻으려면 인수 없이 호출합니다.

numpy.random.rand()의 구문

이 함수에는 차원을 0개 이상 전달할 수 있습니다: numpy.random.rand(d0, d1, ..., dn). 각 인수는 순서대로 한 축의 길이를 지정합니다. 예를 들어 (2, 3)은 행 두 개와 열 세 개를 뜻합니다. 인수들이 배열의 모양을 직접 지정하며, 튜플 하나를 단일 인수로 전달하는 방식은 아닙니다.

매개변수와 반환값

d0부터 dn까지 각 인수는 음이 아닌 정수 차원입니다. 차원을 전달하지 않으면 부동 소수점 스칼라 하나를 반환합니다. 차원을 하나 이상 전달하면 입력한 차원들의 순서대로 모양이 정해지는 NumPy 배열을 반환합니다. 배열에는 반개구간 [0, 1)에서 균등 분포로 추출한 부동 소수점 값이 들어갑니다. 0은 나올 수 있지만 1은 포함되지 않습니다.

스칼라 또는 1차원 배열 생성

다음 예제를 실행해 보세요. 코드 블록의 바이트를 그대로 보존하므로 출력 레이블 scalar type, array shape, scaled shape는 영어로 표시됩니다. 각각 스칼라의 자료형, 배열의 모양, 배율을 적용한 배열의 모양을 나타냅니다.

이 섹션의 코드와 표시되는 레이블 또는 출력은 영어로 유지됩니다.

import numpy as np

np.random.seed(0)
scalar = np.random.rand()
values = np.random.rand(5)
scaled = values * 10

print("scalar type:", type(scalar).__name__)
print("array shape:", values.shape)
print("scaled shape:", scaled.shape)

첫 번째 호출은 스칼라 하나를 반환하고, 두 번째 호출은 모양이 (5,)인 1차원 배열에 값 다섯 개를 반환합니다. 곱셈은 모양이 아니라 값을 바꿉니다. 원래 값의 범위가 [0, 1)이므로 10을 곱하면 조정된 값의 범위는 [0, 10)이 됩니다. 같은 환경에서 동일한 호출을 수행하면 시드에 따라 수열이 반복됩니다. 그렇다고 호출할 때마다 하나의 고정된 값만 반환되는 것은 아닙니다.

여러 차원의 배열 생성

축마다 차원 하나를 전달합니다. 예를 들어 numpy.random.rand(2, 3)은 모양이 (2, 3)인 배열을 만들어 행 두 개와 열 세 개를 담습니다. 같은 규칙은 더 높은 차원에도 적용됩니다. numpy.random.rand(2, 3, 2)의 모양은 (2, 3, 2)입니다. 첫 번째 인수는 가장 바깥쪽 차원을 정하고, 이후 인수는 차례로 다음 축의 차원을 정합니다. 큰 배열의 모든 원소를 출력하지 않고 결과를 확인하려면 shape 속성을 사용합니다.

난수 값 제어 및 해석

호출하면 NumPy의 레거시 전역 난수 상태가 진행되므로, 연속해서 호출할 때 보통 서로 다른 값이 나옵니다. 디버깅을 위해 수열을 재현하려면 같은 환경에서 동일한 호출을 수행하기 전에 numpy.random.seed(seed)로 상태를 초기화합니다. 시드와 호출 순서가 모두 중요합니다. 난수 호출을 추가하거나 위치를 바꾸면 이후 값이 달라집니다. 위 시드 예제는 이러한 조건에서 수열을 반복하기 위해 0을 사용합니다.

스칼라 하나나 특정 모양의 배열을 빠르게 얻고 싶을 때 이 함수를 사용할 수 있습니다. 값의 범위는 [0, 1)이며, 더 큰 상한이 필요하면 곱셈으로 구간을 조정합니다. 반환되는 값은 난수 표본입니다. 시드를 고정하면 같은 연산 순서를 반복할 수 있지만, 호출할 때마다 고정된 결과가 나온다는 뜻은 아닙니다.