binScatterPlot

График поля точек интервалов для длинные массивы

Описание

пример

binScatterPlot(X,Y) создает сгруппированный точечный график данных в X и Y. binScatterPlot функция использует алгоритм автоматического раскладывания, который возвращает интервалы с равномерной областью, выбранной для покрытия области значений элементов в X и Y и выявить базовую форму распределения.

пример

binScatterPlot(X,Y,nbins) задает количество интервалов, используемых в каждой размерности.

пример

binScatterPlot(X,Y,Xedges,Yedges) определяет ребра интервалов в каждой размерности с помощью векторов Xedges и Yedges.

пример

binScatterPlot(X,Y,Name,Value) задает дополнительные опции с одним или несколькими аргументами пары "имя-значение", используя любой из предыдущих синтаксисов. Для примера можно задать 'Color' и действительная опция цвета для изменения цветовой темы графика, или 'Gamma' с помощью положительной скалярной величины для настройки уровня детализации.

h = binScatterPlot(___) возвращает Histogram2 объект. Этот объект используется для просмотра свойств графика.

Примеры

свернуть все

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

При выполнении вычислений на длинные массивы MATLAB ® использует либо параллельный пул (по умолчанию, если у вас есть Parallel Computing Toolbox™), либо локальный сеанс работы с MATLAB. Чтобы запустить пример с использованием локального сеанса работы с MATLAB, когда у вас есть Parallel Computing Toolbox, измените глобальное окружение выполнения с помощью mapreducer функция.

mapreducer(0)

X = tall(randn(1e5,1));
Y = tall(randn(1e5,1));
binScatterPlot(X,Y)
Evaluating tall expression using the Local MATLAB Session:
- Pass 1 of 1: Completed in 1.8 sec
Evaluation completed in 3.4 sec
Evaluating tall expression using the Local MATLAB Session:
- Pass 1 of 1: Completed in 0.28 sec
Evaluation completed in 0.39 sec

Figure contains an axes and other objects of type uicontrol. The axes contains an object of type histogram2.

Получившийся рисунок содержит ползунок для регулировки уровня детализации изображения.

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

При выполнении вычислений на длинные массивы MATLAB ® использует либо параллельный пул (по умолчанию, если у вас есть Parallel Computing Toolbox™), либо локальный сеанс работы с MATLAB. Чтобы запустить пример с использованием локального сеанса работы с MATLAB, когда у вас есть Parallel Computing Toolbox, измените глобальное окружение выполнения с помощью mapreducer функция.

mapreducer(0)

Постройте график сгруппированного точечного графика случайных данных, отсортированных в 100 интервалов в каждой размерности.

X = tall(randn(1e5,1));
Y = tall(randn(1e5,1));
binScatterPlot(X,Y,100)
Evaluating tall expression using the Local MATLAB Session:
- Pass 1 of 1: Completed in 1.1 sec
Evaluation completed in 1.4 sec
Evaluating tall expression using the Local MATLAB Session:
- Pass 1 of 1: Completed in 0.27 sec
Evaluation completed in 0.41 sec

Figure contains an axes and other objects of type uicontrol. The axes contains an object of type histogram2.

Используйте 20 интервалов в размерности X и продолжайте использовать 100 интервалов в размерности Y.

binScatterPlot(X,Y,[20 100])
Evaluating tall expression using the Local MATLAB Session:
- Pass 1 of 1: Completed in 0.2 sec
Evaluation completed in 0.37 sec
Evaluating tall expression using the Local MATLAB Session:
- Pass 1 of 1: Completed in 0.11 sec
Evaluation completed in 0.16 sec

Figure contains an axes and other objects of type uicontrol. The axes contains an object of type histogram2.

Постройте график сгруппированного точечного графика случайных данных с определенными границами интервала. Используйте границы интервала Inf и -Inf для захвата выбросов.

При выполнении вычислений на длинные массивы MATLAB ® использует либо параллельный пул (по умолчанию, если у вас есть Parallel Computing Toolbox™), либо локальный сеанс работы с MATLAB. Чтобы запустить пример с использованием локального сеанса работы с MATLAB, когда у вас есть Parallel Computing Toolbox, измените глобальное окружение выполнения с помощью mapreducer функция.

mapreducer(0)

Создайте сгруппированный точечный график со 100 границ интервала между [-2 2] в каждой размерности. Данные за пределами заданных границ интервала не включаются в график.

