hist

(권장되지 않음) 히스토그램 플롯

hist는 권장되지 않습니다. histogram을 대신 사용하십시오.

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

구문

hist(x)

hist(x,nbins)

hist(x,xbins)

hist(ax,___)

counts = hist(___)

[counts,centers] = hist(___)

설명

hist(x)는 벡터 x에 있는 요소의 히스토그램 막대 차트를 생성합니다. x의 요소는 x의 최솟값과 최댓값 사이에 있는 x축상의 10개의 균일한 간격의 Bin으로 분류됩니다. hist는 각 사각형의 높이가 Bin이 가지는 요소 개수를 나타내도록 Bin을 사각형으로 표시합니다.

입력값이 다중 열 배열인 경우 hist는 x의 각 열에 대한 히스토그램을 생성하고 이 히스토그램을 단일 플롯 위에 겹칩니다.

입력값의 데이터형이 categorical인 경우 각 Bin은 x의 범주입니다.

hist(x,nbins)는 x를 스칼라 nbins로 지정된 개수만큼의 Bin으로 분류합니다.

hist(x,xbins)는 x를 벡터 xbins에 의해 결정되는 간격 또는 범주의 Bin으로 분류합니다.

• xbins가 간격이 균일한 값의 벡터인 경우 hist는 값을 Bin 중심값으로 사용합니다.

• xbins가 간격이 균일하지 않은 값의 벡터인 경우 hist는 연속된 값의 중간점을 Bin 경계값으로 사용합니다.

• x의 데이터형이 categorical인 경우 xbins는 categorical형 벡터이거나 범주를 지정하는 문자형 벡터로 구성된 셀형 배열이어야 합니다. hist는 이러한 범주에 대해서만 막대를 플로팅합니다.

벡터 xbins의 길이는 Bin 개수와 동일합니다.

hist(ax,___)는 현재 좌표축(gca) 대신 ax로 지정된 좌표축에 플로팅됩니다. 옵션 ax는 위에 열거된 구문의 입력 인수 조합보다 먼저 나올 수 있습니다.

counts = hist(___)는 각 Bin의 요소 개수를 포함하는 행 벡터 counts를 반환합니다.

[counts,centers] = hist(___)는 x축에서 각 Bin 중심값의 위치를 나타내는 추가 행 벡터 centers를 반환합니다.

예제

벡터의 히스토그램

x = [0 2 9 2 5 8 7 3 1 9 4 3 5 8 10 0 1 2 9 5 10];
hist(x)

hist는 x의 값을 벡터의 최솟값과 최댓값 사이에서(이 예제에서는 각각 0과 10) 균일한 간격을 가지는 10개의 Bin으로 분류합니다.

다중 열의 히스토그램

1,000개의 난수로 구성된 열을 3개 생성하고, 3개 열이 겹쳐진 히스토그램을 플로팅합니다.

x = randn(1000,3); 
hist(x)

x의 값은 최솟값과 최댓값 사이에서 균일한 간격을 가지는 10개의 Bin으로 분류됩니다. hist는 x의 열을 별도로 분류하고 비닝한 다음 각 열을 다른 색으로 플로팅합니다.

히스토그램 Bin의 개수 지정

1,000개의 난수가 균일한 간격의 50개 Bin으로 분류된 히스토그램을 플로팅합니다.

x = randn(1000,1);  
nbins = 50;
hist(x,nbins)

계산용으로만 hist 사용

1,000개의 난수를 생성합니다. 균일한 간격의 10개 Bin에 각각 몇 개의 난수가 있는지 셉니다. Bin 도수와 Bin 중심값을 반환합니다.

x = randn(1000,1);  
[counts,centers] = hist(x)

counts = 1×10

     4    27    88   190   270   243   123    38    13     4

centers = 1×10

   -2.8915   -2.2105   -1.5294   -0.8484   -0.1673    0.5137    1.1947    1.8758    2.5568    3.2379

bar를 사용하여 히스토그램을 플로팅합니다.

bar(centers,counts)

히스토그램 색 지정

1,000개의 난수를 생성하고 히스토그램을 만듭니다.

data = randn(1000,1);
hist(data)

히스토그램 플롯을 생성하는 patch 객체에 대한 핸들을 가져옵니다.

h = findobj(gca,'Type','patch');

플로팅된 막대의 면 색을 RGB 3색 값 [0 0.5 0.5]로 설정합니다. 모서리 색을 흰색으로 설정합니다.

h.FaceColor = [0 0.5 0.5];
h.EdgeColor = 'w';

입력 인수

x — 입력 배열

벡터 또는 행렬

