exponenta event banner

xlim

Установка или запрос пределов по оси X

Описание

Конкретные ограничения

пример

xlim(limits) устанавливает пределы оси X для текущих осей или диаграммы. Определить limits как двухэлементный вектор вида [xmin xmax], где xmax больше, чем xmin.

пример

xl = xlim возвращает текущие пределы в виде двухэлементного вектора.

Автоматический или ручной выбор предельных значений

пример

xlim(limitmethod) определяет метод ограничения MATLAB ®, используемый для автоматического выбора предела. Укажите метод ограничения как'tickaligned', 'tight', или 'padded'. MATLAB устанавливает XLimitMethod свойства осей для указанного значения. Метод ограничения не поддерживается для автономных визуализаций.

Можно указать limitmethod аргумент без скобок. Например, xlim tight обеспечивает плотные пределы по оси X.

пример

xlim(limitmode) определяет автоматический или ручной выбор предельных значений. limitmode может иметь любое из двух значений:

  • 'auto' - Включить автоматический выбор лимита. MATLAB выбирает пределы на основе диапазона ваших данных и значения XLimitMethod свойства осей. При многократном построении графика в осях пределы обновляются, чтобы охватить все данные.

  • 'manual' - заморозить пределы оси X при их текущем значении.

Можно указать limitmode аргумент без скобок. Например, xlim auto позволяет автоматически выбирать предельные значения.

m = xlim('mode') возвращает текущий режим пределов по оси X, который является 'auto' или 'manual'. По умолчанию режим является автоматическим, если не указаны пределы или не задан режим вручную.

Целевые оси или диаграмма

пример

___ = xlim(target,___) использует оси или автономную визуализацию, заданную target вместо текущих осей. Определить target в качестве первого входного аргумента для любого из предыдущих синтаксисов. Можно включить выходной аргумент, если исходный синтаксис поддерживает выходной аргумент. Используйте одинарные кавычки вокруг входов режима, например: xlim(target,'auto').

Примеры

свернуть все

Постройте график линии и задайте пределы оси X в диапазоне от 0 до 5.

x = linspace(0,10);
y = sin(x);
plot(x,y)
xlim([0 5])

Figure contains an axes. The axes contains an object of type line.

Создайте график поверхности и отобразите только значения x, превышающие 0. Укажите минимальный предел оси X как 0 и дайте MATLAB выбрать максимальный предел.

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

Figure contains an axes. The axes contains an object of type surface.

Создание корневой диаграммы с датами вдоль оси X. Установите пределы оси X в диапазоне от 1 июня 2014 года до 5 июня 2014 года.

t = datetime(2014,06,1) + caldays(0:10);
y = rand(11,1);
stem(t,y,'filled')

tstart = datetime(2014,06,1);
tend = datetime(2014,06,5);
xlim([tstart tend])

Figure contains an axes. The axes contains an object of type stem.

Если требуется, чтобы ось X автоматически регулировалась в соответствии с диапазоном координат X, используйте 'tight' способ ограничения.

Создание линейного графика.

plot([1 2 3 4 5 6.3],[0 0.3 0.1 0.6 0.4 1])

Figure contains an axes. The axes contains an object of type line.

Измените метод ограничения на 'tight'.

xlim tight

Figure contains an axes. The axes contains an object of type line.

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

hold on
plot([1 2 3 4 5 8.3],[0.1 0.2 0.3 0.4 0.5 0.83])
hold off

Figure contains an axes. The axes contains 2 objects of type line.

Начиная с R2019b, можно отобразить мозаику графиков с помощью tiledlayout и nexttile функции. Позвоните в tiledlayout для создания компоновки мозаичной диаграммы «2 на 1». Позвоните в nexttile для создания объектов осей ax1 и ax2. Постройте график данных в каждой оси. Затем задайте пределы оси X для нижнего графика, указав ax2 в качестве первого входного аргумента для xlim.

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

ax2 = nexttile;
plot(ax2,x,y)
xlim(ax2,[0 1])

Figure contains 2 axes. Axes 1 contains an object of type line. Axes 2 contains an object of type line.

Режим вручную используется для сохранения текущих пределов оси X при добавлении дополнительных графиков к осям.

Сначала постройте линию.

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

Figure contains an axes. The axes contains an object of type line.

