pie3

3차원 원형 차트

• 

구문

pie3(X)

pie3(X,explode)

pie3(X,labels)

pie3(X,explode,labels)

pie3(ax,___)

p = pie3(___)

설명

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

pie3(X,explode)는 원형 차트의 중심에서 분리할 슬라이스를 지정합니다.

pie3(X,labels)는 슬라이스에 텍스트 레이블을 지정합니다. 레이블의 개수는 X의 요소 개수와 동일해야 합니다.

pie3(X,explode,labels)는 슬라이스를 분리하고 텍스트 레이블을 지정합니다.

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

p = pie3(___)는 원형 차트를 구성하는 Patch, Surface, Text 객체의 벡터를 반환합니다. 차트를 생성한 후에 속성을 수정하려면 p를 사용하십시오. 이러한 객체에 설정할 수 있는 속성 목록은 Patch 속성, Surface 속성, Text 속성를 참조하십시오.

예제

3차원 원형 차트 생성하기

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

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

원형 차트의 슬라이스 분리하기

3차원 원형 차트를 만들고 해당 explode 요소를 1로 지정하여 슬라이스를 분리합니다.

X = [1 3 0.5 2.5 2];
explode = [0 1 0 0 0];
pie3(X,explode)

텍스트 레이블 지정하기

3차원 원형 차트를 만들고 텍스트 레이블을 지정합니다.

X = 1:3;
labels = ["Taxes" "Expenses" "Profit"];
pie3(X,labels)

글꼴 스타일 수정하기

3차원 원형 차트를 만들고 특정 레이블의 글꼴 스타일을 수정합니다.

먼저 디폴트 글꼴 스타일로 3차원 원형 차트를 만듭니다. 출력 인수 p를 지정하여 원형 차트를 사용자 지정할 때 사용할 수 있게 합니다.

X = [1 2 3];
labels = ["Taxes" "Expenses" "Profit"];
p = pie3(X,labels);

원형 차트의 각 슬라이스마다 p에 4개의 대응하는 요소 Patch, Surface, Patch, Text를 가집니다.

p'

ans = 
  12×1 graphics array:

  Patch
  Surface    (Taxes)
  Patch
  Text       (Taxes)
  Patch
  Surface    (Expenses)
  Patch
  Text       (Expenses)
  Patch
  Surface    (Profit)
  Patch
  Text       (Profit)

레이블 Expenses의 Text 객체를 가져옵니다. 점 표기법으로 색과 글꼴 크기를 변경하여 연결된 속성을 설정합니다.

t = p(8);
t.Color = "red";
t.FontSize = 14;

두 원형 차트 비교하기

2개의 3차원 원형 차트를 타일 형식 차트 레이아웃으로 같은 Figure에 플로팅하여 비교합니다.

2010년과 2011년 재무 데이터의 벡터와 레이블 집합을 만듭니다.

y2010 = [50 0 100 95];
y2011 = [65 22 97 120];
labels = ["Investments" "Cash" "Operations" "Sales"];

2×1 타일 형식 차트 레이아웃을 만듭니다. 첫 번째 타일에 2010년 원형 차트를 만들고 두 번째 타일에 2011년 원형 차트를 만듭니다. 원형 차트에 공통의 범례를 추가합니다.

t = tiledlayout(1,2,"TileSpacing","None");
ax1 = nexttile;
pie3(ax1,y2010)
title("2010")

ax2 = nexttile;
pie3(ax2,y2011)
title("2011")

l = legend(labels);
l.Layout.Tile = "south";

입력 인수

X — 입력 배열

벡터 | 행렬

입력 배열로, 숫자형 벡터나 행렬로 지정됩니다. X의 각 요소는 원형 차트의 한 슬라이스에 대응합니다. X의 모든 요소의 합 S에 따라 pie3이 차트를 표시하는 방식이 결정됩니다.

• S = 1이면 X의 값이 슬라이스의 비율을 지정합니다.

• S < 1이면 X의 값이 슬라이스의 비율을 지정하고 pie3은 부분 원형 차트를 그립니다.

• S > 1이면 pie3은 S로 각 슬라이스의 크기를 정규화합니다.

explode — 슬라이스 분리

숫자형 벡터 또는 숫자형 행렬 | 논리형 벡터 또는 논리형 행렬

슬라이스 분리로, X와 크기가 같은 숫자형이나 논리형 벡터 또는 행렬로 지정됩니다. 슬라이스를 분리하려면 대응하는 요소를 0이 아닌 값이나 true로 설정합니다. 0이 아닌 값을 갖는 요소는 분리에 영향을 주지 않습니다.

예: [0 1 0 0]은 두 번째 슬라이스를 분리합니다.

labels — 텍스트 레이블

string형 배열 | 문자형 벡터로 구성된 셀형 배열

슬라이스에 대한 텍스트 레이블로, string형 배열 또는 문자형 벡터로 구성된 셀형 배열로 지정됩니다. 레이블을 지정하지 않으면 pie3은 자동으로 백분율 값을 표시합니다.

ax — 대상 좌표축

Axes 객체

대상 좌표축으로, Axes 객체로 지정됩니다. 좌표축을 지정하지 않는 경우 MATLAB^®은 현재 좌표축으로 플로팅하거나 좌표축이 없다면 Axes 객체를 만듭니다.

출력 인수

p — 그래픽스 객체

Patch, Surface, Text 객체의 벡터

원형 차트를 구성하는 그래픽스 객체로, Patch, Surface, Text 객체의 벡터로 반환됩니다.

원형 차트의 각 슬라이스는 차트 모양을 수정할 때 사용할 수 있는 4개의 객체로 구성됩니다. 따라서 출력 벡터의 길이는 X의 요소 개수의 4배입니다. 각 슬라이스에는 4개의 대응하는 요소가 p에 다음의 순서로 있습니다.

• Patch 객체 – 밑면(이미지에서는 보이지 않음)

• Surface 객체 – 윗면과 밑면 사이의 면(이미지에서 주황색)

• Patch 객체 – 윗면(이미지에서 파란색)

• Text 객체 - 텍스트 레이블

이러한 객체에 설정할 수 있는 속성에 대한 자세한 내용은 Patch 속성, Surface 속성, Text 속성를 참조하십시오.

확장 기능

GPU 배열

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

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

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

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

분산 배열

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

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

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

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

버전 내역

R2006a 이전에 개발됨

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

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

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

참고 항목

pie