exponenta event banner

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 объект. Этот объект используется для проверки свойств печати.

Примеры

свернуть все

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

При выполнении вычислений в массивах TALL MATLAB ® использует либо параллельный пул (по умолчанию при наличии Toolbox™ Parallel Computing), либо локальный сеанс 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.

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

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

При выполнении вычислений в массивах TALL MATLAB ® использует либо параллельный пул (по умолчанию при наличии Toolbox™ Parallel Computing), либо локальный сеанс 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 для захвата отклонений.

При выполнении вычислений в массивах TALL MATLAB ® использует либо параллельный пул (по умолчанию при наличии Toolbox™ Parallel Computing), либо локальный сеанс 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'.

При выполнении вычислений в массивах TALL MATLAB ® использует либо параллельный пул (по умолчанию при наличии Toolbox™ Parallel Computing), либо локальный сеанс 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 точек данных 2-D, [X(k),Y(k)]. Базовые типы данных X и Y могут быть разными, но binScatterPlot объединяет эти входные данные в единый Nоколо-2 высокая матрица доминирующего базового типа данных.

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])

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

Примечание

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