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

contour3

3차원 등고선(3-D Contour) 플롯

구문

contour3(Z)

contour3(X,Y,Z)

contour3(___,levels)

contour3(___,LineSpec)

contour3(___,Name,Value)

contour3(ax,___)

M = contour3(___)

[M,c] = contour3(___)

설명

contour3(Z)는 행렬 Z의 등치선을 포함하는 3차원 등고선 플롯을 만듭니다. 여기서 Z는 x-y 평면의 높이 값을 포함합니다. MATLAB^®은 표시할 등고선을 자동으로 선택합니다. Z의 열과 행 인덱스는 각각 평면의 x, y 좌표입니다.

contour3(X,Y,Z)는 Z에 들어 있는 값에 대한 x 및 y 좌표를 지정합니다.

contour3(___,levels)는 위에 열거된 구문에서 표시할 등고선을 마지막 인수로 지정합니다. levels를 스칼라 값 n으로 지정하면 n개의 자동으로 선택된 레벨(높이)에 등고선이 표시됩니다. 특정 높이에 등고선을 그리려면 levels를 단조 증가하는 값으로 구성된 벡터로 지정하십시오. 하나의 높이(k)에 등고선을 그리려면 levels를 요소를 2개 가진 행 벡터 [k k]로 지정하십시오.

contour3(___,LineSpec)은 등고선의 스타일과 색을 지정합니다.

contour3(___,Name,Value)는 하나 이상의 이름-값 쌍 인수를 사용하여 등고선 플롯에 대한 추가 옵션을 지정합니다. 다른 모든 입력 인수 다음에 옵션을 지정합니다. 속성 목록은 Contour 속성를 참조하십시오.

contour3(ax,___)는 대상 좌표축에 등고선 플롯을 표시합니다. 위에 열거된 구문에서 좌표축을 첫 번째 인수로 지정합니다.

M = contour3(___)은 각 레벨에서의 꼭짓점의 (x, y) 좌표를 포함하는 등고선 행렬 M을 반환합니다.

[M,c] = contour3(___)은 등고선 행렬과 contour 객체 c를 반환합니다. 등고선 플롯을 표시한 뒤에 c를 사용하여 속성을 설정하십시오.

예제

구의 등고선

Z를 X와 Y의 함수로 정의합니다. 여기서는 sphere 함수를 호출하여 X, Y, Z를 만듭니다. 그런 다음 Z의 등고선을 플로팅합니다.

[X,Y,Z] = sphere(50);
contour3(X,Y,Z);

50개 레벨의 등고선

Z를 2개의 변수 X와 Y의 함수로 정의합니다. 그런 다음 Z의 등고선을 플로팅합니다. 여기서는 MATLAB®이 x축과 y축의 제한과 등고선을 선택하도록 합니다.

[X,Y] = meshgrid(-5:0.25:5);
Z = X.^2 + Y.^2;
contour3(Z)

이제 50개의 등고선 레벨을 지정한 다음 Z를 계산하는 데 사용된 x와 y 제한 안에서 결과를 표시합니다.

contour3(X,Y,Z,50)

레벨과 레이블이 지정된 등고선

Z를 2개의 변수 X와 Y의 함수로 정의합니다. 그런 다음 Z = [-.2 -.1 .1 .2]에서 등고선을 플로팅합니다. ShowText 속성을 'on'으로 설정하여 등고선 레이블을 표시합니다.

[X,Y] = meshgrid(-2:0.25:2);
Z = X.*exp(-X.^2-Y.^2);
contour3(X,Y,Z,[-.2 -.1 .1 .2],'ShowText','on')

1개 레벨의 등고선

Z를 X와 Y의 함수로 정의합니다. 여기서는 peaks 함수를 호출하여 X, Y, Z를 만듭니다. 그런 다음 Z = 2에 등고선을 표시합니다.

[X,Y,Z] = peaks;
contour3(X,Y,Z,[2 2]);

사용자 지정 선 너비

