CategoricalRuler Properties

Управляйте осью с категориальными значениями

Свойства CategoricalRuler управляют внешним видом и поведением оси X, оси Y или оси z, которая показывает категориальные значения. Каждая отдельная ось имеет свой собственный объект линейки. Путем изменения значений свойств линейки можно изменить определенные аспекты определенной оси.

Используйте запись через точку, чтобы относиться к конкретной линейке и свойству. Доступ к объектам линейки через XAxis, YAxis и свойства ZAxis объекта Axes. Например:

ax = gca;
co = ax.XAxis.Color;
ax.XAxis.Color = 'blue';

Внешний вид

развернуть все

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

Примечание

Свойство Color для линейки и связанного XColor, YColor или свойства ZColor для родительских осей всегда имеет то же значение. Установка одного также устанавливает другое.

Ширина строки оси и отметок деления, заданных как положительное значение в модулях точки. Один пункт равен 1/72 дюйма.

Пример: ax.XAxis.LineWidth = 2;

Примечание

Установка свойства LineWidth для родительских осей устанавливает свойство LineWidth для линейки к тому же значению. Однако установка свойства линейки не устанавливает свойство осей. Чтобы предотвратить переопределения значения свойства линейки, сначала установите значение оси, а затем установите значение линейки.

Подпись по осям, которая является текстовым объектом. Чтобы отобразить текст или изменить существующий текст, установите свойство String для текстового объекта. Используйте другие свойства изменить текстовый внешний вид, такой как стиль шрифта или цвет.

ax = gca;
ax.XAxis.Label.String = 'X Axis';
ax.XAxis.Label.FontSize = 12;

Для полного списка опций смотрите Text Properties.

Также добавьте или измените подписи по осям с помощью xlabel, ylabel и функций zlabel.

Примечание

Текстовый объект не является дочерним элементом объекта линейки, таким образом, это не может быть возвращено findobj, и это не использует текстовые значения свойств по умолчанию.

Видимость оси, заданная как одно из этих значений:

  • 'on' — Отобразите ось.

  • 'off' Скройте ось, не удаляя его. Все еще можно получить доступ к свойствам невидимой оси с помощью объекта линейки.

Пример: ax.XAxis.Visible = 'off';

Шкала и направление

развернуть все

Шкала значений вдоль оси, заданной как 'linear'.

Направление увеличения значений, заданных как одно из этих значений:

  • 'normal' — Значения увеличиваются слева направо или нижняя часть к верхней части.

  • реверс Значения увеличиваются справа налево или от начала до конца.

Примечание

Свойство Direction для линейки и связанного XDir, YDir или свойства ZDir для родительских осей всегда имеет то же значение. Установка одного также устанавливает другое.

Пример: ax.XAxis.Direction = 'reverse';

Значения деления и метки

развернуть все

Категории построены вдоль оси, заданной как массив ячеек из символьных векторов, категориальный массив или массив строк. Запрос этого свойства возвращает массив ячеек из символьных векторов. Установите это свойство исключить определенные категории из появления в графике.

Пример: ax.XAxis.Categories = categorical({'small','medium','large'}) задает категориальный массив.

Пример: ax.XAxis.Categories = {'small','medium','large'} задает массив ячеек.

Пример: ax.XAxis.Categories = string({'small','medium','large'}) задает массив строк.

Пример

Создайте гистограмму с категориями вдоль оси X и запросите свойство Categories. Затем установите свойство Categories так, чтобы только подмножество категорий появилось вдоль оси.

A =  categorical({'r' 'b' 'g' 'g' 'r' 'b' 'b' 'r' 'g' 'y' 'g' 'm'});
h = histogram(A);
ax = gca;
ax.XAxis.Categories
ans = 

  1×5 categorical array

     b      g      m      r      y 
ax.XAxis.Categories = categorical({'b','m','y'});

Типы данных: cell | categorical | string

Первые и последние категории отображены вдоль оси, заданной как двухэлементный вектор, указывающий на два названия категории. Категории должны быть двумя из категорий в свойстве Categories и должны появиться в том же относительном порядке, что они появляются в свойстве Categories.

Пример: ax.XAxis.Categories = categorical({'small','medium'}) задает двухэлементный категориальный массив.

Пример: ax.XAxis.Categories = {'small','medium'} задает двухэлементный массив ячеек.

