rand

균일하게 분포된 난수

구문

X = rand

X = rand(n)

X = rand(sz1,...,szN)

X = rand(sz)

X = rand(___,typename)

X = rand(___,"like",p)

X = rand(s,___)

설명

X = rand는 구간 (0,1)의 균등분포에서 추출한 난수 스칼라를 반환합니다.

X = rand(n)은 균등분포된 난수로 구성된 n×n 행렬을 반환합니다.

X = rand(sz1,...,szN)은 난수로 구성된 sz1×...×szN 배열을 반환합니다. 여기서 sz1,...,szN은 각 차원의 크기를 나타냅니다. 예를 들어, rand(3,4)는 3×4 행렬을 반환합니다.

X = rand(sz)는 난수로 구성된 배열을 반환합니다. 여기서 크기 벡터 sz는 size(X)를 정의합니다. 예를 들어, rand([3 4])는 3×4 행렬을 반환합니다.

X = rand(___,typename)은 데이터형이 typename인 난수로 구성된 배열을 반환합니다. typename 입력값은 "single" 또는 "double"이 될 수 있습니다. 위에 열거된 구문의 모든 입력 인수와 사용할 수 있습니다.

X = rand(___,"like",p)는 p와 유사한, 즉 데이터형, 실수/복소수 여부가 p와 동일한 난수로 구성된 배열을 반환합니다. typename이나 "like" 중 하나를 지정할 수 있으나, 둘 다 지정할 수는 없습니다.

X = rand(s,___)는 디폴트 전역 스트림 대신 난수 스트림 s에서 숫자를 생성합니다. 스트림을 만들려면 RandStream 함수를 사용하십시오. s를 지정하고 뒤이어 위에 열거된 구문에 나와 있는 입력 인수 조합을 지정할 수 있습니다.

예제

난수로 구성된 행렬

0과 1 사이의 균일하게 분포된 난수로 구성된 5×5 행렬을 생성합니다.

r = rand(5)

r = 5×5

    0.8147    0.0975    0.1576    0.1419    0.6557
    0.9058    0.2785    0.9706    0.4218    0.0357
    0.1270    0.5469    0.9572    0.9157    0.8491
    0.9134    0.9575    0.4854    0.7922    0.9340
    0.6324    0.9649    0.8003    0.9595    0.6787

지정된 구간 내의 난수

구간 (-5,5)에 균일하게 분포된 난수로 구성된 10×1 열 벡터를 생성합니다.

r = -5 + (5+5)*rand(10,1)

r = 10×1

    3.1472
    4.0579
   -3.7301
    4.1338
    1.3236
   -4.0246
   -2.2150
    0.4688
    4.5751
    4.6489

일반적으로 식 r = a + (b-a).*rand(N,1)을 사용하여 구간 (a,b)에 N개의 난수를 생성할 수 있습니다.

정수형 난수

rand 대신 randi 함수를 사용하여 10에서 50 사이에 균일하게 분포된 5개의 정수형 난수를 생성합니다.

r = randi([10 50],1,5)

r = 1×5

    43    47    15    47    35

난수 생성기 재설정

난수 생성기의 현재 상태를 저장하고 난수로 구성된 1×5 벡터를 생성합니다.

s = rng;
r = rand(1,5)

r = 1×5

    0.8147    0.9058    0.1270    0.9134    0.6324

난수 생성기의 상태를 s로 복원한 다음, 난수로 구성된 1×5 벡터를 새로 생성합니다. 값은 이전과 동일합니다.

rng(s);
r1 = rand(1,5)

r1 = 1×5

    0.8147    0.9058    0.1270    0.9134    0.6324

난수로 구성된 3차원 배열

난수로 구성된 3×2×3 배열을 만듭니다.

X = rand([3,2,3])

X = 
X(:,:,1) =

    0.8147    0.9134
    0.9058    0.6324
    0.1270    0.0975


