панель

Синтаксис

bar(y)
bar(x,y)
bar(___,width)
bar(___,style)
bar(___,color)
bar(___,Name,Value)
bar(ax,___)
b = bar(___)

Описание

пример

bar(y) создает гистограмму с одной панелью для каждого элемента в y. Если y является матрицей, то bar группирует панели согласно строкам в y.

пример

bar(x,y) чертит панели в местоположениях, заданных x.

пример

bar(___,width) устанавливает относительную ширину панели, которая управляет разделением панелей в группе. Задайте width как скалярное значение. Используйте эту опцию с любыми комбинациями входных аргументов в предыдущих синтаксисах.

пример

bar(___,style) задает стиль групп панели. Например, используйте 'stacked', чтобы отобразить каждую группу как одну разноцветную панель.

пример

bar(___,color) выбирает цвет для всех панелей. Например, используйте 'r' для красных панелей.

пример

bar(___,Name,Value) изменяет столбчатую диаграмму с помощью одного или нескольких аргументов пары "имя-значение". Настройки применяются ко всем построенным панелям. Например, используйте 'EdgeColor','black', чтобы обрисовать в общих чертах все панели черного цвета цвета.

пример

bar(ax,___) графики в оси, заданные ax вместо в текущую систему координат (gca). Опция ax может предшествовать любой комбинации входных аргументов в предыдущих синтаксисах.

пример

b = bar(___) возвращает один или несколько объектов Bar. Если y является вектором, то bar создает один объект Bar. Если y является матрицей, то bar создает объект Bar для каждого столбца. Используйте b, чтобы сделать будущие модификации к объектам Bar после того, как они будут созданы.

Примеры

свернуть все

y = [75 91 105 123.5 131 150 179 203 226 249 281.5];
bar(y)

Задайте местоположения панели вдоль оси X.

x = 1900:10:2000;
y = [75 91 105 123.5 131 150 179 203 226 249 281.5];
bar(x,y)

Установите ширину каждой панели к 40 процентам общего пробела, доступного для каждой панели.

y = [75 91 105 123.5 131 150 179 203 226 249 281.5];
bar(y,0.4)

Отобразите четыре группы из трех панелей.

y = [2 2 3; 2 5 6; 2 8 9; 2 11 12];
bar(y)

Отобразите одну панель для каждой строки матрицы. Высота каждой панели является суммой элементов в строке.

y = [2 2 3; 2 5 6; 2 8 9; 2 11 12];
bar(y,'stacked')

Создайте гистограмму с категориальными значениями вдоль оси X. По умолчанию категории отображаются в алфавитном порядке.

c = categorical({'apples','pears','oranges'});
prices = [1.23 0.99 2.3];
bar(c,prices)

Создайте фигуру с двумя подграфиками. В верхнем подграфике постройте гистограмму. В более низком подграфике постройте горизонтальный стек тех же данных.

y = [1 2 3; 4 5 6];
ax1 = subplot(2,1,1);
bar(ax1,y)

ax2 = subplot(2,1,2); 
bar(ax2,y,'stacked')

Создайте гистограмму с помощью красных панелей.

y = [75 91 105 123.5 131 150 179 203 226 249 281.5];
bar(y,'r')

Выберите внутренний цвет панели и цвет контура с помощью триплетов RGB. Установите ширину схемы панели.

y = [75 91 105 123.5 131 150 179 203 226 249 281.5];
bar(y,'FaceColor',[0 .5 .5],'EdgeColor',[0 .9 .9],'LineWidth',1.5)

Управляйте отдельными цветами панели с помощью свойства CData объекта Bar.

Создайте столбчатую диаграмму и присвойте объект Bar переменной. Установите свойство FaceColor объекта Bar к 'flat' так, чтобы график использовал цвета, заданные в свойстве CData. По умолчанию свойство CData предварительно заполняется с матрицей значений цвета RGB по умолчанию. Чтобы изменить конкретный цвет, измените соответствующую строку в матрице. Например, измените цвет второй панели.

