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

histc

(권장되지 않음) 히스토그램 Bin 도수

histc는 권장되지 않습니다. histcounts를 대신 사용하십시오.

코드 업데이트에 대한 제안 사항을 비롯한 자세한 내용은 권장되지 않는 hist 및 histc 인스턴스의 대체 방법 항목을 참조하십시오.

구문

bincounts = histc(x,binranges)

bincounts = histc(x,binranges,dim)

[bincounts,ind] = histc(___)

설명

bincounts = histc(x,binranges)는 x에서 각각의 지정된 Bin 범위 내에 있는 값의 개수를 셉니다. 입력 인수 binranges는 각 Bin에 대한 끝점을 결정합니다. 출력 인수 bincounts는 각 Bin에 있는 x의 요소의 수를 포함합니다.

• x가 벡터인 경우 histc는 bincounts를 히스토그램 Bin 도수로 구성된 벡터로 반환합니다.

• x가 행렬인 경우 histc는 x의 각 열을 따라 동작하고, bincounts를 각 열에 대한 히스토그램 Bin 도수의 행렬로 반환합니다.

히스토그램을 플로팅하려면 bar(binranges,bincounts,'histc')를 사용합니다.

bincounts = histc(x,binranges,dim)은 차원 dim을 따라 동작합니다.

[bincounts,ind] = histc(___)는 x의 각 항목이 정렬되는 Bin 번호를 나타내는, x와 크기가 같은 배열인 ind를 반환합니다. 이전의 입력 인수 조합 중 하나와 함께 다음 구문을 사용합니다.

예제

히스토그램 플롯 생성

randn의 출력값이 반복되도록 난수 생성기를 초기화합니다.

rng(0,'twister')

x를 정규분포된 난수 100개로 정의합니다. Bin을 -4와 4 사이의 범위로 정의합니다. 각 지정된 Bin 범위 내에 있는 x에서 값의 수를 확인합니다. 각 Bin에 있는 요소 개수를 bincounts에 반환합니다.

x = randn(100,1);
binranges = -4:4;
[bincounts] = histc(x,binranges)

bincounts = 9×1

     0
     2
    17
    28
    32
    16
     3
     2
     0

히스토그램을 플로팅하려면 bar 함수를 사용하십시오.

figure
bar(binranges,bincounts,'histc')

히스토그램에 대한 Bin 번호 반환

나이로 이루어진 벡터를 ages에 정의합니다. ages를 0과 75 사이의 다양한 간격을 갖는 Bin으로 분류합니다.

ages = [3,12,24,15,5,74,23,54,31,23,64,75];
binranges = [0,10,25,50,75];

[bincounts,ind] = histc(ages,binranges)

bincounts = 1×5

     2     5     1     3     1

ind = 1×12

     1     2     2     2     1     4     2     4     3     2     4     5

bincounts는 각 Bin에서 값의 수를 포함합니다. ind는 Bin 번호를 나타냅니다.

입력 인수

x — 정렬할 값

벡터 | 행렬

정렬할 값으로, 벡터 또는 행렬로 지정됩니다. Bin 도수는 NaN이거나 지정된 Bin 범위 밖에 위치하는 x의 값을 포함하지 않습니다. x가 복소수 값을 포함하는 경우 histc는 허수부를 무시하고 실수부만 사용합니다.

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

binranges — Bin 범위

벡터 | 행렬

Bin 범위로, 각각의 연속된 열을 따라 단조 비감소 값의 벡터 또는 단조 비감소 값의 행렬로 지정됩니다. binranges의 값은 각 Bin의 좌측 및 우측 끝점을 결정합니다. binranges가 복소수 값을 포함하는 경우 histc는 허수부를 무시하고 실수부만 사용합니다.

binranges가 행렬인 경우, histc는 연속된 열을 따라 내려가는 값을 사용하여 Bin 범위를 결정합니다. 각 Bin은 좌측 끝점은 포함하지만 우측 끝점은 포함하지 않습니다. 마지막 Bin은 binranges의 마지막 값에 해당하는 스칼라 값으로 구성됩니다.

예를 들어, binranges가 벡터 [0,5,10,13]과 같은 경우, histc는 네 개의 Bin을 생성합니다. 첫 번째 Bin은 0보다 크거나 같고 5보다 작은 값을 포함하고, 두 번째 Bin은 5보다 크거나 같고 10보다 작은 값을 포함하는 식으로 계속됩니다. 마지막 Bin은 스칼라 값 13을 포함합니다.

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

dim — 동작이 수행될 차원

스칼라

동작이 수행될 차원으로, 스칼라로 지정됩니다.

출력 인수

bincounts — 각 Bin의 요소 개수

벡터 | 행렬

각 Bin의 요소 개수로, 벡터 또는 행렬로 반환됩니다. bincounts의 마지막 항목은 binranges의 마지막 항목과 같은 x의 값의 개수입니다.

ind — Bin 인덱스 번호

벡터 | 행렬

Bin 인덱스 번호로, 벡터 또는 x와 동일한 크기의 행렬로 반환됩니다.

팁

• x의 값이 지정된 Bin 범위를 벗어난 경우, histc는 Bin 도수에 이러한 값을 포함하지 않습니다. x의 모든 값이 Bin 도수에 포함되도록 하려면 binranges 벡터를 -inf와 inf로 시작하고 끝내야 합니다.

확장 기능

C/C++ 코드 생성

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

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

• 입력 인수 x에 대해 다음이 적용됩니다.

  • 차원을 지정하지 않을 경우 코드 생성기는 입력 배열에서 가변 크기이거나 크기가 1이 아닌 첫 번째 차원을 따라 연산을 수행합니다. 이 차원이 코드 생성 시점에 가변 크기이고 런타임에 1인 경우, 런타임 오류가 발생할 수 있습니다. 이 오류를 피하려면 차원을 지정하십시오.

• 런타임에 열 벡터인 가변 크기 배열의 출력값은 행 벡터가 아니라 열 벡터입니다.

• dim 인수가 사용될 경우, 이 인수는 코드 생성 시 상수여야 합니다.

스레드 기반 환경

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

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

분산 배열

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

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

버전 내역

R2006a 이전에 개발됨

참고 항목

bar | hist | mode | histogram | histcounts