ylim

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

Описание

Определенные пределы

пример

ylim(limits) устанавливает пределы оси Y для текущей системы координат или графика. Задайте limits как двухэлементный вектор из формы [ymin ymax], где ymax больше ymin.

пример

yl = ylim возвращает текущие пределы как двухэлементный вектор.

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

пример

ylim(limitmethod) задает предельный метод MATLAB® использование для автоматического предельного выбора. Задайте предельный метод как 'tickaligned', 'tight', или 'padded'. MATLAB устанавливает YLimitMethod свойство осей к значению вы задаете. Предельный метод не поддерживается для автономной визуализации.

Можно задать limitmethod аргумент без круглых скобок. Например, ylim tight включает трудный y - пределы по осям.

пример

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

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

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

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

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

Целевые оси или график

пример

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

Примеры

свернуть все

Постройте график и установите пределы оси Y, чтобы лежать в диапазоне от-2 до 2.

x = linspace(0,10);
y = sin(x);
plot(x,y)
ylim([-2 2])

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

Создайте объемную поверхностную диаграмму и покажите только y значения, больше, чем 0. Задайте минимальный предел оси Y как 0 и позвольте MATLAB выбрать максимальный предел.

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

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

Создайте горизонтальную диаграмму с датами вдоль оси Y. Установите пределы оси Y, чтобы расположиться с 1 июня 2014 до 10 июня 2014.

t = datetime(2014,06,1) + caldays(0:20);
y = rand(21,1);
barh(t,y)

tstart = datetime(2014,06,1);
tend = datetime(2014,06,10);
ylim([tstart tend])

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

Постройте график.

x = 1:5; 
y = [-2.7 2 -1 4.2 0];
plot(x,y)

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

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

ylim tight

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

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

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

ax2 = nexttile;
plot(ax2,x,y)
ylim(ax2,[-10 10])

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

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

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

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

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

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

ylim manual
hold on
y2 = 2*sin(x);
plot(x,y2)
hold off

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

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

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

ylim auto

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

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

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.

yl =  ylim
yl = 1×2

    -2     3

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

свернуть все

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

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

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

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

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

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

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

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

ЗначениеОписаниеПример
'tickaligned'

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

Line plot with 'tickaligned' limit method.

'tight'

Соответствуйте полю осей плотно вокруг данных путем установки пределов по осям области значений данных.

Line plot with 'tight' limit method.

'padded'

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

Line plot with 'padded' limit method.

Примечание

  • Предельный метод не оказывает влияния когда YLimMode свойство осей установлено в 'manual'.

  • Определение предельного метода не поддерживается для автономной визуализации такой как heatmap.

Ограничьте режим в виде одного из следующих значений:

  • 'auto' — Включите автоматический предельный выбор, который основан на общем промежутке данных и значении YLimitMethod свойство осей. Если вы строите в оси многократно, пределы обновляются, чтобы охватить все данные. Можно использовать эту опцию, если вы изменяете пределы и хотите задержать их к значениям по умолчанию.

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

Когда вы задаете этот аргумент, MATLAB устанавливает YLimMode свойство осей к значению вы задаете. Однако YLimMode свойство превращается в 'manual' каждый раз, когда вы устанавливаете y - пределы по осям явным образом, любой путем вызова ylim(limits), или путем устанавливания значения YLim свойство на осях.

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

  • Axes объект.

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

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

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

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

свернуть все

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

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

Текущий предельный режим, возвращенный как одно из этих значений:

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

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

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

Алгоритмы

ylim функционируйте наборы и запросы несколько свойств осей, связанных с пределами оси Y.

  • YLim — Свойство, которое хранит пределы оси Y.

  • YLimMode — Свойство, которое хранит ось Y, ограничивает режим. Когда вы устанавливаете пределы оси Y, это свойство превращается в 'manual'.

  • YLimitMethod — Свойство, которое управляет, как пределы оси Y вычисляются когда YLimMode свойство установлено в 'auto'.

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