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

bar3h

3차원 가로 막대 그래프

• 

×

구문

bar3h(y)

bar3h(z,y)

bar3h(___,width)

bar3h(___,style)

bar3h(___,color)

bar3h(ax,___)

h = bar3h(___)

설명

bar3h(y)는 y 요소의 3차원 가로 막대 그래프를 만듭니다. 각 막대는 y의 요소에 대응합니다.

• 단일 막대 계열을 플로팅하려면 y를 벡터로 지정하십시오. 길이가 m인 벡터의 경우 함수는 범위가 1부터 m까지인 z축에 막대를 플로팅합니다.

• 여러 개의 막대 계열을 플로팅하려면 y를 계열마다 열을 하나씩 갖는 행렬로 지정하십시오. m×n 행렬의 경우 함수는 범위가 1부터 n까지인 x축과 범위가 1부터 m까지인 z축에 막대를 플로팅합니다.

bar3h(z,y)는 z에 지정된 z 값에 y의 요소에 대한 가로 막대 그래프를 만듭니다.

bar3h(___,width)는 x축과 z축을 따라 막대의 너비를 설정하며 그룹 내에서 막대 간 구분 방법을 제어하는 데 사용됩니다. 기본적으로 width는 0.8이며 막대는 서로 약간의 간격을 두고 구분됩니다. width가 1이면 그룹 내에서 막대가 서로 접하게 됩니다. 이전 구문에 나와 있는 입력 인수 조합 중 하나와 더불어 width를 지정합니다.

bar3h(___,style)은 막대의 스타일을 지정합니다. 여기서 style은 "detached", "grouped" 또는 "stacked"일 수 있습니다. 디폴트 스타일은 "detached"입니다.

bar3h(___,color)는 color에 지정된 색을 사용하여 모든 막대를 표시합니다. 예를 들어, 모든 빨간색 막대를 지정하려면 "r"을 사용합니다.

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

h = bar3h(___)는 하나 이상의 Surface 객체를 반환합니다. y가 벡터인 경우 bar3h는 Surface 객체를 하나 생성합니다. y가 행렬이면 bar3h는 각 계열에 대해 Surface 객체를 반환합니다. h를 사용하면 막대 그래프를 표시한 후에 막대의 속성을 설정할 수 있습니다. 속성 목록은 Surface 속성 항목을 참조하십시오.

예제

벡터 데이터의 3차원 가로 막대 그래프

y를 5개의 값으로 구성된 벡터로 지정합니다. 이러한 값을 각 막대의 높이가 y의 값에 대응하고 y축 위치가 그 값의 인덱스에 대응하는 3차원 가로 막대 계열로 플로팅합니다.

y = [50 40 30 20 10];
bar3h(y);

행렬 데이터의 3차원 가로 막대 그래프

y를 행렬로 지정합니다. 각 계열이 y의 열에 대응하는, y의 3차원 가로 막대 그래프를 만듭니다.

y = [1 4 7; 2 5 8; 3 6 9; 4 7 10];
bar3h(y)

막대 위치 지정

z를 y의 막대에 대한 z축 위치로 구성된 벡터로 지정합니다. 지정된 z축 위치에 막대를 플로팅합니다.

z = [1950 1960 1970 1980 1990];
y = [16 8 4 2 1];
bar3h(z,y)

막대 너비 및 스타일 지정하기

y를 4개 계열로 구성된 행렬로 지정합니다. 'grouped' 스타일을 사용하여 서로 그룹화된 각 행에 대한 데이터로 y를 플로팅합니다. 같은 그룹의 막대 사이에 있는 간격을 없애기 위해 width를 1로 설정합니다.

y = [70 50 33 10; 75 55 35 15; 80 60 40 20];
bar3h(y,1,'grouped')

막대 색 지정

0 ~ n 범위의 z 좌표 세트를 만듭니다. Z 값의 사인 함수를 3차원 가로 막대 그래프로 플로팅합니다. 색 사양 "r"을 사용하여 막대를 빨간색으로 만듭니다.

