zlim

z축 제한 설정 또는 쿼리

구문

zlim(limits)

zlim(limitmethod)

zlim(limitmode)

zl = zlim

limmethod = zlim("method")

limmode = zlim("mode")

___ = zlim(ax,___)

설명

제한 지정하기

zlim(limits)는 현재 좌표축의 z축 제한을 설정합니다. limits를 [zmin zmax] 형식의 요소를 2개 가진 벡터로 지정합니다. 여기서 zmax는 zmin보다 큽니다.

zlim(limitmethod)는 MATLAB^®이 제한을 자동으로 선택하는 데 사용하는 방법을 지정합니다. 제한 방법을 "tickaligned", "tight" 또는 "padded"로 지정합니다. MATLAB은 지정한 값으로 좌표축의 ZLimitMethod 속성을 설정합니다.

limitmethod 인수를 괄호 없이 지정할 수 있습니다. 예를 들어, zlim tight를 지정하면 꼭 맞는 z축 제한이 활성화됩니다.

zlim(limitmode)는 제한의 자동 또는 수동 선택을 지정합니다. limitmode는 다음 두 개의 값 중 하나일 수 있습니다.

• "auto" — 자동 제한 선택을 활성화합니다. MATLAB은 데이터의 범위와 좌표축의 ZLimitMethod 속성값에 따라 제한을 선택합니다. 좌표축에 여러 차례 플로팅하는 경우 모든 데이터가 포함되도록 제한이 업데이트됩니다.

• "manual" — z축 제한을 현재 값으로 고정합니다.

limitmode 인수를 괄호 없이 지정할 수 있습니다. 예를 들어, zlim auto를 지정하면 자동 제한 선택이 활성화됩니다.

제한 쿼리하기

zl = zlim은 현재 제한을 요소를 2개 가진 벡터로 반환합니다.

limmethod = zlim("method")는 현재 z축 제한 방법을 반환합니다. 이는 'tickaligned', 'tight' 또는 'padded'일 수 있습니다.

limmode = zlim("mode")는 현재 z축 제한 모드에 따라 'auto' 또는 'manual'을 반환합니다. 제한을 지정하거나 모드를 'manual'로 설정하지 않는 한 이 모드는 기본적으로 'auto'로 설정됩니다.

대상 좌표축 또는 차트 지정하기

___ = zlim(ax,___)는 현재 좌표축 대신 ax로 지정된 좌표축을 사용합니다. 위에 열거된 모든 구문에서 ax를 첫 번째 입력 인수로 지정할 수 있습니다. 원래 구문이 출력 인수를 지원하는 경우 출력 인수를 포함시킬 수 있습니다. 모드 입력값을 따옴표로 묶으십시오(예: zlim(ax,"auto")).

예제

z축 제한 설정하기

곡면을 플로팅하고 z축 제한의 범위를 -5 ~ 5로 설정합니다.

[X,Y,Z] = peaks;
surf(X,Y,Z);
zlim([-5 5])

반자동 z축 제한 사용하기

메시 곡면 플롯을 만들고, 0보다 큰 z 값만 표시합니다. 최소 z축 제한을 0으로 지정하고, MATLAB이 최대 제한을 선택하도록 합니다.

[X,Y,Z] = peaks;
mesh(X,Y,Z)
zlim([0 inf])

꼭 맞는 z축 제한 지정하기

peaks 데이터 세트의 곡면 플롯을 만듭니다. 측면에서 곡면을 볼 수 있도록 플롯 상자의 보기를 조정합니다.

surf(peaks)
view([-45 15])

곡면 위와 아래의 공간이 줄어들도록 z축 제한을 조정합니다. 제한 방법을 'tight'로 변경합니다.

zlim tight

특정 좌표축의 z축 제한 설정하기

R2019b부터는 tiledlayout 함수와 nexttile 함수를 사용하여 플롯을 타일 형식 배열로 표시할 수 있습니다. tiledlayout 함수를 호출하여 2×1 타일 형식 차트 레이아웃을 만듭니다. nexttile 함수를 호출하여 axes 객체 ax1과 ax2를 만듭니다. 각 좌표축에 데이터를 플로팅합니다. 그런 다음 ax2를 zlim에 대한 첫 번째 입력 인수로 지정하여 하부 플롯의 z축 제한을 설정합니다.

