uiaxes

앱에서 플롯을 위한 UI 좌표축 만들기

구문

ax = uiaxes

ax = uiaxes(Name,Value)

ax = uiaxes(parent)

ax = uiaxes(parent,Name,Value)

설명

ax = uiaxes는 새 Figure 창에 UI 좌표축을 만들고 UIAxes 객체를 반환합니다. MATLAB^®은 uifigure 함수를 호출하여 Figure를 만듭니다.

UIAxes 객체는 앱에서 카테시안 플롯을 만들 때 유용합니다. 이 객체는 axes 함수가 반환하는 카테시안 Axes 객체와 매우 비슷합니다. 따라서 Axes 객체를 받는 대부분의 함수에 UIAxes 객체를 전달할 수 있습니다. 자세한 내용은 UIAxes 객체와 Axes 객체의 차이점 항목을 참조하십시오.

ax = uiaxes(Name,Value)는 하나 이상의 Name,Value 쌍의 인수를 사용하여 UIAxes 속성값을 지정합니다.

ax = uiaxes(parent)는 지정된 부모 컨테이너에 UI 좌표축을 만듭니다. 부모 컨테이너는 uifigure 함수를 사용하여 만든 Figure이거나 그 자식 컨테이너 중 하나여야 합니다.

ax = uiaxes(parent,Name,Value)는 하나 이상의 Name,Value 인수를 사용하여 UIAxes 속성값을 지정합니다.

예제

UI 좌표축에 플롯 생성하기

UI 좌표축에 선 플롯과 산점도 플롯을 생성합니다.

UI 좌표축이 있는 Figure 창을 만들고 UIAxes 객체를 변수 ax에 할당합니다. UIAxes 객체를 plot 함수에 대한 첫 번째 입력 인수로 지정하여 선 플롯을 좌표축에 추가합니다.

fig = uifigure;
ax = uiaxes(fig);
x = linspace(-pi,pi,50);
y = 5*sin(x);
plot(ax,x,y)

유지 상태를 켜짐으로 설정하고 산점도 플롯을 추가합니다. UIAxes 객체를 hold 함수와 scatter 함수에 대한 첫 번째 입력 인수로 지정합니다.

hold(ax,'on')
y2 = 5*sin(x) + randn(1,50);
scatter(ax,x,y2)

UI 좌표축 속성 지정하기

이름-값 쌍 인수를 사용해 속성을 설정하여 UI 좌표축의 모양을 수정합니다. 예를 들어, XDir 이름-값 쌍을 사용하여 x축 방향을 반대로 바꿉니다.

fig = uifigure;
ax = uiaxes(fig,'XDir','reverse');
x = linspace(-pi,pi);
y = sin(x);
plot(ax,x,y)

또는 좌표축을 만든 후 점 표기법을 사용하여 속성을 지정합니다. 예를 들어, 점 표기법을 사용해 YDir 속성에 액세스하여 y축 방향을 반대로 바꿉니다.

ax.YDir = 'reverse';

UI 좌표축 위치 지정하기

Position 속성을 설정하여 UI 좌표축 위치를 지정합니다. 위치를 픽셀 단위로 지정합니다.

fig = uifigure;
ax = uiaxes(fig,'Position',[10 10 550 400]);

패널에 UI 좌표축 추가하기

Figure 창 내에 있는 패널에 UI 좌표축을 추가합니다. 패널 위치와 좌표축 위치를 픽셀 단위로 지정합니다.

fig = uifigure;
p = uipanel(fig,'Position',[10 10 400 400]);
ax = uiaxes(p,'Position',[10 10 390 390]);

입력 인수

parent — 부모 컨테이너

Figure 객체 | Panel 객체 | Tab 객체 | GridLayout 객체 | TiledChartLayout 객체

부모 컨테이너로, Figure, Panel, Tab, GridLayout 또는 TiledChartLayout 객체로 지정됩니다. 컨테이너가 지정되지 않은 경우 MATLAB은 uifigure 함수를 호출하여 부모 컨테이너 역할을 하는 새 Figure 객체를 만듭니다.

이름-값 인수

선택적 인수 쌍을 Name1=Value1,...,NameN=ValueN으로 지정합니다. 여기서 Name은 인수 이름이고 Value는 대응값입니다. 이름-값 인수는 다른 인수 뒤에 와야 하지만, 인수 쌍의 순서는 상관없습니다.

R2021a 이전 릴리스에서는 쉼표를 사용하여 각 이름과 값을 구분하고 Name을 따옴표로 묶으십시오.

