exponenta event banner

zlim

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

Описание

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

пример

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

пример

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

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

пример

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

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

пример

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

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

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

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

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

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

пример

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

Примеры

свернуть все

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

[X,Y,Z] = peaks;
surf(X,Y,Z);
zlim([-5 5])

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

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

[X,Y,Z] = peaks;
mesh(X,Y,Z)
zlim([0 inf])

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

Создание графика поверхности peaks набор данных. Настройте вид окна печати таким образом, чтобы можно было видеть поверхность сбоку.

surf(peaks)
view([-45 15])

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

Отрегулируйте пределы оси Z так, чтобы было меньше места над и под поверхностью. Измените метод ограничения на 'tight'.

zlim tight

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

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

[X,Y,Z] = peaks;
tiledlayout(2,1)
ax1 = nexttile;
surf(X,Y,Z)

ax2 = nexttile;
surf(X,Y,Z)
zlim(ax2,[-5 5])

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

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

Сначала создайте график рассеяния 3-D.

theta = linspace(0,2*pi);
X = cos(theta);
Y = sin(theta);
Z = theta;
scatter3(X,Y,Z)

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

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

zlim manual
hold on 
Znew = 5*theta;
scatter3(X,Y,Znew)
hold off

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

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

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

zlim auto

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

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

x = randn(50,1);
y = randn(50,1);
z = randn(50,1);
scatter3(x,y,z)

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

zl = zlim
zl = 1×2

    -3     3

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

свернуть все

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

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

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

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

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

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

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

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

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

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

Plotted surface with 'tickaligned' limit method.

'tight'

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

Plotted surface with 'tight' limit method.

'padded'

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

Plotted surface with 'padded' limit method.

Примечание

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

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

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

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

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

Целевые оси, указанные как Axes объект или массив Axes объекты.

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

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

свернуть все

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

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

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

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

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

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

Алгоритмы

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

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

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

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

См. также

Функции

Свойства

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