입력 벡터 또는 행렬입니다.

• x가 벡터인 경우 hist는 히스토그램 하나를 생성합니다.

• x가 행렬인 경우 hist는 각 열에 대해 별도의 히스토그램을 생성하고, 서로 다른 색을 사용하여 히스토그램을 플로팅합니다.

입력 배열이 NaN 또는 정의되지 않은 categorical형 값을 포함하는 경우 hist는 이러한 값을 Bin 도수에 포함시키지 않습니다.

입력 배열이 무한대 값 -Inf 또는 Inf를 포함하는 경우, hist는 -Inf를 첫 번째 Bin에 그리고 Inf를 마지막 Bin에 정렬합니다. Bin 구간을 지정하지 않을 경우 hist는 입력 배열 내의 유한 값만 사용하여 Bin 구간을 계산합니다.

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

nbins — Bin 개수

10 (디폴트 값) | 스칼라

Bin 개수입니다. 입력 인수 x는 categorical형이 아니라 숫자형이어야 합니다.

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

xbins — Bin 위치 또는 범주

벡터

Bin 위치 또는 범주로, 벡터로 지정됩니다.

x가 숫자형이거나 논리형이면 xbins는 single형 또는 double형이어야 합니다.

• xbins의 요소 사이 간격이 균일한 경우, 이들 요소는 Bin 중심값입니다.

• xbins의 요소 사이 간격이 균일하지 않은 경우, 이들 요소는 x축을 따라 마커로 표시되지만 실제 Bin 중심값은 아닙니다. 대신 hist가 벡터 xbins의 연속 요소 사이의 중간점을 Bin 경계값으로 계산합니다. Bin 경계값을 직접 지정하려면 histc를 사용하십시오.

• xbins는 유한한 값만을 포함해야 합니다. 첫 번째와 마지막 Bin은 x의 최솟값과 최댓값을 포함하도록 확장됩니다.

x가 categorical형인 경우 xbins는 categorical형 벡터이거나 범주를 지정하는 문자형 벡터로 구성된 셀형 배열이어야 합니다. hist는 xbins로 지정된 범주에 대해서만 막대를 플로팅합니다.

ax — axes 객체

axes 객체

axes 객체입니다. ax를 사용하면 현재 좌표축(gca) 대신 특정 axes에 히스토그램을 플로팅할 수 있습니다.

출력 인수

counts — 각 Bin의 요소 개수(Bin 도수)

행 벡터

각 Bin의 요소 개수로, 행 벡터로 반환됩니다.

centers — Bin 중심값 또는 범주

벡터

Bin 중심값 또는 범주로, 벡터로 반환됩니다. 구문 [counts,centers] = hist(x,xbins)와 함께 사용될 경우 centers 출력값은 xbins 입력값과 동일한 요소를 갖습니다.

• x가 숫자형이거나 논리형이면 centers는 숫자형 행 벡터입니다.

• x가 categorical형이면 centers는 문자형 벡터로 구성된 셀형 배열입니다.

확장 기능

C/C++ 코드 생성

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

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

• 코드 생성 시에는 히스토그램 막대 차트 생성이 지원되지 않습니다. 출력 인수를 하나 이상 사용하여 hist를 호출하십시오.

• ax 입력 인수는 지원되지 않습니다.

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

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

  • 코드 생성 시 입력 벡터를 고정 크기 벡터나 가변 길이 벡터로 지정해야 합니다. 벡터의 첫 번째 차원 또는 두 번째 차원은 가변 크기일 수 있습니다. 다른 모든 차원은 고정 크기 1을 가져야 합니다.

• 입력 배열 x의 값은 실수여야 합니다.

• 생성된 코드에 의한 벡터 출력값 방향이 MATLAB^®에 의한 벡터 출력값 방향과 일치하지 않을 수 있습니다.

• 코드 생성 시 x가 가변 크기 행렬이면 x는 런타임 시 행 벡터일 수 없습니다. 이 오류를 피하려면 x를 고정 크기 또는 가변 길이 행 벡터로 지정하십시오.

GPU 배열

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

hist 함수는 GPU 배열 입력값을 지원하지만 다음과 같은 사용법 관련 참고 및 제한 사항이 있습니다.

• 이 함수는 GPU 배열을 받지만 GPU에서 실행되지는 않습니다.

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

분산 배열

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

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

• 이 함수는 분산 배열에 대해 연산을 수행하지만 클라이언트 측의 MATLAB에서 실행됩니다.

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

버전 내역

R2006a 이전에 개발됨

참고 항목

bar | histc | mode | patch | rose | stairs | histogram | histcounts