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

scatter3

3차원 산점도 플롯

• 

×

구문

scatter3(X,Y,Z)

scatter3(X,Y,Z,S)

scatter3(X,Y,Z,S,C)

scatter3(___,'filled')

scatter3(___,markertype)

scatter3(tbl,xvar,yvar,zvar)

scatter3(tbl,xvar,yvar,zvar,'filled')

scatter3(ax,___)

scatter3(___,Name,Value)

h = scatter3(___)

설명

벡터 및 행렬 데이터

scatter3(X,Y,Z)는 X, Y, Z로 지정된 위치에 원을 표시합니다.

• 하나의 좌표 집합을 플로팅하려면 X, Y, Z를 동일한 길이의 벡터로 지정하십시오.

• 동일한 좌표축에 여러 개의 좌표의 집합을 플로팅하려면 X, Y, Z 중 적어도 하나를 행렬로 지정하십시오. (R2022a 이후)

scatter3(X,Y,Z,S)는 원 크기를 지정합니다.

• 원 크기에 변화를 주려면 S를 벡터로 지정하십시오.

• 여러 개의 좌표의 집합에서 다양한 크기를 지정하려면 행렬을 지정하십시오. (R2022a 이후)

scatter3(X,Y,Z,S,C)는 원의 색을 지정합니다. 모든 원에 대해 하나의 색을 지정할 수도 있고 색을 달리할 수도 있습니다. 예를 들어, C를 "red"로 지정하여 모든 원을 빨간색으로 플로팅할 수 있습니다.

scatter3(___,'filled')는 위에 열거된 구문에 나와 있는 입력 인수의 조합을 사용하여 원을 채웁니다.

scatter3(___,markertype)은 마커 유형을 지정합니다.

테이블 데이터

scatter3(tbl,xvar,yvar,zvar)는 테이블 tbl에서 변수 xvar, yvar, zvar을 플로팅합니다. 하나의 데이터 세트를 플로팅하려면 xvar, yvar, zvar 각각에 대해 1개의 변수를 지정하십시오. 여러 개의 데이터 세트를 플로팅하려면 적어도 하나의 인수에 대해 변수를 여러 개 지정하십시오. 여러 개의 변수를 지정하는 인수들에는 동일한 개수의 변수를 지정해야 합니다. (R2021b 이후)

scatter3(tbl,xvar,yvar,zvar,'filled')는 테이블에서 지정된 변수를 채워진 원으로 플로팅합니다. (R2021b 이후)

추가 옵션

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

scatter3(___,Name,Value)는 속성을 설정하는 하나 이상의 이름-값 인수를 사용하여 산점도 플롯을 수정합니다. 예를 들면 다음과 같습니다.

• scatter3(x,y,z,'LineWidth',2)는 2포인트 마커 윤곽선으로 산점도 플롯을 만듭니다.

• scatter3(tbl,'MyX','MyY','MyZ','ColorVariable','MyColors')는 테이블의 데이터로 산점도 플롯을 만들고 테이블의 데이터를 사용하여 마커 색을 사용자 지정합니다.

전체 속성 목록은 Scatter 속성를 참조하십시오.

h = scatter3(___)은 Scatter 객체를 반환합니다. 산점도 차트가 생성된 후에 이 산점도 차트의 속성을 수정하려면 h를 사용하십시오.

예제

3차원 산점도 플롯 생성하기

3차원 산점도 플롯을 만듭니다. sphere를 사용하여 벡터 x, y, z를 정의합니다.

figure
[X,Y,Z] = sphere(16);
x = [0.5*X(:); 0.75*X(:); X(:)];
y = [0.5*Y(:); 0.75*Y(:); Y(:)];
z = [0.5*Z(:); 0.75*Z(:); Z(:)];
scatter3(x,y,z)

다양한 마커 크기 지정하기

sphere를 사용하여 벡터 x, y, z를 정의합니다.

[X,Y,Z] = sphere(16);
x = [0.5*X(:); 0.75*X(:); X(:)];
y = [0.5*Y(:); 0.75*Y(:); Y(:)];
z = [0.5*Z(:); 0.75*Z(:); Z(:)];

벡터 s를 정의하여 마커 크기를 지정합니다.

S = repmat([100,50,5],numel(X),1);
s = S(:);

3차원 산점도 플롯을 만든 다음 view를 사용하여 Figure의 좌표축 각도를 변경합니다.

figure
scatter3(x,y,z,s)
view(40,35)

x, y, z, s의 해당하는 항목은 각 마커의 위치와 크기를 결정합니다.

다양한 마커 색 지정하기

sphere를 사용하여 벡터 x, y, z를 정의합니다.

[X,Y,Z] = sphere(16);
x = [0.5*X(:); 0.75*X(:); X(:)];
y = [0.5*Y(:); 0.75*Y(:); Y(:)];
z = [0.5*Z(:); 0.75*Z(:); Z(:)];

벡터 s와 c를 정의하여 각 마커의 크기와 색을 지정합니다.

S = repmat([50,25,10],numel(X),1);
C = repmat([1,2,3],numel(X),1);
s = S(:);
c = C(:);

3차원 산점도 플롯을 만든 다음 view를 사용하여 Figure의 좌표축 각도를 변경합니다.

figure
scatter3(x,y,z,s,c)
view(40,35)

x, y, z, c의 해당하는 항목은 각 마커의 위치와 색을 결정합니다.

마커 채우기

벡터 x와 y를 랜덤 잡음을 갖는 코사인 값과 사인 값으로 생성합니다.

z = linspace(0,4*pi,250);
x = 2*cos(z) + rand(1,250);
y = 2*sin(z) + rand(1,250);

3차원 산점도 플롯을 만든 다음 마커를 채웁니다. view를 사용하여 Figure의 좌표축 각도를 변경합니다.

