uiaxes

Создайте оси пользовательского интерфейса для графиков в приложениях

Описание

пример

ax = uiaxes создает пользовательский интерфейс оси в новом окне рисунка и возвращает UIAxes объект. MATLAB® вызывает uifigure функция, чтобы создать фигуру.

UIAxes объекты полезны для создания Декартовых графиков в приложениях. Они очень похожи на Декартов Axes объекты, возвращенные axes функция. Таким образом можно передать UIAxes возразите против большинства функций, которые принимают Axes объект. Для получения дополнительной информации смотрите Различия Между UIAxes и Объектами осей.

пример

ax = uiaxes(Name,Value) задает UIAxes значения свойств с помощью одного или нескольких Name,Value парные аргументы.

пример

ax = uiaxes(parent) создает оси пользовательского интерфейса в заданном родительском контейнере. Родительским элементом может быть Figure созданное использование uifigure функция или один из ее дочерних контейнеров.

ax = uiaxes(parent,Name,Value) задает UIAxes значения свойств с помощью одного или нескольких Name,Value аргументы.

Примеры

свернуть все

Постройте график и график рассеивания в осях пользовательского интерфейса.

Создайте окно рисунка с осями пользовательского интерфейса и присвойте 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)

Измените внешний вид осей пользовательского интерфейса путем установки аргументов пары "имя-значение" использования свойств. Например, инвертируйте направление оси X с помощью XDir пара "имя-значение".

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

В качестве альтернативы задайте свойства после того, как оси будут созданы с помощью записи через точку. Например, инвертируйте направление оси Y с помощью записи через точку, чтобы получить доступ к YDir свойство.

ax.YDir = 'reverse';

Задайте положение осей пользовательского интерфейса путем установки Position свойство. Задайте положение в пикселях.

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

Добавьте оси пользовательского интерфейса в панель в рамках окна рисунка. Задайте панель и положения осей в пикселях.

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

Входные параметры

свернуть все

Родительский контейнер в виде FigureПанель, Tab, GridLayout, или TiledChartLayout объект. Если никакой контейнер не задан, MATLAB вызывает uifigure функция, чтобы создать новый Figure объект, который служит родительским контейнером.

Аргументы name-value

Задайте дополнительные разделенные запятой пары Name,Value аргументы. Name имя аргумента и Value соответствующее значение. Name должен появиться в кавычках. Вы можете задать несколько аргументов в виде пар имен и значений в любом порядке, например: Name1, Value1, ..., NameN, ValueN.

Пример: 'Xscale','linear','YScale','log'

Список свойств здесь является только подмножеством. Для полного списка смотрите UIAxes Properties.

Минимум и максимум ограничивают в виде двухэлементного вектора из формы [min max], где max больше min. Можно задать пределы как числовые, категориальные, datetime или значения длительности. Однако тип значений, которые вы задаете, должен совпадать с типом значений вдоль оси.

Можно задать оба предела, или задать один предел и позволить 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'

Примечание

Оси могут исключить координаты в некоторых случаях:

  • Если координаты включают положительные и отрицательные величины, только положительные значения отображены.

  • Если координаты являются всем отрицанием, все значения отображены на логарифмической шкале с соответствующим знаком.

  • Нулевые значения не отображены.

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]. Это свойство эквивалентно OuterPosition свойство. Вектор задает прямоугольник, который заключает внешние границы осей. Значения измеряются в модулях, заданных Units свойство, который значения по умолчанию к пикселям.

  • left и bottom элементы задают положение прямоугольника, измеренного от левого нижнего угла родительского контейнера.

  • width и height задайте размер прямоугольника.

Если вы хотите задать положение и составлять текст вокруг осей, то установленный любой Position или OuterPosition свойство. Эти рисунки показывают области, заданные Position (или OuterPosition) в синем и InnerPosition в красном.

2D представление осей3-D представление осей

Примечание

Установка этого свойства не оказывает влияния, когда родительским контейнером является TiledChartLayout.

Выходные аргументы

свернуть все

UIAxes объект. Используйте ax установить свойства UIAxes после того, как они создаются.

Больше о

свернуть все

Различия между UIAxes и Axes Объекты

Эта таблица описывает свойства, которые отличаются для UIAxes и Axes объекты. Для получения дополнительной информации о создавании графиков в приложениях смотрите Графику Отображения в App Designer.

Свойство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