Пример: ax.XAxis.Categories = string({'small','medium'}) задает двухэлементный массив строк.

Если вы присваиваете значение этому свойству, то MATLAB изменяет связанное свойство LimitsMode на 'manual'.

Также установите пределы с помощью xlim, ylim и функций zlim.

Примечание

Свойство Limits для линейки и связанного XLim, YLim или свойства ZLim для родительских осей всегда имеет то же значение. Установка одного также устанавливает другое.

Пример

Установите свойство Limits только показать категории между 'b' и 'm' вдоль оси.

A =  categorical({'r' 'b' 'g' 'g' 'r' 'b' 'b' 'r' 'g' 'y' 'g' 'm'});
h = histogram(A);
ax = gca;
ax.XAxis.Limits = categorical({'b','m'});

Типы данных: categorical | string | cell

Режим выбора для свойства Limits, заданного как одно из этих значений:

  • 'auto' Автоматически выберите пределы по осям на основе отображенных на графике данных.

  • 'manual' — Используйте значения предела по осям, которые вы задаете. Чтобы задать пределы по осям, установите свойство Limits.

Примечание

Свойство LimitsMode для линейки и связанного XLimMode, YLimMode или свойства ZLimMode для родительских осей всегда имеет то же значение. Установка одного также устанавливает другое.

Местоположения отметки деления вдоль оси, заданной как массив ячеек из символьных векторов, категориальный массив или массив строк, указывающий на названия категории. Категории должны быть подмножеством категорий в свойстве Categories и должны появиться в том же относительном порядке, что они появляются в свойстве Categories. Чтобы удалить все отметки деления и метки вдоль оси, установите это свойство на пустой массив [].

Пример: ax.XAxis.Categories = categorical({'small','medium','large'}) задает категориальный массив.

Пример: ax.XAxis.Categories = {'small','medium','large'} задает массив ячеек.

Пример: ax.XAxis.Categories = string({'small','medium','large'}) задает массив строк.

Если вы присваиваете значение этому свойству, то MATLAB устанавливает свойство TickValuesMode на 'manual'.

Также используйте xticks, yticks и функции zticks.

Примечание

Свойство TickValues для линейки и связанного XTick, YTick или свойства ZTick для родительских осей всегда имеет то же значение. Установка одного также устанавливает другое.

Пример

Маркируйте подмножество категорий вдоль оси путем установки свойства TickValues на подмножество категорий.

A =  categorical({'r' 'b' 'g' 'g' 'r' 'b' 'b' 'r' 'g' 'y' 'g' 'm'});
h = histogram(A);
ax = gca;
ax.XAxis.TickValues = categorical({'b','m','y'});

Типы данных: categorical | string | cell

Режим выбора для свойства TickValues, заданного как одно из этих значений:

  • 'auto' Автоматически выберите значения деления на основе отображенных на графике данных.

  • 'manual' — Используйте значения деления, которые вы задаете. Чтобы задать значения, установите свойство TickValues.

Примечание

Свойство TickValuesMode для линейки и связанного XTickMode, YTickMode или свойства ZTickMode для родительских осей всегда имеет то же значение. Установка одного также устанавливает другое.

Подписи меток, заданные как массив ячеек из символьных векторов, массив строк или категориальный массив. Используйте это свойство повторно маркировать отметки деления, не изменяя названия категории. Если вы не задаете метку для каждого значения, то повторение меток. Метки поддерживают TeX и ПРОПИТЫВАЮТ ЛАТЕКСОМ разметку. Смотрите свойство TickLabelInterpreter для получения дополнительной информации.

Если вы устанавливаете это свойство, то MATLAB устанавливает свойство TickLabelsMode на 'manual'.

Также задайте метки в виде галочки с помощью xticklabels, yticklabels и функций zticklabels.

Примечание

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

  • Свойство TickLabels для линейки и связанного XTickLabel, YTickLabel или свойства ZTickLabel для родительских осей всегда имеет то же значение. Установка одного также устанавливает другое.

Пример

Повторно маркируйте категории вдоль оси X.

A =  categorical({'r' 'b' 'g' 'g' 'r' 'b' 'b' 'r' 'g' 'y' 'g'});
h = histogram(A);
ax = gca;
ax.XAxis.TickLabels = {'Blue','Green','Red','Yellow'}

Типы данных: char | string | categorical

