exponenta event banner

Свойства поз-диаграммы

Внешний вид и поведение диаграммы поля управления

BoxChart свойства управляют внешним видом и поведением BoxChart объект. Изменяя значения свойств, можно изменять некоторые аспекты объекта.

Для запроса и задания свойств можно использовать точечную нотацию. Например, можно изменить цвет поля диаграммы:

b = boxchart(rand(10,1));
b.BoxFaceColor = [0 0.5 0.5];

Отображение данных

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

Относительная ширина отдельных полей, заданная как скаляр в диапазоне [0,1]. Это свойство используется для управления разделением полей. Значение по умолчанию: 0.5, что означает, что расстояние между ящиками равно ширине одного ящика. Если для этого свойства задано значение 1, то соседние коробки могут касаться.

Пример: b = boxchart(rand(10,3),'BoxWidth',0.75)

Пример: b.BoxWidth = 0.75;

Смещение маркера отклонения, указанное как 'on' или 'off'или как числовое или логическое 1 (true) или 0 (false). Значение 'on' эквивалентно true, и 'off' эквивалентно false. Таким образом, можно использовать значение этого свойства в качестве логического значения. Значение сохраняется как логическое значение типа вкл/выкл matlab.lang.OnOffSwitchState.

Если установить JitterOutliers свойство для 'on', то boxchart случайным образом смещает маркеры отклонения вдоль XData направление, чтобы помочь различать отклонения, которые имеют аналогичные ydata значения. Пример см. в разделах Визуализация и поиск отклонений.

Пример: b = boxchart([rand(20,1);2;2;2],'JitterOutliers','on')

Пример: b.JitterOutliers = 'on';

Отображение сравнения медианы, указанное как 'on' или 'off'или как числовое или логическое 1 (true) или 0 (false). Значение 'on' эквивалентно true, и 'off' эквивалентно false. Таким образом, можно использовать значение этого свойства в качестве логического значения. Значение сохраняется как логическое значение типа вкл/выкл matlab.lang.OnOffSwitchState.

Если установить Notch свойство для 'on', то boxchart создает коническую затененную область вокруг каждой разделительной полосы. Бокс-диаграммы, вырезы которых не перекрываются, имеют различные медианы на уровне значимости 5%. Дополнительные сведения см. в разделе Рамочная диаграмма (Рамочный график).

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

Пример: b = boxchart(rand(10,2),'Notch','on')

Пример: b.Notch = 'on';

Ориентация диаграмм полей, указанных как 'vertical' или 'horizontal'. По умолчанию диаграммы полей ориентированы вертикально, так что ydata статистика выравнивается по оси Y. Независимо от ориентации, boxchart сохраняет ydata значения в YData имущества BoxChart объект.

Пример: b = boxchart(rand(10,1),'Orientation','horizontal')

Пример: b.Orientation = 'horizontal';

Цвет и стиль

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

Цвет поля, указанный как триплет RGB, шестнадцатеричный код цвета, имя цвета или короткое имя.

Для пользовательского цвета укажите триплет 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 = boxchart(rand(10,1),'BoxFaceColor','red')

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

Пример: b.BoxFaceColor = '#EDB120';

Как BoxFaceColor установлено свойство, указанное как одно из следующих значений:

  • 'auto' - MATLAB управляет значением BoxFaceColor путем выбора цвета из ColorOrder свойства осей.

  • 'manual' - Вы контролируете значение BoxFaceColor вручную, либо путем указания цвета при создании BoxChart объект или путем установки BoxFaceColor на объекте после его создания.

При изменении значения BoxFaceColor вручную MATLAB изменяет значение BoxFaceColorMode свойство для 'manual'.

Цвет Уискера, указанный как триплет RGB, шестнадцатеричный код цвета, имя цвета или короткое имя.

Для пользовательского цвета укажите триплет 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 = boxchart(rand(10,1),'WhiskerLineColor','r')

Пример: b.WhiskerLineColor = [0.25 0.5 0.5];

Пример: b.WhiskerLineColor = '#A2142F';

Прозрачность заливки поля, заданная как скаляр в диапазоне [0,1]. Значение 1 непрозрачен и 0 является полностью прозрачным. Значения между 0 и 1 полупрозрачные.

Пример: b = boxchart(rand(10,1),'BoxFaceAlpha',0.4)

Пример: b.BoxFaceAlpha = 0.4;

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

Стиль линииОписаниеРезультирующая линия
'-'Сплошная линия

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

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

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

'none'Без строкиБез строки

Пример: b = boxchart(rand(10,1),'WhiskerLineStyle','--')

Пример: b.WhiskerLineStyle = '--';

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

Пример: b = boxchart(rand(10,1),'LineWidth',1.5)

Пример: b.LineWidth = 1.5;

