xlim

Установите или запросите x предельные пределы по осям

Описание

Конкретные пределы

пример

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

пример

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

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

пример

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

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

пример

xlim(limitmode) определяет автоматический или ручной выбор предела. The 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 или значения длительности. Однако тип значений, которые вы задаете, должен совпадать с типом значений вдоль оси x.

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

Пример: 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 свойство на осях.

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

  • A объекта осей.

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

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

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

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

свернуть все

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

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

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

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

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

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

Алгоритмы

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

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

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

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

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