Z를 2개의 변수 X와 Y의 함수로 정의합니다. Z의 등고선 30개를 플로팅한 다음 선 너비를 3으로 설정합니다.

[X,Y] = meshgrid(-2:0.0125:2);
Z = X.*exp(-X.^2-Y.^2);
[M,c] = contour3(X,Y,Z,30);
c.LineWidth = 3;

입력 인수

X — x 좌표

행렬 | 벡터

x 좌표로, Z와 크기가 동일한 행렬 또는 길이가 n인 벡터로 지정됩니다(여기서 [m,n] = size(Z)임). X의 디폴트 값은 벡터 (1:n)입니다.

X가 행렬이면 한 차원에서는 값이 순증가 또는 순감소하고 다른 한 차원에서는 값이 일정해야 합니다. 값이 변하는 차원은 Y의 값이 변하는 차원과 반대 차원이어야 합니다. meshgrid 함수를 사용하여 X와 Y 행렬을 만들 수 있습니다.

X가 벡터이면 값은 순증가 또는 순감소해야 합니다.

예: X = 1:10

예: X = [1 2 3; 1 2 3; 1 2 3]

예: [X,Y] = meshgrid(1:10)

Contour 객체의 XData 속성에는 x 좌표가 저장됩니다.

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

Y — y 좌표

행렬 | 벡터

y 좌표로, Z와 크기가 동일한 행렬 또는 길이가 m인 벡터로 지정됩니다(여기서 [m,n] = size(Z)임). Y의 디폴트 값은 벡터 (1:m)입니다.

Y가 행렬이면 한 차원에서는 값이 순증가 또는 순감소하고 다른 한 차원에서는 값이 일정해야 합니다. 값이 변하는 차원은 X의 값이 변하는 차원과 반대 차원이어야 합니다. meshgrid 함수를 사용하여 X와 Y 행렬을 만들 수 있습니다.

Y가 벡터이면 값은 순증가 또는 순감소해야 합니다.

예: Y = 1:10

예: Y = [1 1 1; 2 2 2; 3 3 3]

예: [X,Y] = meshgrid(1:10)

Contour 객체의 YData 속성에는 y 좌표가 저장됩니다.

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

Z — z 좌표

행렬

z 좌표로, 행렬로 지정됩니다. 이 행렬은 적어도 2개의 행과 2개의 열을 가져야 하며, 2개 이상의 서로 다른 값을 포함해야 합니다.

예: Z = peaks(20)

Contour 객체의 ZData 속성에는 z 좌표가 저장됩니다.

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

levels — 레벨

스칼라 | 벡터

등고선 레벨로, 스칼라 정수나 벡터로 지정됩니다. 이 인수를 사용하여 등고선의 개수와 위치를 제어합니다. 레벨을 지정하지 않으면 contour3 함수는 레벨을 자동으로 선택합니다.

• 자동으로 선택된 n개의 높이에 등고선을 그리려면 levels를 스칼라 값 n으로 지정하십시오.

• 특정 높이에 등고선을 그리려면 levels를 단조 증가하는 값으로 구성된 벡터로 지정하십시오.

• 하나의 높이 k에 등고선을 그리려면 levels를 요소를 2개 가진 행 벡터 [k k]로 지정하십시오.

예: contour3(peaks,10)은 peaks 함수에 대해 자동으로 선택된 10개의 높이에 등고선을 그립니다.

예: contour3(peaks,[-4 0 4])는 peaks 함수에 대해 3개의 특정 높이(-4, 0, 4)에 등고선을 그립니다.

예: contour3(peaks,[3 3])은 peaks 함수의 높이가 3인 등고선을 그립니다.

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

LineSpec — 선 스타일과 색

문자형 벡터 | string형 스칼라

선 스타일과 색으로, 선 스타일 기호, 색 옵션 또는 두 가지 모두를 포함하는 문자형 벡터나 string형 스칼라로 지정됩니다. 선 스타일 기호는 아래 표에서 확인할 수 있으며, 어떤 순서로 지정해도 좋습니다. 'o'와 같은 마커 기호는 무시됩니다.