Индекс серии, указанный как целое число, большее или равное 0. Это свойство полезно для переназначения цвета поля (BoxFaceColor) и более яркий цвет (MarkerColor) нескольких BoxChart объекты, чтобы они совпадали друг с другом. По умолчанию SeriesIndex свойство BoxChart объект - это число, соответствующее порядку создания объекта, начиная с 1.

MATLAB использует число для вычисления индекса для назначения цветов при вызове функций печати. Индекс ссылается на строки массива, сохраненного в ColorOrder свойства осей.

MATLAB автоматически обновляет цвет поля или цвет отклонения BoxChart объект при изменении его SeriesIndexили при изменении ColorOrder свойство на осях. Однако для того, чтобы изменения имели какой-либо эффект, должны быть выполнены следующие условия:

  • Либо BoxFaceColorMode или MarkerColorMode имущества BoxChart объект имеет значение 'auto'.

  • SeriesIndex свойство на BoxChart объект больше, чем 0.

  • NextSeriesIndex свойство объекта axes больше, чем 0.

Маркеры

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

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

СтоимостьОписание
'o'Круг
'+'Знак «Плюс»
'*'Звездочка
'.'Пункт
'x'Крест
'_'Горизонтальная линия
'|'Вертикальная линия
'square' или 's'Квадрат
'diamond' или 'd'Алмаз
'^'Треугольник, направленный вверх
'v'Треугольник, направленный вниз
'>'Прямоугольный треугольник
'<'Треугольник, указывающий влево
'pentagram' или 'p'Пятиконечная звезда (пентаграмма)
'hexagram' или 'h'Шестиконечная звезда (гексаграмма)
'none'Без маркеров

Пример: b = boxchart([rand(10,1);2],'MarkerStyle','x')

Пример: b.MarkerStyle = 'x';

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

Пример: b = boxchart([rand(10,1);2],'MarkerSize',8)

Пример: b.MarkerSize = 8;

Цвет отклонения, указанный как триплет RGB, шестнадцатеричный код цвета, имя цвета или короткое имя.

Для пользовательского цвета укажите триплет 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 = boxchart([rand(10,1);2],'MarkerColor','magenta')

Пример: b.MarkerColor = [0.5 0.5 1];

Пример: b.MarkerColor = '#7E2F8E';

Как MarkerColor установлено свойство, указанное как одно из следующих значений:

  • 'auto' - MATLAB управляет значением MarkerColor путем выбора цвета из ColorOrder свойства осей.

  • 'manual' - Вы контролируете значение MarkerColor вручную, либо путем указания цвета при создании BoxChart объект или путем установки MarkerColor на объекте после его создания.

При изменении значения MarkerColor вручную MATLAB изменяет значение MarkerColorMode свойство для 'manual'.

Данные

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

Позиционные данные, указанные как числовой или категориальный вектор.

  • Если YData является вектором, то XData - вектор той же длины, что и YData. XData(i) значение указывает положение диаграммы полей, созданной с помощью YData(i) значение.

  • Если YData является матрицей, то XData - вектор, длина которого равна количеству столбцов в YData. XData(i) значение указывает положение диаграммы полей, созданной с помощью столбца YData(:,i).

По умолчанию XData управляет позициями таблицы полей вдоль x-axis. Однако, когда Orientation значение свойства - 'horizontal', XData значения соответствуют позициям вдоль y-axis.

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

Образец данных, указанный как числовой вектор или матрица.

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

Легенда

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

Метка легенды, заданная как вектор символа или скаляр строки. Легенда не отображается, пока не будет вызван legend команда. Если текст не указан, то legend устанавливает метку с помощью формы 'dataN'.

Это свойство доступно только для чтения.

Элемент управления для включения или исключения объекта из легенды, возвращаемый как Annotation объект. Установить нижележащий IconDisplayStyle к одному из следующих значений:

  • 'on' - Включить объект в легенду (по умолчанию).

  • 'off' - не включать объект в легенду.

Например, чтобы исключить графический объект, go, из набора условных обозначений IconDisplayStyle свойство для 'off'.

go.Annotation.LegendInformation.IconDisplayStyle = 'off';

Можно также управлять элементами легенды с помощью legend функция. Укажите первый входной аргумент в качестве вектора включаемых графических объектов. Если в первом входном аргументе не указан существующий графический объект, он не отображается в легенде. Однако графические объекты, добавленные к осям после создания легенды, появляются в легенде. Рекомендуется создать легенду после создания всех графиков, чтобы избежать дополнительных элементов.

Интерактивность

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

Состояние видимости, указанное как 'on' или 'off'или как числовое или логическое 1 (true) или 0 (false). Значение 'on' эквивалентно true, и 'off' эквивалентно false. Таким образом, можно использовать значение этого свойства в качестве логического значения. Значение сохраняется как логическое значение типа вкл/выкл matlab.lang.OnOffSwitchState.

  • 'on' - Просмотр объекта.

  • 'off' - Скрыть объект, не удаляя его. По-прежнему можно получить доступ к свойствам невидимого объекта.

