exponenta event banner

zlabel

Описание

пример

zlabel(txt) помечает текст по оси Z текущих осей, txt. Переиздание zlabel приводит к замене новой метки старой.

пример

zlabel(txt,Name,Value) дополнительно задает свойства текстового объекта с помощью одного или нескольких Name,Value аргументы пары.

zlabel(ax,___) добавляет метку к осям, указанным ax. Этот синтаксис позволяет указать оси для добавления метки. ax может предшествовать любой из комбинаций входных аргументов в предыдущих синтаксисах.

h = zlabel(___) возвращает маркер к текстовому объекту, используемому в качестве метки оси Z. Дескриптор полезен при внесении будущих изменений в метку.

Примеры

свернуть все

surf(peaks)
zlabel('Height')

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

figure
surf(peaks)
zlabel(123)

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

Дисплеи MATLAB ®123 рядом с осью Z.

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

figure
surf(peaks)
zlabel({'First Line';'Second Line'})

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

Использовать Name,Value пары для задания размера шрифта, веса шрифта и цвета текста метки оси Z.

figure
surf(peaks)
zlabel('Elevation','FontSize',12,...
       'FontWeight','bold','Color','r')

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

'FontSize',12 отображает текст метки 12-точечным шрифтом. 'FontWeight','bold' делает текст полужирным. 'Color','r' устанавливает красный цвет текста.

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

tiledlayout(2,1)
ax1 = nexttile;
surf(ax1,peaks(30))

ax2 = nexttile;
surf(ax2,peaks(45))
zlabel(ax2,'Height')

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

Пометьте ось Z и верните текстовый объект, используемый в качестве метки.

surf(peaks)
t = zlabel('Population Change');

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

Установите красный цвет метки. Для задания свойств используйте точечную нотацию.

t.Color = 'red';

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

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

свернуть все

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

Пример: 'my label'

Пример: {'first line','second line'}

Пример: 123

Чтобы включить числовые переменные с текстом в метку, используйте num2str функция. Например:

x = 42;
txt = ['The value is ',num2str(x)];

Чтобы включить специальные символы, такие как надстрочные, подстрочные, греческие буквы или математические символы, используйте разметку TeX. Список поддерживаемых пометок см. в разделе Interpreter собственность.

Для создания многострочных меток:

  • Используйте строковый массив, где каждый элемент содержит строку текста, например ["first line","second line"].

  • Используйте массив ячеек, где каждая ячейка содержит строку текста, например {'first line','second line'}.

  • Используйте символьный массив, где каждая строка содержит одинаковое количество символов, например ['abc'; 'ab '].

  • Использовать sprintf для создания текста с новым символом строки, например, sprintf('first line \n second line').

Числовые метки преобразуются в текст с помощью sprintf('%g',value). Например, 12345678 отображается как 1.23457e+07.

Примечание

  • Если метка указана как категориальный массив, MATLAB ® использует значения в массиве, а не категории.

  • Слова default, factory, и remove - зарезервированные слова, которые не будут отображаться в метке в виде обычных символов. Чтобы отобразить любое из этих слов по отдельности, перед ними используйте обратную косую черту, например '\default' или '\remove'.

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

Если этот аргумент не указан, то zlabel изменяет текущие оси.

Аргументы пары «имя-значение»

Укажите дополнительные пары, разделенные запятыми Name,Value аргументы. Name является именем аргумента и Value - соответствующее значение. Name должен отображаться внутри кавычек. Можно указать несколько аргументов пары имен и значений в любом порядке как Name1,Value1,...,NameN,ValueN.

Пример: 'Color','red','FontSize',12 указывает красный, 12-точечный шрифт.

В дополнение к следующему, можно указать другие свойства текстового объекта с помощью Name,Value аргументы пары. См. раздел Свойства текста.

Размер шрифта, указанный как скалярное значение больше 0 в точечных единицах. Одна точка равна 1/72 дюйма. Для изменения единиц шрифта используйте FontUnits собственность.

Настройка свойств размера шрифта для связанных осей также влияет на размер шрифта метки. Размер шрифта метки изменяется таким образом, чтобы он равнялся размеру шрифта осей, умноженному на масштабный коэффициент метки. FontSize свойство осей содержит размер шрифта осей. LabelFontSizeMultiplier свойство осей содержит масштабный коэффициент метки. По умолчанию размер шрифта осей равен 10 пунктам, а масштабный коэффициент - 1,1, поэтому размер шрифта метки оси Z равен 11 пунктам.

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

Толщина символа, указанная как 'normal' или 'bold'.

MATLAB использует FontWeight для выбора шрифта из доступных в системе. Не все шрифты имеют жирный вес. Поэтому задание полужирного веса шрифта может привести к нормальному весу шрифта.

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

Чтобы использовать шрифт фиксированной ширины, который хорошо выглядит в любом языковом стандарте, используйте 'FixedWidth'. Шрифт фиксированной ширины зависит от корня FixedWidthFontName собственность. Установка корня FixedWidthFontName приводит к немедленному обновлению отображения для использования нового шрифта.

Цвет текста, указанный как триплет RGB, шестнадцатеричный код цвета, имя цвета или короткое имя.

