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.

В качестве альтернативы добавьте или измените подписи по осям с помощью xlabelYLabel , и zlabel функции.

Примечание

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

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

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

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

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

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

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

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

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

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

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

Примечание

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'.

В качестве альтернативы установите пределы с помощью xlimylim, и zlim функции.

Примечание

Limits свойство для линейки и связанного XLimylim, или 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'.

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

В качестве альтернативы задайте метки в виде галочки с помощью xticklabelsyticklabels, и 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Пурпурный, blue, black, whiteсерый, 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 по умолчанию. FontNameFontWeight , и FontAngle свойства не оказывают влияние. Чтобы изменить стиль шрифта, используйте разметку LATEX в рамках текста. Максимальный размер текста, который можно использовать с интерпретатором LATEX, является 1 200 символами. Для многострочного текста максимальный размер текста уменьшает приблизительно на 10 символов на строку.

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

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

В качестве альтернативы можно вращать метки в виде галочки с помощью xtickangleytickangle, и 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' — Более толстые символьные основы, чем нормальный.

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