exponenta event banner

цветная полоса

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

Описание

пример

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

пример

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

пример

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' свойства colorbar to 'reverse'.

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

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

Значения colorbar поднимаются сверху вниз, а не снизу вверх.

Отображение засечек цветовой полосы и засечек на стороне цветовой полосы, обращенной к поверхностному графику.

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 свойства colorbar.Зависит от формы плитки

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

Также можно задать расположение панели цветов с помощью ее Location собственность. Например, colorbar('Location','northoutside') является таким же, как colorbar('northoutside').

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

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

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

Примечание

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

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

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

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

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

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

Чтобы отобразить панель цветов в расположении, которое не отображается в таблице, используйте 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'
\color{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 по умолчанию. 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% от размера шрифта осей. Если размер шрифта colorbar задается вручную, то изменение размера шрифта осей не влияет на шрифт colorbar.

Совет

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

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

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

    c.Label.FontSize = 12;

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

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

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

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

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

Не рекомендуется начинать с R2014b

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