X(:,:,2) =

    0.2785    0.9649
    0.5469    0.1576
    0.9575    0.9706


X(:,:,3) =

    0.9572    0.1419
    0.4854    0.4218
    0.8003    0.9157

난수의 데이터형 지정

단정밀도 요소를 갖는 난수로 구성된 1×4 벡터를 만듭니다.

r = rand(1,4,"single")

r = 1x4 single row vector

    0.8147    0.9058    0.1270    0.9134

class(r)

ans = 
'single'

크기가 기존 배열과 동일

기존 배열과 동일한 크기의, 균등분포된 난수로 구성된 행렬을 만듭니다.

A = [3 2; -2 1];
sz = size(A);
X = rand(sz)

X = 2×2

    0.8147    0.1270
    0.9058    0.9134

앞의 두 줄의 코드는 다음과 같이 한 줄로 표현하는 것이 보통입니다.

X = rand(size(A));

크기와 데이터형이 기존 배열과 동일

단정밀도 난수로 구성된 2×2 행렬을 만듭니다.

p = single([3 2; -2 1]);

p와 크기, 데이터형이 동일한, 난수로 구성된 배열을 만듭니다.

X = rand(size(p),"like",p)

X = 2x2 single matrix

    0.8147    0.1270
    0.9058    0.9134

class(X)

ans = 
'single'

복소수형 난수

구간 (0,1)에 실수부와 허수부가 있는 정사각형 영역에 대한 균등분포에서 복소수형 난수 10개를 생성합니다.

a = rand(10,1,"like",1i)

a = 10×1 complex

   0.8147 + 0.9058i
   0.1270 + 0.9134i
   0.6324 + 0.0975i
   0.2785 + 0.5469i
   0.9575 + 0.9649i
   0.1576 + 0.9706i
   0.9572 + 0.4854i
   0.8003 + 0.1419i
   0.4218 + 0.9157i
   0.7922 + 0.9595i

입력 인수

n — 정사각 행렬의 크기

정수 값

정사각 행렬의 크기로, 정수 값으로 지정됩니다.

• n이 0이면 X는 빈 행렬이 됩니다.

• n이 음수이면 0으로 처리됩니다.

데이터형: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

sz1,...,szN — 각 차원의 크기(개별 인수)

정수 값

각 차원의 크기로, 정수 값으로 구성된 개별 인수로 지정됩니다.

• 크기가 0인 차원이 있을 경우 X는 빈 배열이 됩니다.

• 크기가 음수인 차원이 있을 경우 0으로 처리됩니다.

• rand는 세 번째 차원부터는 크기가 1인 차원을 무시합니다. 예를 들어, rand(3,1,1,1)은 난수로 구성된 3×1 벡터를 생성합니다.

데이터형: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

sz — 각 차원의 크기(행 벡터)

정수 값

각 차원의 크기로, 정수 값으로 구성된 행 벡터로 지정됩니다. 이 벡터의 요소는 각각 해당하는 차원의 크기를 나타냅니다.

• 크기가 0인 차원이 있을 경우 X는 빈 배열이 됩니다.

• 크기가 음수인 차원이 있을 경우 0으로 처리됩니다.

• rand는 세 번째 차원부터는 크기가 1인 차원을 무시합니다. 예를 들어, rand([3 1 1 1])은 난수로 구성된 3×1 벡터를 생성합니다.

예: sz = [2 3 4]는 2×3×4 배열을 생성합니다.

데이터형: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

typename — 생성할 데이터형(클래스)

"double" (디폴트 값) | "single"

생성할 데이터형(클래스)으로, "double", "single", 또는 rand를 지원하는 다른 클래스의 이름으로 지정됩니다.

예: rand(5,"single")

p — 생성할 배열의 프로토타입

숫자형 배열

생성할 배열의 프로토타입으로, 숫자형 배열로 지정됩니다.

예: rand(5,"like",p)

데이터형: single | double
복소수 지원 여부: 예

