colorbar

Шкала палитры, показывающая цветовую шкалу

Синтаксис

colorbar
colorbar(location)
colorbar(___,Name,Value)
colorbar(target,___)
c = colorbar(___)
colorbar('off')
colorbar(target,'off')

Описание

пример

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

пример

colorbar(location) отображает шкалу палитры в определенном месте, таком как 'northoutside'. Не все типы поддержки графиков, изменяющей местоположение шкалы палитры.

пример

colorbar(___,Name,Value) изменяет внешний вид шкалы палитры с помощью одного или нескольких аргументов пары "имя-значение". Например, 'Direction','reverse' инвертирует цветовую шкалу. Задайте Name,Value как последнюю пару аргументов в любом из предыдущих синтаксисов. Не все типы поддержки графиков, изменяющей внешний вид шкалы палитры.

colorbar(target,___) добавляет шкала палитры к осям или графику, заданному target. Задайте целевые оси или график в качестве первого аргумента в любом из предыдущих синтаксисов.

пример

c = colorbar(___) возвращает объект ColorBar. Можно использовать этот объект установить свойства после создания шкалы палитры. Задайте возвращаемый аргумент c с любым из предыдущих синтаксисов.

пример

colorbar('off') удаляет все шкалы палитры, сопоставленные с текущей системой координат или графиком.

colorbar(target,'off') удаляет все шкалы палитры, сопоставленные с целевыми осями или графиком. Также можно задать объект ColorBar как цель.

Примеры

свернуть все

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

surf(peaks)
colorbar

По умолчанию функция colorbar добавляет вертикальную шкалу палитры в правую сторону графика.

Добавьте горизонтальную шкалу палитры ниже графика путем определения местоположения шкалы палитры как 'southoutside'.

contourf(peaks)
colorbar('southoutside')

Инвертируйте направление значений в шкале палитры на графике путем установки свойства 'Direction' шкалы палитры к 'reverse'.

surf(peaks)
colorbar('Direction','reverse')

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

Отобразите отметки деления шкалы палитры и метки в виде галочки на стороне шкалы палитры, стоящей перед объемной поверхностной диаграммой.

surf(peaks)
colorbar('AxisLocation','in')

Создайте фигуру с двумя подграфиками. Добавьте шкалы палитры в оба подграфика.

subplot(2,1,1) % upper subplot 
surf(peaks)
colorbar

subplot(2,1,2) % lower subplot
contourf(peaks)
colorbar

Добавьте шкалу палитры в график и задайте отметки деления шкалы палитры и метки в виде галочки. Задайте то же количество меток в виде галочки как отметки деления. Если вы не задаете достаточно меток в виде галочки, то функция colorbar повторяет метки.

contourf(peaks)
colorbar('Ticks',[-5,-2,1,4,7],...
         'TickLabels',{'Cold','Cool','Neutral','Warm','Hot'})

Добавьте текстовую метку вдоль шкалы палитры.

surf(peaks)
c = colorbar;
c.Label.String = 'Elevation (ft in 1000s)';

Добавьте шкалу палитры в объемную поверхностную диаграмму.

surf(peaks)
colorbar

Удалите шкалу палитры из объемной поверхностной диаграммы.

colorbar('off')

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

свернуть все

Местоположение шкалы палитры относительно осей, заданных как одно из значений в этой таблице.

ЗначениеПолучившееся местоположениеПолучившаяся ориентация
'north'Верхняя часть осейГоризонталь
'south'Нижняя часть осейГоризонталь
'east'Правая сторона осейВертикальный
'west'Левая сторона осейВертикальный
'northoutside'Верхняя часть за пределами осейГоризонталь
'southoutside'Нижняя часть за пределами осейГоризонталь
'eastoutside'Прямо вне осей (значение по умолчанию)Вертикальный
'westoutside'Оставленный за пределами осейВертикальный

Если шкала палитры уже существует в заданном месте, то обновленная шкала палитры заменяет существующий. Чтобы гарантировать, что шкала палитры не перекрывает график, задайте местоположение с суффиксом, outside.

