이 페이지의 최신 내용은 아직 번역되지 않았습니다. 최신 내용은 영문으로 볼 수 있습니다.

scatter3

3차원 산점도 플롯

구문

scatter3(X,Y,Z)

scatter3(X,Y,Z,S)

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

scatter3(___,'filled')

scatter3(___,markertype)

scatter3(___,Name,Value)

scatter3(ax,___)

h = scatter3(___)

설명

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

scatter3(X,Y,Z,S)는 각 원을 S로 지정된 크기로 그립니다. 각 원을 동일한 크기로 플로팅하려면 S를 스칼라로 지정하십시오. 각 원을 특정 크기로 플로팅하려면 S를 벡터로 지정하십시오.

scatter3(X,Y,Z,S,C)는 각 원을 C로 지정된 색으로 그립니다.

• C가 RGB 3색이나 색 이름을 포함하는 문자형 벡터나 string형이면 모든 원이 지정한 색으로 플로팅됩니다.

• C가 3열 행렬이고 C의 행 개수가 X, Y, Z의 길이와 동일한 경우, C의 각 행은 대응하는 원의 RGB 색 값을 지정합니다.

• C가 벡터이고 그 길이가 X, Y, Z의 길이와 같은 경우 C의 값은 현재 컬러맵의 색에 선형적으로 매핑됩니다.

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

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

scatter3(___,Name,Value)는 하나 이상의 이름-값 쌍의 인수를 사용하여 산점도 차트를 수정합니다.

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

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)

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

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

seamount 데이터 세트를 불러와서 벡터 x, y, z를 가져옵니다. tiledlayout 함수를 호출하여 2x1 바둑판식 배열 차트 레이아웃을 만듭니다. 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, Y, Z는 길이가 같은 벡터여야 합니다.

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

Y — y 값

벡터

y 값으로, 벡터로 지정됩니다. X, Y, Z는 길이가 같은 벡터여야 합니다.

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

Z — z 값

벡터

z 값으로, 벡터로 지정됩니다. X, Y, Z는 길이가 같은 벡터여야 합니다.

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

S — 마커 면적

36 (디폴트 값) | 스칼라 | 벡터 | []

마커 면적으로, 스칼라, 벡터, [] 중 하나로 지정됩니다. S의 값은 양수여야 합니다. 면적의 단위는 제곱포인트입니다.

• S가 스칼라이면 scatter3은 지정된 면적에 모든 마커를 플로팅합니다.

• S가 행 벡터이거나 열 벡터이면 S의 각 항목은 해당하는 마커의 면적을 지정합니다. S의 길이는 X, Y, Z의 길이와 같아야 합니다. X, Y, Z, S의 해당하는 항목은 각 마커의 위치와 면적을 결정합니다.

• S가 비어 있으면 디폴트 크기인 36제곱포인트가 사용됩니다.

예: 50

예: [36,25,25,17,46]

C — 마커 색

[0 0 1](파란색) (디폴트 값) | RGB 3색 | RGB 3색으로 구성된 3열 행렬 | 벡터 | 'r' | 'g' | 'b' | ...

마커 색으로, RGB 3색, RGB 3색으로 구성된 3열 행렬, 벡터 또는 표의 색 옵션 중 하나로 지정됩니다.

RGB 3색은 요소를 3개 가진 행 벡터로, 각 요소는 색을 구성하는 빨간색, 녹색, 파란색의 농도를 지정합니다. 농도의 범위는 [0,1]이어야 합니다(예: [0.4 0.6 0.7]). 몇몇의 흔한 색은 이름으로 지정할 수도 있습니다. 다음 표에는 색의 긴 이름과 짧은 이름 옵션, 그리고 각각에 대응하는 RGB 3색 값이 나열되어 있습니다.

옵션	설명	대응하는 RGB 3색
'red' 또는 'r'	빨간색	[1 0 0]
'green' 또는 'g'	녹색	[0 1 0]
'blue' 또는 'b'	파란색	[0 0 1]
'yellow' 또는 'y'	노란색	[1 1 0]
'magenta' 또는 'm'	자홍색	[1 0 1]
'cyan' 또는 'c'	녹청색	[0 1 1]
'white' 또는 'w'	흰색	[1 1 1]
'black' 또는 'k'	검은색	[0 0 0]

산점도 플롯에 3개의 점이 있고 해당 색을 컬러맵에 대한 인덱스로 설정하려면 C를 요소를 3개 가진 열 벡터로 지정하십시오.

예: 'y'

예: [1,2,3,4]

markertype — 마커

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

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

값	설명
'o'	원
'+'	플러스 기호
'*'	별표
'.'	점
'x'	십자
'square' 또는 's'	정사각형
'diamond' 또는 'd'	다이아몬드
'^'	위쪽 방향 삼각형
'v'	아래쪽 방향 삼각형
'>'	오른쪽 방향 삼각형
'<'	왼쪽 방향 삼각형
'pentagram' 또는 'p'	오각별(펜타그램)
'hexagram' 또는 'h'	육각별(헥사그램)
'none'	마커 없음

ax — axes 객체

axes 객체

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

이름-값 쌍의 인수

선택적으로 Name,Value 인수가 쉼표로 구분되어 지정됩니다. 여기서 Name은 인수 이름이고 Value는 대응값입니다. Name은 따옴표 안에 표시해야 합니다. Name1,Value1,...,NameN,ValueN과 같이 여러 개의 이름-값 쌍의 인수를 어떤 순서로든 지정할 수 있습니다.

예: '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'

출력 인수

h — Scatter 객체

Scatter 객체

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

확장 기능

GPU 배열

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

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

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

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

분산 배열

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

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

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

자세한 내용은 Run MATLAB Functions with Distributed Arrays (Parallel Computing Toolbox) 항목을 참조하십시오.

참고 항목

함수

• plot3 | scatter

속성

• Scatter 속성

도움말 항목

• 날짜와 기간 플로팅하기
• categorical형 데이터 플로팅하기

R2006a 이전에 개발됨

×

예제 열기

귀하의 시스템에 이 예제의 수정된 버전이 있습니다. 이 버전을 대신 여시겠습니까?

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