s — 난수 스트림

RandStream 객체

난수 스트림으로, RandStream 객체로 지정됩니다.

예: s = RandStream("dsfmt19937"); rand(s,[3 1])

팁

• rand가 생성하는 수열은 rand, randi, randn의 기반이 되는 균일 의사 난수 생성기의 내부 설정에 의해 결정됩니다. rng를 사용하여 이 공유 난수 생성기를 제어할 수 있습니다.

확장 기능

C/C++ 코드 생성

MATLAB® Coder™를 사용하여 C 코드나 C++ 코드를 생성할 수 있습니다.

사용법 관련 참고 및 제한 사항:

• 데이터형(클래스)은 MATLAB^® 내장 숫자형이어야 합니다. 다른 클래스의 경우 정적 rand 메서드를 불러오지 않습니다. 예를 들어, rand(sz,'myclass')는 myclass.rand(sz)를 불러오지 않습니다.

• 크기 인수는 고정된 크기를 가져야 합니다.

• Variable-Sizing Restrictions for Code Generation of Toolbox Functions (MATLAB Coder) 항목을 참조하십시오.

  • 외재적(Extrinsic) 호출이 활성화되고 rand가 parfor 루프 내에서 호출되지 않은 경우, 생성된 MEX 파일은 직렬 코드에서 MATLAB과 동일한 난수 상태를 사용합니다. 그렇지 않을 경우, 생성된 MEX 코드와 독립형 코드는 MATLAB과 동일한 상태로 초기화되는 자체의 난수 상태를 유지합니다.

스레드 기반 환경

MATLAB®의 backgroundPool을 사용해 백그라운드에서 코드를 실행하거나 Parallel Computing Toolbox™의 ThreadPool을 사용해 코드 실행 속도를 높일 수 있습니다.

이 함수는 스레드 기반 환경을 완전히 지원합니다. 자세한 내용은 스레드 기반 환경에서 MATLAB 함수 실행하기 항목을 참조하십시오.

GPU 배열

Parallel Computing Toolbox™를 사용해 GPU(그래픽스 처리 장치)에서 실행하여 코드 실행 속도를 높일 수 있습니다.

사용법 관련 참고 및 제한 사항:

• GPU에서는 스트림 구문 rand(s,___)가 지원되지 않습니다.

• typename을 'gpuArray'로 지정할 수 있습니다. typename을 'gpuArray'로 지정하는 경우 배열의 디폴트 기본 유형은 double입니다.

  기본 유형 datatype을 갖는 GPU 배열을 만들려면 typename 앞에 추가 인수로 기본 유형을 지정하십시오. 예를 들어, X = rand(3,datatype,'gpuArray')는 기본 유형이 datatype이고 난수로 구성된 3×3 GPU 배열을 만듭니다.

  기본 유형 datatype은 다음 옵션 중 하나로 지정할 수 있습니다.

  • 'double'

  • 'single'

• 숫자형 변수 p를 gpuArray로 지정할 수도 있습니다.

  p를 gpuArray로 지정하는 경우 반환되는 배열의 기본 유형은 p와 같습니다.

자세한 내용은 GPU에서 MATLAB 함수 실행하기 (Parallel Computing Toolbox) 항목을 참조하십시오.

분산 배열

Parallel Computing Toolbox™를 사용하여 대규모 배열을 클러스터의 결합된 메모리에 걸쳐 분할할 수 있습니다.

사용법 관련 참고 및 제한 사항:

• codistributed 또는 distributed 배열에 대해서는 스트림 구문 rand(s,___)가 지원되지 않습니다.

• typename을 'codistributed' 또는 'distributed'로 지정할 수 있습니다. typename을 'codistributed' 또는 'distributed'로 지정하면 반환된 배열의 디폴트 기본 유형은 double입니다.

  기본 유형 datatype을 갖는 분산 배열 또는 공동분산 배열을 만들려면 typename 앞에 추가 인수로 기본 유형을 지정하십시오. 예를 들어, X = rand(3,datatype,'distributed')는 기본 유형이 datatype이고 난수로 구성된 3×3 분산 행렬을 만듭니다.

  기본 유형 datatype은 다음 옵션 중 하나로 지정할 수 있습니다.

  • 'double'

  • 'single'

