contourc

로우 레벨 등고선 행렬 계산

구문

M = contourc(Z)

M = contourc(x,y,Z)

M = contourc(___,levels)

설명

M = contourc(Z)는 곡면에 대한 등고선 행렬 M을 구합니다. Z를 x-y 평면에 대한 등고선 높이 값을 포함하는 행렬로 지정합니다. MATLAB^®에서 등고선의 개수와 대응값을 결정합니다. Z의 열과 행 인덱스는 각각 평면의 x, y 좌표입니다.

참고

contourc로 반환된 행렬은 contour 함수와 contourf 함수, contour3 함수의 결과와 일치하지 않을 수 있습니다. 이러한 함수 중 하나에 사용된 행렬을 가져오려면 해당 함수를 출력 인수와 함께 호출하십시오.

M = contourc(x,y,Z)는 Z에 들어 있는 값에 대한 x, y 좌표를 지정합니다.

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

예제

포물면의 등고선

벡터 x와 y를 만듭니다. 그런 다음 xy 평면에서 그리드를 정의하는 행렬 Xm 및 Ym을 만듭니다. 행렬 Z를 포물면의 높이 값으로 정의합니다.

x = -5:0.5:5;
y = -5:0.5:5;
[Xm,Ym] = meshgrid(x,y);
Z = Xm.^2 + Ym.^2;

Z의 x, y 좌표를 지정하지 않고 Z에 대한 등고선 행렬을 계산합니다. 결과를 행렬 M1로 반환하고, 처음 5개 열을 표시합니다. 첫 번째 열의 값은 첫 번째 등고선이 꼭짓점이 29개 있는 Z=5에 있다는 것을 나타냅니다. 첫 번째 꼭짓점은 x=7, y=13에 있습니다.

M1 = contourc(Z);
M1(:,1:5)

ans = 2×5

    5.0000    7.0000    7.7143    8.0000    9.0000
   29.0000   13.0000   14.0000   14.2857   15.0000

Z에 대한 등고선 행렬을 다시 계산합니다. 이번에는 x, y 좌표를 지정합니다. M2의 처음 5개 열을 표시합니다. 첫 번째 등고선의 첫 번째 Z 값과 꼭짓점 개수는 M1에서와 동일하지만, 꼭짓점 좌표는 다릅니다.

M2 = contourc(x,y,Z);
M2(:,1:5)

ans = 2×5

    5.0000   -2.0000   -1.6429   -1.5000   -1.0000
   29.0000    1.0000    1.5000    1.6429    2.0000

10개 레벨의 등고선

벡터 x와 y를 만듭니다. 그런 다음 xy 평면에서 그리드를 정의하는 행렬 Xm 및 Ym을 만듭니다. 행렬 Z를 포물면의 높이 값으로 정의합니다.

x = -5:0.5:5;
y = -5:0.5:5;
[Xm,Ym] = meshgrid(x,y);
Z = Xm.^2 + Ym.^2;

contourc 함수에 의해 선택된 10개 레벨의 등고선 행렬을 계산합니다. 결과를 행렬 M으로 반환하고, 처음 5개 열을 표시합니다. 첫 번째 열의 값은 첫 번째 등고선이 꼭짓점이 37개 있는 Z=4.55에 있다는 것을 나타냅니다. 첫 번째 꼭짓점은 x=-2, y=0.697에 있습니다.

M = contourc(x,y,Z,10);
M(:,1:5)

ans = 2×5

    4.5455   -2.0000   -1.8701   -1.5130   -1.5000
   37.0000    0.6970    1.0000    1.5000    1.5130

특정 레벨의 등고선

벡터 x와 y를 만듭니다. 그런 다음 xy 평면에서 그리드를 정의하는 행렬 Xm 및 Ym을 만듭니다. 행렬 Z를 포물면의 높이 값으로 정의합니다.

x = -5:0.5:5;
y = -5:0.5:5;
[Xm,Ym] = meshgrid(x,y);
Z = Xm.^2 + Ym.^2;

4개의 특정 레벨, 즉 5, 10, 15, 20의 등고선 행렬을 계산합니다. 결과를 행렬 M으로 반환하고, 처음 5개 열을 표시합니다. 첫 번째 열의 값은 첫 번째 등고선이 꼭짓점이 29개 있는 Z=5에 있다는 것을 나타냅니다. 첫 번째 꼭짓점은 x=-2, y=1에 있습니다.

M = contourc(x,y,Z,[5 10 15 20]);
M(:,1:5)

ans = 2×5

    5.0000   -2.0000   -1.6429   -1.5000   -1.0000
   29.0000    1.0000    1.5000    1.6429    2.0000

입력 인수

x — x 좌표

벡터

x 좌표로, 길이가 n인 벡터로 지정됩니다. 여기서 [m,n] = size(Z)입니다. x의 디폴트 값은 벡터 (1:n)입니다. 벡터의 값은 순증가 또는 순감소해야 합니다.

예: x = 1:10

예: x = [1 2 3 4 5]

참고

contourc는 규칙적인 간격으로 나뉜 등고선 그리드를 사용하여 등고선을 계산한 다음 해당 데이터를 x 또는 y로 변환합니다. x 또는 y가 불규칙적인 간격으로 나뉜 경우 등고선의 모양이 왜곡될 수 있습니다.

데이터형: double

y — y 좌표

벡터

y 좌표로, 길이가 m인 벡터로 지정됩니다. 여기서 [m,n] = size(Z)입니다. y의 디폴트 값은 벡터 (1:m)입니다. 벡터의 값은 순증가 또는 순감소해야 합니다.

예: y = 1:10

예: y = [1 2 3 4 5]

참고

contourc는 규칙적인 간격으로 나뉜 등고선 그리드를 사용하여 등고선을 계산한 다음 해당 데이터를 x 또는 y로 변환합니다. x 또는 y가 불규칙적인 간격으로 나뉜 경우 등고선의 모양이 왜곡될 수 있습니다.

데이터형: double

Z — z 좌표

행렬

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

예: Z = peaks(20)

데이터형: double

levels — 등고선 레벨

스칼라 | 벡터

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

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

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

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

예: contourc(peaks,10)은 peaks 함수에 대해 자동으로 선택된 10개의 높이에서 등고선을 계산합니다.

예: contourc(peaks,[-4 0 4])는 peaks 함수에 대해 3개의 특정 높이(-4, 0, 4)에서 등고선을 계산합니다.

예: contourc(peaks,[3 3])은 peaks 함수의 높이가 3인 등고선을 계산합니다.

데이터형: double

출력 인수

M — 등고선 행렬

행렬

등고선 행렬로, 다음 형식의 2행 행렬로 반환됩니다.

Z1, x1,1, x1,2, ..., x1,N1, Z2, x2,1, x2,2, ..., x2,N2, Z3, ...
N1, y1,1, y1,2, ..., y1,N1, N2, y2,1, y2,2, ..., y2,N2, N3, ...

행렬의 열은 등고선을 정의합니다. 각 등고선은 Z 값 및 N 값을 포함하는 열로 시작합니다.

• Zi — i번째 등고선의 높이

• Ni — i번째 등고선의 꼭짓점 개수

• (x_ij, y_ij) — i번째 등고선의 꼭짓점 좌표임. 여기서 j의 범위는 1에서 Ni까지임

확장 기능

GPU 배열

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

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

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

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

분산 배열

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

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

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

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

버전 내역

R2006a 이전에 개발됨

참고 항목

contour | contour3 | contourf | clabel