ylim

y축 제한 설정 또는 쿼리

구문

ylim(limits)

ylim(limitmethod)

ylim(limitmode)

yl = ylim

limmethod = ylim("method")

limmode = ylim("mode")

___ = ylim(target,___)

설명

제한 지정하기

ylim(limits)는 현재 좌표축 또는 차트의 y축 제한을 설정합니다. limits를 [ymin ymax] 형식의 요소를 2개 가진 벡터로 지정합니다. 여기서 ymax는 ymin보다 큽니다.

ylim(limitmethod)는 MATLAB^®이 제한을 자동으로 선택하는 데 사용하는 방법을 지정합니다. 제한 방법을 "tickaligned", "tight" 또는 "padded"로 지정합니다. MATLAB은 지정한 값으로 좌표축의 YLimitMethod 속성을 설정합니다. 독립형 시각화에서는 제한 방법이 지원되지 않습니다.

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

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

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

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

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

제한 쿼리하기

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

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

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

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

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

예제

y축 제한 설정하기

선을 플로팅하고 y축 제한의 범위를 -2 ~ 2로 설정합니다.

x = linspace(0,10);
y = sin(x);
plot(x,y)
ylim([-2 2])

반자동 y축 제한 사용하기

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

[X,Y,Z] = peaks;
surf(X,Y,Z)
ylim([0 inf])

날짜로 y축 제한 설정하기

y축을 따라 날짜로 가로 막대 차트를 만듭니다. y축 제한의 범위를 2014년 6월 1일 ~ 2014년 6월 10일로 설정합니다.

t = datetime(2014,06,1) + caldays(0:20);
y = rand(21,1);
barh(t,y)

tstart = datetime(2014,06,1);
tend = datetime(2014,06,10);
ylim([tstart tend])

꼭 맞는 y축 제한 지정하기

선 플롯을 생성합니다.

x = 1:5; 
y = [-2.7 2 -1 4.2 0];
plot(x,y)

제한 방법을 'tight'로 변경합니다.

ylim tight

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

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

tiledlayout(2,1)
x = linspace(0,10,1000);
y = sin(10*x).*exp(.5*x);
ax1 = nexttile;
plot(ax1,x,y)

ax2 = nexttile;
plot(ax2,x,y)
ylim(ax2,[-10 10])

현재 y축 제한 유지하기

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

먼저, 선을 플로팅합니다.

x = linspace(0,10);
y = sin(x);
plot(x,y)

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

ylim manual
hold on
y2 = 2*sin(x);
plot(x,y2)
hold off

y축 제한이 새 플롯에 맞춰 업데이트되지 않습니다.

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

ylim auto

y축 제한 반환하기

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

x = randn(50,1);
y = randn(50,1);
scatter(x,y)

yl =  ylim

yl = 1×2

    -2     3

입력 인수

limits — 최소 제한 및 최대 제한

요소를 2개 가진 벡터

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

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

예: ylim([0 1])

예: ylim([-inf 1])

예: ylim([0 inf])

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

limitmethod — 제한 선택 방법

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

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

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

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

참고

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

• heatmap과 같은 독립형 시각화에서는 제한 방법을 지정하는 것이 지원되지 않습니다.

limitmode — 제한 모드

"auto" | "manual"

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

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

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

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

target — 대상 좌표축 또는 차트

axes 객체 | 독립형 시각화 | 좌표축 또는 독립형 시각화로 구성된 배열

대상 좌표축 또는 차트로, 다음 중 하나로 지정됩니다.

• Axes 객체.

• heatmap 차트와 같은 YLimits 속성이 있는 독립형 시각화.

• 동일한 클래스에 속하는 좌표축 또는 독립형 시각화로 구성된 배열. 클래스를 확인하려면 class 함수를 사용하십시오.

이 인수를 지정하지 않는 경우 ylim은 gca 명령이 반환한 그래픽스 객체에 대해 제한을 설정합니다.

출력 인수

yl — 현재 제한

요소를 2개 가진 벡터

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

제한을 쿼리하면 해당 Axes 객체 또는 그래픽스 객체의 YLim 또는 YLimits 속성값이 반환됩니다.

limmethod — 현재 제한 방법

'tickaligned' | 'tight' | 'padded'

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

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

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

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

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

limmode — 현재 제한 모드

'auto' | 'manual'

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

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

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

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

알고리즘

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

• YLim — y축 제한을 저장하는 속성.

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

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

버전 내역

R2006a 이전에 개발됨

R2022a: 축 제한 방법 쿼리

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

R2021a: 축 제한 방법 설정

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

참고 항목

함수

• xlim | zlim | grid | ylabel | yticks | yticklabels | ytickformat

속성

• Axes 속성

도움말 항목

• 축 제한 지정하기