ScatterHistogramChart Properties

Управляйте гистограммой рассеяния графика внешним видом и поведением

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

s = scatterhistogram(rand(10,1),rand(10,1));
s.Title = 'My Title';

Метки

расширить все

Заголовок графика, заданный как вектор символов, строковые массивы, массив ячеек из векторов символов или категориальный массив. Заголовок графика по умолчанию отсутствует.

Чтобы создать заголовок мультилинии, задайте строковые массивы или массив ячеек из векторов символов. Каждый элемент массива соответствует линии текста.

Если вы задаете заголовок как категориальный массив, MATLAB® использует значения в массиве, а не категории.

Пример: s = scatterhistogram(__,'Title','My Title Text')

Пример: s.Title = 'My Title Text'

Пример: s.Title = {'My','Title'}

Метка для x -оси, заданная как вектор символов, строковые массивы, массив ячеек из векторов символов или категориальный массив. Использование '' при отсутствии метки.

Чтобы создать многострочную метку, задайте строковые массивы или массив ячеек из векторов символов. Каждый элемент массива соответствует линии текста.

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

Пример: s = scatterhistogram(__,'XLabel','My Label')

Пример: s.XLabel = 'My Label'

Пример: s.XLabel = {'My','Label'}

Метка для y -оси, заданная как вектор символов, строковые массивы, массив ячеек из векторов символов или категориальный массив. Использование '' при отсутствии метки.

Чтобы создать многострочную метку, задайте строковые массивы или массив ячеек из векторов символов. Каждый элемент массива соответствует линии текста.

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

Пример: s = scatterhistogram(__,'YLabel','My Label')

Пример: s.YLabel = 'My Label'

Пример: s.YLabel = {'My','Label'}

Заголовок легенды, заданный как вектор символов, строковые массивы, массив ячеек векторов символов или категориальный массив. Использование '' за отсутствие заголовка.

Чтобы создать заголовок мультилинии, задайте строковые массивы или массив ячеек из векторов символов. Каждый элемент массива соответствует линии текста.

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

Пример: s = scatterhistogram(__,'LegendTitle','My Title Text')

Пример: s.LegendTitle = 'My Title Text'

Пример: s.LegendTitle = {'My','Title'}

Гистограммы

расширить все

Количество интервалов гистограммы, заданное как положительный целочисленный скаляр, 2 на 1 положительный целочисленный вектор или 2-байт- n положительная целочисленная матрица, где n количество групп в GroupData.

Заданное значениеОписание
скалярЗначение является количеством интервалов для x и y гистограмм.
Вектор 2 на 1Первое значение является количеством интервалов для x данных, а второе значение - количеством интервалов для y данных.
2-by- n матрицаThe (1,j) значение является количеством интервалов для гистограммы x данных, которая находится в jth group. Точно так же (2,j) значение является количеством интервалов для гистограммы y данных, которая находится в jth group.

scatterhistogram использует 'BinMethod','auto' Аргумент пары "имя-значение" из histogram для определения NumBins по умолчанию и BinWidths значения.

Вы не можете изменить NumBins для категориальных данных.

Пример: s = scatterhistogram(__,'NumBins',20)

Пример: s.NumBins = [10; 15]

Интервал гистограммы, заданная как положительный скаляр, 2 на 1 положительный вектор или 2 by n положительная матрица, где n количество групп в GroupData.

Заданное значениеОписание
скалярЗначение является шириной интервала для x и y гистограмм.
Вектор 2 на 1Первое значение является шириной интервала для данных x, а второе значение - шириной интервала для данных y.
2-by- n матрицаThe (1,j) значение является шириной интервала для гистограммы x данных, которая находится в jth group. Точно так же (2,j) значение является шириной интервала для гистограммы y данных, которая находится в jth group.

scatterhistogram использует 'BinMethod','auto' Аргумент пары "имя-значение" из histogram для определения NumBins по умолчанию и BinWidths значения. The BinWidths значения для категориальных данных всегда 0.

Если вы задаете BinWidths, затем scatterhistogram игнорирует NumBins значение.

Пример: s = scatterhistogram(__,'BinWidths',0.5)

Пример: s.BinWidths = [1.5; 2]

