주요 콘텐츠

uiaxes

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

설명

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

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

App window containing a line plot of a sine wave in a UIAxes object

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

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

App window containing a line plot of a sine wave and scatter plot in the same UIAxes object

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

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

App window containing a line plot of a sine wave in a UIAxes object. The x-axis tick labels increase from right to left.

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

ax.YDir = 'reverse';

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

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

App window containing a UIAxes object that fills the entire window

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

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

App window containing a panel. The panel contains a UIAxes object.

입력 인수

모두 축소

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

이름-값 인수

모두 축소

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

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

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

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

최소 제한과 최대 제한으로, [min max] 형식의, 요소를 2개 가진 벡터로 지정됩니다. 여기서 maxmin보다 큽니다. 제한은 숫자형 값, 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

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

설명결과
'linear'

선형 스케일

예: ax.XScale = 'linear'

Axis with the scale set to 'linear'. The tick values that start at 0 and increment by adding 100 to the previous value.
'log'

로그 스케일

예: ax.XScale = 'log'

참고

다음과 같은 경우 좌표축이 좌표를 제외할 수 있습니다.

  • 좌표에 양수 값과 음수 값이 포함된 경우, 양의 값만 표시됩니다.

  • 좌표가 모두 음수인 경우, 모든 값이 적절한 부호와 함께 로그 스케일에 표시됩니다.

  • 0 값은 표시되지 않습니다.

Axis with the scale set to 'log'. The tick values start at 0.10 (10 raised to -1). Each major tick value increases by a factor of 10.

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

선 스타일설명결과 선
"-"실선

Sample of solid line

"--"파선

Sample of dashed line

":"점선

Sample of dotted line

"-."일점 쇄선

Sample of dash-dotted line, with alternating dashes and dots

"none"선 없음선 없음

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

예: ax.GridLineStyle = '--'

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

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

  • widthheight는 사각형의 크기를 정의합니다.

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

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

2-D axes with a title and axis labels. The inner position is outlined in red. It encloses the plot box only. The title, axis labels, and tick labels lie outside this rectangle. The outer position is outlined in blue. It encloses the plot box, the title, and the axis labels.

3-D axes with a title and axis labels. The inner position is outlined in red. It encloses the plot box. The title and axis labels lie outside this rectangle. Depending on the orientation of the plot box, some of the tick labels might lie inside or outside of this rectangle. The outer position is outlined in blue. It encloses the plot box, the title, and all of the axis labels.

참고

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

출력 인수

모두 축소

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

세부 정보

모두 축소

버전 내역

R2016a에 개발됨