scatter3(x,y,z,'filled')
view(-30,10)

마커 유형 설정하기

rand의 출력값이 반복되도록 하기 위해 난수 생성기를 초기화합니다. 벡터 x와 y를 랜덤 잡음을 갖는 코사인 값과 사인 값으로 정의합니다.

rng default
z = linspace(0,4*pi,250);
x = 2*cos(z) + rand(1,250);
y = 2*sin(z) + rand(1,250);

3차원 산점도 플롯을 만든 다음 마커 유형을 설정합니다. view를 사용하여 Figure의 좌표축 각도를 변경합니다.

figure
scatter3(x,y,z,'*')
view(-30,10)

마커 속성 설정하기

rand의 출력값이 반복되도록 하기 위해 난수 생성기를 초기화합니다. 벡터 x와 y를 랜덤 잡음을 갖는 코사인 값과 사인 값으로 정의합니다.

rng default
z = linspace(0,4*pi,250);
x = 2*cos(z) + rand(1,250);
y = 2*sin(z) + rand(1,250);

3차원 산점도 플롯을 만든 다음 마커 가장자리 색과 마커 면 색을 설정합니다. view를 사용하여 Figure의 좌표축 각도를 변경합니다.

figure
scatter3(x,y,z,...
        'MarkerEdgeColor','k',...
        'MarkerFaceColor',[0 .75 .75])
view(-30,10)

테이블의 데이터 플로팅하기

R2021b 이후

테이블을 scatter3 함수에 전달하고 플로팅할 변수를 지정하면 테이블의 데이터를 편리하게 플로팅할 수 있습니다. 예를 들어, patients.xls를 테이블 tbl로 읽어옵니다. tbl을 scatter3 함수에 대한 첫 번째 인수로 전달하고 이어서 변수 이름을 전달하여 Systolic, Diastolic, Weight 변수 사이의 관계를 플로팅합니다. 기본적으로 좌표축 레이블은 변수 이름과 일치합니다.

tbl = readtable('patients.xls');
scatter3(tbl,'Systolic','Diastolic','Weight');

여러 개의 변수를 동시에 플로팅할 수도 있습니다. 예를 들어, xvar 인수를 셀형 배열 {'Systolic','Diastolic'}으로 지정하여 x 축에 혈압 변수를 모두 플로팅합니다. 그런 다음 범례를 추가합니다. 범례 레이블은 변수 이름과 일치합니다.

scatter3(tbl,{'Systolic','Diastolic'},'Age','Weight');
legend

사용자 지정 마커 크기와 색으로 테이블 데이터 플로팅하기

R2021b 이후

ColorVariable과 SizeData 속성을 설정하면 테이블의 데이터를 플로팅하고 색과 마커 크기를 사용자 지정할 수 있습니다. scatter3 함수를 호출할 때 이러한 속성을 이름-값 인수로 설정하거나 나중에 Scatter 객체에서 속성을 설정할 수 있습니다.

예를 들어, patients.xls를 테이블 tbl로 읽어옵니다. Systolic, Diastolic, Weight 변수 사이의 관계를 채워진 마커로 플로팅합니다. ColorVariable 이름-값 인수를 지정하여 다양한 마커 색을 지정합니다. 나중에 다른 속성을 설정할 수 있도록 Scatter 객체를 s로 반환합니다.

tbl = readtable('patients.xls');
s = scatter3(tbl,'Systolic','Diastolic','Weight','filled', ...
    'ColorVariable','Diastolic');

SizeData 속성을 설정하여 마커 크기를 100포인트로 변경합니다. 그런 다음 컬러바를 추가합니다.

s.SizeData = 100;
colorbar

3차원 산점도 플롯의 좌표축 지정하기

R2019b부터는 tiledlayout 함수와 nexttile 함수를 사용하여 플롯을 타일 형식 배열로 표시할 수 있습니다.

seamount 데이터 세트를 불러와서 벡터 x, y, z를 가져옵니다. tiledlayout 함수를 호출하여 2×1 타일 형식 차트 레이아웃을 만듭니다. nexttile 함수를 호출하여 axes 객체 ax1과 ax2를 만듭니다. 그런 다음, scatter3에 대한 첫 번째 인수로 axes 객체를 지정하여 좌표축에 별도의 산점도 플롯을 만듭니다.

load seamount
tiledlayout(2,1)
ax1 = nexttile;
ax2 = nexttile;
scatter3(ax1,x,y,z,'MarkerFaceColor',[0 .75 .75])
scatter3(ax2,x,y,z,'*')

핸들을 사용하여 scatter series 속성 설정하기

sphere 함수를 사용하여 벡터 x, y, z를 만듭니다.

[X,Y,Z] = sphere(16);
x = [0.5*X(:); 0.75*X(:); X(:)];
y = [0.5*Y(:); 0.75*Y(:); Y(:)];
z = [0.5*Z(:); 0.75*Z(:); Z(:)];

벡터 s와 c를 만들어 각 마커의 크기와 색을 지정합니다.

S = repmat([70,50,20],numel(X),1);
C = repmat([1,2,3],numel(X),1);
s = S(:);
c = C(:);

3차원 산점도 플롯을 만들고 scatter series 객체를 반환합니다.

h = scatter3(x,y,z,s,c);

RGB 3색 값을 사용하여 마커 면 색을 설정합니다. 점 표기법을 사용하여 속성을 설정합니다.

h.MarkerFaceColor = [0 0.5 0.5];

입력 인수

X — x 좌표

스칼라 | 벡터 | 행렬

x 좌표로, 스칼라, 벡터 또는 행렬로 지정됩니다. X의 크기와 형태는 데이터의 형태에 따라 결정됩니다. 다음 표에서는 가장 일반적인 경우를 설명합니다.