Установите режим предельных значений по оси X в ручной режим, чтобы предельные значения не изменялись. Использовать hold on для добавления второго графика к осям.

xlim manual
hold on
plot(2*x,2*y)
hold off

Figure contains an axes. The axes contains 2 objects of type line.

Пределы оси X не обновляются для включения нового графика.

Вернитесь к автоматически обновляемым предельным значениям, сбросив режим на автоматический.

xlim auto

Figure contains an axes. The axes contains 2 objects of type line.

Создайте график рассеяния случайных данных. Возвращает значения пределов по оси X.

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

Figure contains an axes. The axes contains an object of type scatter.

xl = xlim
xl = 1×2

    -3     4

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

свернуть все

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

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

Пример: xlim([0 1])

Пример: xlim([-inf 1])

Пример: xlim([0 inf])

Типы данных: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64 | categorical | datetime | duration

Метод ограничения выбора, заданный как значение из таблицы.

Примеры в таблице показывают приблизительный внешний вид для каждого метода. Результаты могут отличаться в зависимости от данных, размера осей и типа создаваемого графика.

СтоимостьОписаниеПример
'tickaligned'

Как правило, выравнивайте края поля осей по делениям, ближайшим к данным, не исключая никаких данных. Внешний вид может варьироваться в зависимости от типа выводимых данных и типа создаваемой диаграммы.

Plotted sine wave with 'tickaligned' limit method.

'tight'

Поместите поле осей плотно вокруг данных, установив пределы оси для диапазона данных.

Plotted sine wave with 'tight' limit method.

'padded'

Поместите рамку осей вокруг данных с тонкой заливкой с каждой стороны. Ширина границы составляет приблизительно 7% от диапазона данных.

Plotted sine wave with 'padded' limit method.

Примечание

  • Метод ограничения не действует, если XLimMode свойство осей имеет значение 'manual'.

  • Указание метода ограничения не поддерживается для автономных визуализаций, таких как heatmap или stackedplot.

Предельный режим, заданный как одно из следующих значений:

  • 'auto' - Включить автоматический выбор лимита, который основан на общем диапазоне данных и значении XLimitMethod свойства осей. При многократном построении графика в осях пределы обновляются, чтобы охватить все данные. Эту опцию можно использовать, если вы изменяете пределы и хотите вернуть им значения по умолчанию.

  • 'manual' - зафиксировать пределы при текущих значениях. Используйте эту опцию, если требуется сохранить текущие пределы при добавлении новых данных к осям с помощью hold on команда.

При указании этого аргумента MATLAB устанавливает значение XLimMode свойства осей для указанного значения. Тем не менее, XLimMode изменение свойства в 'manual' каждый раз, когда вы явно устанавливаете пределы по оси X, либо путем вызова xlim(limits)или путем установки значения XLim свойство на осях.

Целевые оси или диаграмма, указанные как одно из следующих:

  • Объект оси.

  • Автономная визуализация, имеющая XLimits свойство, такое как heatmap диаграмма или stackedplot.

  • Массив осей или автономных визуализаций, принадлежащих одному классу. Для определения класса используйте class функция.

Если этот аргумент не указан, то xlim устанавливает пределы для графического объекта, возвращаемые gca команда.

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

свернуть все

Текущие пределы, возвращаемые как двухэлементный вектор формы [xmin xmax].

Запрос предельных значений возвращает значение XLim или XLimits значение свойства для соответствующего Axes или графический объект.

Режим текущих лимитов, возвращаемый как одно из следующих значений:

  • 'auto' - Автоматически определить пределы.

  • 'manual' - Используйте вручную указанные пределы, которые не обновляются, чтобы отразить изменения в данных.

Запрос режима предельных значений по оси X возвращает значение XLimMode значение свойства для соответствующего Axes объект.

Алгоритмы

xlim устанавливает и запрашивает несколько свойств осей, связанных с пределами оси X.

  • XLim - свойство, сохраняющее пределы по оси X.

  • XLimMode - Свойство, хранящее режим пределов по оси X. При установке пределов по оси X это свойство изменяется на 'manual'.

  • XLimitMethod - Свойство, которое управляет расчетом пределов по оси X при XLimMode свойство имеет значение 'auto'.

См. также

Функции

Свойства

Представлен до R2006a