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 object. The axes object 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 object. The axes object 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 object. The axes object 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 object. The axes object contains an object of type line.

Измените предельный метод в 'tight'.

xlim tight

Figure contains an axes object. The axes object 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 object. The axes object 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 objects. Axes object 1 contains an object of type line. Axes object 2 contains an object of type line.

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

Во-первых, постройте график.

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

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

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

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

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

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

Переключитесь назад на автоматически обновленные пределы путем сброса режима к автоматическому.

xlim auto

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

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

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

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

xl = xlim
xl = 1×2

    -3     4

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

свернуть все

Минимум и максимум ограничивают в виде двухэлементного вектора из формы [xmin xmax], где xmax больше xmin. Можно задать пределы как числовые, категориальные, datetime или значения длительности. Однако тип значений, которые вы задаете, должен совпадать с типом значений вдоль 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

Ограничьте метод выбора в виде значения из таблицы.

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

ЗначениеОписаниеПример
'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 свойство, такое как a heatmap стройте диаграмму или a 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