플롯 유형	좌표 지정 방법
단일 점	X, Y, Z를 스칼라로 지정합니다. 예를 들어, 다음과 같이 합니다. scatter3(1,2,3)
하나의 점 집합	X, Y, Z를 길이가 같은 행 또는 열 벡터의 임의의 조합으로 지정합니다. 예를 들어, 다음과 같이 합니다. X = [1 2 3 4]; Y = [5; 6; 7; 8]; Z = [9 10 11 12]; scatter3(X,Y,Z)
색이 서로 다른 여러 개의 점 집합	모든 데이터 세트가 하나 이상의 차원에서 좌표를 공유하는 경우, 공유되는 좌표를 벡터로 지정하고 나머지 좌표를 행렬로 지정합니다. 벡터의 길이는 행렬의 차원 중 하나와 일치해야 합니다. 예를 들어 동일한 x 좌표를 공유하는 데이터 세트 2개를 플로팅합니다. X = [1 2 3 4]; Y = [4 5 6 7; 8 9 10 11]; Z = [10 11 12 13; 14 15 16 17]; scatter3(X,Y,Z) 행렬이 정사각 행렬인 경우 scatter3은 행렬의 각 열에 대한 개별적인 점 집합을 플로팅합니다. 또는 X, Y, Z를 동일한 크기의 행렬로 지정합니다. 이 경우 scatter3은 행렬의 열을 플로팅합니다. 예를 들어 데이터 세트 4개를 플로팅합니다. X = [1 3 5 6; 2 4 6 8]; Y = [10 25 45 61; 20 40 60 70]; Z = [12 5 6 8; 9 13 2 7]; scatter3(X,Y,Z)

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

Y — y 좌표

스칼라 | 벡터 | 행렬

y 좌표로, 스칼라, 벡터 또는 행렬로 지정됩니다. y의 크기와 형태는 데이터의 형태에 따라 결정됩니다. 다음 표에서는 가장 일반적인 경우를 설명합니다.

플롯 유형	좌표 지정 방법
단일 점	X, Y, Z를 스칼라로 지정합니다. 예를 들어, 다음과 같이 합니다. scatter3(1,2,3)
하나의 점 집합	X, Y, Z를 길이가 같은 행 또는 열 벡터의 임의의 조합으로 지정합니다. 예를 들어, 다음과 같이 합니다. X = [1 2 3 4]; Y = [5; 6; 7; 8]; Z = [9 10 11 12]; scatter3(X,Y,Z)
색이 서로 다른 여러 개의 점 집합	모든 데이터 세트가 하나 이상의 차원에서 좌표를 공유하는 경우, 공유되는 좌표를 벡터로 지정하고 나머지 좌표를 행렬로 지정합니다. 벡터의 길이는 행렬의 차원 중 하나와 일치해야 합니다. 예를 들어 동일한 x 좌표를 공유하는 데이터 세트 2개를 플로팅합니다. X = [1 2 3 4]; Y = [4 5 6 7; 8 9 10 11]; Z = [10 11 12 13; 14 15 16 17]; scatter3(X,Y,Z) 행렬이 정사각 행렬인 경우 scatter3은 행렬의 각 열에 대한 개별적인 점 집합을 플로팅합니다. 또는 X, Y, Z를 동일한 크기의 행렬로 지정합니다. 이 경우 scatter3은 행렬의 열을 플로팅합니다. 예를 들어 데이터 세트 4개를 플로팅합니다. X = [1 3 5 6; 2 4 6 8]; Y = [10 25 45 61; 20 40 60 70]; Z = [12 5 6 8; 9 13 2 7]; scatter3(X,Y,Z)

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

Z — z 좌표

스칼라 | 벡터 | 행렬

z 좌표로, 스칼라, 벡터 또는 행렬로 지정됩니다. Z의 크기와 형태는 데이터의 형태에 따라 결정됩니다. 다음 표에서는 가장 일반적인 경우를 설명합니다.

플롯 유형	좌표 지정 방법
단일 점	X, Y, Z를 스칼라로 지정합니다. 예를 들어, 다음과 같이 합니다. scatter3(1,2,3)
하나의 점 집합	X, Y, Z를 길이가 같은 행 또는 열 벡터의 임의의 조합으로 지정합니다. 예를 들어, 다음과 같이 합니다. X = [1 2 3 4]; Y = [5; 6; 7; 8]; Z = [9 10 11 12]; scatter3(X,Y,Z)
색이 서로 다른 여러 개의 점 집합	모든 데이터 세트가 하나 이상의 차원에서 좌표를 공유하는 경우, 공유되는 좌표를 벡터로 지정하고 나머지 좌표를 행렬로 지정합니다. 벡터의 길이는 행렬의 차원 중 하나와 일치해야 합니다. 예를 들어 동일한 x 좌표를 공유하는 데이터 세트 2개를 플로팅합니다. X = [1 2 3 4]; Y = [4 5 6 7; 8 9 10 11]; Z = [10 11 12 13; 14 15 16 17]; scatter3(X,Y,Z) 행렬이 정사각 행렬인 경우 scatter3은 행렬의 각 열에 대한 개별적인 점 집합을 플로팅합니다. 또는 X, Y, Z를 동일한 크기의 행렬로 지정합니다. 이 경우 scatter3은 행렬의 열을 플로팅합니다. 예를 들어 데이터 세트 4개를 플로팅합니다. X = [1 3 5 6; 2 4 6 8]; Y = [10 25 45 61; 20 40 60 70]; Z = [12 5 6 8; 9 13 2 7]; scatter3(X,Y,Z)

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

S — 마커 크기

36 (디폴트 값) | 숫자형 스칼라 | 행 벡터 또는 열 벡터 | 행렬 | []