Также можно установить местоположение шкалы палитры с помощью его свойства Location. Например, colorbar('Location','northoutside') совпадает с colorbar('northoutside').

Пример: colorbar('westoutside')

Целевой объект, который содержит связанную визуализацию данных, заданную как объект Axes, объект PolarAxes или графический объект, который имеет свойство ColorbarVisible. Например, объект HeatmapChart имеет свойство ColorbarVisible.

Если вы не задаете цель, то команда colorbar влияет на текущую систему координат (объект, возвращенный gca).

Примечание

Некоторые графики не поддерживают изменение внешнего вида шкалы палитры, такого как местоположение или возврат объекта ColorBar как выходной аргумент.

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

Пример: colorbar('FontSize',12,'Direction','reverse') устанавливает размер шрифта шкалы палитры к 12 точкам и инвертирует ориентацию шкалы палитры.

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

Местоположение относительно осей, заданных как одно из значений, перечислено в этой таблице.

ЗначениеПолучившееся местоположениеПолучившаяся ориентация
'north'Верхняя часть осейГоризонталь
'south'Нижняя часть осейГоризонталь
'east'Правая сторона осейВертикальный
'west'Левая сторона осейВертикальный
'northoutside'Верхняя часть за пределами осейГоризонталь
'southoutside'Нижняя часть за пределами осейГоризонталь
'eastoutside'Прямо вне осей (значение по умолчанию)Вертикальный
'westoutside'Оставленный за пределами осейВертикальный
'manual'Определенный свойством PositionВертикальный

Чтобы отобразить шкалу палитры в месте, которое не появляется в таблице, используйте свойство Position задать пользовательское местоположение. Если вы устанавливаете свойство Position, то MATLAB® устанавливает свойство Location на 'manual'. Связанные оси не изменяют размер, чтобы разместить шкалу палитры, когда свойство Location установлено в 'manual'.

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

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

Пример: {'cold','warm','hot'}

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

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

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

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

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'. Отображаемый текст использует стиль шрифта LATEX по умолчанию. FontName, FontWeight и свойства FontAngle не имеют эффекта. Чтобы изменить стиль шрифта, используйте разметку LATEX в рамках текста.

Максимальный размер текста, который можно использовать с интерпретатором LATEX, является 1 200 символами. Для многострочного текста максимальный размер текста уменьшает приблизительно на 10 символов на строку.

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

Местоположения отметки деления, заданные как вектор монотонно увеличения числовых значений. Значения не должны быть равномерно распределены. Если вы не хотите отображенных отметок деления, то установленный свойство в пустой вектор, [].

Пример: [-1,0,1,2,3,4,5]

Типы данных: single | double

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

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

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

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

Если вы изменяете размер шрифта осей, то MATLAB автоматически устанавливает размер шрифта шкалы палитры к 90% размера шрифта осей. Если вы вручную устанавливаете размер шрифта шкалы палитры, то изменение размера шрифта осей не влияет на шрифт шкалы палитры.

Советы

  • Чтобы добавить текстовое описание вдоль шкалы палитры, получите доступ к базовому текстовому объекту с помощью свойства Label шкалы палитры.

    c.Label.String = 'My Colorbar Label';
    

    Чтобы изменить внешний вид метки, такой как стиль шрифта или цвет, устанавливают другие текстовые свойства. Для списка свойств смотрите Text Properties. Например, этот код изменяет размер шрифта.

    c.Label.FontSize = 12;

  • Добавление шкалы палитры может изменить размер осей, чтобы разместить шкалу палитры.

  • Если оси не существуют, то функция colorbar создает пустые оси и отображает шкалу палитры с палитрой по умолчанию.

  • Можно использовать colorbar('delete') или colorbar('hide') вместо colorbar('off'), чтобы удалить все шкалы палитры в текущей системе координат. Все эти команды эквивалентны.

Вопросы совместимости

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

Не рекомендуемый запуск в R2014b

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

Для просмотра документации необходимо авторизоваться на сайте