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 object. The axes object contains an object of type surface.

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

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

contourf(peaks)
colorbar('southoutside')

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

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

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

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

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

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

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

Figure contains an axes object. The axes object 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 objects. Axes object 1 contains an object of type surface. Axes object 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 objects. Axes object 1 contains an object of type contour. Axes object 2 contains an object of type contour.

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

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

Figure contains 2 axes objects. Axes object 1 contains an object of type contour. Axes object 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 object. The axes object contains an object of type contour.

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

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

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

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

surf(peaks)
colorbar

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

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

colorbar('off')

Figure contains an axes object. The axes object 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 объект, PolarAxes объект, GeographicAxes объект или графический объект, который имеет ColorbarVisible свойство. Например, HeatmapChart объект имеет ColorbarVisible свойство.

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

Примечание

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

Аргументы name-value

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

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

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

ЗначениеПолучившееся местоположениеПолучившаяся ориентация
'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 Markup

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

Модификаторы остаются в силе до конца текста. Верхние индексы и индексы являются исключением, потому что они изменяют только следующий символ или символы в фигурных скобках. Когда вы устанавливаете интерпретатор на '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}}Цвет шрифта — Замена specifier с одним из этих цветов: 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'

Эта таблица приводит поддерживаемые специальные символы для '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 символов на строку.

Для примеров, которые используют 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';
    

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

    c.Label.FontSize = 12;

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

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

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

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

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

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

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