마커 크기로, 숫자형 스칼라, 벡터, 행렬 또는 빈 배열([])로 지정됩니다. 크기는 각 마커의 면적을 제곱포인트 단위로 제어합니다. 빈 배열은 디폴트 크기인 36포인트를 지정합니다. 크기를 지정하는 방법은 X, Y, Z를 지정하는 방법과 원하는 플롯의 모양에 따라 달라집니다. 다음 표에서는 가장 일반적인 경우를 설명합니다.

마커 크기	X, Y, Z	S	예
모든 점에 같은 크기 사용	X, Y, Z에 대해 기술된 벡터 또는 행렬의 모든 유효한 조합.	스칼라	X를 벡터로 지정하고, Y와 Z를 행렬로 지정하고, S를 스칼라로 지정합니다. X = [1 2 3 4]; Y = [5 6 7 8; 9 10 11 12]; Z = [13 14 15 16; 17 18 19 20]; scatter3(X,Y,Z,100)
각 마커에 다른 크기 사용	동일한 길이의 벡터	X, Y, Z와 길이가 같은 벡터. 적어도 하나의 차원이 X, Y, Z의 길이와 일치하는 행렬. 각 (x,y,z) 위치에서 서로 다른 크기의 마커 여러 개를 표시하려면 행렬을 지정하는 것이 유용합니다.	X, Y, Z, S를 벡터로 지정합니다. X = [1 2 3 4]; Y = [4 5 6 7]; Z = [8 9 10 11]; S = [80 150 700 50]; scatter3(X,Y,Z,S) X, Y, Z를 벡터로 지정하고 S를 행렬로 지정합니다. X = [1 2 3 4]; Y = [5 6 7 8]; Z = [9 10 11 12]; S = [80 30; 150 900; 50 500; 200 350]; scatter3(X,Y,Z,S)
각 마커에 다른 크기 사용	X, Y, Z 중 적어도 하나가 여러 데이터 세트를 플로팅하기 위한 행렬임	각 데이터 세트에 있는 점의 개수와 동일한 요소 개수를 갖는 벡터. X, Y, Z 행렬과 크기가 같은 행렬.	X를 벡터로 지정하고, Y와 Z를 행렬로 지정하고, S를 벡터로 지정합니다. X = [1 2 3 4]; Y = [1 6; 3 8; 2 7; 4 9]; Z = [2 8; 3 10; 4 7; 4 12]; S = [80 150 200 350]; scatter3(X,Y,Z,S) X를 벡터로 지정하고, Y, Z, S를 행렬로 지정합니다. X = [1 2 3 4]; Y = [1 6; 3 8; 2 7; 4 9]; Z = [10 11; 12 13; 14 15; 16 17]; S = [80 30; 150 900; 50 2000; 200 350]; scatter3(X,Y,Z,S)

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

C — 마커 색

색 이름 | RGB 3색 | RGB 3색으로 구성된 행렬 | 컬러맵 인덱스로 구성된 벡터

마커 색으로, 색 이름, RGB 3색, RGB 3색으로 구성된 행렬 또는 컬러맵 인덱스로 구성된 벡터로 지정됩니다.

• 색 이름 — 색 이름(예: "red") 또는 짧은 이름(예: "r").

• RGB 3색 — 요소를 3개 가진 행 벡터로, 각 요소는 색을 구성하는 빨간색, 녹색, 파란색 성분을 지정합니다. 농도의 범위는 [0,1]이어야 합니다(예: [0.4 0.6 0.7]). RGB 3색은 사용자 지정 색을 생성할 때 유용합니다.

• RGB 3색으로 구성된 행렬 — 각 행이 RGB 3색인 3열 행렬.

• 컬러맵 인덱스로 구성된 벡터 — X, Y, Z 벡터와 길이가 같은, 숫자형 값으로 구성된 벡터.

색을 지정하는 방법은 원하는 색 체계, 그리고 좌표 집합을 하나 플로팅할 것인지 아니면 여러 개 플로팅할 것인지에 따라 달라집니다. 다음 표에서는 가장 일반적인 경우를 설명합니다.

색 체계	색을 지정하는 방법	예
모든 점에 하나의 색을 사용합니다.	아래 표에 나와 있는 색 이름 또는 짧은 이름을 지정하거나 하나의 RGB 3색을 지정합니다.	하나의 점 집합을 플로팅하고 색을 "red"로 지정합니다. X = [1 2 3 4]; Y = [2 5 3 6]; Z = [10 6 4 7]; S = 50; scatter3(X,Y,Z,S,"red") 두 개의 점 집합을 플로팅하고 RGB 3색 [1 0 0]을 사용하여 색을 빨간색으로 지정합니다. X = [1 2 3 4]; Y = [2 5 3 6]; Z = [2 5; 1 2; 8 4; 7 9]; S = 50; scatter3(X,Y,Z,S,[1 0 0])
컬러맵을 사용하여 각 점에 다른 색을 할당합니다.	숫자로 구성된 행 벡터 또는 열 벡터를 지정합니다. 숫자는 현재 컬러맵 배열로 매핑됩니다. 가장 작은 값은 컬러맵의 첫 번째 행에 매핑되고, 가장 큰 값은 마지막 행에 매핑됩니다. 중간값은 중간 행에 선형적으로 매핑됩니다. 플롯에 점 3개가 있는 경우 값이 컬러맵 인덱스로 해석되도록 열 벡터를 지정하십시오. 이 방법은 X, Y, Z가 모두 벡터이고 S가 벡터나 스칼라인 경우에만 사용할 수 있습니다.	4개의 컬러맵 인덱스를 지정하는 벡터 C를 만듭니다. 현재 컬러맵의 색을 사용하여 4개의 점을 플로팅합니다. 그런 다음, 컬러맵을 winter로 변경합니다. C = [1 2 3 4]; X = [1 2 3 4]; Y = [1 0 6 2]; Z = [2 5 3 7]; S = 50; scatter3(X,Y,Z,S,C) colormap(gca,"winter")
각 점에 대해 사용자 지정 색을 만듭니다.	RGB 3색으로 구성된 m×3 행렬을 지정합니다. 여기서 m은 플롯에 있는 점의 개수입니다. 이 방법은 X, Y, Z가 모두 벡터이고 S가 벡터나 스칼라인 경우에만 사용할 수 있습니다.	녹색, 빨간색, 회색, 자주색에 대해 RGB 3색을 지정하는 행렬 C를 만듭니다. 그런 다음, 이러한 색을 사용하여 4개의 점이 있는 산점도 플롯을 만듭니다. C = [0 1 0; 1 0 0; 0.5 0.5 0.5; 0.6 0 1]; X = [1 2 3 4]; Y = [2 5 3 6]; Z = [10 6 4 7]; S = 50; scatter3(X,Y,Z,S,C)
각 데이터 세트에 대해 서로 다른 색을 만듭니다.	RGB 3색으로 구성된 n×3 행렬을 지정합니다. 여기서 n은 데이터 세트의 개수입니다. 이 방법은 X, Y, Z, S 중 적어도 하나가 행렬인 경우에만 사용할 수 있습니다.	2개의 RGB 3색을 포함하는 행렬 C를 만듭니다. 그런 다음, 이러한 색을 사용하여 2개의 데이터 세트를 플로팅합니다. C = [1 0 0; 0.6 0 1]; X = [1 2 3 4]; Y = [5 6 7 8]; Z = [2 5; 1 2; 8 4; 11 9]; S = 50; scatter3(X,Y,Z,S,C)

