zlabel

Пометьте z-ось

Свернуть все на странице

Синтаксис

zlabel(txt)

zlabel(txt,Name,Value)

zlabel(ax,___)

h = zlabel(___)

Описание

пример

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

пример

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

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

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

Примеры

свернуть все

Пометьте z-ось

Открыть Live Script

surf(peaks)
zlabel('Height')

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

Пометьте z-ось числовым входом

Открыть Live Script

figure
surf(peaks)
zlabel(123)

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

MATLAB ® отображает 123 рядом с осью Z.

Создайте многострочную метку Z-оси

Открыть Live Script

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

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

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

Пометьте Z-ось и установите свойства шрифта

Открыть Live Script

Использование 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' устанавливает красный цвет текста.

Пометьте z-ось определенных осей

Открыть Live Script

Начиная с 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 и возврат Указателя на объект

Открыть Live Script

Пометьте ось 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.

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

свернуть все

`txt` - Подпись по осям
строковый скаляр | вектор символов | строковые массивы | символьный массив | массив ячеек | категориальный массив | числовое значение

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

Пример: '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'.

`ax` - Целевые оси
`Axes` объект | массив `Axes` объекты

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

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

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

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

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

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

`'FontSize'` - Размер шрифта
`11` (по умолчанию) | скалярное значение, больше `0`

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

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

`'FontWeight'` - Толщина символов
`'normal'` (по умолчанию) | `'bold'`

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

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

`'FontName'` - Название шрифта
поддерживаемое название шрифта | `'FixedWidth'`

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

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

`'Color'` - Цвет текста
`[0.15 0.15 0.15]` (по умолчанию) | триплет RGB | шестнадцатеричный цветовой код | `'r'` | `'g'` | `'b'` | ...

Цвет текста, заданный как триплет 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'

`'Interpreter'` - Текстовый интерпретатор
`'tex'` (по умолчанию) | `'latex'` | `'none'`

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

'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'`
`\ цвет {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$'
Отображение	'$$\int_1^{20} x^2 dx$$'

Режим LaTeX

Пример

Результат

Действующий

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

Equation with LaTeX inline mode.

Отображение

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

Equation with LaTeX display mode.

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

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

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

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

свернуть все

`h` - Текстовый объект
текстовый объект

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

См. также

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

Документация

zlabel

Синтаксис

Описание

Примеры

Пометьте z-ось

Пометьте z-ось числовым входом

Создайте многострочную метку Z-оси

Пометьте Z-ось и установите свойства шрифта

Пометьте z-ось определенных осей

Метка ось Z и возврат Указателя на объект

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

`txt` - Подпись по осям
строковый скаляр | вектор символов | строковые массивы | символьный массив | массив ячеек | категориальный массив | числовое значение

`ax` - Целевые оси
`Axes` объект | массив `Axes` объекты

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

`'FontSize'` - Размер шрифта
`11` (по умолчанию) | скалярное значение, больше `0`

`'FontWeight'` - Толщина символов
`'normal'` (по умолчанию) | `'bold'`

`'FontName'` - Название шрифта
поддерживаемое название шрифта | `'FixedWidth'`

`'Color'` - Цвет текста
`[0.15 0.15 0.15]` (по умолчанию) | триплет RGB | шестнадцатеричный цветовой код | `'r'` | `'g'` | `'b'` | ...

`'Interpreter'` - Текстовый интерпретатор
`'tex'` (по умолчанию) | `'latex'` | `'none'`

Синтаксис TeX

Разметка LaTeX

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

`h` - Текстовый объект
текстовый объект

См. также

Функции

Свойства

Темы

Документация MATLAB

Поддержка

Документация

zlabel

Синтаксис

Описание

Примеры

Пометьте z-ось

Пометьте z-ось числовым входом

Создайте многострочную метку Z-оси

Пометьте Z-ось и установите свойства шрифта

Пометьте z-ось определенных осей

Метка ось Z и возврат Указателя на объект

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

txt - Подпись по осям строковый скаляр | вектор символов | строковые массивы | символьный массив | массив ячеек | категориальный массив | числовое значение

ax - Целевые оси Axes объект | массив Axes объекты

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

'FontSize' - Размер шрифта 11 (по умолчанию) | скалярное значение, больше 0

'FontWeight' - Толщина символов 'normal' (по умолчанию) | 'bold'

'FontName' - Название шрифта поддерживаемое название шрифта | 'FixedWidth'

'Color' - Цвет текста [0.15 0.15 0.15] (по умолчанию) | триплет RGB | шестнадцатеричный цветовой код | 'r' | 'g' | 'b' | ...

'Interpreter' - Текстовый интерпретатор 'tex' (по умолчанию) | 'latex' | 'none'

Синтаксис TeX

Разметка LaTeX

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

h - Текстовый объект текстовый объект

См. также

Функции

Свойства

Темы

Документация MATLAB

Поддержка

`txt` - Подпись по осям
строковый скаляр | вектор символов | строковые массивы | символьный массив | массив ячеек | категориальный массив | числовое значение

`ax` - Целевые оси
`Axes` объект | массив `Axes` объекты

`'FontSize'` - Размер шрифта
`11` (по умолчанию) | скалярное значение, больше `0`

`'FontWeight'` - Толщина символов
`'normal'` (по умолчанию) | `'bold'`

`'FontName'` - Название шрифта
поддерживаемое название шрифта | `'FixedWidth'`

`'Color'` - Цвет текста
`[0.15 0.15 0.15]` (по умолчанию) | триплет RGB | шестнадцатеричный цветовой код | `'r'` | `'g'` | `'b'` | ...

`'Interpreter'` - Текстовый интерпретатор
`'tex'` (по умолчанию) | `'latex'` | `'none'`

`h` - Текстовый объект
текстовый объект