colorbar
Шкала палитры, показывающая шкалу цвета
Синтаксис
Описание
colorbar отображение вертикальной шкалы палитры справа от текущей системы координат или графика. Шкалы палитры отображают текущую палитру и указывают на отображение значений данных в палитру.
colorbar( отображает шкалу палитры в определенном месте, например location)'northoutside'. Не все типы графиков поддерживают изменение расположения шкалы палитры.
colorbar(___, изменяет внешний вид шкалы палитры с помощью одного или нескольких аргументов пары "имя-значение". Для примера, Name,Value)'Direction','reverse'изменение цвета на противоположную шкалу. Задайте Name,Value как последняя пара аргументов в любом из предыдущих синтаксисов. Не все типы графиков поддерживают изменение внешнего вида шкалы палитры.
colorbar( добавляет шкалу палитры к заданным в target,___)target осям или графике. Задайте целевые оси или график в качестве первого аргумента в любом из предыдущих синтаксисов.
c = colorbar(___) возвращает ColorBar объект. Можно использовать этот объект для задания свойств после создания шкалы палитры. Задайте возвращаемый аргумент c с любым из предыдущих синтаксисов.
Примеры
Добавить Шкалу палитры в график
Добавьте шкалы палитры к объемной поверхностной диаграмме, указывающему на шкалу цвета.
surf(peaks) colorbar
По умолчанию в colorbar функция добавляет вертикальный шкала палитры в правую сторону графика.
Добавьте горизонтальную шкалу палитры к графику
Добавить горизонтальную шкалу палитры под график можно путем определения расположения шкалы палитры следующим 'southoutside'.
contourf(peaks)
colorbar('southoutside')
Обратная шкала палитры
Противоположное направление значений в шкале палитры на графике путем установки 'Direction' свойство шкалы палитры для 'reverse'.
surf(peaks) colorbar('Direction','reverse')
Шкалы палитры возрастают сверху вниз вместо возрастания снизу вверх.
Отобразите Шкалу палитры Тактов на противоположной стороне
Отображение шкал палитры отметок деления и меток такта на стороне шкалы палитры, обращенной к объемной поверхностной диаграмме.
surf(peaks) colorbar('AxisLocation','in')
Добавление шкал палитры к размещению мозаичного графика
Начиная с R2019b, можно отобразить плиточное размещение графиков с помощью tiledlayout и nexttile функций. Вызовите tiledlayout функция для создания мозаичного графика размещения 2 на 1. Вызовите nexttile функция для создания осей. Затем отобразите объемную поверхностную диаграмму в каждой оси с шкалой палитры.
tiledlayout(2,1) % Top plot nexttile surf(peaks) colorbar % Bottom plot nexttile mesh(peaks) colorbar
Отображение общей шкалы палитры в размещении мозаичного графика
Когда необходимо разделить шкалу палитры между двумя или несколькими графиками, можно отобразить шкалу палитры в отдельной плитке размещения.
Создайте заполненные контурные графики peaks и membrane наборы данных в размещении мозаичного графика.
Z1 = peaks; Z2 = membrane; tiledlayout(2,1); nexttile contourf(Z1) nexttile contourf(Z2)
Добавьте шкалу палитры цветов и переместите ее на восточную плитку.
cb = colorbar;
cb.Layout.Tile = 'east';
Задайте Шкалу палитры Тактов и Такта метки
Добавьте шкалы палитры к графику и задайте шкалу палитры отметок деления и такта метки. Задайте то же количество меток такта, что и отметок деления. Если вы не задаете достаточное количество меток такта, то 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')
Входные параметры
location - Расположение
'eastoutside' (по умолчанию) | 'north' | 'south' | 'east' | 'west' | 'northoutside' | ...
Расположение шкалы палитры относительно осей, заданное как одно из значений в этой таблице.
| Значение | Получившееся местоположение | Результирующая ориентация |
|---|---|---|
'north' | Верхняя часть осей | Горизонтальный |
'south' | Дно осей | Горизонтальный |
'east' | Правая сторона осей | Вертикальный |
'west' | Левая сторона осей | Вертикальный |
'northoutside' | Верхняя часть снаружи осей | Горизонтальный |
'southoutside' | Дно снаружи осей | Горизонтальный |
'eastoutside' | Прямо за пределами осей (по умолчанию) | Вертикальный |
'westoutside' | Слева от осей | Вертикальный |
'layout' | Плитка в плитке графика размещения. Чтобы переместить шкалу палитры в другую плитку, установите Layout свойство шкалы палитры. | Зависит от формы плитки |
Если шкала палитры уже существует в указанном расположении, обновленный шкала палитры заменяет существующий. Чтобы убедиться, что шкала палитры не перекрывает график, задайте местоположение с суффиксом, outside.
Вы также можете задать шкалу палитры с помощью его Location свойство. Для примера, colorbar('Location','northoutside') то же, что и colorbar('northoutside').
Пример: colorbar('westoutside')
target - Цель
Axes |
объекта PolarAxesGeographicAxes объект | графический объект
Целевой объект, который содержит связанную визуализацию данных, заданную как Axes объект, a PolarAxes объект, a GeographicAxes объект или графический объект, имеющий ColorbarVisible свойство. Для примера, a HeatmapChart объект имеет ColorbarVisible свойство.
Если вы не задаете цель, то colorbar команда влияет на текущие системы координат (объект, возвращенный gca).
Примечание
Некоторые графики не поддерживают изменение внешнего вида шкалы палитры, например, местоположение или возврат ColorBar объект как выходной аргумент.
Аргументы в виде пар имя-значение
colorbar('FontSize',12,'Direction','reverse') устанавливает размер шрифта шкалы палитры равным 12 точкам и меняет ориентацию шкалы палитры на противоположную.Перечисленные здесь свойства шкалы палитры являются только подмножеством. Полный список см. в разделе « Свойствах ColorBar».
Интерпретатор метки такта, заданный как одно из следующих значений:
'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 | Название шрифта - Заменить | '\fontname{Courier} text' |
\ fontsize | Размер шрифта - Заменить | '\fontsize{15} text' |
\ цвет | Цвет шрифта - Заменить red, green, yellow, magenta, blue, black, white, gray, darkGreen, orange, или lightBlue. | '\color{magenta} text' |
\color[rgb]{specifier} | Цвет пользовательского шрифта - Заменить | '\color[rgb]{0,0.5,0.5} text' |
В этой таблице перечислены поддерживаемые специальные символы для 'tex' интерпретатор.
| Последовательность символов | Символ | Последовательность символов | Символ | Последовательность символов | Символ |
|---|---|---|---|---|---|
| α |
| υ |
| ~ |
| ∠ |
|
|
| ≤ |
|
|
| χ |
| ∞ |
| β |
| ψ |
| ♣ |
| γ |
| ω |
| ♦ |
| δ |
| Γ |
| ♥ |
| ϵ |
| Δ |
| ♠ |
| ζ |
| Θ |
| ↔ |
| η |
| Λ |
| ← |
| θ |
| Ξ |
| ⇐ |
| ϑ |
| Π |
| ↑ |
| ι |
| Σ |
| → |
| κ |
| ϒ |
| ⇒ |
| λ |
| Φ |
| ↓ |
| µ |
| Ψ |
| º |
| ν |
| Ω |
| ± |
| ξ |
| ∀ |
| ≥ |
| π |
| ∃ |
| ∝ |
| ρ |
| ∍ |
| ∂ |
| σ |
| ≅ |
| • |
| ς |
| ≈ |
| ÷ |
| τ |
| ℜ |
| ≠ |
| ≡ |
| ⊕ |
| ℵ |
| ℑ |
| ∪ |
| ℘ |
| ⊗ |
| ⊆ |
| ∅ |
| ∩ |
| ∈ |
| ⊇ |
| ⊃ |
| ⌈ |
| ⊂ |
| ∫ |
| · |
| ο |
| ⌋ |
| ¬ |
| ∇ |
| ⌊ |
| x |
| ... |
| ⊥ |
| √ |
| ´ |
| ∧ |
| ϖ |
| ∅ |
| ⌉ |
| 〉 |
| | |
| ∨ |
| 〈 |
| © |
Разметка 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/.
Совет
Чтобы добавить текстовое описание вдоль шкалы палитры, получите доступ к базовому текстовому объекту с помощью
Labelсвойство шкалы палитры.c.Label.String = 'My Colorbar Label';Чтобы изменить внешний вид метки, например стиль шрифта или цвет, задайте другие свойства текста. Список свойств см. в разделе Свойства текста. Для примера этот код изменяет размер шрифта.
c.Label.FontSize = 12;
Добавление шкалы палитры может изменить размер осей для размещения шкалы палитры.
Если осей не существует, то
colorbarфункция создает пустые оси и отображает шкалу палитры с палитрой по умолчанию.Можно использовать
colorbar('delete')илиcolorbar('hide')вместоcolorbar('off')чтобы удалить все шкалы палитры в текущей системе координат. Все эти команды эквивалентны.