일반적인 색의 색 이름과 RGB 3색

색 이름	짧은 이름	RGB 3색	16진수 색 코드	모양
'red'	'r'	[1 0 0]	'#FF0000'
'green'	'g'	[0 1 0]	'#00FF00'
'blue'	'b'	[0 0 1]	'#0000FF'
'cyan'	'c'	[0 1 1]	'#00FFFF'
'magenta'	'm'	[1 0 1]	'#FF00FF'
'yellow'	'y'	[1 1 0]	'#FFFF00'
'black'	'k'	[0 0 0]	'#000000'
'white'	'w'	[1 1 1]	'#FFFFFF'

다음은 MATLAB^®이 여러 유형의 플롯에서 사용하는 디폴트 색의 RGB 3색과 16진수 색 코드입니다.

RGB 3색	16진수 색 코드	모양
[0 0.4470 0.7410]	'#0072BD'
[0.8500 0.3250 0.0980]	'#D95319'
[0.9290 0.6940 0.1250]	'#EDB120'
[0.4940 0.1840 0.5560]	'#7E2F8E'
[0.4660 0.6740 0.1880]	'#77AC30'
[0.3010 0.7450 0.9330]	'#4DBEEE'
[0.6350 0.0780 0.1840]	'#A2142F'

markertype — 마커

'o' (디폴트 값) | '+' | '*' | '.' | 'x' | ...

마커로, 다음 표에 나열된 마커 중 하나로 지정됩니다.

마커	설명	결과로 생성되는 마커
'o'	원
'+'	플러스 기호
'*'	별표
'.'	점
'x'	십자
'_'	가로선
'|'	세로선
's'	정사각형
'd'	다이아몬드
'^'	위쪽 방향 삼각형
'v'	아래쪽 방향 삼각형
'>'	오른쪽 방향 삼각형
'<'	왼쪽 방향 삼각형
'p'	펜타그램
'h'	헥사그램
'none'	마커 없음	해당 없음

'filled' — 마커의 내부를 채우는 옵션

'filled'

마커의 내부를 채우는 옵션으로, 'filled'로 지정됩니다. 이 옵션은 면이 있는 마커(예: 'o' 또는 'square')와 함께 사용하십시오. 면이 없고 가장자리만 포함된 마커는 그려지지 않습니다('+', '*', '.', 'x').

'filled' 옵션은 Scatter 객체의 MarkerFaceColor 속성을 'flat'으로 설정하고 MarkerEdgeColor 속성을 'none'으로 설정하므로, 마커 면은 그려지지만 가장자리는 그려지지 않습니다.

tbl — 소스 테이블

테이블 | 타임테이블

플로팅할 데이터를 포함하는 소스 테이블로, table형이나 timetable형으로 지정됩니다.

xvar — x 좌표를 포함하는 테이블 변수

하나 이상의 테이블 변수 인덱스

x 좌표를 포함하는 테이블 변수로, 하나 이상의 테이블 변수 인덱스로 지정됩니다.

테이블 인덱스 지정하기

다음 인덱싱 방식 중 하나를 사용하여 원하는 변수를 지정합니다.

인덱싱 방식	예제
변수 이름: string형, 문자형 벡터 또는 셀형 배열. pattern 객체.	"A" 또는 'A' — A라는 변수 ["A","B"] 또는 {'A','B'} — A와 B라는 2개의 변수 "Var"+digitsPattern(1) — "Var" 다음에 하나의 숫자가 오는 이름을 갖는 변수
변수 인덱스: 테이블에서의 변수 위치를 나타내는 인덱스 번호. 숫자 벡터. 논리형 벡터. 일반적으로 이 벡터는 변수의 개수와 길이가 같지만 후행 0 값 또는 false 값을 생략할 수 있습니다.	3 — 테이블의 세 번째 변수 [2 3] — 테이블의 두 번째 변수와 세 번째 변수 [false false true] — 세 번째 변수
변수 유형: 지정된 유형의 변수를 선택하는 vartype 첨자.	vartype("categorical") — categorical형 값을 포함하는 모든 변수

데이터 플로팅하기

사용자가 지정하는 테이블 변수는 숫자형 값, categorical형 값, datetime형 값 또는 duration형 값을 포함할 수 있습니다.

