colorbar

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

Описание

пример

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

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

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

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

contourf(peaks)
colorbar('southoutside')

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

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

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

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

Шкалы палитры возрастают сверху вниз вместо возрастания снизу вверх.

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

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

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

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

tiledlayout(2,1)

% Top plot
nexttile 
surf(peaks)
colorbar

% Bottom plot
nexttile
mesh(peaks)
colorbar

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

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

Создайте заполненные контурные графики peaks и membrane наборы данных в размещении мозаичного графика.

Z1 = peaks;
Z2 = membrane;
tiledlayout(2,1);
nexttile
contourf(Z1)
nexttile
contourf(Z2)

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

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

cb = colorbar;
cb.Layout.Tile = 'east';

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

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

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

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

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

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

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

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

surf(peaks)
colorbar

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

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

colorbar('off')

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

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

свернуть все

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

ЗначениеПолучившееся местоположениеРезультирующая ориентация
'north'Верхняя часть осейГоризонтальный
'south'Дно осейГоризонтальный
'east'Правая сторона осейВертикальный
'west'Левая сторона осейВертикальный
'northoutside'Верхняя часть снаружи осейГоризонтальный
'southoutside'Дно снаружи осейГоризонтальный
'eastoutside'Прямо за пределами осей (по умолчанию)Вертикальный
'westoutside'Слева от осейВертикальный
'layout'Плитка в плитке графика размещения. Чтобы переместить шкалу палитры в другую плитку, установите Layout свойство шкалы палитры.Зависит от формы плитки

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

Вы также можете задать шкалу палитры с помощью его Location свойство. Для примера, colorbar('Location','northoutside') то же, что и colorbar('northoutside').

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

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

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

Примечание

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

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

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

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

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

ЗначениеПолучившееся местоположениеРезультирующая ориентация
'north'Верхняя часть осейГоризонтальный
'south'Дно осейГоризонтальный
'east'Правая сторона осейВертикальный
'west'Левая сторона осейВертикальный
'northoutside'Верхняя часть снаружи осейГоризонтальный
'southoutside'Дно снаружи осейГоризонтальный
'eastoutside'Прямо за пределами осей (по умолчанию)Вертикальный
'westoutside'Слева от осейВертикальный
'manual'Определяется Position свойствоВертикальный
'layout'Плитка в плитке графика размещения. Чтобы переместить шкалу палитры в другую плитку, установите Layout свойство шкалы палитры.Зависит от формы плитки

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

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

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

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

Интерпретатор метки такта, заданный как одно из следующих значений:

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

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

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

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

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

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

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

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

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

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

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

Совет

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

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

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

    c.Label.FontSize = 12;

  • Добавление шкалы палитры может изменить размер осей для размещения шкалы палитры.

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

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

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

расширить все

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

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