uiaxes

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

Описание

пример

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, Panel, Tab, GridLayout, или TiledChartLayout объект. Если контейнер не задан, MATLAB вызывает uifigure функция для создания нового Figure объект, который служит родительским контейнером.

Аргументы в виде пар имя-значение

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

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

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

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

Можно задать оба предела или один предел, и позволить MATLAB автоматически вычислить другой. Для автоматического опредления пределов используйте -inf или inf, соответственно. MATLAB использует 'tight' метод limit для вычисления соответствующего предела.

Пример: 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'

'log'

Шкала журнала

Пример: ax.XScale = 'log'

Примечание

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

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

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

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

Стиль линии для линий сетки, заданный как один из стилей линии в этой таблице.

Стиль линииОписаниеРезультирующая линия
'-'Сплошная линия

'--'Штриховая линия

':'Пунктирная линия

'-.'Штрих-пунктирная линия

'none'Нет линииНет линии

Для отображения линий сетки используйте grid on команда или установите XGrid, YGrid, или ZGrid свойство к 'on'.

Пример: ax.GridLineStyle = '--'

Размер и расположение осей, включая метки и поля, заданные как четырехэлементный вектор формы [left bottom width height]. Это свойство эквивалентно OuterPosition свойство. Вектор задает прямоугольник, который окружает внешние границы осей. Значения измеряются в модулях, заданных Units свойство, которое по умолчанию равняется пикселям.

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

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

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

2-D вид осей3-D вид осей

Примечание

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

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

свернуть все

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

Подробнее о

свернуть все

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

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

СвойствоUIAxes ОбъектыAxes Объекты
NextPlot

Значение по умолчанию 'replacechildren'.

Значение по умолчанию 'replace'.

Position

Значение по умолчанию Position является [10 10 400 300] в пикселях.

The Position свойство эквивалентно OuterPosition свойство.

Значение по умолчанию Position является [0.1300 0.1100 0.7750 0.8150] в нормированных модулях.

The Position свойство эквивалентно InnerPosition свойство.

Units

Значение по умолчанию 'pixels'.

Значение по умолчанию 'normalized'.

FontUnits

Значение по умолчанию 'pixels'.

Значение по умолчанию 'points'.

Введенный в R2016a