Режим выбора для свойства TickLabels, заданного как одно из этих значений:

  • 'auto' Автоматически выберите метки в виде галочки.

  • 'manual' — Используйте метки в виде галочки, которые вы задаете. Чтобы задать метки, установите свойство TickLabels.

Примечание

Свойство TickLabelsMode для линейки и связанного XTickLabelMode, YTickLabelMode или свойства ZTickLabelMode для родительских осей всегда имеет то же значение. Установка одного также устанавливает другое.

Интерпретация символов метки в виде галочки, заданных как одно из этих значений:

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

  • 'latex' — Интерпретируйте символы, использующие разметку LATEX.

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

Примечание

Установка свойства TickLabelInterpreter для родительских осей устанавливает свойство TickLabelInterpreter для линейки к тому же значению. Однако установка свойства линейки не устанавливает свойство осей. Чтобы предотвратить переопределения значения свойства линейки, сначала установите значение оси, а затем установите значение линейки.

Пример: ax.XAxis.TickLabelInterpreter = 'latex';

TeX Markup

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

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

МодификаторОписаниеПример
^{ }Верхний индекс'text^{superscript}'
_{ }Индекс'text_{subscript}'
\bfBold font'\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}Установите specifer как один из этих цветов: 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'

В этой таблице перечислены поддерживаемые специальные символы со свойством Interpreter, установленным на '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, установите свойство TickLabelInterpreter на 'latex'. Используйте долларовые символы вокруг меток, например, используйте '$\int_1^{20} x^2 dx$' для встроенного режима или '$$\int_1^{20} x^2 dx$$' для режима отображения.

Отображаемый текст использует стиль шрифта LATEX по умолчанию. FontName, FontWeight и свойства FontAngle не имеют эффекта. Чтобы изменить стиль шрифта, используйте разметку LATEX в рамках текста. Максимальный размер текста, который можно использовать с интерпретатором LATEX, является 1 200 символами. Для многострочного текста максимальный размер текста уменьшает приблизительно на 10 символов на строку.

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

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

Также можно вращать метки в виде галочки с помощью xtickangle, ytickangle и функций ztickangle.

Примечание

Свойство TickLabelRotation для линейки и связанного XTickLabelRotation, YTickLabelRotation или свойства ZTickLabelRotation для родительских осей всегда имеет то же значение. Установка одного также устанавливает другое.

Пример: ax.XAxis.TickLabelRotation = 45;

Пример: ax.YAxis.TickLabelRotation = -45;

Режим выбора для свойства TickLabelRotation, заданного как одно из этих значений:

  • 'auto' Автоматически выберите вращение метки в виде галочки.

  • 'manual' — Используйте вращение метки в виде галочки, которое вы задаете. Чтобы задать вращение, установите свойство TickLabelRotation.

Направление отметки деления, заданное как одно из этих значений:

  • \in Направьте отметки деления внутрь от строк оси. Это - значение по умолчанию для 2D представлений.

  • 'out' — Направьте отметки деления, исходящие от строк оси. Это - значение по умолчанию для 3-D представлений.

  • 'both' — Сосредоточьте отметки деления по строкам оси.

Если вы присваиваете значение этому свойству, то MATLAB устанавливает свойство TickDirectionMode на 'manual'.

Примечание

Установка свойства TickDir для родительских осей устанавливает свойство TickDirection для линейки к тому же значению. Однако установка свойства линейки не устанавливает свойство осей. Чтобы предотвратить переопределения значения свойства линейки, сначала установите значение оси, а затем установите значение линейки.

Пример: ax.YAxis.TickDirection = 'out';

Режим выбора для свойства TickDirection, заданного как одно из этих значений:

  • 'auto' Автоматически выберите направление метки деления.

  • 'manual' — Используйте направление метки деления, которое вы задаете. Чтобы задать направление метки деления, установите свойство TickDirection.

Длина отметки деления, заданная как двухэлементный вектор формы [2Dlength 3Dlength]. Первый элемент является длиной отметки деления в 2D представлениях. Второй элемент является длиной отметки деления в 3-D представлениях. Задайте значения в модулях, нормированных относительно самой долгой размерности осей.

Примечание

Установка свойства TickLength для родительских осей устанавливает свойство TickLength для линейки к тому же значению. Однако установка свойства линейки не устанавливает свойство осей. Чтобы предотвратить переопределения значения свойства линейки, сначала установите значение оси, а затем установите значение линейки.