Направление гистограмм данных x, заданное как 'up' или 'down'. Если на XHistogramDirection значение 'up'затем гистограммы x данных имеют столбцы, направленные вверх. Если на XHistogramDirection значение 'down'затем гистограммы x данных имеют столбцы, направленные вниз.

Пример: s = scatterhistogram(__,'XHistogramDirection','down')

Пример: s.XHistogramDirection = 'down'

Направление гистограмм данных y, заданное как 'right' или 'left'. Если на YHistogramDirection значение 'right'затем гистограммы y данных имеют полосы, направленные вправо. Если на YHistogramDirection значение 'left'затем гистограммы y данных имеют полосы, направленные влево.

Пример: s = scatterhistogram(__,'YHistogramDirection','left')

Пример: s.YHistogramDirection = 'left'

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

Стиль отображенияОписание
'stairs'Отобразите ступенчатый график, который показывает контур гистограммы без заполнения полос.
'bar'Отобразите гистограмму столбиковой диаграммы.
'smooth'Отобразите плавный график, сгенерированный через оценки плотности ядра. Для этой опции требуется лицензия Statistics and Machine Learning Toolbox™.

scatterhistogram использует 'pdf' тип нормализации для генерации гистограмм. Для получения дополнительной информации смотрите 'Normalization' Аргумент пары "имя-значение" из histogram.

Пример: s = scatterhistogram(__,'HistogramDisplayStyle','smooth')

Пример: s.HistogramDisplayStyle = 'bar'

Стиль линии гистограммы, заданный в одной из следующих форм:

  • Вектор символов, обозначающий один стиль линии

  • Строковые массивы или массив ячеек векторов символов, обозначающих одну или несколько стили линии

Выберите один из следующих опций стиля линии.

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

'--'Штриховая линия

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

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

'none'Нет линииНет линии

Когда общее количество групп превышает количество заданных стилей линии, scatterhistogram переходит к указанным стилям линии.

Пример: s = scatterhistogram(__,'LineStyle',':')

Пример: s.LineStyle = {':','-','-.'}

Гистограмма ширины линии, заданная как положительная скалярная величина или положительный вектор в точках. По умолчанию, scatterhistogram задает ширину линии 0.5 к каждому графику гистограммы линии.

Когда общее количество групп превышает количество заданных ширин линии, scatterhistogram переходит через заданные ширины линии.

Пример: s = scatterhistogram(__,'LineWidth',0.75)

Пример: s.LineWidth = [0.5 0.75 0.5]

Цвет и шрифт

расширить все

Группируйте цвет, заданный в одной из следующих форм:

  • Вектор символов, обозначающий название цвета.

  • Строковые массивы или массив ячеек векторов символов, обозначающих один или несколько названия цвета.

  • Трехколоночная матрица значений RGB в области значений [0,1]. Три столбца представляют значение R, значение G и значение B, соответственно.

Выберите один из этих предопределенных цветов и их эквивалентных триплетов RGB.

ОпцияОписаниеЭквивалентный триплет RGB
'red' или 'r'Красный[1 0 0]
'green' или 'g'Зеленый[0 1 0]
'blue' или 'b'Синий[0 0 1]
'yellow' или 'y'Желтый[1 1 0]
'magenta' или 'm'Пурпурный[1 0 1]
'cyan' или 'c'Голубой[0 1 1]
'white' или 'w'Белый[1 1 1]
'black' или 'k'Черный[0 0 0]

По умолчанию, scatterhistogram присваивает максимум семь уникальных групповых цветов. Когда общее количество групп превышает количество заданных цветов, scatterhistogram переходит через указанные цвета.