X = tall(randn(1e5,1));
Y = tall(randn(1e5,1));
Xedges = linspace(-2,2);
Yedges = linspace(-2,2);
binScatterPlot(X,Y,Xedges,Yedges)
Evaluating tall expression using the Local MATLAB Session:
- Pass 1 of 1: Completed in 1.2 sec
Evaluation completed in 1.6 sec

Figure contains an axes and other objects of type uicontrol. The axes contains an object of type histogram2.

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

Xedges = [-Inf linspace(-2,2) Inf];
Yedges = [-Inf linspace(-2,2) Inf];
binScatterPlot(X,Y,Xedges,Yedges)
Evaluating tall expression using the Local MATLAB Session:
- Pass 1 of 1: Completed in 0.29 sec
Evaluation completed in 0.46 sec

Figure contains an axes and other objects of type uicontrol. The axes contains an object of type histogram2.

Постройте график сгруппированного точечного графика случайных данных, задав 'Color' как 'c'.

При выполнении вычислений на длинные массивы MATLAB ® использует либо параллельный пул (по умолчанию, если у вас есть Parallel Computing Toolbox™), либо локальный сеанс работы с MATLAB. Чтобы запустить пример с использованием локального сеанса работы с MATLAB, когда у вас есть Parallel Computing Toolbox, измените глобальное окружение выполнения с помощью mapreducer функция.

mapreducer(0)

X = tall(randn(1e5,1));
Y = tall(randn(1e5,1));
binScatterPlot(X,Y,'Color','c')
Evaluating tall expression using the Local MATLAB Session:
- Pass 1 of 1: Completed in 1.1 sec
Evaluation completed in 3.6 sec
Evaluating tall expression using the Local MATLAB Session:
- Pass 1 of 1: Completed in 0.21 sec
Evaluation completed in 0.29 sec

Figure contains an axes and other objects of type uicontrol. The axes contains an object of type histogram2.

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

свернуть все

Данные для распределения между интервалами, заданные как отдельные аргументы высоких векторов, матриц или многомерных массивов. X и Y должен быть одинаковым размером. Если X и Y не являются векторами, тогда binScatterPlot рассматривает их как одинарные векторы-столбцы, X(:) и Y(:).

Соответствующие элементы в X и Y задайте x и y координаты 2D данных точек, [X(k),Y(k)]. Базовые типы данных X и Y может быть различным, но binScatterPlot объединяет эти входы в одну N-by- 2 tall matrix доминирующего базового типа данных.

binScatterPlot игнорирует все NaN значения. Точно так же, binScatterPlot игнорирует Inf и -Inf значения, если только границы интервала не заданы явно Inf или -Inf как граница интервала.

Примечание

Если X или Y содержат целые числа типа int64 или uint64 которые больше flintmax, затем рекомендуется явным образом задать границы интервала.binScatterPlot автоматические интервалы входных данных с помощью двойной точности, в которой отсутствует целочисленная точность для чисел, больше flintmax.

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

Количество интервалов в каждом измерении, заданное как положительное скалярное целое число или двухэлементный вектор положительных целых чисел. Если вы не задаете nbins, затем binScatterPlot автоматически вычисляет, сколько интервалов использовать на основе значений в X и Y.

  • Если nbins является скаляром, тогда binScatterPlot использует это множество интервалов в каждой размерности.

  • Если nbins является вектором, тогда nbins(1) задает количество интервалов в x -размерность и nbins(2) задает количество интервалов в y -размерности.

Пример: binScatterPlot(X,Y,20) использует по 20 интервалов в каждой размерности.

Пример: binScatterPlot(X,Y,[10 20]) использует 10 интервалов в x-размерность и 20 интервалов в y-размерность.

Границы интервала по x-размеру, заданные как вектор. Xedges(1) является первым ребром первого интервала по x-размеру и Xedges(end) является внешним краем последнего интервала.

Значение [X(k),Y(k)] находится в (i,j)th bin, если Xedges(i)X(k) <Xedges(i+1) и Yedges(j)Y(k) <Yedges(j+1). Последние интервалы в каждой размерности также включают последнее (внешнее) ребро. Для примера, [X(k),Y(k)] падает в ith bin в последней строке, если Xedges(end-1)X(k)Xedges(end) и Yedges(i)Y(k) <Yedges(i+1).

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

Границы интервала по y-размеру, заданные как вектор. Yedges(1) является первым ребром первого интервала по y-размеру и Yedges(end) является внешним краем последнего интервала.

