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.

Создайте объемную поверхностную диаграмму mesh и покажите только 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 или значения длительности. Однако тип значений, которые вы задаете, должен совпадать с типом значений вдоль 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

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

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

ЗначениеОписаниеПример
'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