pie

원형 차트

• 

×

구문

pie(X)

pie(X,explode)

pie(X,labels)

pie(X,explode,labels)

pie(ax,___)

p = pie(___)

설명

pie(X)는 X의 데이터를 사용하여 원형 차트를 그립니다. 원형 차트의 각 슬라이스는 X의 요소를 나타냅니다.

• sum(X) ≤ 1이면 X의 값이 원형 슬라이스의 면적을 직접 지정합니다. sum(X) < 1인 경우 pie는 원형 차트를 일부만 그립니다.

• sum(X) > 1이면 pie는 X/sum(X)로 값을 정규화하여 각 원형 슬라이스의 면적을 결정합니다.

• X의 데이터형이 categorical이면 슬라이스는 범주에 해당합니다. 각 슬라이스의 면적은 범주의 요소 개수를 X의 요소 개수로 나눈 값과 같습니다.

pie(X,explode)는 원형 차트에서 슬라이스를 분리합니다. explode는 X에 대응하는 0 그리고, 0이 아닌 요소로 구성된 벡터 또는 행렬입니다. pie 함수는 explode의 0이 아닌 요소에 대해서만 슬라이스를 분리합니다.

X의 데이터형이 categorical인 경우 explode는 범주에 대응하는 0과 0이 아닌 요소로 구성된 벡터이거나, 분리할 범주의 이름으로 구성된 셀형 배열일 수 있습니다.

pie(X,labels)는 원형 슬라이스 레이블 옵션을 지정합니다. 이 경우 X는 숫자여야 합니다.

pie(X,explode,labels)는 슬라이스를 분리하고 텍스트 레이블을 지정합니다. X는 숫자형 또는 categorical형일 수 있습니다.

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

p = pie(___)는 patch 그래픽스 객체와 text 그래픽스 객체의 벡터를 반환합니다. 입력값은 위에 열거된 구문의 입력 인수 조합 중 하나일 수 있습니다.

예제

분리된 슬라이스가 있는 원형 차트 생성하기

벡터 X의 원형 차트를 만듭니다.

X = [1 3 0.5 2.5 2];
pie(X)

대응하는 explode 요소를 1로 설정하여 두 번째와 네 번째 원형 슬라이스를 분리합니다.

explode = [0 1 0 1 0];
pie(X,explode)

원형 차트에 텍스트 레이블 지정하기

벡터 X의 원형 차트를 만들고 슬라이스에 레이블을 지정합니다.

X = 1:3;
labels = {'Taxes','Expenses','Profit'};
pie(X,labels)

원형 차트의 텍스트 레이블 수정하기

레이블이 지정된 원형 차트를 만든 다음 텍스트 레이블의 색과 글꼴 크기를 수정합니다.

X = 1:3;
labels = {'Taxes','Expenses','Profit'};
p = pie(X,labels)

p = 
  1x6 graphics array:

    Patch    Text     Patch    Text     Patch    Text 

레이블 'Profit'에 대한 text 객체를 가져옵니다. 이 객체의 색과 글꼴 크기를 변경합니다. 점 표기법을 사용하여 속성을 설정합니다.

t = p(6);
t.BackgroundColor = 'cyan';
t.EdgeColor = 'red';
t.FontSize = 14;

백분율 레이블의 형식 지정하기

원형 차트를 만들고 소수점 이하 3자릿수로 각 레이블을 표시하도록 형식 표현식을 지정합니다. 레이블에 백분율 기호를 포함하려면 표현식 끝에 '%%'를 지정하십시오.

X = [1/3 2/3];
pie(X,'%.3f%%')

원형 차트를 일부만 플로팅하기

요소의 합이 1보다 작은 벡터 X의 원형 차트를 만듭니다.

X = [0.19 0.22 0.41];
pie(X)

요소의 합이 1보다 작기 때문에 pie는 원형 차트를 일부만 그립니다.

두 원형 차트 비교하기

2년 동안의 금융 데이터를 포함하는 벡터 y2010과 y2011을 만듭니다. 그런 다음, 값에 대한 레이블을 포함하는 셀형 배열을 만듭니다.

y2010 = [50 0 100 95];
y2011 = [65 22 97 120];
labels = {'Investments','Cash','Operations','Sales'};

1×2 타일 형식 차트 레이아웃을 만들고 각각 제목이 있는 두 개의 원형 차트를 표시합니다. 그런 다음, 레이아웃의 동쪽 타일에 공유 범례를 표시합니다. 이렇게 하려면 반환 인수가 있는 legend 함수를 호출하여 legend 객체를 저장합니다. 그런 다음, Layout.Tile 속성을 'east'로 설정하여 범례를 동쪽 타일로 이동합니다.