선 스타일과 색 중 하나를 지정하지 않아도 됩니다. 예를 들어, 선 스타일을 생략하고 색만 지정하면 지정된 색의 실선으로 플로팅됩니다.

선 스타일	설명	결과 선
-	실선(디폴트 값)
--	파선
:	점선
-.	일점 쇄선

다음 표에서는 사용 가능한 색 옵션을 확인할 수 있습니다.

옵션	설명	대응하는 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]

ax — 대상 좌표축

Axes 객체

대상 좌표축으로, Axes 객체로 지정됩니다. 좌표축을 지정하지 않을 경우 contour3은 현재 좌표축에 플로팅됩니다.

이름-값 쌍의 인수

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

예: contour3(Z,'ShowText','on')은 등고선 레이블을 표시합니다.

참고

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

'ShowText' — 등고선 레이블

'off' (디폴트 값) | on/off 논리값

등고선 레이블로, 'on' 또는 'off'나 숫자형 값 또는 논리값 1(true) 또는 0(false)으로 지정됩니다. 값 'on'은 true와 동일하고 값 'off'는 false와 동일합니다. 따라서 이 속성의 값을 논리값으로 사용할 수 있습니다. 값은 matlab.lang.OnOffSwitchState 유형의 on/off 논리값으로 저장됩니다.

• 'on' — 등고선을 따라 높이 값을 표시합니다.

• 'off' — 등고선에 레이블을 지정하지 않습니다.

'LineWidth' — 선 너비

0.5 (디폴트 값) | 양의 값

등고선 너비로, 양의 값으로 지정됩니다(단위: 포인트). 1포인트는 1/72인치와 같습니다.

'LabelSpacing' — 레이블 간격

144 (디폴트 값) | 스칼라

등고선을 따라 표시되는 레이블의 간격으로, 스칼라 값으로 지정됩니다(단위: 포인트). 여기서 1포인트는 1/72인치입니다(1인치 = 2.54cm). 이 속성을 사용하여 등고선을 따라 표시되는 등고선 레이블의 개수를 제어합니다. 값이 작을수록 더 많은 레이블이 표시됩니다.

LabelSpacing 속성이 영향을 미치려면 ShowText 속성을 'on'으로 설정해야 합니다.

clabel 함수를 사용하여 레이블을 표시할 경우에는 LabelSpacing 속성이 영향을 미치지 않으며 플롯에 선 하나당 레이블 하나가 표시됩니다.

출력 인수

M — 등고선 행렬

행렬

등고선 행렬로, 2행 행렬로 반환됩니다. 이 행렬은 등고선 레벨(높이)과 각 레벨에서의 꼭짓점의 좌표를 포함합니다. 데이터는 n개의 등고선에 대해 n개의 열 세트로 순서대로 배열됩니다.

• 각 세트의 첫 번째 열은 등고선 레벨과 그 레벨에서의 꼭짓점의 개수를 포함합니다. 위 숫자는 등고선 레벨이고 아래 숫자는 꼭짓점 개수입니다.

• 각 세트의 그 다음 열들은 꼭짓점의 (x, y) 좌표입니다. 각 열은 순서가 지정된 쌍을 표현합니다. 위 숫자는 x 좌표이고 아래 숫자는 y 좌표입니다.

예를 들어, 다음은 등고선 행렬 M = contour(peaks(3))의 처음 몇 개의 열입니다.

Contour 객체의 ContourMatrix 속성에는 등고선 행렬이 저장됩니다.

c — contour 객체

Contour 객체

Contour 객체입니다. 등고선 플롯을 표시한 뒤에 이 객체를 사용하여 속성을 설정합니다.

확장 기능

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) 항목을 참조하십시오.

참고 항목

함수

• clabel | contour | contourc | contourf

속성

• Contour 속성

R2006a 이전에 개발됨

×

예제 열기

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

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