[X,Y,Z] = peaks;
tiledlayout(2,1)
ax1 = nexttile;
surf(X,Y,Z)

ax2 = nexttile;
surf(X,Y,Z)
zlim(ax2,[-5 5])

현재 z축 제한 유지하기

좌표축에 플롯을 추가할 때 manual 모드를 사용하여 현재 z축 제한을 유지합니다.

먼저 3차원 산점도 플롯을 만듭니다.

theta = linspace(0,2*pi);
X = cos(theta);
Y = sin(theta);
Z = theta;
scatter3(X,Y,Z)

제한값이 변경되지 않도록 z축 제한 모드를 manual로 설정합니다. hold on을 사용하여 좌표축에 두 번째 플롯을 추가합니다.

zlim manual
hold on 
Znew = 5*theta;
scatter3(X,Y,Znew)
hold off

z축 제한이 새 플롯에 대해 업데이트되지 않습니다.

모드를 auto로 설정하여 자동 업데이트된 제한으로 다시 전환합니다.

zlim auto

z축 제한 반환하기

임의의 데이터로 구성된 3차원 산점도 플롯을 만듭니다. z축 제한의 값을 반환합니다.

x = randn(50,1);
y = randn(50,1);
z = randn(50,1);
scatter3(x,y,z)

zl = zlim

zl = 1×2

    -3     3

입력 인수

limits — 최소 제한 및 최대 제한

요소를 2개 가진 벡터

최소 제한과 최대 제한으로, [zmin zmax] 형식의 요소를 2개 가진 벡터로 지정됩니다. 여기서 zmax는 zmin보다 큽니다. 제한은 숫자형 값, categorical형 값, datetime형 값 또는 duration형 값으로 지정할 수 있습니다. 하지만 지정한 값 유형은 z축의 값 유형과 일치해야 합니다.

두 제한을 모두 지정하거나 한 제한을 지정하고 MATLAB이 다른 하나를 자동으로 계산하게 할 수 있습니다. 자동으로 계산된 최소 제한이나 최대 제한의 경우 각각 -inf 또는 inf를 사용합니다. MATLAB은 'tight' 제한 방법을 사용하여 해당 제한을 계산합니다.

예: zlim([0 1])

예: zlim([-inf 1])

예: zlim([0 inf])

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

limitmethod — 제한 선택 방법

"tickaligned" (디폴트 값) | "padded" | "tight"

제한 선택 방법으로, 다음 표의 값으로 지정됩니다.

표에 나와 있는 예제는 각 방법의 대략적인 모양을 보여줍니다. 결과는 데이터, 좌표축 크기, 플롯 상자의 시야각, 만든 플롯의 유형에 따라 달라질 수 있습니다.

값	설명	예
"tickaligned"	일반적으로, 좌표축 상자의 가장자리를 데이터에 가장 가까운 눈금에 맞춰 정렬합니다. 이때 어떠한 데이터도 제외하지 않습니다. 모양은 플로팅하는 데이터의 유형과 생성하는 차트의 유형에 따라 달라질 수 있습니다.
"tight"	축 제한을 데이터 범위로 설정하여 좌표축 상자를 데이터 둘레에 꼭 맞게 맞춥니다.
"padded"	사방을 가느다란 여백으로 채워 좌표축 상자를 데이터 둘레에 맞게 맞춥니다. 여백의 너비는 대략 데이터 범위의 7%입니다.

참고

좌표축의 ZLimMode 속성이 "manual"로 설정된 경우에는 제한 방법이 영향을 미치지 않습니다.

limitmode — 제한 모드

"auto" | "manual"

제한 모드로, 다음 값 중 하나로 지정됩니다.