z = 0:pi/16:pi;
y = [sin(z')/4 sin(z')/2 sin(z')];
bar3h(z,y,1,"r")

계열 색 사용자 지정하기

막대 스타일은 "stacked"로, 막대 너비는 0.5로 하여 데이터 행렬 y를 플로팅합니다. 반환된 Surface 객체를 h에 저장합니다. 이 경우 h는 y의 각 열에 대한 요소가 하나씩 있는 4개 요소를 갖습니다.

bar3h은 디폴트 컬러맵을 기반으로 각 계열의 색을 지정합니다.

y = [19 30 21 30; 40 16 32 12];
h = bar3h(y,0.5,"stacked");

h의 대응하는 객체의 FaceColor를 설정하여 각 계열의 색을 사용자 지정합니다.

h(1).FaceColor = "k";
h(2).FaceColor = "white";
h(3).FaceColor = [.5 .7 .8];
h(4).FaceColor = [.9 .7 .8];

대상 좌표축 지정하기

R2019b 이상

tiledlayout 함수와 nexttile 함수를 사용하여 플롯을 타일 형식 배열로 표시할 수 있습니다. tiledlayout 함수를 호출하여 1×2 타일 형식 차트 레이아웃을 만듭니다. nexttile 함수를 호출하여 axes 객체 ax1과 ax2를 만듭니다. bar3h에 대한 첫 번째 인수로 axes 객체를 지정하여 좌표축에 별도의 이산 데이터 플롯을 만듭니다.

왼쪽 좌표축에 누적형 3차원 가로 막대 그래프를 표시합니다. 오른쪽 좌표축에 동일한 데이터를 사용하여 그룹형 가로 막대 그래프를 표시합니다.

tiledlayout(1,2)
y = [64 56 48; 49 42 35; 36 30 24];

% Left bar graph
ax1 = nexttile;
bar3h(ax1,y,0.5,"stacked")

% Right bar graph
ax2 = nexttile;
bar3h(ax2,y,1,"grouped")

입력 인수

y — y 좌표

벡터 | 행렬

y 좌표로, 벡터 또는 행렬로 지정됩니다. y의 차원에 따라 함수의 데이터 표시 방법이 결정됩니다. 다음 표에서는 가장 일반적인 경우를 설명합니다.

표시 방법	y와 z를 지정하는 방법	예제	결과
하나의 막대 계열 표시.	y와 z를 동일한 길이의 벡터로 지정합니다. z의 값은 고유해야 하지만 y의 값은 고유하지 않아도 됩니다. 또는 단순히 y 값을 지정합니다.	벡터 y와 벡터 z를 정의한 다음, 3차원 가로 막대 그래프를 만듭니다. z = [1 2 3 4]; y = [10 20 30 40]; bar3h(z,y) 또는 단순히 y 값을 지정합니다. bar3h(y)
x축을 따라 있는 여러 개의 막대 계열 표시.	z를 벡터로 지정하고 y를 행렬로 지정합니다. z의 요소 개수는 y의 행 개수와 일치해야 합니다. 또는 단순히 y 행렬을 지정합니다.	벡터 z와 행렬 y를 정의한 다음, 3개의 막대 계열을 가진 3차원 가로 막대 그래프를 만듭니다. z = [1 2 3 4]; y = [1 5 9; 2 6 10; 3 7 11; 4 8 12]; bar3h(z,y) 또는 단순히 y 값을 지정합니다. bar3h(y)

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

z — z 좌표

벡터

z 좌표로, 벡터로 지정됩니다. z의 값들은 순서대로 되어 있을 필요는 없지만, z의 크기는 y의 크기 및 데이터를 표시하려는 방법에 따라 달라집니다. 다음 표에서는 가장 일반적인 경우를 설명합니다.

표시 방법	y와 z를 지정하는 방법	예제	결과
하나의 막대 계열 표시.	y와 z를 동일한 길이의 벡터로 지정합니다. z의 값은 고유해야 하지만 y의 값은 고유하지 않아도 됩니다. 또는 단순히 y 값을 지정합니다.	벡터 z와 벡터 y를 정의한 다음, 3차원 가로 막대 그래프를 만듭니다. z = [1 2 3 4]; y = [10 20 30 40]; bar3h(z,y) 또는 단순히 y 값을 지정합니다. bar3h(y)
x축을 따라 있는 여러 개의 막대 계열 표시.	z를 벡터로 지정하고 y를 행렬로 지정합니다. z의 요소 개수는 y의 행 개수와 일치해야 합니다. 또는 단순히 y 행렬을 지정합니다.	벡터 z와 행렬 y를 정의한 다음, 3개의 막대 계열을 가진 3차원 가로 막대 그래프를 만듭니다. z = [1 2 3 4]; y = [1 5 9; 2 6 10; 3 7 11; 4 8 12]; bar3h(z,y) 또는 단순히 y 값을 지정합니다. bar3h(y)

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

width — 막대 너비

0.8 (디폴트 값) | 스칼라

막대 너비로, 각 막대의 사용 가능한 총 공간에 대한 비율을 나타내는 스칼라로 지정됩니다. 디폴트 값인 0.8은 막대 너비가 이전 막대에서 다음 막대까지의 거리의 80%이며 그 거리의 10% 간격이 막대 양쪽에 존재함을 의미합니다. 너비가 1이면 그룹 내에서 막대가 서로 접하게 됩니다.

예: bar3h([1 2 3],0.5)는 사용 가능한 공간의 50%를 사용하는 막대를 만듭니다.

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

style — 그룹 스타일

"detached" (디폴트 값) | "grouped" | "stacked"

그룹 스타일로, "detached", "grouped" 또는 "stacked"로 지정됩니다. 그룹 스타일에 따라 여러 개의 막대 계열이 서로를 기준으로 어떻게 표시되는지가 결정됩니다. y가 벡터이면 스타일은 그래프 모양에 영향을 주지 않습니다.

다음 표에는 각 그룹 스타일 옵션을 사용한 결과가 나와 있습니다.

그룹 스타일	결과	예제
"detached"	각 막대를 대응하는 x, z 값 위치에 표시합니다.
"grouped"	각 그룹을 z 값을 중심으로 인접해 있는 막대로 표시합니다.
"stacked"	각 그룹을 서로 다른 색으로 채색된 하나의 막대로 표시합니다. 막대 길이는 그룹 내 요소들의 합과 같습니다.

color — 막대 색

색 이름 | 짧은 이름

막대 색으로, 다음 표에 나와 있는 옵션 중 하나로 지정됩니다.

색 이름	짧은 이름	모양
'red'	'r'
'green'	'g'
'blue'	'b'
'cyan'	'c'
'magenta'	'm'
'yellow'	'y'
'black'	'k'
'white'	'w'

ax — axes 객체

axes 객체

axes 객체입니다. axes 객체를 지정하지 않으면 bar3h는 현재 좌표축에 막대 그래프를 만듭니다.

출력 인수

h — 표시된 가로 막대

Surface 객체로 구성된 벡터

표시된 가로 막대로, Surface 객체로 구성된 벡터로 반환됩니다. h의 요소를 사용하면 특정 가로 막대 계열이 생성된 후에 해당 막대 계열의 속성에 액세스하여 수정할 수 있습니다. 반환되는 Surface 객체의 수는 y의 크기에 따라 달라집니다. y가 벡터이면 h는 하나의 Surface 객체입니다. y가 행렬이면 h는 y의 각 열에 대한 Surface 객체를 포함하는 벡터입니다.

세부 정보

막대 계열

하나의 막대 계열은 y의 특정 열에 대응되는 막대들로 이루어집니다. bar3h 함수는 x축을 따라 서로 다른 위치에 각 계열을 표시합니다. 기본적으로 각 계열은 서로 다른 색입니다.

이 이미지에서는 첫 번째 계열이 강조 표시되어 있습니다.

막대 그룹

하나의 그룹은 특정 y 위치에 함께 배치된 막대들로 이루어집니다.

이 이미지에서는 세 번째 그룹이 강조 표시되어 있습니다.

팁

• 플로팅된 막대는 반환된 Surface 객체의 속성을 변경하여 수정할 수 있습니다. Surface 속성 목록은 Surface 속성 항목을 참조하십시오.

확장 기능

GPU 배열

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

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

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

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

분산 배열

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

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

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

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

버전 내역

R2006a 이전에 개발됨

R2022b: 데이터형 지원 확대

y 인수는 이제 숫자형과 duration형 값을 허용합니다. z 인수는 숫자형, datetime형, duration형, categorical형 값을 허용합니다. 이전 릴리스에서는 숫자형 값만 지원했습니다.

참고 항목

함수

• bar | barh | bar3 | patch

속성

• Surface 속성

도움말 항목

• 높이를 기준으로 3차원 막대 색 지정하기
• 막대 그래프 유형