ScatterHistogramChart Properties

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

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

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

Метки

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

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

Пример: s = scatterhistogram (__, 'Заголовок', 'Мой Текст заголовка')

Примеры. Заголовок = 'мой текст заголовка'

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

Пример: s = scatterhistogram (__, 'XLabel', 'Моя Метка')

Примеры. XLabel = 'моя метка'

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

Пример: s = scatterhistogram (__, 'YLabel', 'Моя Метка')

Примеры. YLabel = 'моя метка'

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

Пример: s = scatterhistogram (__, 'LegendTitle', 'Мой Текст заголовка')

Примеры. LegendTitle = 'мой текст заголовка'

Гистограммы

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

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

Заданное значениеОписание
скалярЗначение является количеством интервалов для гистограмм x и y.
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)

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

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

Заданное значениеОписание
скалярЗначение является шириной интервала для гистограмм x и y.
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)

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

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

Пример: s = scatterhistogram (__, 'XHistogramDirection', 'вниз')

Примеры. XHistogramDirection = 'вниз'

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

Пример: s = scatterhistogram (__, 'YHistogramDirection', 'оставленный')

Примеры. YHistogramDirection = 'оставленный'

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

DisplayStyle Описание
лестницаОтобразите ступенчатый график, который показывает схему гистограммы, не заполняя панели.
панельОтобразите столбиковую диаграмму гистограммы.
'smooth'Отобразите сглаженный график, сгенерированный через оценки плотности ядра. Эта опция требует Статистики и Машинного обучения лицензия Toolbox™.

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

Пример: s = scatterhistogram (__, 'HistogramDisplayStyle', 'сглаженный')

Примеры. HistogramDisplayStyle = 'панель'

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

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

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

Выберите среди этих опций стиля линии.

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

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

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

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

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

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

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

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

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

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

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

Примеры. 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 (__, 'Цвет', {'синий', 'зеленый', красный'})

Примеры. Цвет = [.5 0 1; 0.5.5]

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

Пример: s = scatterhistogram (__, 'Имя шрифта', 'Cambria')

Примеры. FontName = 'Cambria'

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

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

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

Примеры. FontSize = 12

Маркеры

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

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

  • Вектор символа, определяющий стиль маркера

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

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

ЗначениеОписание
OКруг
'+'Знак «плюс»
'*'Звездочка
'.'Точка
XКрест
square' или 's'Квадрат
'diamond' или 'd'Ромб
'^'Треугольник, направленный вверх
VНисходящий треугольник
'>'Треугольник, указывающий вправо
'<'Треугольник, указывающий влево
pentagram' или 'p'Пятиконечная звезда (пентаграмма)
'hexagram' or 'h'Шестиконечная звезда (гексаграмма)
'none'Никакие маркеры

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

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

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

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

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

Примеры. MarkerSize = 40

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

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

Примеры. MarkerFilled = 'off'

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

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

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

Размещение

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

Местоположение графика рассеивания, заданного как одна из этих опций.

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

Пример: s = scatterhistogram (__, 'ScatterPlotLocation', 'Северо-восток')

Примеры. ScatterPlotLocation = 'Юго-восток'

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

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

Примеры. ScatterPlotProportion = 0.6

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

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

В легенде scatterhistogram отображает названия группы в порядке их первого выступления в GroupData.

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

Примеры. LegendVisible = 'off'

Положение

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

Свойство Position содержать постоянный во время изменяет размер операций, заданных как 'outerposition' или 'innerposition'. Значение по умолчанию 'outerposition' означает, что свойство OuterPosition остается постоянным. Значение свойства InnerPosition может измениться, когда родительский контейнер изменяет размер, изменения данных или изменение меток.

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

Примеры. 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.

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

МодулиОписание
'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 автоматически обновляет к соответствующим значениям.

Примечание

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

Примеры. XVariable = 'Ускорение' задает переменную под названием 'Ускорение'.

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

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

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

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

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

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

Примечание

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

Примеры. YVariable = 'Лошадиная сила' задает переменную под названием 'Лошадиная сила'.

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

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

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

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

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

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

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

Примечание

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

Примеры. GroupVariable = 'Источник'

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

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

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

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

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

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

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

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

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

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

Примеры. GroupData = {'синий', 'зеленый', 'зеленый', 'синий', 'зеленый'}

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

Примеры. XLimits = категориальный ({'синий', 'зеленый'})

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

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

Примеры. YLimits = категориальный ({'синий', 'зеленый'})

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

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

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

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

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

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

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

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

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

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

Представленный в R2018b

Была ли эта тема полезной?