ylim

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

Описание

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

пример

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

пример

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

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

пример

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

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

пример

ylim(limitmode) определяет автоматический или ручной выбор предела. The 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. The axes 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. The axes 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. The axes contains an object of type bar.

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

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

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

Измените метод предела на 'tight'.

ylim tight

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

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

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

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

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

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

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

ylim auto

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

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

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

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

yl =  ylim
yl = 1×2

    -2     3

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

свернуть все

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

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

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

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

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

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

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

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

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

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

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

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

свернуть все

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

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

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

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

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

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

Алгоритмы

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

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

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

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

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