• "auto" — 자동 제한 선택을 활성화합니다. 자동 제한 선택은 데이터의 총 범위와 좌표축의 ZLimitMethod 속성값을 기반으로 합니다. 좌표축에 여러 차례 플로팅하는 경우 모든 데이터가 포함되도록 제한이 업데이트됩니다. 제한을 변경한 후 이를 다시 디폴트 값으로 설정하려는 경우 이 옵션을 사용하면 됩니다.

• "manual" — 제한을 현재 값으로 고정합니다. hold on 명령을 사용하여 좌표축에 새 데이터를 추가할 때 현재 제한을 유지하려면 이 옵션을 사용하십시오.

이 인수를 지정하면 MATLAB은 지정한 값으로 좌표축의 ZLimMode 속성을 설정합니다. 단, zlim(limits)를 호출하거나 좌표축의 ZLim 속성값을 설정하여 z축 제한을 명시적으로 설정하는 경우에는 항상 ZLimMode 속성이 "manual"로 변경됩니다.

ax — 대상 좌표축

Axes 객체 | Axes 객체로 구성된 배열

대상 좌표축으로, Axes 객체 또는 Axes 객체로 구성된 배열로 지정됩니다.

이 인수를 지정하지 않는 경우 zlim은 현재 좌표축에 대해 제한을 설정합니다.

출력 인수

zl — 현재 제한

요소를 2개 가진 벡터

현재 제한으로, [zmin zmax] 형식의, 요소를 2개 가진 벡터로 반환됩니다.

제한을 쿼리하면 대응하는 Axes 객체의 ZLim 속성값이 반환됩니다.

limmethod — 현재 제한 방법

'tickaligned' | 'tight' | 'padded'

현재 제한 방법으로, 다음 값 중 하나로 반환됩니다.

• 'tickaligned' — 일반적으로, 좌표축 상자의 가장자리를 데이터에 가장 가까운 눈금에 맞춰 정렬합니다. 이때 어떠한 데이터도 제외하지 않습니다. 모양은 플로팅하는 데이터의 유형과 생성하는 차트의 유형에 따라 달라질 수 있습니다.

• 'tight' — 축 제한을 데이터 범위로 설정하여 좌표축 상자를 데이터 둘레에 꼭 맞게 맞춥니다.

• 'padded' — 사방을 가느다란 여백으로 채워 좌표축 상자를 데이터 둘레에 맞게 맞춥니다. 여백의 너비는 대략 데이터 범위의 7%입니다.

z축 제한 방법을 쿼리하면 해당 Axes 객체의 ZLimitMethod 속성값이 반환됩니다.

limmode — 현재 제한 모드

'auto' | 'manual'

현재 제한 모드로, 다음 값 중 하나로 반환됩니다.

• 'auto' — 자동으로 제한이 결정됩니다.

• 'manual' — 데이터가 변경되어도 수동으로 지정한 제한은 바뀌지 않습니다.

z축 제한 모드를 쿼리하면 해당 Axes 객체의 ZLimMode 속성값이 반환됩니다.

알고리즘

zlim 함수는 z축 제한에 관련된 여러 axes 속성을 설정하고 쿼리합니다.

• ZLim — z축 제한을 저장하는 속성.

• ZLimMode — z축 제한 모드를 저장하는 속성. z축 제한을 사용자가 설정하면 이 속성이 "manual"로 변경됩니다.

• ZLimitMethod — ZLimMode 속성이 "auto"로 설정된 경우 z축 제한이 계산되는 방법을 제어하는 속성.

버전 내역

R2006a 이전에 개발됨

R2022a: 축 제한 방법 쿼리

"method" 입력 인수를 사용하여 현재 축 제한 방법을 쿼리합니다.

R2021a: 축 제한 방법 설정

limitmethod 인수를 지정하여 MATLAB이 제한을 자동으로 선택하는 데 사용하는 방법을 설정합니다. 이 인수는 값 'tickaligned', 'tight' 또는 'padded'를 가질 수 있습니다.

참고 항목

함수

• ylim | xlim | grid | zlabel | zticks | zticklabels | ztickformat

속성

• Axes 속성

도움말 항목

• 축 제한 지정하기