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 возразите как цель.

Примеры

свернуть все

Скрипт Open Live Script

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

surf(peaks)
colorbar

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

Скрипт Open Live Script

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

contourf(peaks)
colorbar('southoutside')

Скрипт Open Live Script

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

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

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

Скрипт Open Live Script

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

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

Скрипт Open Live Script

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

tiledlayout(2,1)

% Top plot
nexttile 
surf(peaks)
colorbar

% Bottom plot
nexttile
mesh(peaks)
colorbar

Скрипт Open Live Script

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

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

Скрипт Open Live Script

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

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

Скрипт Open Live Script

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

surf(peaks)
colorbar

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

colorbar('off')

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

свернуть все

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

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

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

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

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

Целевой объект, который содержит связанную визуализацию данных, заданную как Axes объект, PolarAxes объект, GeographicAxes объект или графический объект, который имеет 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Пурпурный, 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'. Отображаемый текст использует стиль шрифта LATEX по умолчанию. FontNameFontWeight , и FontAngle свойства не оказывают влияние. Чтобы изменить стиль шрифта, используйте разметку LATEX в рамках текста.

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

Для получения дополнительной информации о системе 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

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