하나의 데이터 세트를 플로팅하려면 xvar에 대한 변수 1개, yvar에 대한 변수 1개, zvar에 대한 변수 1개를 지정하십시오. 예를 들어, Patients.xls를 테이블 tbl로 읽어옵니다. Height, Weight, Diastolic 변수를 플로팅합니다.

tbl = readtable('Patients.xls');
scatter3(tbl,'Height','Weight','Diastolic')

여러 개의 데이터 세트를 함께 플로팅하려면 xvar, yvar 또는 zvar 중 적어도 하나에 대해 여러 개의 변수를 지정하십시오. 하나 이상의 인수에 대해 여러 개의 변수를 지정하는 경우 변수의 개수는 이들 인수 각각에 대해 동일해야 합니다.

예를 들어, Weight 변수는 x 축에 플로팅하고, Systolic과 Diastolic 변수는 y 축에 플로팅하고, Age 변수는 z 축에 플로팅합니다.

scatter3(tbl,'Weight',{'Systolic','Diastolic'},'Age')

xvar, yvar, zvar에 대해 다른 인덱싱 방식을 사용할 수도 있습니다. 예를 들어, xvar을 변수 이름으로 지정하고, yvar을 인덱스 번호로 지정하고, zvar을 논리형 벡터로 지정합니다.

scatter3(tbl,'Height',6,[false false true])

yvar — y 좌표를 포함하는 테이블 변수

하나 이상의 테이블 변수 인덱스

y 좌표를 포함하는 테이블 변수로, 하나 이상의 테이블 변수 인덱스로 지정됩니다.

테이블 인덱스 지정하기

다음 인덱싱 방식 중 하나를 사용하여 원하는 변수를 지정합니다.

인덱싱 방식	예제
변수 이름: string형, 문자형 벡터 또는 셀형 배열. pattern 객체.	"A" 또는 'A' — A라는 변수 ["A","B"] 또는 {'A','B'} — A와 B라는 2개의 변수 "Var"+digitsPattern(1) — "Var" 다음에 하나의 숫자가 오는 이름을 갖는 변수
변수 인덱스: 테이블에서의 변수 위치를 나타내는 인덱스 번호. 숫자 벡터. 논리형 벡터. 일반적으로 이 벡터는 변수의 개수와 길이가 같지만 후행 0 값 또는 false 값을 생략할 수 있습니다.	3 — 테이블의 세 번째 변수 [2 3] — 테이블의 두 번째 변수와 세 번째 변수 [false false true] — 세 번째 변수
변수 유형: 지정된 유형의 변수를 선택하는 vartype 첨자.	vartype("categorical") — categorical형 값을 포함하는 모든 변수

데이터 플로팅하기

사용자가 지정하는 테이블 변수는 숫자형 값, categorical형 값, datetime형 값 또는 duration형 값을 포함할 수 있습니다.

하나의 데이터 세트를 플로팅하려면 xvar에 대한 변수 1개, yvar에 대한 변수 1개, zvar에 대한 변수 1개를 지정하십시오. 예를 들어, Patients.xls를 테이블 tbl로 읽어옵니다. Height, Weight, Diastolic 변수를 플로팅합니다.

tbl = readtable('Patients.xls');
scatter3(tbl,'Height','Weight','Diastolic')

여러 개의 데이터 세트를 함께 플로팅하려면 xvar, yvar 또는 zvar 중 적어도 하나에 대해 여러 개의 변수를 지정하십시오. 하나 이상의 인수에 대해 여러 개의 변수를 지정하는 경우 변수의 개수는 이들 인수 각각에 대해 동일해야 합니다.

예를 들어, Weight 변수는 x 축에 플로팅하고, Systolic과 Diastolic 변수는 y 축에 플로팅하고, Age 변수는 z 축에 플로팅합니다.

scatter3(tbl,'Weight',{'Systolic','Diastolic'},'Age')

xvar, yvar, zvar에 대해 다른 인덱싱 방식을 사용할 수도 있습니다. 예를 들어, xvar을 변수 이름으로 지정하고, yvar을 인덱스 번호로 지정하고, zvar을 논리형 벡터로 지정합니다.

scatter3(tbl,'Height',6,[false false true])

zvar — z 좌표를 포함하는 테이블 변수

하나 이상의 테이블 변수 인덱스

z 좌표를 포함하는 테이블 변수로, 하나 이상의 테이블 변수 인덱스로 지정됩니다.

테이블 인덱스 지정하기

다음 인덱싱 방식 중 하나를 사용하여 원하는 변수를 지정합니다.

인덱싱 방식	예제
변수 이름: string형, 문자형 벡터 또는 셀형 배열. pattern 객체.	"A" 또는 'A' — A라는 변수 ["A","B"] 또는 {'A','B'} — A와 B라는 2개의 변수 "Var"+digitsPattern(1) — "Var" 다음에 하나의 숫자가 오는 이름을 갖는 변수
변수 인덱스: 테이블에서의 변수 위치를 나타내는 인덱스 번호. 숫자 벡터. 논리형 벡터. 일반적으로 이 벡터는 변수의 개수와 길이가 같지만 후행 0 값 또는 false 값을 생략할 수 있습니다.	3 — 테이블의 세 번째 변수 [2 3] — 테이블의 두 번째 변수와 세 번째 변수 [false false true] — 세 번째 변수
변수 유형: 지정된 유형의 변수를 선택하는 vartype 첨자.	vartype("categorical") — categorical형 값을 포함하는 모든 변수

데이터 플로팅하기

사용자가 지정하는 테이블 변수는 숫자형 값, categorical형 값, datetime형 값 또는 duration형 값을 포함할 수 있습니다.

하나의 데이터 세트를 플로팅하려면 xvar에 대한 변수 1개, yvar에 대한 변수 1개, zvar에 대한 변수 1개를 지정하십시오. 예를 들어, Patients.xls를 테이블 tbl로 읽어옵니다. Height, Weight, Diastolic 변수를 플로팅합니다.