b = bar(rand(10,1));
b.FaceColor = 'flat';
b.CData(2,:) = [.5 0 .5];

Создайте столбчатую диаграмму, которая использует цвета палитры путем установки свойства FaceColor на 'flat'. Затем установите свойство CData для каждого объекта Bar к целому числу.

y = [1 3 5; 3 2 7; 3 4 2];
b = bar(y,'FaceColor','flat');
for k = 1:size(y,2)
    b(k).CData = k;
end

Создайте гистограмму с матричным входом с тремя столбцами и возвратите три серийных объекта панели. bar создает один ряд панели для каждого столбца в матрице.

y = [2 4 6; 3 4 5];
b = bar(y);

Измените свойства для определенного ряда панели путем индексации в объектный массив. Например, измените свойства панелей, представляющих второй столбец y использование b(2). Начиная с R2014b, вы можете использовать запись через точку для того, чтобы задать свойства. Если вы используете более раннюю версию, используйте вместо этого функцию set.

b(2).LineWidth = 2;
b(2).EdgeColor = 'red';

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

свернуть все

x значения, заданные как вектор или матрица. Если x и y являются оба векторами, то они должны быть равной длиной. Если x и y являются оба матрицами, то они должны быть равным размером. Если x является вектором, и y является матрицей, то длина x должна равняться количеству строк в y.

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

Пример: 1:10

Типы данных: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64 | categorical | datetime | duration

y значения, заданные как вектор или матрица.

  • Если y является вектором, то bar чертит одну панель для каждого элемента. Функция bar обрабатывает все векторы как вектор-столбцы.

  • Если y является матрицей, то bar группирует панели согласно строкам в y.

Пример: [10 8 5 7 3 9 1]

Типы данных: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64 | duration

Ширина панели, заданная как часть общего пробела, доступного для каждой панели. Значение по умолчанию 0.8 означает, что ширина панели составляет 80% пробела от предыдущей панели до следующей панели с 10% того пробела на каждой стороне.

Если шириной является 1, то панели в группе касаются друг друга.

Пример: 0.5

Типы данных: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

Стиль группы панели, заданный одним из этих значений.

СтильЦель

'grouped'

Отобразите одну группу для каждой строки в y.

  • Если y является матрицей m на n, то bar отображает m группы n вертикальных панелей, где m является количеством строк, и n является количеством столбцов в y.

  • Если y является вектором длины n, то bar отображает одну группу n панелей. Функция bar обрабатывает все векторы как вектор-столбцы.

'stacked'

Отобразите одну панель для каждой строки в y.

  • Если y является матрицей m на n, то bar отображает m панели, где каждая высота панели является суммой элементов в строке. Каждая панель является разноцветной. Цвета соответствуют отличным элементам и показывают относительный вклад, который каждый элемент строки делает к полной сумме.

  • Если y является вектором длины n, то bar отображает n панели. Функция bar обрабатывает все векторы как вектор-столбцы.

'histc'

Отобразите график в формате гистограммы, в котором панели касаются друг друга. Эта опция создает объект Patch вместо объекта Bar. Вы не можете задать аргументы пары "имя-значение" при использовании этой опции.

'hist'

Отобразите график в формате гистограммы, но сосредоточьте каждую панель по x-меткам-деления, вместо того, чтобы заставить панели охватить x-метки-деления, как опция histc делает. Эта опция создает объект Patch вместо объекта Bar. Вы не можете задать аргументы пары "имя-значение" при использовании этой опции.

Цвет панели, заданный как один из цветов в этой таблице.

ЦветЦвет
'b'Синий
'r'Красный
'g'Зеленый
'c'Голубой
'm'Пурпурный
'y'Желтый
'k'Черный
'w'Белый

Объект осей. Если вы не задаете оси, то bar использует текущую систему координат для гистограммы.

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

Укажите необязательные аргументы в виде пар ""имя, значение"", разделенных запятыми. Имя (Name) — это имя аргумента, а значение (Value) — соответствующее значение. Name должен появиться в кавычках. Вы можете задать несколько аргументов в виде пар имен и значений в любом порядке, например: Name1, Value1, ..., NameN, ValueN.

