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'})
Маркировка Colorbar
Добавьте текстовую метку вдоль шкалы палитры.
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 возразите |
PolarAxes возразите | GeographicAxes возразите | графический объект
Целевой объект, который содержит связанную визуализацию данных в виде Axes объект, PolarAxes объект, GeographicAxes объект или графический объект, который имеет ColorbarVisible свойство. Например, HeatmapChart объект имеет ColorbarVisible свойство.
Если вы не задаете цель, то colorbar команда влияет на текущую систему координат (объект, возвращенный gca).
Примечание
Некоторые графики не поддерживают изменение внешнего вида шкалы палитры, такого как местоположение или возврат ColorBar возразите как выходной аргумент.
Аргументы name-value
colorbar('FontSize',12,'Direction','reverse') устанавливает размер шрифта шкалы палитры к 12 точкам и инвертирует ориентацию шкалы палитры.Свойства шкалы палитры, перечисленные здесь, являются только подмножеством. Поскольку полный список видит ColorBar Properties.
Интерпретатор метки в виде галочки в виде одного из этих значений:
'tex'— Интерпретируйте метки с помощью подмножества разметки TeX.'latex'— Интерпретируйте метки с помощью подмножества разметки LATEX. Когда вы зададите метки в виде галочки, используйте знаки доллара вокруг каждого элемента в массиве ячеек.'none'— Отобразите буквенные символы.
TeX Markup
По умолчанию MATLAB поддерживает подмножество разметки TeX. Используйте синтаксис TeX, чтобы добавить верхние индексы и индексы, изменить тип текста и окрасить и включать специальные символы в метки.
Модификаторы остаются в силе до конца текста. Верхние индексы и индексы являются исключением, потому что они изменяют только следующий символ или символы в фигурных скобках. Когда вы устанавливаете интерпретатор на 'tex', поддерживаемые модификаторы следующие.
| Модификатор | Описание | Пример |
|---|---|---|
^{ } | Верхний индекс | 'text^{superscript}' |
_{ } | Индекс | 'text_{subscript}' |
\bf | Bold font | '\bf text' |
\it | Курсивный шрифт | '\it text' |
\sl | Наклонный шрифт (обычно то же самое как курсивный шрифт) | '\sl text' |
\rm | Обычный шрифт | '\rm text' |
| Название шрифта — Замена | '\fontname{Courier} text' |
| Размер шрифта — Замена | '\fontsize{15} text' |
| Цвет шрифта — Замена red, green, yellowПурпурный, blue, black, whiteсерый, darkGreen, orange, или lightBlue. | '\color{magenta} text' |
\color[rgb]{specifier} | Цвет пользовательского шрифта — Замена | '\color[rgb]{0,0.5,0.5} text' |
Эта таблица приводит поддерживаемые специальные символы для 'tex' интерпретатор.
| Последовательность символов | Символ | Последовательность символов | Символ | Последовательность символов | Символ |
|---|---|---|---|---|---|
| α |
| υ |
| ~ |
| ∠ |
|
|
| ≤ |
|
|
| χ |
| ∞ |
| β |
| ψ |
| ♣ |
| γ |
| ω |
| ♦ |
| δ |
| Γ |
| ♥ |
| ϵ |
| Δ |
| ♠ |
| ζ |
| Θ |
| ↔ |
| η |
| Λ |
| ← |
| θ |
| Ξ |
| ⇐ |
| ϑ |
| Π |
| ↑ |
| ι |
| Σ |
| → |
| κ |
| ϒ |
| ⇒ |
| λ |
| Φ |
| ↓ |
| µ |
| Ψ |
| º |
| ν |
| Ω |
| ± |
| ξ |
| ∀ |
| ≥ |
| π |
| ∃ |
| ∝ |
| ρ |
| ∍ |
| ∂ |
| σ |
| ≅ |
| • |
| ς |
| ≈ |
| ÷ |
| τ |
| ℜ |
| ≠ |
| ≡ |
| ⊕ |
| ℵ |
| ℑ |
| ∪ |
| ℘ |
| ⊗ |
| ⊆ |
| ∅ |
| ∩ |
| ∈ |
| ⊇ |
| ⊃ |
| ⌈ |
| ⊂ |
| ∫ |
| · |
| ο |
| ⌋ |
| ¬ |
| ∇ |
| ⌊ |
| x |
| ... |
| ⊥ |
| √ |
| ´ |
| ∧ |
| ϖ | \0 | ∅ |
| ⌉ |
| 〉 |
| | |
| ∨ |
| 〈 |
| © |
Разметка 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/.
Советы
Чтобы добавить текстовое описание вдоль шкалы палитры, получите доступ к базовому текстовому объекту с помощью
Labelсвойство шкалы палитры.c.Label.String = 'My Colorbar Label';Чтобы изменить внешний вид метки, такой как стиль шрифта или цвет, устанавливают другие текстовые свойства. Для списка свойств смотрите Text Properties. Например, этот код изменяет размер шрифта.
c.Label.FontSize = 12;
Добавление шкалы палитры может изменить размер осей, чтобы вместить шкалу палитры.
Если оси не существует, то
colorbarфункция создает пустые оси и отображает шкалу палитры с палитрой по умолчанию.Можно использовать
colorbar('delete')илиcolorbar('hide')вместоcolorbar('off')удалить все шкалы палитры в текущей системе координат. Все эти команды эквивалентны.