tbl = readtable('Patients.xls');
scatter3(tbl,'Height','Weight','Diastolic')

여러 개의 데이터 세트를 함께 플로팅하려면 xvar, yvar 또는 zvar 중 적어도 하나에 대해 여러 개의 변수를 지정하십시오. 하나 이상의 인수에 대해 여러 개의 변수를 지정하는 경우 변수의 개수는 이들 인수 각각에 대해 동일해야 합니다.

예를 들어, Weight 변수는 x 축에 플로팅하고, Systolic과 Diastolic 변수는 y 축에 플로팅하고, Age 변수는 z 축에 플로팅합니다.

scatter3(tbl,'Weight',{'Systolic','Diastolic'},'Age')

xvar, yvar, zvar에 대해 다른 인덱싱 방식을 사용할 수도 있습니다. 예를 들어, xvar을 변수 이름으로 지정하고, yvar을 인덱스 번호로 지정하고, zvar을 논리형 벡터로 지정합니다.

scatter3(tbl,'Height',6,[false false true])

ax — axes 객체

axes 객체

axes 객체입니다. 좌표축을 지정하지 않을 경우 scatter3은 현재 좌표축에 플로팅됩니다.

이름-값 인수

선택적 인수 쌍을 Name1=Value1,...,NameN=ValueN으로 지정합니다. 여기서 Name은 인수 이름이고 Value는 대응값입니다. 이름-값 인수는 다른 인수 뒤에 와야 하지만, 인수 쌍의 순서는 상관없습니다.

R2021a 이전 릴리스에서는 쉼표를 사용하여 각 이름과 값을 구분하고 Name을 따옴표로 묶으십시오.

예: 'MarkerFaceColor','red'는 마커 면 색을 빨간색으로 설정합니다.

여기에 나와 있는 속성은 일부에 불과합니다. 전체 목록을 보려면 Scatter 속성를 참조하십시오.

LineWidth — 마커 가장자리의 너비

0.5 (디폴트 값) | 양의 값

마커 가장자리의 너비로, 양의 값으로 지정됩니다(단위: 포인트).

예: 0.75

MarkerEdgeColor — 마커 윤곽선 색

'flat' (디폴트 값) | RGB 3색 | 16진수 색 코드 | 'r' | 'g' | 'b' | ...

마커 윤곽선 색으로, 'flat', RGB 3색, 16진수 색 코드, 색 이름 또는 짧은 이름으로 지정됩니다. 디폴트 값인 'flat'은 CData 속성의 색을 사용합니다.

사용자 지정 색의 경우에는 RGB 3색 또는 16진수 색 코드를 지정하십시오.

• RGB 3색은 요소를 3개 가진 행 벡터로, 각 요소는 색을 구성하는 빨간색, 녹색, 파란색의 농도를 지정합니다. 농도의 범위는 [0,1]이어야 합니다(예: [0.4 0.6 0.7]).