t = tiledlayout(1,2,'TileSpacing','compact');

% Create pie charts
ax1 = nexttile;
pie(ax1,y2010)
title('2010')

ax2 = nexttile;
pie(ax2,y2011)
title('2011')

% Create legend
lgd = legend(labels);
lgd.Layout.Tile = 'east';

분리된 슬라이스가 있는 categorical형 원형 차트 플로팅하기

분리된 슬라이스가 범주에 대응하는 categorical형 원형 차트를 플로팅합니다.

X = categorical({'North','South','North','East','South','West'});
explode = {'North','South'};
pie(X,explode)

이제, 논리형 벡터를 사용하여 동일한 슬라이스를 분리하십시오.

explode = [0 1 1 0];
pie(X,explode)

레이블이 지정된 categorical형 원형 차트 플로팅하기

분리된 슬라이스가 없는 categorical형 원형 차트를 플로팅하고 슬라이스에 레이블을 지정합니다. X의 데이터형이 categorical형이면 입력 인수 explode를 지정해야 합니다. 분리된 슬라이스 없이 레이블을 지정하려면 explode를 빈 셀형 배열로 지정하고 labels를 레이블로 지정하십시오.

X = categorical({'North','South','North','East','South','West'});
explode = {};
labels = {'E','N','S','W'};
pie(X,explode,labels)

이제, 슬라이스를 분리하고 모든 슬라이스에 레이블을 지정합니다.

X = categorical({'North','South','North','East','South','West'});
explode = {'West'};
labels = {'E','N','S','W'};
pie(X,explode,labels)

입력 인수

X — 입력 배열

벡터 | 행렬

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

• X가 숫자형이면 X의 모든 값이 유한해야 합니다.

• X가 categorical형이면 pie는 정의되지 않은 요소를 무시합니다.

데이터형: double|categorical

explode — 분리된 슬라이스

숫자형 벡터 또는 숫자형 행렬 | 논리형 벡터 또는 논리형 행렬 | string형 배열 | 문자형 벡터로 구성된 셀형 배열

분리된 슬라이스로, 숫자형 벡터나 숫자형 행렬, 논리형 벡터나 논리형 행렬, string형 배열 또는 문자형 벡터로 구성된 셀형 배열로 지정됩니다.

• X가 숫자형이면 explode는 X에 대응하는 0, 그리고 0이 아닌 요소로 구성된 논리형 또는 숫자형 벡터나 행렬이어야 합니다. true(0이 아닌) 값은 해당하는 슬라이스를 원형 차트의 중심에서 분리합니다. 즉, explode(i,j)가 0이 아닌 경우 X(i,j)가 중심에서 분리됩니다. explode는 X와 크기가 동일해야 합니다.

• X가 categorical형인 경우 explode는 범주 이름으로 구성된 string형 배열 또는 셀형 배열일 수 있습니다. pie는 explode의 범주에 해당하는 슬라이스를 분리합니다.

• X가 categorical형인 경우 explode는 X의 각 범주에 해당하는 요소로 구성된 논리형 벡터나 숫자형 벡터가 될 수 있습니다. pie 함수는 true(0이 아님)에 대응하는 슬라이스를 범주 순서대로 분리합니다.

labels — 레이블 옵션

'%.0f%%' (디폴트 값) | 텍스트 레이블로 구성된 배열 | 형식 표현식

레이블 옵션으로, 텍스트 레이블로 구성된 배열 또는 형식 표현식으로 지정됩니다. 이 인수를 사용하여 원형 슬라이스에 사용자 지정 텍스트 레이블을 표시하거나 MATLAB^®에서 특정 형식으로 제공하는 백분율 값을 표시합니다.

참고

X에 categorical형 값이 포함된 경우 레이블 옵션을 지정하려면 레이블 옵션 앞에 explode 인수를 지정해야 합니다.

텍스트 레이블 표시하기

레이블을 문자형 벡터로 구성된 셀형 배열 또는 String형 배열로 지정합니다.

X에 숫자형 값이 포함된 경우 labels의 요소 개수는 X의 요소 개수와 같아야 합니다.

X에 categorical형 값이 포함된 경우 labels의 요소 개수 및 순서는 X의 범주 개수 및 순서와 같아야 합니다. 범주 개수와 순서를 결정하려면 categories 함수를 사용하십시오.

특정 형식으로 백분율 표시하기