• 또한 p를 codistributed 또는 distributed 배열로 지정할 수도 있습니다.

  p를 codistributed 또는 distributed 배열로 지정하는 경우 반환되는 배열의 기본 유형은 p와 같습니다.

• 추가적인 codistributed 구문을 보려면 rand (codistributed) (Parallel Computing Toolbox) 함수를 참조하십시오.

자세한 내용은 분산 배열을 사용하여 MATLAB 함수 실행 (Parallel Computing Toolbox) 항목을 참조하십시오.

버전 내역

R2006a 이전에 개발됨

R2022a: "like"로 실수/복소수 여부를 일치시키고 "like"를 RandStream 객체와 함께 사용함

"like" 입력값은 실수 및 복소수 프로토타입 배열을 모두 지원합니다. 예를 들면 다음과 같습니다.

r = rand(2,2,"like",1i)

r =

   0.8147 + 0.9058i   0.6324 + 0.0975i
   0.1270 + 0.9134i   0.2785 + 0.5469i

모든 구문에서 이 기능을 지원합니다. 또한, 이제 "like"를 RandStream 객체와 함께 rand의 첫 번째 입력값으로 사용할 수 있습니다.

R2014a: 'like'를 사용해서 기존 변수의 데이터형과 일치시킴

기존 변수와 동일한 데이터형으로 난수를 생성하려면 구문 rand(__,'like',p)를 사용하십시오. 예를 들어, 다음과 같이 합니다.

A = single(pi);
r = rand(4,4,'like',A);
class(r)

ans = 
single

이 기능은 RandStream 객체를 rand에 대한 첫 번째 입력값으로 전달하는 경우 사용할 수 없습니다.

R2013b: 정수가 아닌 크기 입력값은 지원되지 않음

정수가 아닌 차원을 지정하면 오류가 발생합니다. floor를 사용하여 정수가 아닌 크기 입력값을 정수로 변환합니다.

R2008b: 'seed', 'state', 'twister' 입력값은 권장되지 않습니다.

rand, randi 및 randn의 기반이 되는 난수 생성기를 제어하는 이러한 입력값을 제거할 계획은 없습니다. 하지만 rng 함수가 다음과 같은 이유로 권장됩니다.

• 'seed' 및 'state' 생성기에는 결함이 있습니다.

• 'seed' 및 'state'라는 용어는 생성기에 대해 오해를 불러일으키는 이름입니다. 'seed'는 시드 초기화 값이 아니라 MATLAB v4 생성기를 나타냅니다. 'state'는 생성기의 내부 상태가 아니라 v5 생성기를 나타냅니다.

• 이 세 개의 입력값은 rand와 randn에 불필요하게 다른 생성기를 사용합니다.

코드 업데이트에 대한 자세한 내용은 권장되지 않는 rand 구문과 randn 구문 대체하기 항목을 참조하십시오.

참고 항목

randi | randn | rng | RandStream | sprand | sprandn | randperm

도움말 항목

• 난수로 구성된 배열 만들기
• 반복 가능한 난수 생성하기
• 각기 다른 난수 생성하기
• 특정 범위 내 난수
• 구 내의 난수
• 난수 스트림을 만들고 제어하기
• 배열 생성 함수에 대한 클래스 지원
• 권장되지 않는 rand 구문과 randn 구문 대체하기
• 시작 후 난수가 반복되는 이유

×

예제 열기

이 예제의 수정된 버전이 있습니다. 사용자가 편집한 내용을 반영하여 이 예제를 여시겠습니까?

아니요, 수정된 버전을 덮어씁니다. 예