이 번역 페이지는 최신 내용을 담고 있지 않습니다. 최신 내용을 영문으로 보려면 여기를 클릭하십시오.

range

값 범위

구문

y = range(X)

y = range(X,'all')

y = range(X,dim)

y = range(X,vecdim)

설명

y = range(X)는 X에 포함된 표본 데이터의 최댓값과 최솟값 간의 차이를 반환합니다.

• X가 벡터인 경우, range(X)는 X의 값 범위입니다.

• X가 행렬인 경우, range(X)는 X의 각 열의 범위를 포함하는 행 벡터입니다.

• X가 다차원 배열인 경우, range는 X의 첫 번째 비한원소 차원을 따라 연산을 수행하고 값을 벡터로 처리합니다. 이 차원의 크기는 1이 되고 다른 모든 차원의 크기는 변경되지 않습니다. X가 첫 번째 차원이 0인 빈 배열인 경우, range(X)는 X와 동일한 크기의 빈 배열을 반환합니다.

y = range(X,'all')은 X에 있는 모든 요소의 범위를 반환합니다.

y = range(X,dim)은 X의 연산 차원 dim을 따라 범위를 반환합니다. 예를 들어, X가 행렬인 경우 range(X,2)는 각 행의 범위 값을 포함하는 열 벡터입니다.

y = range(X,vecdim)은 벡터 vecdim에 지정된 차원을 따라 범위를 반환합니다. 예를 들어, X가 행렬인 경우 행렬의 모든 요소가 차원 1과 차원 2로 정의된 배열 슬라이스에 포함되기 때문에 range(X,[1 2])는 X에 포함된 모든 요소의 범위입니다.

예제

표준정규 난수의 범위

표준정규 난수로 구성된 5개 대규모 표본을 생성합니다.

rng('default') % For reproducibility
rv = normrnd(0,1,1000,5);

표본의 범위 값을 구합니다.

near6 = range(rv)

near6 = 1×5

    6.8104    6.6420    6.9578    6.0860    6.8165

각 표본의 범위 값은 대략적으로 6입니다.

시험 점수 범위

다섯 번의 시험에 대해 시험 점수의 범위를 구합니다.

examgrades 데이터 세트를 불러옵니다.

load examgrades

모든 시험 점수의 범위를 구합니다.

y = range(grades,'all')

y = 46

학생별 시험 점수 범위

다섯 번의 시험에 대해 학생별로 시험 점수의 범위를 구합니다.

examgrades 데이터 세트를 불러옵니다.

load examgrades

처음 10명의 학생에 대한 시험 점수의 범위를 구합니다. 예를 들어, 여덟 번째 학생의 최고 시험 점수와 최저 시험 점수의 차이는 7점입니다.

X = grades(1:10,:);
y = range(X,2)

y = 10×1

    12
    13
    10
    12
     8
    16
    14
     7
    12
    10

벡터 차원을 따른 범위

여러 차원을 따라 다차원 배열의 범위를 구합니다.

평균 mu = 2이고 표준편차 sigma = 7인 정규분포 난수로 구성된 3×5×2 배열을 생성합니다.

rng('default') % For reproducibility
mu = 2;
sigma = 7;
X = normrnd(mu,sigma,[3 5 2])

X = 
X(:,:,1) =

    5.7637    8.0352   -1.0351   21.3861    7.0778
   14.8372    4.2314    4.3984   -7.4492    1.5586
  -13.8119   -7.1538   27.0488   23.2445    7.0032


X(:,:,2) =

    0.5652   11.8632   -6.4524    5.4223   -0.1241
    1.1310   11.9203    7.0207    9.2429    4.0571
   12.4279    6.7005   13.4116    7.0882   -3.5110

차원 1과 차원 2를 연산 차원으로 지정하여 X의 각 페이지 범위를 구합니다.

ypage = range(X,[1 2])

ypage = 
ypage(:,:,1) =

   40.8607


ypage(:,:,2) =

   19.8641

예를 들어, ypage(1,1,2)는 X(:,:,2)에 포함된 모든 요소의 범위입니다.

차원 2와 차원 3을 연산 차원으로 지정하여 각 X(i,:,:) 슬라이스에 포함된 요소의 범위를 구합니다.

yrow = range(X,[2 3])

yrow = 3×1

   27.8385
   22.2864
   40.8607

예를 들어, yrow(3)은 X(3,:,:)에 포함된 모든 요소의 범위입니다.

입력 인수

X — 데이터 표본

스칼라 | 벡터 | 행렬 | 다차원 배열

데이터 표본으로, 스칼라, 벡터, 행렬 또는 다차원 배열로 지정됩니다.

• X가 스칼라인 경우, range(X)는 0입니다.

• X가 0×0의 빈 배열인 경우, range(X)도 빈 배열입니다.

데이터형: single | double | logical | datetime | duration

dim — 연산을 수행할 차원

양의 정수 스칼라

연산을 수행할 차원으로, 양의 정수 스칼라로 지정됩니다. 값을 지정하지 않으면 디폴트 값은 크기가 1이 아닌 첫 번째 배열 차원이 됩니다.

dim은 길이가 1로 줄어드는 차원을 나타냅니다. size(X,dim)이 0이 아니면 size(y,dim)은 1이 되고, 다른 모든 차원의 크기는 변경되지 않습니다. size(X,dim)이 0이면 range(X,dim)은 X와 동일한 크기의 빈 배열을 반환합니다.

2차원 데이터 표본 X가 있다고 가정하겠습니다.

• dim이 1인 경우, range(X,1)은 각 열의 범위를 포함하는 행 벡터를 반환합니다.

• dim이 2인 경우, range(X,2)는 각 행의 범위를 포함하는 열 벡터를 반환합니다.

dim이 ndims(X)보다 큰 경우 range는 X와 동일한 차원 및 누락값을 갖는 0으로 구성된 배열을 반환합니다.

데이터형: single | double

vecdim — 차원의 벡터

양의 정수 벡터

차원의 벡터로, 양의 정수 벡터로 지정됩니다. vecdim의 각 요소는 입력 배열 X의 차원을 나타냅니다. 출력값 y는 지정된 연산 차원에서 길이가 1입니다. 다른 차원 길이는 X 및 y에서 같습니다.

예를 들어, X가 2×3×3 배열인 경우 range(X,[1 2])는 1×1×3 배열을 반환합니다. 출력 배열의 각 요소는 X의 대응되는 페이지에 있는 요소의 범위입니다.

데이터형: single | double

출력 인수

y — 최댓값과 최솟값의 차이

스칼라 | 벡터 | 행렬 | 다차원 배열

최댓값과 최솟값의 차이로, 스칼라, 벡터, 행렬 또는 다차원 배열로 반환됩니다.

팁

• range는 NaN을 누락값으로 처리하여 무시합니다.

• range는 표본의 산포를 단순하게 계산한 추정값을 제공합니다. 이상값은 이 통계량에 과도한 영향을 미치므로 이상값을 갖는 데이터에는 range를 사용하지 마십시오.

확장 기능

tall형 배열

메모리에 담을 수 없을 정도로 많은 행을 가진 배열을 계산할 수 있습니다.

이 함수는 tall형 배열을 완전히 지원합니다. 자세한 내용은 tall형 배열 항목을 참조하십시오.

스레드 기반 환경

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

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

GPU 배열

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

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

• 'all' 및 vecdim 입력 인수는 지원되지 않습니다.

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

버전 내역

R2006a 이전에 개발됨

참고 항목

std | iqr | mad