형식 표현식을 문자형 벡터 또는 string형 스칼라로 지정합니다. 형식 표현식은 백분율 기호(%)로 시작하고 뒤에 일련의 식별자가 옵니다.

변환 문자를 제외한 모든 식별자는 선택 사항입니다. 다음 순서로 식별자를 지정하십시오.

1. 하나 이상의 플래그 — 플러스 기호, 소수점 표시 및 레이블 맞춤을 위한 옵션입니다.

   • 플러스 기호(+) — 양수 값 옆에 플러스 기호를 표시합니다.

   • 해시 기호(#) — '50.'과 같이 정밀도가 0인 경우에도 소수점을 표시합니다.

   • 마이너스 기호(–) — 시작 부분을 채우지 않고 레이블을 왼쪽 맞춤하여 레이블 끝을 공백으로 채웁니다.

2. 필드 너비 — 레이블에 표시할 최소 문자 수입니다. 필드 너비는 정수 값으로 지정합니다. 레이블의 자릿수가 필드 너비보다 작으면 레이블에 공백이 채워집니다.

3. 정밀도 — 소수점 오른쪽의 자릿수입니다. 정밀도를 소수점으로 지정하고 뒤에 정수가 오도록 합니다.

4. 변환 문자 — 고정소수점 또는 지수 표기법입니다. 변환 문자 목록은 아래 표를 참조하십시오. 데이터에 맞지 않는 변환 문자를 지정하는 경우 MATLAB은 대신 %e를 사용합니다.

변환 문자	설명	예제
f	고정소수점 표기법. 정밀도 값은 소수점 이하 자릿수를 나타냅니다.	'%.4f%%'는 원형 차트에서 6.25%를 차지하는 슬라이스의 레이블을 6.2500%로 표시합니다.
e	지수 표기법. 정밀도 값은 소수점 이하 자릿수를 나타냅니다.	'%.4e%%'는 원형 차트에서 6.25%를 차지하는 슬라이스의 레이블을 6.2500e+00%로 표시합니다.
g	후행 0이 없는 e 또는 f의 간단한 버전입니다. 정밀도 값은 소수점 이하 최대 자릿수를 나타냅니다.	'%.4g%%'는 원형 차트에서 6.25%를 차지하는 슬라이스의 레이블을 6.25%로 표시합니다.

위에 나열된 식별자 외에 형식 표현식의 시작이나 끝에 리터럴 텍스트를 지정할 수도 있습니다. 작은따옴표를 표시하려면 ''를 사용하십시오. 백분율 기호를 표시하려면 %%를 사용하십시오. 예를 들어, '%.2f%%'는 소수점 이하 2자릿수 뒤에 백분율 기호가 붙은 레이블을 표시합니다.

ax — 좌표축

axes 객체

axes 객체입니다. ax를 사용하면 현재 좌표축(gca) 대신 특정 좌표축에 원형 차트를 플로팅할 수 있습니다.

출력 인수

p — Patch 및 Text 객체

벡터

Patch 및 Text 객체로, 벡터로 반환됩니다. 자세한 내용은 Patch 속성 및 Text 속성를 참조하십시오.

확장 기능

tall형 배열

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

이 함수는 tall형 배열을 지원하지만 다음과 같은 제한 사항이 있습니다.

X는 tall categorical형 배열이어야 합니다.

자세한 내용은 tall형 배열 항목을 참조하십시오.

GPU 배열

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

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

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

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

분산 배열

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

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

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

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

버전 내역

R2006a 이전에 개발됨

R2019b: 원형 차트에 0 값이 표시됨

pie 함수를 호출하고 0 값을 포함하는 데이터를 지정하면 원형 차트에 0 값과 그에 대응되는 레이블이 표시됩니다. 출력 인수와 함께 pie를 호출하는 경우 출력값에는 각각의 0 값에 대한 객체가 포함됩니다.

이전 릴리스에서는 pie가 차트에서 0 값을 생략하고 그 값에 해당하는 객체를 반환하지 않았습니다. 0 값을 표시하지 않거나 이 값에 대응되는 객체를 반환하지 않으려면 데이터에서 0을 제거하십시오.

참고 항목

pie3

도움말 항목

• 가장 큰 비중을 차지하는 원형 슬라이스 분리하기
• 텍스트와 백분율을 사용하여 원형 차트의 레이블 지정하기

×

예제 열기

이 예제의 수정된 버전이 있습니다. 사용자가 편집한 내용을 반영하여 이 예제를 여시겠습니까?

아니요, 수정된 버전을 덮어씁니다. 예