Значение [X(k),Y(k)] находится в (i,j)th bin, если Xedges(i)X(k) <Xedges(i+1) и Yedges(j)Y(k) <Yedges(j+1). Последние интервалы в каждой размерности также включают последнее (внешнее) ребро. Для примера, [X(k),Y(k)] падает в ith bin в последней строке, если Xedges(end-1)X(k)Xedges(end) и Yedges(i)Y(k) <Yedges(i+1).

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

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

Задайте необязательные разделенные разделенными запятой парами Name,Value аргументы. Name - имя аргумента и Value - соответствующее значение. Name должны находиться внутри кавычек. Можно задать несколько аргументов в виде пар имен и значений в любом порядке Name1,Value1,...,NameN,ValueN.

Пример: binScatterPlot(X,Y,'BinWidth',[5 10])

Алгоритм Биннинга, заданный как разделенная разделенными запятой парами, состоящая из 'BinMethod' и одно из этих значений.

ЗначениеОписание
'auto'Значение по умолчанию 'auto' алгоритм использует максимум 100 интервалов и выбирает ширину интервала, чтобы охватить диапазон данных и показать форму базового распределения.
'scott'Правило Скотта оптимально, если данные близки к совместному нормальному распределению. Это правило подходит и для большинства других распределений. В нем используется интервал размером [3.5*std(X)*numel(X)^(-1/4), 3.5*std(Y)*numel(Y)^(-1/4)].
'integers'Целочисленное правило полезно с целочисленными данными, так как оно создает интервал для каждого целого числа. Он использует ширину интервала 1 и помещает границы интервала между целыми числами. Чтобы избежать случайного создания слишком большого количества интервалов, вы можете использовать это правило, чтобы создать предел в 65536 интервалов (216). Если область значений данных больше 65536, то в целочисленном правиле вместо этого используются более широкие интервалы.

Примечание

The BinMethod свойство получившегося Histogram2 объект всегда имеет значение 'manual'.

Ширина интервалов в каждой размерности, заданная как разделенная разделенными запятой парами, состоящая из 'BinWidth' и скалярный или двухэлементный вектор положительных целых чисел, [xWidth yWidth]. Скалярное значение указывает ту же ширину интервала для каждой размерности.

Если вы задаете BinWidth, затем binScatterPlot может использовать максимум 1024 интервала (210) вдоль каждой размерности. Если вместо этого заданная ширина интервала требует больше интервалов, то binScatterPlot использует большую ширину интервала, соответствующую максимальному количеству интервалов.

Пример: binScatterPlot(X,Y,'BinWidth',[5 10]) использует интервалы с размером 5 в x-размерность и размер 10 в y-размерность.

Постройте цветовую тему, заданную как разделенная разделенными запятой парами, состоящая из 'Color' и один из таких опций.

ОпцияОписание
'b'

Синий

'm'

Пурпурный

'c'

Голубой

'r'

Красный

'g'

Зеленый

'y'

Желтый

'k'

Черный

Гамма- коррекция, заданная как разделенная запятой пара, состоящая из 'Gamma' и положительная скалярная величина. Используйте эту опцию, чтобы настроить яркость и интенсивность цвета, чтобы повлиять на количество деталей в изображении.

  • gamma < 1 - Когда гамма уменьшается, затенение интервалов с меньшими количествами интервалов становится постепенно темнее, включая более подробную информацию на изображении.

  • gamma > 1 - Когда гамма увеличивается, затенение интервалов с меньшими количествами интервалов становится постепенно легче, удаляя детали из изображения.

  • Значение по умолчанию 1 не применяет коррекций к отображению.

Пределы интервала в x-измерении, заданные как разделенная разделенными запятой парами, состоящая из 'XBinLimits' и двухэлементный вектор, [xbmin,xbmax]. Вектор указывает первые и последние границы интервала в x -размерности.

binScatterPlot строит графики только тех данных, которые попадают в пределы интервала включительно, Data(Data(:,1)>=xbmin & Data(:,1)<=xbmax).

Пределы интервала в y-измерении, заданные как разделенная разделенными запятой парами, состоящая из 'YBinLimits' и двухэлементный вектор, [ybmin,ybmax]. Вектор указывает первые и последние границы интервала в y -размерности.

binScatterPlot строит графики только тех данных, которые попадают в пределы интервала включительно, Data(Data(:,2)>=ybmin & Data(:,2)<=ybmax).

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

свернуть все

Сгруппированный точечный график, возвращается как Histogram2 объект. Для получения дополнительной информации смотрите Histogram2 Свойств.

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

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