예: 'Xscale','linear','YScale','log'

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

XLim, YLim, ZLim — 최소 축 제한과 최대 축 제한

[0 1] (디폴트 값) | [min max] 형식의, 요소를 2개 가진 벡터

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

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

예: ax.XLim = [0 10]

예: ax.YLim = [-inf 10]

예: ax.ZLim = [0 inf]

또는, xlim, ylim, zlim 함수를 사용하여 제한을 설정하십시오. 예제는 축 제한 지정하기 항목을 참조하십시오.

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

XScale, YScale, ZScale — 축에 있는 값에 대한 스케일

'linear' (디폴트 값) | 'log'

축 스케일로, 다음 값 중 하나로 지정됩니다.

값	설명	결과
'linear'	선형 스케일 예: ax.XScale = 'linear'
'log'	로그 스케일 예: ax.XScale = 'log' 참고 다음과 같은 경우 좌표축이 좌표를 제외할 수 있습니다. 좌표에 양수 값과 음수 값이 포함된 경우, 양의 값만 표시됩니다. 좌표가 모두 음수인 경우, 모든 값이 적절한 부호와 함께 로그 스케일에 표시됩니다. 0 값은 표시되지 않습니다.

GridLineStyle — 그리드 선의 선 스타일

'-' (디폴트 값) | '--' | ':' | '-.' | 'none'

그리드 선의 선 스타일로, 다음 표의 선 스타일 중 하나로 지정됩니다.

선 스타일	설명	결과 선
"-"	실선
"--"	파선
":"	점선
"-."	일점 쇄선
"none"	선 없음	선 없음

그리드 선을 표시하려면 grid on 명령을 사용하거나 XGrid, YGrid, 또는 ZGrid 속성을 'on'으로 설정하십시오.

예: ax.GridLineStyle = '--'

Position — 레이블과 여백을 포함한 좌표축의 크기와 위치

[10 10 400 300] (디폴트 값) | 요소를 4개 가진 벡터

레이블과 여백을 포함한 좌표축의 크기와 위치로, [left bottom width height] 형식의, 요소를 4개 가진 벡터로 지정됩니다. 이 속성은 OuterPosition 속성과 동일합니다. 벡터는 좌표축의 바깥쪽 경계를 둘러싸는 사각형을 정의합니다. 모든 값은 Units 속성으로 지정된 단위로 측정됩니다(디폴트 값: 픽셀).

• left 요소와 bottom 요소는 부모 컨테이너의 왼쪽 아래 코너에서 측정한 사각형의 위치를 정의합니다.

• width와 height는 사각형의 크기를 정의합니다.

위치를 지정할 때 좌표축 주위의 텍스트를 고려하려면 Position 또는 OuterPosition 속성을 설정하십시오. 다음 Figure는 Position 또는 OuterPosition(파란색)과 InnerPosition(빨간색)으로 정의된 영역을 표시합니다.

좌표축의 2차원 보기	좌표축의 3차원 보기

참고

부모 컨테이너가 TiledChartLayout 객체일 때는 이 속성을 설정해도 아무 효과가 없습니다.

출력 인수

ax — UIAxes 객체

UIAxes 객체

UIAxes 객체입니다. UIAxes를 생성한 후에는 ax를 사용하여 이 객체의 속성을 설정합니다.

세부 정보

UIAxes 객체와 Axes 객체의 차이점

다음 표에서는 UIAxes 객체와 Axes 객체에서 차이가 나는 속성에 대해 설명합니다. 앱에서 차트를 만드는 방법에 대한 자세한 내용은 앱 디자이너에서 그래픽스 표시하기 항목을 참조하십시오.

속성	UIAxes 객체	Axes 객체
NextPlot	디폴트 값은 'replacechildren'입니다.	디폴트 값은 'replace'입니다.
Position	디폴트 Position은 [10 10 400 300]입니다(단위: 픽셀). Position 속성은 OuterPosition 속성과 동일합니다.	디폴트 Position은 [0.1300 0.1100 0.7750 0.8150]입니다(단위: 정규화 단위). Position 속성은 InnerPosition 속성과 동일합니다.
Units	디폴트 값은 'pixels'입니다.	디폴트 값은 'normalized'입니다.
FontUnits	디폴트 값은 'pixels'입니다.	디폴트 값은 'points'입니다.

버전 내역

R2016a에 개발됨

참고 항목

함수

• uifigure

속성

• UIAxes 속성

툴

• 앱 디자이너

도움말 항목

• 앱 디자이너에서 그래픽스 표시하기