Пример: 'EdgeColor','g' задает зеленую схему вокруг панелей.

Свойства Bar, перечисленные здесь, являются только подмножеством. Для полного списка смотрите Свойства панели.

Примечание

Вы не можете задать пары Name,Value при использовании 'hist' или параметров стиля группы панели 'histc'.

Цвет контура, заданный как 'flat', триплет RGB, шестнадцатеричный цветовой код, название цвета или краткое название. Если существует 150 панелей, или меньше, значением по умолчанию является [0 0 0], который соответствует черный. Если существует больше чем 150 панелей, значением по умолчанию является 'none'.

Начиная в R2017b, опция 'flat' использует значения CData, чтобы окрасить ребра. В предыдущих релизах опция 'flat' окрасила ребра с помощью цветов из палитры.

Для пользовательского цвета задайте триплет RGB или шестнадцатеричный цветовой код.

  • Триплет RGB представляет собой трехэлементный вектор-строку, элементы которого определяют интенсивность красных, зеленых и синих компонентов цвета. Интенсивность должны быть в диапазоне [0,1]; например, [0,4 0,6 0,7].

  • Шестнадцатеричный цветовой код является вектором символов или скаляром строки, который запускается с символа хеша (#), сопровождаемый тремя или шестью шестнадцатеричными цифрами, которые могут колебаться от 0 до F. Значения не являются чувствительными к регистру. Таким образом цветовые коды '#FF8800', '#ff8800', '#F80' и '#f80' эквивалентны.

Кроме того, вы можете задать имена некоторых простых цветов. Эта таблица приводит опции именованного цвета, эквивалентные триплеты RGB и шестнадцатеричные цветовые коды.

Название цветаКраткое названиеТриплет RGBШестнадцатеричный цветовой кодВнешний вид
'red''r'[1 0 0]'#FF0000'

'green''g'[0 1 0]'#00FF00'

'blue''b'[0 0 1]'#0000FF'

'cyan' 'c'[0 1 1]'#00FFFF'

'magenta''m'[1 0 1]'#FF00FF'

'yellow''y'[1 1 0]'#FFFF00'

'black''k'[0 0 0]'#000000'

'white''w'[1 1 1]'#FFFFFF'

'none'Не применяетсяНе применяетсяНе применяетсяНет цвета

Вот являются триплеты RGB и шестнадцатеричные цветовые коды для цветов по умолчанию использованием MATLAB® во многих типах графиков.

Триплет RGBШестнадцатеричный цветовой кодВнешний вид
[0 0.4470 0.7410]'#0072BD'

[0.8500 0.3250 0.0980]'#D95319'

[0.9290 0.6940 0.1250]'#EDB120'

[0.4940 0.1840 0.5560]'#7E2F8E'

[0.4660 0.6740 0.1880]'#77AC30'

[0.3010 0.7450 0.9330]'#4DBEEE'

[0.6350 0.0780 0.1840]'#A2142F'

Пример: b = bar(1:10,'EdgeColor','red')

Пример: b.EdgeColor = [0 0.5 0.5];

Пример: b.EdgeColor = 'flat';

Пример: b.EdgeColor = '#D2F9A7';

Цвет заливки, заданный как 'flat', триплет RGB, шестнадцатеричный цветовой код, название цвета или краткое название. Опция 'flat' использует значения CData, чтобы окрасить поверхности.

Для пользовательского цвета задайте триплет RGB или шестнадцатеричный цветовой код.

  • Триплет RGB представляет собой трехэлементный вектор-строку, элементы которого определяют интенсивность красных, зеленых и синих компонентов цвета. Интенсивность должны быть в диапазоне [0,1]; например, [0,4 0,6 0,7].

  • Шестнадцатеричный цветовой код является вектором символов или скаляром строки, который запускается с символа хеша (#), сопровождаемый тремя или шестью шестнадцатеричными цифрами, которые могут колебаться от 0 до F. Значения не являются чувствительными к регистру. Таким образом цветовые коды '#FF8800', '#ff8800', '#F80' и '#f80' эквивалентны.

Кроме того, вы можете задать имена некоторых простых цветов. Эта таблица приводит опции именованного цвета, эквивалентные триплеты RGB и шестнадцатеричные цветовые коды.

Название цветаКраткое названиеТриплет RGBШестнадцатеричный цветовой кодВнешний вид
'red''r'[1 0 0]'#FF0000'

'green''g'[0 1 0]'#00FF00'

'blue''b'[0 0 1]'#0000FF'

'cyan' 'c'[0 1 1]'#00FFFF'

'magenta''m'[1 0 1]'#FF00FF'

'yellow''y'[1 1 0]'#FFFF00'

'black''k'[0 0 0]'#000000'

'white''w'[1 1 1]'#FFFFFF'

'none'Не применяетсяНе применяетсяНе применяетсяНет цвета

Вот являются триплеты RGB и шестнадцатеричные цветовые коды для цветов по умолчанию использованием MATLAB во многих типах графиков.

Триплет RGBШестнадцатеричный цветовой кодВнешний вид
[0 0.4470 0.7410]'#0072BD'

[0.8500 0.3250 0.0980]'#D95319'

[0.9290 0.6940 0.1250]'#EDB120'

[0.4940 0.1840 0.5560]'#7E2F8E'

[0.4660 0.6740 0.1880]'#77AC30'

[0.3010 0.7450 0.9330]'#4DBEEE'

[0.6350 0.0780 0.1840]'#A2142F'

Начиная в R2017b, значением по умолчанию является триплет RGB из свойства ColorOrder осей. В предыдущих релизах значением по умолчанию был 'flat', и цвета были основаны на палитре.

Пример: b = bar(1:10,'FaceColor','red')

Пример: b.FaceColor = [0 0.5 0.5];

Пример: b.FaceColor = 'flat';

Пример: b.FaceColor = '#D2F9A7';

Цветные данные, заданные как одно из этих значений:

  • Триплет RGB — Одно значение цвета RGB применяется ко всем панелям.

  • Матрица с тремя столбцами — Один цвет на панель. Каждая строка в матрице задает триплет RGB для конкретной панели.

  • Скаляр — Один цвет применяется ко всем панелям, куда цвет прибывает из палитры.

  • Вектор — Один цвет на панель. Цвета прибывают из палитры.

По умолчанию, когда вы создаете столбчатую диаграмму, свойство CData содержит матрицу с тремя столбцами триплетов RGB. Можно изменить цвет для конкретной панели путем изменения соответствующей строки в матрице.

Это свойство применяется только, когда свойство FaceColor или EdgeColor установлено в 'flat'.

Пример

Измените цвет для конкретной панели путем установки свойства FaceColor на 'flat'. Затем измените соответствующую строку в матрице CData к новому триплету RGB. Например, измените цвет второй панели.

b = bar(1:10,'FaceColor','flat');
b.CData(2,:) = [0 0.8 0.8];

Базовое значение, заданное как значение числового скаляра.

Базовое значение, которое вы задаете, применяется или к оси X или к оси Y в зависимости от ориентации столбчатой диаграммы. Если вы изменяете ориентацию столбчатой диаграммы от вертикального до горизонтали, или наоборот, базовое значение может измениться. Установите свойство BaseValue после установки свойства Horizontal.

Стиль линии основ панели, заданных как один из стилей линии в этой таблице.

Стиль линииСтиль линииПолучившаяся строка
'-'Сплошная линия

'--'Пунктирная линия

':'Пунктирная линия

'-.'Штрих-пунктирная линия

'none'Никакая строкаНикакая строка

Ширина основ панели, заданных как положительное значение в модулях точки. Один пункт равен 1/72 дюйма.

Пример: 1.5

Типы данных: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

Выходные аргументы

свернуть все

Объекты Bar. Используйте элементы в b, чтобы получить доступ и изменить свойства определенного объекта Bar после того, как он будет создан.

Расширенные возможности

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