zlim

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

Описание

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

пример

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

пример

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

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

пример

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

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

пример

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

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

Пример: 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 объект.

Алгоритмы

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

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

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

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

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