Для пользовательского цвета укажите триплет RGB или шестнадцатеричный цветовой код.

  • Триплет RGB - это трехэлементный вектор строки, элементы которого задают интенсивности красной, зеленой и синей составляющих цвета. Интенсивности должны находиться в диапазоне [0,1]; например, [0.4 0.6 0.7].

  • Шестнадцатеричный цветовой код - это символьный вектор или строковый скаляр, начинающийся с хэш-символа (#), за которыми следуют три или шесть шестнадцатеричных цифр, которые могут варьироваться от 0 кому F. Значения не чувствительны к регистру. Таким образом, цветовые коды '#FF8800', '#ff8800', '#F80', и '#f80' эквивалентны.

Можно также задать некоторые общие цвета по имени. В этой таблице перечислены параметры именованного цвета, эквивалентные триплеты RGB и шестнадцатеричные цветовые коды.

Имя цветаКраткое имяТриплет RGBШестнадцатеричный цветовой кодВнешность
'red''r'[1 0 0]'#FF0000'

'green''g'[0 1 0]'#00FF00'

'blue''b'[0 0 1]'#0000FF'

'cyan' 'c'[0 1 1]'#00FFFF'

'magenta''m'[1 0 1]'#FF00FF'

'yellow''y'[1 1 0]'#FFFF00'

'black''k'[0 0 0]'#000000'

'white''w'[1 1 1]'#FFFFFF'

'none'НеприменимоНеприменимоНеприменимоБез цвета

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

Триплет RGBШестнадцатеричный цветовой кодВнешность
[0 0.4470 0.7410]'#0072BD'

[0.8500 0.3250 0.0980]'#D95319'

[0.9290 0.6940 0.1250]'#EDB120'

[0.4940 0.1840 0.5560]'#7E2F8E'

[0.4660 0.6740 0.1880]'#77AC30'

[0.3010 0.7450 0.9330]'#4DBEEE'

[0.6350 0.0780 0.1840]'#A2142F'

Пример: 'blue'

Пример: [0 0 1]

Пример: '#0000FF'

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

  • 'tex' - интерпретировать символы с помощью подмножества разметки TeX.

  • 'latex' - Интерпретировать символы с помощью разметки LaTeX.

  • 'none' - Отображение буквенных символов.

Разметка TeX

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

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

МодификаторОписаниеПример
^{ }Верхний индекс'text^{superscript}'
_{ }Нижний индекс'text_{subscript}'
\bfПолужирный шрифт'\bf text'
\itКурсивный шрифт'\it text'
\slКосой шрифт (обычно такой же, как курсив)'\sl text'
\rmОбычный шрифт'\rm text'
\fontname{specifier}Имя шрифта - Заменить specifier с именем семейства шрифтов. Это можно использовать в сочетании с другими модификаторами.'\fontname{Courier} text'
\fontsize{specifier}Размер шрифта - Заменитьspecifier с числовым скалярным значением в единицах измерения точки.'\fontsize{15} text'
\color{specifier}Цвет шрифта - Заменить specifier с одним из следующих цветов: red, green, yellow, magenta, blue, black, white, gray, darkGreen, orange, или lightBlue.'\color{magenta} text'
\color[rgb]{specifier}Цвет пользовательского шрифта - Заменить specifier с трехэлементным триплетом RGB.'\color[rgb]{0,0.5,0.5} text'

В этой таблице перечислены поддерживаемые специальные символы для 'tex' переводчик.

Последовательность символовСимволПоследовательность символовСимволПоследовательность символовСимвол

\alpha

α

\upsilon

υ

\sim

~

\angle

\phi

\leq

\ast

*

\chi

χ

\infty

\beta

β

\psi

ψ

\clubsuit

\gamma

γ

\omega

ω

\diamondsuit

\delta

δ

\Gamma

Γ

\heartsuit

\epsilon

ϵ

\Delta

Δ

\spadesuit

\zeta

ζ

\Theta

Θ

\leftrightarrow

\eta

η

\Lambda

Λ

\leftarrow

\theta

θ

\Xi

Ξ

\Leftarrow

\vartheta

ϑ

\Pi

Π

\uparrow

\iota

ι

\Sigma

Σ

\rightarrow

\kappa

κ

\Upsilon

ϒ

\Rightarrow

\lambda

λ

\Phi

Φ

\downarrow

\mu

µ

\Psi

Ψ

\circ

º

\nu

ν

\Omega

Ω

\pm

±

\xi

ξ

\forall

\geq

\pi

π

\exists

\propto

\rho

ρ

\ni

\partial

\sigma

σ

\cong

\bullet

\varsigma

ς

\approx

\div

÷

\tau

τ

\Re

\neq

\equiv

\oplus

\aleph

\Im

\cup

\wp

\otimes

\subseteq

\oslash

\cap

\in

\supseteq

\supset

\lceil

\subset

\int

\cdot

·

\o

ο

\rfloor

\neg

¬

\nabla

\lfloor

\times

x

\ldots

...

\perp

\surd

\prime

´

\wedge

\varpi

ϖ

\0

\rceil

\rangle

\mid

|

\vee

\langle

\copyright

©

Разметка LaTeX

Чтобы использовать разметку LaTeX, установите для интерпретатора значение 'latex'. Для встроенного режима окружить разметку однодолларовыми знаками ($). Для режима отображения обведите разметку двойными знаками доллара ($$).

Режим LaTeXПримерРезультат
Действующий

'$\int_1^{20} x^2 dx$'

Equation with LaTeX inline mode.

Показ

'$$\int_1^{20} x^2 dx$$'

Equation with LaTeX display mode.

В отображаемом тексте используется стиль шрифта LaTeX по умолчанию. FontName, FontWeight, и FontAngle свойства не имеют эффекта. Чтобы изменить стиль шрифта, используйте разметку LaTeX.

Максимальный размер текста, который можно использовать с интерпретатором LaTeX, составляет 1200 символов. Для многострочного текста это уменьшает приблизительно на 10 символов на строку.

Примеры использования TeX и LaTeX см. в разделе Греческие буквы и специальные символы в тексте диаграммы. Дополнительные сведения о системе LaTeX см. на веб-сайте проекта LaTeX по адресу https://www.latex-project.org/.

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

свернуть все

Текстовый объект, используемый в качестве метки оси Z. Использовать h для доступа и изменения свойств метки после ее создания.

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