Пример: ax.YAxis.TickLength = [0.02 0.035];

Незначительное отображение отметки деления, заданное как одно из этих значений:

  • 'off' Не отображайте незначительные отметки деления. Это - значение по умолчанию для оси с линейной шкалой.

  • 'on' — Отобразите незначительные отметки деления между главными отметками деления на оси. Это - значение по умолчанию для оси с логарифмической шкалой. Пробел между главными отметками деления определяет количество незначительных отметок деления. Если свойство MinorTickValues собирается освободить [], то никакие незначительные отметки деления не появляются. Задайте местоположения отметки деления путем установки свойства MinorTickValues.

Примечание

Свойство MinorTick для линейки и связанного XMinorTick, YMinorTick или свойства ZMinorTick для родительских осей всегда имеет то же значение. Установка одного также устанавливает другое.

Пример: ax.XAxis.MinorTick = 'on';

Незначительные местоположения отметки деления, заданные как массив ячеек из символьных векторов, категориальный массив или массив строк, указывающий на названия категории. Категории должны быть подмножеством категорий в свойстве Categories и должны появиться в том же относительном порядке, что они появляются в свойстве Categories.

Если вы присваиваете значения этому свойству, то MATLAB устанавливает свойство MinorTickValuesMode на 'manual'.

Типы данных: categorical | string | cell

Режим выбора для свойства MinorTickValues, заданного как одно из этих значений:

  • 'auto' Использование автоматически вычислило незначительные значения деления.

  • 'manual' — Используйте незначительные значения деления, которые вы задаете. Чтобы задать значения, установите свойство MinorTickValues.

Шрифт

развернуть все

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

Примечание

Установка свойства FontName для родительских осей устанавливает свойство FontName для линейки к тому же значению. Однако установка свойства линейки не устанавливает свойство осей. Чтобы предотвратить переопределения значения свойства линейки, сначала установите значение оси, а затем установите значение линейки.

Пример: ax.XAxis.FontName = 'Cambria';

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

Примечание

Установка свойства FontSize для родительских осей устанавливает свойство FontSize для линейки к тому же значению. Однако установка свойства линейки не устанавливает свойство осей. Чтобы предотвратить переопределения значения свойства линейки, сначала установите значение оси, а затем установите значение линейки.

Пример: ax.XAxis.FontSize = 12;

Толщина текстовых символов, заданных как одно из этих значений:

  • normal' — Насыщенность по умолчанию, определяемая конкретным видом шрифта.

  • 'bold' — более тонкие контуры символов, чем 'normal'.

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

Примечание

Установка свойства FontWeight для родительских осей устанавливает свойство FontWeight для линейки к тому же значению. Однако установка свойства линейки не устанавливает свойство осей. Чтобы предотвратить переопределения значения свойства линейки, сначала установите значение оси, а затем установите значение линейки.

Пример: ax.XAxis.FontWeight = 'bold';

Наклонные символы, заданные как 'normal' или 'italic'. Не все шрифты имеют оба стилей шрифтов. Поэтому курсивный шрифт может выглядеть одинаково как обычный шрифт.

Примечание

Установка свойства FontAngle для родительских осей устанавливает свойство FontAngle для линейки к тому же значению. Однако установка свойства линейки не устанавливает свойство осей. Чтобы предотвратить переопределения значения свойства линейки, сначала установите значение оси, а затем установите значение линейки.

Пример: ax.XAxis.FontAngle = 'italic';

Текстовое сглаживание, заданное как одно из этих значений:

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

  • 'off' Отключите текстовое сглаживание. Используйте эту установку, если текст кажется расплывчатым.

Примечание

Установка свойства FontSmoothing для родительских осей устанавливает свойство FontSmoothing для линейки к тому же значению. Однако установка свойства линейки не устанавливает свойство осей. Чтобы предотвратить переопределения значения свойства линейки, сначала установите значение оси, а затем установите значение линейки.

Пример: ax.XAxis.FontSmoothing = 'off';

Родительский элемент/Дочерний элемент

развернуть все

Родительский элемент линейки, заданный как объект Axes.

Примечание

Объекты линейки не перечислены в свойстве Children родительского объекта Axes.

У линейки нет дочерних элементов. Вы не можете задать это свойство.

Смотрите также

Введенный в R2017a