Пример: s = scatterhistogram(__,'Color',{'blue','green',red'})

Пример: s.Color = [0 0 1; 0 0.5 0.5; 0.5 0.5 0.5]

Название шрифта, заданная как поддерживаемая системой название шрифта. Тот же шрифт используется для заголовка, подписей по осям, заголовка легенды и имен групп. Шрифт по умолчанию зависит от конкретной операционной системы и локали.

Пример: s = scatterhistogram(__,'FontName','Cambria')

Пример: s.FontName = 'Cambria'

Размер шрифта, заданный как скалярное значение. FontSize - то же самое для заголовка, подписей по осям, заголовка легенды и имен групп. Размер шрифта по умолчанию зависит от конкретной операционной системы и локали.

Когда вы корректируете размер элементов графика, программа автоматически обновляет размер шрифта. Однако изменение FontSize свойство отключает автоматическое изменение размера.

Пример: s = scatterhistogram(__,'FontSize',12)

Пример: s.FontSize = 12

Маркеры

расширить все

Символ маркера для каждой группы графиков поля точек, заданный в одной из следующих форм:

  • Вектор символов, обозначающий стиль маркера

  • Строковые массивы или массив ячеек векторов символов, обозначающих один или несколько стилей маркеров

Выберите среди этих опций маркера.

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

По умолчанию, scatterhistogram присваивает символ маркера 'o' для каждой группы на графике поля точек. Когда общее количество групп превышает количество заданных символов, scatterhistogram переходит через указанные символы.

Пример: s = scatterhistogram(__,'MarkerStyle','x')

Пример: s.MarkerStyle = {'x','o'}

Размер маркера для каждой группы графиков поля точек, заданный как неотрицательный скалярный или неотрицательный вектор со значениями, измеренными в точках. По умолчанию, scatterhistogram присваивает 36 как размер маркера для каждой группы на графике поля точек. Когда общее количество групп превышает количество заданных значений, scatterhistogram переходит к заданным значениям.

Пример: s = scatterhistogram(__,'MarkerSize',30)

Пример: s.MarkerSize = 40

Состояние заливки маркера лица, заданное как 'on' или 'off'. Если MarkerFilled установлено в 'on', затем scatterhistogram заполняет интерьер маркеров на графике поля точек. Если MarkerFilled установлено в 'off', затем scatterhistogram оставляет внутреннюю часть маркеров графика поля точек пустой.

Пример: s = scatterhistogram(__,'MarkerFilled','off')

Пример: s.MarkerFilled = 'off'

Прозрачность маркера для каждой группы графика поля точек, заданная в виде числового скаляра или числового вектора со значениями от 0 до 1. Значения ближе к 0 задают более прозрачные маркеры, а значения ближе к 1 задают более непрозрачные маркеры. По умолчанию, scatterhistogram назначает MarkerAlpha значение 1 ко всем маркерам в график поля точек.

Пример: s = scatterhistogram(__,'MarkerAlpha',0.75)

Пример: s.MarkerAlpha = [0.2 0.7 0.4]

Размещение

расширить все

Расположение графика поля точек, заданное как один из следующих опций.

МестоположениеОписание
'SouthWest'Постройте гистограммы выше и справа от графика поля точек.
'SouthEast'Постройте гистограммы выше и слева от графика поля точек.
'NorthEast'Постройте гистограммы ниже и слева от графика поля точек.
'NorthWest'Постройте гистограммы ниже и справа от графика поля точек.

Пример: s = scatterhistogram(__,'ScatterPlotLocation','NorthEast')

Пример: s.ScatterPlotLocation = 'SouthEast'

Отношение длины графика поля точек к общей длине диаграммы, заданное как числовой скаляр между 0 и 1. The ScatterPlotProportion значение применяется к обоим x и y осей.

Пример: s = scatterhistogram(__,'ScatterPlotProportion',0.7)

Пример: s.ScatterPlotProportion = 0.6

Состояние видимости легенды, заданное как 'on' или 'off'. Задайте LegendVisible на 'on' отображение легенды или 'off' чтобы скрыть легенду.

Если GroupData пуст ([]) или содержит одну группу, затем scatterhistogram не отображает легенду. В противном случае, scatterhistogram отображает легенду по умолчанию, если только легенда не перекрывает график поля точек или маргинальные гистограммы.

В легенде, scatterhistogram отображает имена групп в порядке их первого внешнего вида в GroupData.

Пример: s = scatterhistogram(__,'LegendVisible','on')

Пример: s.LegendVisible = 'off'

Положение

расширить все

Свойство Position, которое остается постоянным при добавлении, удалении или изменении украшений, задается как одно из следующих значений:

  • 'outerposition' - The OuterPosition свойство остается постоянным, когда вы добавляете, удаляете или изменяете украшения, такие как заголовок или подпись по осям. Если необходимы какие-либо корректировки положения, MATLAB настраивает InnerPosition свойство.

  • 'innerposition' - The InnerPosition свойство остается постоянным, когда вы добавляете, удаляете или изменяете украшения, такие как заголовок или подпись по осям. Если необходимы какие-либо корректировки положения, MATLAB настраивает OuterPosition свойство.

Этот рисунок показывает innerposition и outerposition определения для ScatterHistogramChart.

Пример: s.PositionConstraint = 'outerposition'

Примечание

Установка этого свойства не влияет, когда родительский контейнер является TiledChartLayout.

Внутренний размер и положение графика в родительском контейнере (обычно это рисунок, панель или вкладка), заданные как четырехэлементный числовой вектор формы [left bottom width height]. Внутреннее положение включает только график поля точек.

  • The left и bottom элементы определяют расстояние от нижнего левого угла контейнера до нижнего левого угла графика поля точек.

  • The width и height элементы являются размерностями графика поля точек.

Для рисунка смотрите PositionConstraint.

Примечание

Установка этого свойства не влияет, когда родительский контейнер является TiledChartLayout.

Внешний размер и положение полной гистограммы рассеяния графика в родительском контейнере (обычно это рисунок, панель или вкладка), заданные как четырехэлементный числовой вектор формы [left bottom width height]. Значение по умолчанию [0 0 1 1] включает в себя всю внутреннюю часть контейнера.

Для рисунка смотрите PositionConstraint.

Примечание

Установка этого свойства не влияет, когда родительский контейнер является TiledChartLayout.

Внутренний размер и положение графика в родительском контейнере (обычно это рисунок, панель или вкладка), заданные как четырехэлементный числовой вектор формы [left bottom width height]. Это свойство эквивалентно свойству InnerPosition.

Примечание

Установка этого свойства не влияет, когда родительский контейнер является TiledChartLayout.

Позиционные модули, заданные в качестве одного из следующих значений.

UnitsОписание
'normalized' (по умолчанию)Нормированный относительно контейнера, который обычно является рисунком или панелью. Нижний левый угол контейнера сопоставлен с (0,0), и правый верхний угол преобразуется в (1,1).
'inches'Дюймы.
'centimeters'Сантиметры.
'characters'

На основе шрифта uicontrol по умолчанию графического корневого объекта:

  • Ширина символа = ширина буквы x.

  • Высота символа = расстояние между базовыми линиями двух строк текста.

'points'Опечатки точек. Одна точка равна 1/72 дюйма.
'pixels'

Пиксели.

Начиная с R2015b, расстояния в пикселях не зависят от вашего системного разрешения в Windows® и системы Macintosh:

  • В системах Windows пиксель составляет 1/96 дюйма.

  • В системах Macintosh пиксель составляет 1/72 дюйма.

На Linux® систем, размер пикселя определяется вашим системным разрешением.

При определении модулей как пары "имя-значение" во время создания объекта необходимо задать Units свойство перед указанием свойств, которые вы хотите использовать эти модули, таких как OuterPosition.

Опции размещения, заданные как TiledChartLayoutOptions или GridLayoutOptions объект. Это свойство полезно, когда график находится либо в размещении мозаичной диаграммы, либо в размещении сетки.

Чтобы разместить график в сетке размещения мозаичной диаграммы, установите Tile и TileSpan свойства на TiledChartLayoutOptions объект. Для примера рассмотрим плиточный график размещения 3 на 3. Размещение имеет сетку плиток в центре, и четыре плитки по внешним краям. На практике сетка невидима, и внешние плитки не занимают пространства, пока вы не заполняете их осями или графиками.

Diagram of a 3-by-3 tiled chart layout.

Этот код помещает график c в третьей плитке сетки..

c.Layout.Tile = 3;

Чтобы график охватывал несколько мозаик, задайте TileSpan свойство как двухэлементный вектор. Для примера этот график охватывает 2 строки и 3 столбцы плитки.

c.Layout.TileSpan = [2 3];

Чтобы поместить график в один из окружающих плиток, задайте Tile свойство как 'north', 'south', 'east', или 'west'. Для примера установите значение 'east' помещает график в плитку справа от сетки.

c.Layout.Tile = 'east';

Чтобы поместить график в размещение в приложении, задайте это свойство как GridLayoutOptions объект. Для получения дополнительной информации о работе с размещениями сетки в приложениях, см. uigridlayout.

Если график не является дочерним элементом макета мозаичной диаграммы или макета сетки (например, если он является дочерним элементом фигуры или панели), это свойство пустое и не влияет.

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

  • 'on' - Отобразите ScatterHistogramChart объект.

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

Данные и пределы

расширить все

Исходная таблица, заданная как таблица.

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

Примечание

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

Табличная переменная для x-оси, заданная в одной из следующих форм:

  • Вектор символов или строковый скаляр, указывающий на одно из имен переменных

  • Числовой скаляр, указывающий индекс табличной переменной

  • Логический вектор, содержащий один true элемент

Значения, сопоставленные с табличной переменной, должны быть числового типа или categorical.

Если вы задаете XVariable значение свойства, затем XData свойство автоматически обновляется до соответствующих значений.

Примечание

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

Пример: s.XVariable = 'Acceleration' задает переменную с именем 'Acceleration'.

Табличная переменная для y-оси, заданная в одной из следующих форм:

  • Вектор символов или строковый скаляр, указывающий на одно из имен переменных

  • Числовой скаляр, указывающий индекс табличной переменной

  • Логический вектор, содержащий один true элемент

Значения, сопоставленные с табличной переменной, должны быть числового типа или categorical.

Если вы задаете YVariable значение свойства, затем YData свойство автоматически обновляется до соответствующих значений.

Примечание

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

Пример: s.YVariable = 'Horsepower' задает переменную с именем 'Horsepower'.

Табличная переменная для группировки данных, заданная в одной из следующих форм:

  • Вектор символов или строковый скаляр, указывающий на одно из имен переменных

  • Числовой скаляр, указывающий индекс табличной переменной

  • Логический вектор, содержащий один true элемент

Значения, сопоставленные с вашими табличными переменными, должны сформировать числовой вектор, логический вектор, категориальный массив, строковые массивы или массив ячеек векторов символов.

GroupVariable разделяет данные на XVariable и YVariable в уникальные группы. Каждая группа имеет цвет по умолчанию и независимую гистограмму на каждой оси. В легенде, scatterhistogram отображает имена групп в порядке их первого внешнего вида в GroupData.

Когда вы задаете переменную группы, MATLAB обновляет GroupData значения свойств.

Примечание

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

Пример: s.GroupVariable = 'Origin'

Значения, появляющиеся вдоль оси x, заданные как числовой вектор или категориальный массив.

Если вы используете табличные данные, вы не можете задать это свойство. The XData значения автоматически заполняются на основе табличной переменной, выбранной с помощью XVariable свойство.

Пример: s.XData = [0.5 4.3 2.4 5.6 3.4]

Значения, появляющиеся вдоль оси y, заданные как числовой вектор или категориальный массив.

Если вы используете табличные данные, вы не можете задать это свойство. The YData значения автоматически заполняются на основе табличной переменной, выбранной с помощью YVariable свойство.

Пример: s.YData = [0.5 4.3 2.4 5.6 3.4]

Значения групп для графика поля точек и соответствующие маргинальные гистограммы, заданные как числовой вектор, логический вектор, категориальный массив, строковые массивы или массив ячеек из векторов символов.

GroupData разделяет данные на XData и YData в уникальные группы. Каждая группа имеет цвет по умолчанию и независимую гистограмму на каждой оси. В легенде, scatterhistogram отображает имена групп в порядке их первого внешнего вида в GroupData.

Если вы используете табличные данные, вы не можете задать это свойство. The GroupData значения автоматически заполняются на основе табличной переменной, выбранной с помощью GroupVariable свойство.

Пример: s.GroupData = [1 2 1 3 2 1 3]

Пример: s.GroupData = {'blue','green','green','blue','green'}

x -границы оси, заданные как двухэлементный числовой вектор или двухэлементный категориальный вектор. По умолчанию значения получают из XData значения.

Пример: s.XLimits = categorical({'blue','green'})

Пример: s.XLimits = [10 50]

y -границы оси, заданные как двухэлементный числовой вектор или двухэлементный категориальный вектор. По умолчанию значения получают из YData значения.

Пример: s.YLimits = categorical({'blue','green'})

Пример: s.YLimits = [10 50]

Родитель/ребенок

расширить все

Родительский контейнер, заданный как Figure, Panel, Tab, TiledChartLayout, или GridLayout объект.

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

  • 'on' - указатель на объект всегда отображается.

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

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

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

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

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

расширить все

Не рекомендуемый запуск в R2020a

Введенный в R2018b