exponenta event banner

xlabel

Описание

пример

xlabel(txt) помечает ось X текущих осей или автономную визуализацию. Переиздание xlabel заменяет старую метку новой меткой.

пример

xlabel(target,txt) добавляет метку к указанному целевому объекту.

пример

xlabel(___,Name,Value) изменяет внешний вид метки, используя один или несколько аргументов пары имя-значение. Например, 'FontSize',12 устанавливает размер шрифта равным 12 точкам. Укажите аргументы пары имя-значение после всех других входных аргументов. Изменение внешнего вида метки поддерживается не для всех типов диаграмм.

пример

t = xlabel(___) возвращает текстовый объект, используемый в качестве метки оси X. Использовать t для внесения будущих изменений в метку после ее создания.

Примеры

свернуть все

Показ Population под осью X.

plot((1:10).^2)
xlabel('Population')

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

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

plot((1:10).^2)
xlabel({'Population','(in thousands)'})

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

Включение греческих букв и других специальных символов в метку с помощью разметки TeX.

x = linspace(-2*pi,2*pi);
y = sin(x);
plot(x,y)
xlabel('-2\pi \leq x \leq 2\pi')

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

Добавление метки с текстом и значением переменной. Используйте num2str для включения значения переменной в метку.

plot((1:10).^2)  
year = 2014;
xlabel(['Population for Year ',num2str(year)])

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

Используйте '^' и '_' символы для включения надстрочных и подстрочных индексов в метки оси. Использовать фигурные скобки {} для изменения нескольких символов.

t = linspace(0,1);
y = exp(t);
plot(t,y)
xlabel('t_{seconds}')
ylabel('e^t')

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

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

plot((1:10).^2)
xlabel('Population','FontSize',12,'FontWeight','bold','Color','r')

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

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

tiledlayout(2,1)
ax1 = nexttile;
plot((1:10).^2)
xlabel(ax1,'Population')

ax2 = nexttile;
plot((1:10).^3)

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

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

plot((1:10).^2)
t = xlabel('Population');

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

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

t.Color = 'red';

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

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

свернуть все

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

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

  • A TiledChartLayout объект.

  • Автономная визуализация, имеющая XLabel собственность. Например, можно указать heatmap диаграмма в качестве цели.

  • Массив графических объектов из предыдущего списка. Объекты должны принадлежать одному классу. Для определения класса используйте class функция.

Если целевой объект не указан, то xlabel добавляет метку к графическому объекту, возвращаемому gca команда.

Примечание

Автономные визуализации не поддерживают изменение внешнего вида метки, например цвета, или возврат текстового объекта в качестве выходного аргумента.

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

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

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

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

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

Настройка свойств размера шрифта для связанных осей также влияет на размер шрифта метки. Размер шрифта метки изменяется таким образом, чтобы он равнялся размеру шрифта осей, умноженному на масштабный коэффициент метки. FontSize свойство осей содержит размер шрифта осей. LabelFontSizeMultiplier свойство осей содержит масштабный коэффициент метки. По умолчанию размер шрифта осей равен 10 пунктам, а масштабный коэффициент - 1,1, поэтому размер шрифта метки оси X равен 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/.

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

свернуть все

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

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