Содержимое подсказки данных, указанное как DataTipTemplate объект. Можно управлять содержимым, появляющимся в подсказке данных, изменяя свойства нижележащего содержимого. DataTipTemplate объект. Список свойств см. в разделе Свойства DataTipTemplate.

Пример изменения подсказок по данным см. в разделе Создание подсказок по пользовательским данным.

Примечание

DataTipTemplate объект не возвращен findobj или findall, и он не копируется copyobj.

Возможность захвата щелчков мыши, указанных как одно из следующих значений:

  • 'visible' - Захват щелчков мыши при отображении. Visible свойство должно иметь значение 'on' и необходимо щелкнуть на части BoxChart объект, имеющий определенный цвет. Нельзя щелкнуть деталь, для которой свойство цвета имеет значение 'none'. HitTest определяет, BoxChart объект отвечает на клик или если это делает предок.

  • 'none' - Не удается зафиксировать щелчки мыши. Щелкните значок BoxChart объект передает щелчок на объект под ним в текущем виде окна фигуры. HitTest имущества BoxChart объект не имеет эффекта.

Ответ на зафиксированные щелчки мыши, указанный как 'on' или 'off'или как числовое или логическое 1 (true) или 0 (false). Значение 'on' эквивалентно true, и 'off' эквивалентно false. Таким образом, можно использовать значение этого свойства в качестве логического значения. Значение сохраняется как логическое значение типа вкл/выкл matlab.lang.OnOffSwitchState.

  • 'on' - Включить BoxChart объект для захвата щелчков мыши.

  • 'off' - Инициировать обратные вызовы для ближайшего предка BoxChart объект, имеющий один из следующих объектов:

    • A HitTest свойство имеет значение 'on'

    • A PickableParts свойство имеет значение, которое позволяет предку фиксировать щелчки мыши

Примечание

PickableParts определяет, BoxChart объект может захватывать щелчки мыши. Если он не может, то HitTest свойство не имеет эффекта.

Родительский/дочерний

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

Родитель, указан как Axes, Group, или Transform объект.

Дети, возвращенные как пустые GraphicsPlaceholder массив или DataTip массив объектов. Это свойство используется для просмотра списка подсказок по данным, отображаемых на диаграмме.

Невозможно добавить или удалить дочерние элементы с помощью Children собственность. Чтобы добавить дочерний элемент в этот список, установите Parent имущества DataTip объект к объекту диаграммы.

Видимость дескриптора объекта в Children свойство родительского объекта, указанное как одно из следующих значений:

  • 'on' - Дескриптор объекта всегда виден.

  • 'off' - Дескриптор объекта всегда невидим. Этот параметр полезен для предотвращения непреднамеренных изменений другой функцией. Установите HandleVisibility кому 'off' для временного скрытия дескриптора во время выполнения этой функции.

  • 'callback' - Дескриптор объекта виден из обратных вызовов или функций, вызываемых обратными вызовами, но не из функций, вызываемых из командной строки. Этот параметр блокирует доступ к объекту в командной строке, но разрешает доступ к нему функциям обратного вызова.

Если объект не указан в списке Children свойства родительского объекта, то функции, которые получают дескрипторы объектов путем поиска в иерархии объектов или запроса свойств дескрипторов, не могут вернуть его. Примеры таких функций включают get, findobj, gca, gcf, gco, newplot, cla, clf, и close функции.

Дескрипторы скрытых объектов по-прежнему действительны. Установка корня ShowHiddenHandles свойство для 'on' перечисление всех дескрипторов объектов независимо от их HandleVisibility параметр свойства.

Идентификаторы

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

Это свойство доступно только для чтения.

Тип графического объекта, возвращаемого как 'BoxChart'. Это свойство используется для поиска всех объектов данного типа в иерархии печати, например, путем поиска типа с помощью findobj.

Идентификатор объекта, заданный как вектор символа или скаляр строки. Можно указать уникальный Tag для использования в качестве идентификатора объекта. При необходимости доступа к объекту в другом месте кода можно использовать findobj для поиска объекта на основе Tag значение.

Пользовательские данные, указанные как любой массив MATLAB. Например, можно указать скаляр, вектор, матрицу, массив ячеек, символьный массив, таблицу или структуру. Это свойство используется для хранения произвольных данных объекта.

Если вы работаете в App Designer, создайте открытые или частные свойства в приложении для совместного использования данных вместо использования UserData собственность. Дополнительные сведения см. в разделе Общий доступ к данным в приложениях App Designer.

См. также

Представлен в R2020a