numpy.random — 난수 생성

numpy.random 서브모듈은 일반적인 확률 분포에서 표본을 추출하는 Generator 클래스를 제공합니다. 기반 알고리즘은 순열 합동 생성기(PCG)이며, 자세한 내용은 https://www.pcg-random.org/ 를 참고하십시오.

Generator 는 상태를 가지는 객체입니다. 표본 추출 메서드를 호출할 때마다 내부 상태가 진행되므로 연속된 호출은 서로 독립적인 표본을 반환합니다. 출력 배열의 dtype은 항상 numpy.float 입니다.

클래스

class numpy.random.Generator(seed: int | tuple[int, ...] | None = None)

새 의사 난수 생성기를 생성합니다.

매개변수:

seed – 생성기 상태를 초기화하는 데 사용되는 시드입니다. 정수를 전달하면 그대로 사용됩니다. 정수의 튜플을 전달하면 단일 인스턴스 대신 (요소마다 하나씩) 독립적으로 시드된 Generator 객체의 튜플이 반환됩니다. None 을 전달하면 (빌드 시점에 구성된 경우) 플랫폼 기본 시드가 사용되고, 그렇지 않으면 ValueError 가 발생합니다.

예외 발생:

  • TypeError – seed 가 None, 정수, 또는 정수의 튜플이 아닌 경우.

  • ValueError – seed 가 None 이고 기본 시드가 구성되어 있지 않은 경우.

normal(loc: float = 0.0, scale: float = 1.0, size: int | tuple[int, ...] | None = None) → float | ndarray

정규(가우시안) 분포에서 표본을 추출합니다.

매개변수:

  • loc – 분포의 평균(중심)입니다.

  • scale – 분포의 표준 편차(폭)입니다. 음수가 아니어야 합니다.

  • size – 출력의 형태입니다. 정수이면 해당 길이의 1차원 배열이 반환됩니다. 튜플이면 해당 형태의 배열이 반환됩니다. None (기본값)이면 단일 Python float 이 반환됩니다.

반환:

Python float 또는 요청한 형태의 float numpy.ndarray 입니다.

예외 발생:

  • ValueError – 요청한 형태가 ULAB_MAX_DIMS 를 초과하는 경우.

  • TypeError – size 가 None, 정수, 튜플 중 어느 것도 아닌 경우.

표본은 Box-Muller 변환을 사용하여 생성됩니다.

random(size: int | tuple[int, ...] | None = None, *, out: ndarray | None = None) → float | ndarray

반열린 구간 [0.0, 1.0) 에 대한 균등 분포에서 표본을 추출합니다.

매개변수:

  • size – 출력의 형태입니다. 정수이면 해당 길이의 1차원 배열이 반환됩니다. 튜플이면 해당 형태의 배열이 반환됩니다. None (기본값)이고 out 도 None 이면 단일 Python float 이 반환됩니다.

  • out – 표본을 받을, 미리 할당된 조밀한 float numpy.ndarray (선택 사항)입니다. size 와 out 을 모두 전달하면 두 형태가 일치해야 합니다.

반환:

인수에 따라 Python float, 새 numpy.ndarray, 또는 (표본으로 채워진) out 입니다.

예외 발생:

  • TypeError – size 의 타입이 지원되지 않거나, out 이 ndarray가 아니거나, out 의 dtype이 float 이 아닌 경우.

  • ValueError – 요청한 형태가 ULAB_MAX_DIMS 를 초과하거나, size 와 out.shape 가 일치하지 않거나, out 이 연속적이지 않은 경우.

uniform(low: float = 0.0, high: float = 1.0, size: int | tuple[int, ...] | None = None) → float | ndarray

반열린 구간 [low, high) 에 대한 균등 분포에서 표본을 추출합니다.

매개변수:

  • low – 분포의 하한(포함)입니다.

  • high – 분포의 상한(제외)입니다.

  • size – 출력의 형태입니다. 튜플이면 해당 형태의 배열이 반환됩니다. None (기본값)이면 [0.0, 1.0) 에서 추출한 단일 Python float 이 반환됩니다(스칼라인 경우 low/high 경계는 무시됩니다).

반환:

Python float 또는 요청한 형태의 float numpy.ndarray 입니다.

예외 발생:

  • ValueError – 요청한 형태가 ULAB_MAX_DIMS 를 초과하는 경우.

  • TypeError – size 가 None 도 튜플도 아닌 경우.

동일한 기본 인수를 사용하면 uniform() 은 random() 과 동일한 시퀀스를 생성합니다.