• 16진수 색 코드는 문자형 벡터 또는 string형 스칼라로, 해시 기호(#)로 시작하고 그 뒤에 3자리 또는 6자리의 16진수 숫자(0에서 F 사이일 수 있음)가 옵니다. 이 값은 대/소문자를 구분하지 않습니다. 따라서 색 코드 '#FF8800', '#ff8800', '#F80' 및 '#f80'은 모두 동일합니다.

몇몇의 흔한 색은 이름으로 지정할 수도 있습니다. 다음 표에는 명명된 색 옵션과 그에 해당하는 RGB 3색 및 16진수 색 코드가 나와 있습니다.

색 이름	짧은 이름	RGB 3색	16진수 색 코드	모양
'red'	'r'	[1 0 0]	'#FF0000'
'green'	'g'	[0 1 0]	'#00FF00'
'blue'	'b'	[0 0 1]	'#0000FF'
'cyan'	'c'	[0 1 1]	'#00FFFF'
'magenta'	'm'	[1 0 1]	'#FF00FF'
'yellow'	'y'	[1 1 0]	'#FFFF00'
'black'	'k'	[0 0 0]	'#000000'
'white'	'w'	[1 1 1]	'#FFFFFF'
'none'	해당 없음	해당 없음	해당 없음	색 없음

다음은 MATLAB이 여러 유형의 플롯에서 사용하는 디폴트 색의 RGB 3색과 16진수 색 코드입니다.

RGB 3색	16진수 색 코드	모양
[0 0.4470 0.7410]	'#0072BD'
[0.8500 0.3250 0.0980]	'#D95319'
[0.9290 0.6940 0.1250]	'#EDB120'
[0.4940 0.1840 0.5560]	'#7E2F8E'
[0.4660 0.6740 0.1880]	'#77AC30'
[0.3010 0.7450 0.9330]	'#4DBEEE'
[0.6350 0.0780 0.1840]	'#A2142F'

예: [0.5 0.5 0.5]

예: 'blue'

예: '#D2F9A7'

MarkerFaceColor — 마커 채우기 색

'none' (디폴트 값) | 'flat' | 'auto' | RGB 3색 | 16진수 색 코드 | 'r' | 'g' | 'b' | ...

마커 채우기 색으로, 'flat', 'auto', RGB 3색, 16진수 색 코드, 색 이름 또는 짧은 이름으로 지정됩니다. 'flat' 옵션은 CData 값을 사용합니다. 'auto' 옵션은 좌표축의 Color 속성과 동일한 색을 사용합니다.

사용자 지정 색의 경우에는 RGB 3색 또는 16진수 색 코드를 지정하십시오.

• RGB 3색은 요소를 3개 가진 행 벡터로, 각 요소는 색을 구성하는 빨간색, 녹색, 파란색의 농도를 지정합니다. 농도의 범위는 [0,1]이어야 합니다(예: [0.4 0.6 0.7]).

• 16진수 색 코드는 문자형 벡터 또는 string형 스칼라로, 해시 기호(#)로 시작하고 그 뒤에 3자리 또는 6자리의 16진수 숫자(0에서 F 사이일 수 있음)가 옵니다. 이 값은 대/소문자를 구분하지 않습니다. 따라서 색 코드 '#FF8800', '#ff8800', '#F80' 및 '#f80'은 모두 동일합니다.

몇몇의 흔한 색은 이름으로 지정할 수도 있습니다. 다음 표에는 명명된 색 옵션과 그에 해당하는 RGB 3색 및 16진수 색 코드가 나와 있습니다.

색 이름	짧은 이름	RGB 3색	16진수 색 코드	모양
'red'	'r'	[1 0 0]	'#FF0000'
'green'	'g'	[0 1 0]	'#00FF00'
'blue'	'b'	[0 0 1]	'#0000FF'
'cyan'	'c'	[0 1 1]	'#00FFFF'
'magenta'	'm'	[1 0 1]	'#FF00FF'
'yellow'	'y'	[1 1 0]	'#FFFF00'
'black'	'k'	[0 0 0]	'#000000'
'white'	'w'	[1 1 1]	'#FFFFFF'
'none'	해당 없음	해당 없음	해당 없음	색 없음

다음은 MATLAB이 여러 유형의 플롯에서 사용하는 디폴트 색의 RGB 3색과 16진수 색 코드입니다.

RGB 3색	16진수 색 코드	모양
[0 0.4470 0.7410]	'#0072BD'
[0.8500 0.3250 0.0980]	'#D95319'
[0.9290 0.6940 0.1250]	'#EDB120'
[0.4940 0.1840 0.5560]	'#7E2F8E'
[0.4660 0.6740 0.1880]	'#77AC30'
[0.3010 0.7450 0.9330]	'#4DBEEE'
[0.6350 0.0780 0.1840]	'#A2142F'

예: [0.3 0.2 0.1]

예: 'green'

예: '#D2F9A7'

ColorVariable — 색 데이터를 포함하는 테이블 변수

테이블 변수 인덱스

색 데이터를 포함하는 테이블 변수로, 소스 테이블의 요소를 참조하는 변수 인덱스로 지정됩니다.

테이블 인덱스 지정하기

다음 인덱싱 방식 중 하나를 사용하여 원하는 변수를 지정합니다.

인덱싱 방식	예제
변수 이름: string형 스칼라 또는 문자형 벡터. pattern 객체. pattern 객체는 하나의 변수만 참조해야 합니다.	"A" 또는 'A' — A라는 변수 "Var"+digitsPattern(1) — "Var" 다음에 하나의 숫자가 오는 이름을 갖는 변수
변수 인덱스: 테이블에서의 변수 위치를 나타내는 인덱스 번호. 논리형 벡터. 일반적으로 이 벡터는 변수의 개수와 길이가 같지만 후행 0 값 또는 false 값을 생략할 수 있습니다.	3 — 테이블의 세 번째 변수 [false false true] — 세 번째 변수
변수 유형: 지정된 유형의 테이블 변수를 선택하는 vartype 첨자. 첨자는 하나의 변수만 참조해야 합니다.	vartype("double") — double형 값을 포함하는 변수

색 데이터 지정하기

ColorVariable 속성을 지정하면 마커의 색이 제어됩니다. MarkerFaceColor 속성이 'flat'으로 설정된 경우 이 변수의 데이터가 마커 채우기 색을 제어합니다. 또한, MarkerEdgeColor가 'flat'으로 설정된 경우 이 데이터로 마커 윤곽선 색도 제어할 수 있습니다.

사용자가 지정하는 테이블 변수에는 임의의 숫자형 값이 포함될 수 있습니다. 이 값은 다음 형식 중 하나가 될 수 있습니다.

• 현재 컬러맵에 선형으로 매핑되는 번호의 열.

• RGB 3색으로 구성된 3열 배열. RGB 3색은 3개의 요소를 가진 벡터로, 각 요소의 값은 특정 색을 구성하는 빨간색, 녹색, 파란색 성분의 농도를 지정합니다. 농도의 범위는 [0,1]이어야 합니다. 예를 들어, [0.5 0.7 1]은 연한 파란색을 지정합니다.

ColorVariable 속성을 설정하면 MATLAB은 CData 속성을 업데이트합니다.

출력 인수

h — Scatter 객체

Scatter 객체

Scatter 객체입니다. 이는 고유 식별자로, Scatter 객체가 생성된 후에 이 객체의 속성을 쿼리하고 수정하는 데 사용할 수 있습니다.

확장 기능

GPU 배열

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

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

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

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

분산 배열

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

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

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

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

버전 내역

R2006a 이전에 개발됨

R2022a: 행렬을 사용하여 여러 개의 데이터 세트를 한꺼번에 플로팅

이제 scatter3 함수가 좌표를 벡터와 행렬의 조합으로 받습니다. 따라서 플로팅 명령 간에 hold 함수를 사용할 필요 없이 여러 개의 데이터 세트를 한꺼번에 시각화할 수 있습니다.

R2021b: 테이블을 scatter3에 직접 전달

테이블을 scatter3 함수에 전달하고 이어서 플로팅할 변수를 전달하여 플롯을 생성합니다. 데이터를 테이블로 지정하면, 테이블 변수 이름을 사용하여 축 레이블과 범례(있는 경우)에 자동으로 레이블이 지정됩니다.

참고 항목

함수

• scatter | plot3 | bubblechart3 | swarmchart3

속성

• Scatter 속성

도움말 항목

• 날짜/시간 플로팅하기
• categorical형 데이터 플로팅하기
• Plots That Support Tables

×

예제 열기

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

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