DurationRuler Properties

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

Свойства DurationRuler управляют внешним видом и поведением оси 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';

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

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

Минимальные и максимальные пределы по осям, заданные как двухэлементный вектор формы [min max], где min и max являются значениями длительности. Например:

d = duration(1,40:45,0);
y = rand(6,1);
plot(d,y)
ax = gca;
ax.XAxis.Limits = [d(2) d(5)];

Можно задать оба предела, или задать один предел и позволить линейке автоматически вычислить другое использование Inf или значения длительности -Inf, такого как days(Inf).

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

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

Примечание

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

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

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

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

Примечание

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

Шкала значений вдоль оси, возвращенной как 'linear'. объекты DurationRuler не поддерживают логарифмические шкалы.

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

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

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

Примечание

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

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

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

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

Местоположения отметки деления вдоль оси, заданной как вектор значений длительности. Например:

d = duration(1,40:45,0);
y = rand(6,1);
plot(d,y)
ax = gca;
ax.XAxis.TickValues = [d(1) d(3) d(5)];

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

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

Примечание

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

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

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

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

Примечание

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

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

Основное значение всегда равняется 10. Можно изменить значение экспоненты путем установки свойства Exponent. Если значением экспоненты является 0, то метка экспоненты не отображена.

Например, этот код изменяет значение экспоненты на 8.

x = hours((1:10)*1e10);
plot(x,1:10)
ax = gca;
ax.XAxis.Exponent = 8;

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

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

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

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

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

Пример: ax.XAxis.TickLabels = {'January','February','March','April','May'}';

Пример: ax.YAxis.TickLabels = {'\pi','2\pi','3\pi'}'

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

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

Примечание

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

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

Типы данных: 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/.

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

Чтобы отобразить длительность как, один номер, который включает дробную часть (например, 1,234 часа), задает один из следующих форматов.

Формат Описание
'y'Номер точных лет фиксированной длины. Год фиксированной длины равен 365,2425 дням.
'd'Номер точных дней фиксированной длины. День фиксированной длины равен 24 часам.
'h'Номер часов
'm'Номер минут
's'Номер секунд

Чтобы отобразить длительность в форме цифрового таймера, задайте один из этих форматов:

  • 'dd:hh:mm:ss'

  • 'hh:mm:ss'

  • 'mm:ss'

  • 'hh:mm'

Кроме того, можно отобразить до девяти цифр доли секунды путем добавления до девяти символов S. Например, 'hh:mm:ss.SSS' отображает миллисекунды значения длительности к трем цифрам.

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

Также можно вращать метки в виде галочки с помощью 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';

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

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

Режим выбора для свойства 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.

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

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

Введенный в R2017b