randsample

임의 표본

구문

y = randsample(n,k)

y = randsample(population,k)

y = randsample(___,replacement)

y = randsample(n,k,true,w)

y = randsample(population,k,true,w)

y = randsample(s,___)

설명

y = randsample(n,k)는 정수 1에서 n 사이의 범위에서 균일하게 무작위 비복원추출된 k개의 값을 반환합니다.

y = randsample(population,k)는 벡터 population의 값에서 균일하게 무작위 비복원추출된 k개 값으로 구성된 벡터를 반환합니다.

y = randsample(___,replacement)는 replacement가 true인 경우 복원추출된 표본을 반환하고, replacement가 false인 경우 비복원추출된 표본을 반환합니다. 위에 열거된 구문대로 입력 인수를 조합하고 그 뒤에 replacement를 지정합니다.

y = randsample(n,k,true,w)는 길이가 n인, 음이 아닌 가중치로 구성된 벡터 w를 사용하여 정수 i가 y의 요소로 선택될 확률을 확인합니다.

y = randsample(population,k,true,w)는 벡터 population과 같은 길이의, 음이 아닌 가중치로 구성된 벡터 w를 사용하여 값 population(i)가 y의 요소로 선택될 확률을 확인합니다.

y = randsample(s,___) 는 난수 생성 시 스트림 s를 사용합니다. 옵션 s는 위에 열거된 구문의 입력 인수 앞에 들어갈 수 있습니다. s는 RandStream 클래스의 멤버입니다.

예제

범위에서 고유한 값 추출하기

정수 1부터 10까지에서 단일 값을 추출합니다.

n = 10;
x = randsample(n,1)

x = 9

모집단 벡터에서 표본 추출하기

결과 재현이 가능하도록 난수 시드값을 생성합니다.

s = RandStream('mlfg6331_64'); 

벡터 [10:20]에서 단일 값을 추출합니다.

population = 10:20;
y = randsample(s,population,1)

y = 17

지정된 확률에 따른 랜덤 시퀀스 생성하기

재현이 가능하도록 난수 스트림을 생성합니다.

s = RandStream('mlfg6331_64');

지정된 확률에 따라 수열 ACGT에서 무작위 복원추출 방식으로 48개 문자를 선택합니다.

R = randsample(s,'ACGT',48,true,[0.15 0.35 0.35 0.15])

R = 
'GGCGGCGCAAGGCGCCGGACCTGGCTGCACGCCGTTCCCTGCTACTCG'

난수 스트림 설정하기

재현이 가능하도록 난수 스트림을 생성합니다.

s = RandStream('mlfg6331_64'); 

정수 1:10에서 5개 값을 복원추출합니다.

y = randsample(s,10,5,true)

y = 5×1

     7
     8
     5
     7
     8

입력 인수

n — 범위의 상한

양의 정수

표본을 추출할 범위(1~n)의 상한으로, 양의 정수로 지정됩니다. 기본적으로, randsample은 범위 1~n의 값에서 균일하게 무작위 비복원추출합니다.

데이터형: single | double

population — 입력 데이터

벡터

표본을 추출할 입력 데이터로, 벡터로 지정됩니다. 기본적으로, randsample은 population의 값에서 균일하게 무작위 비복원추출합니다. y의 방향(행 또는 열)은 population의 방향과 같습니다.

population이 음이 아닌 정수 값만 포함하는 숫자형 벡터이고 population이 길이 1을 가질 수 있는 경우 y = randsample(population,k) 대신 y = population(randsample(length(population),k)) 또는 y = datasample(population,k,'Replace',false)를 사용합니다.

예: y = randsample([50:100],20)은 50에서 100 사이의 정수로 구성된 population 벡터에서 균일하게 무작위 비복원추출된 20개의 값으로 구성된 벡터를 반환합니다.

데이터형: single | double | logical | char | string | categorical

k — 표본 개수

양의 정수

표본 개수로, 양의 정수로 지정됩니다.

예: randsample(20,10)은 정수 1에서 20 사이의 범위에서 균일하게 무작위 비복원추출된 10개의 값으로 구성된 벡터를 반환합니다.

데이터형: single | double

replacement — 복원추출을 나타내는 표시자

false (디폴트 값) | true

복원추출을 나타내는 표시자로, false 또는 true로 지정됩니다.

예: randsample(10,2,true)는 정수 1에서 10 사이의 범위에서 복원추출된 두 개의 값을 반환합니다.

데이터형: logical

w — 표본 추출 가중치

ones(n,1) (디폴트 값) | 음이 아닌 스칼라 값으로 구성된 벡터

표본 추출 가중치로, 음이 아닌 스칼라 값으로 구성된 벡터로 지정됩니다. w의 길이는 population의 길이 또는 표본을 추출할 정수 범위와 같아야 합니다. 벡터 w는 최소 하나의 양수 값을 가져야 합니다. w가 음수 값 또는 NaN 값을 포함하는 경우, randsample은 오류 메시지를 표시합니다. randsample 함수는 w(i)/sum(w)에 비례하는 확률로 표본을 추출합니다. 일반적으로, w는 확률로 구성된 벡터입니다. randsample 함수에서는 복원추출에만 가중치를 지정할 수 있습니다.

예: [0.1 0.5 0.35 0.46]

데이터형: single | double

s — 난수 스트림

MATLAB^®의 디폴트 난수 스트림 (디폴트 값) | RandStream

난수 스트림으로, MATLAB의 디폴트 난수 스트림 또는 RandStream으로 지정됩니다. 자세한 내용은 난수 스트림을 만들고 제어하기 항목을 참조하십시오.

예: s = RandStream('mlfg6331_64')는 승산식 시차 피보나치 수열(Multiplicative Lagged Fibonacci) 생성기 알고리즘을 사용하는 난수 스트림을 생성합니다.

출력 인수

y — 표본

벡터 | 스칼라

표본으로, 벡터 또는 스칼라로 반환됩니다.

• k = 1인 경우, y는 스칼라입니다.

• k > 1인 경우, y는 k×1 벡터입니다.

대체 기능

데이터를 무작위로 복원추출 또는 비복원추출하려면 datasample을 사용하십시오.

확장 기능

C/C++ 코드 생성

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

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

• 비복원추출을 수행할 경우 출력값 순서는 MATLAB의 순서와 일치하지 않을 수 있습니다.

• 코드 생성 시 난수 스트림 입력 인수 s는 지원되지 않습니다.

코드 생성에 대한 자세한 내용은 Introduction to Code Generation 항목 및 General Code Generation Workflow 항목을 참조하십시오.

GPU 배열

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

이 함수는 GPU 배열을 완전히 지원합니다. 자세한 내용은 GPU에서 MATLAB 함수 실행하기 (Parallel Computing Toolbox) 항목을 참조하십시오.

버전 내역

R2006a 이전에 개발됨

참고 항목

datasample | rand | randperm | RandStream