Свойства ScatterHistogramChart

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

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

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

Метки

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

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

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

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

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

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

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

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

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

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

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

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

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

Гистограммы

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

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

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

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

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

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

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

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

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

scatterhistogram использует аргумент пары "имя-значение" 'BinMethod','auto' histogram, чтобы определить NumBins по умолчанию и значения BinWidths. Значениями 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'

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

DisplayStyle Описание
'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
'красный' или 'r'Красный[1 0 0]
'green' или 'g'Зеленый[0 1 0]
'blue' или 'b'Синий[0 0 1]
'yellow' или 'y'Желтый[1 1 0]
'пурпурный' или 'm'Пурпурный[1 0 1]
'голубой' или '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' or '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. Значение 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' или 'innerposition'. Значение по умолчанию 'outerposition' означает, что свойство OuterPosition остается постоянным. Значение свойства InnerPosition может измениться, когда родительский контейнер изменяет размер, изменения данных или изменение меток.

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

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

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

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

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

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

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

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

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

Модули положения, заданные как одно из этих значений.

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

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

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

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

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

'pixels'.

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

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

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

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

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

Состояние объектной видимости, заданной как одно из этих значений:

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

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

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

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

Таблица Source, заданная как таблица.

Можно составить таблицу от переменных рабочей области с помощью функции 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 - ось, заданная как числовой векторный или категориальный массив.

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

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

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

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

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

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

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

Если вы используете табличные данные, вы не можете установить это свойство. Значения 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]

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

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

Родительский контейнер, заданный как фигура, панель или объект вкладки.

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

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

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

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

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

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

Введенный в R2018b

Для просмотра документации необходимо авторизоваться на сайте