polarhistogram

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

Синтаксис

polarhistogram(theta)
polarhistogram(theta,nbins)
polarhistogram(theta,edges)
polarhistogram('BinEdges',edges,'BinCounts',counts)
polarhistogram(___,Name,Value)
polarhistogram(pax,___)
h = polarhistogram(___)

Описание

пример

polarhistogram(theta) создает график гистограммы в полярных координатах путем сортировки значений в theta в равномерно распределенные интервалы. Задайте значения в радианах.

пример

polarhistogram(theta,nbins) использует количество интервалов, заданных положительным целым числом, nbins.

Виды polarhistogram(theta,edges) theta в интервалы с краями интервала, заданными вектором, edges. Все интервалы включают левый край, но только последний интервал включает правый край. Другими словами, последний интервал включает оба края.

polarhistogram('BinEdges',edges,'BinCounts',counts) использует вручную заданные края интервала и сопоставленные количества интервала. Функция polarhistogram не делает никакого раскладывания данных.

пример

polarhistogram(___,Name,Value) задает дополнительные опции с помощью одного или нескольких аргументов в виде пар "имя-значение". Например, можно использовать полупрозрачные панели путем определения 'FaceAlpha' и скалярного значения между 0 и 1.

polarhistogram(pax,___) строит график в полярные оси, заданные pax вместо в текущую систему координат.

пример

h = polarhistogram(___) возвращает объект Histogram. Используйте h, чтобы изменить гистограмму после того, как это будет создано. Для списка свойств смотрите Histogram Properties.

Примеры

свернуть все

Создайте вектор значений между 0 и. Создайте график гистограммы, который показывает данные, отсортированные в шесть интервалов.

theta = [0.1 1.1 5.4 3.4 2.3 4.5 3.2 3.4 5.6 2.3 2.1 3.5 0.6 6.1];
polarhistogram(theta,6)

Создайте график гистограммы из 100 000 значений между и и отсортируйте данные в 25 интервалов.

theta = atan2(rand(100000,1)-0.5,2*(rand(100000,1)-0.5));
polarhistogram(theta,25);

Создайте график гистограммы в полярных координатах, и затем измените его внешний вид. Задайте цвета панели путем установки свойства FaceColor на вектор символа названия цвета, такие как 'red' или триплет RGB. Задайте прозрачность путем установки свойства FaceAlpha на значение между 0 и 1.

theta = atan2(rand(100000,1)-0.5,2*(rand(100000,1)-0.5));
polarhistogram(theta,25,'FaceColor','red','FaceAlpha',.3);

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

theta = atan2(rand(100000,1)-0.5,2*(rand(100000,1)-0.5));
h = polarhistogram(theta,25)

h = 
  Histogram with properties:

             Data: [100000x1 double]
           Values: [1x25 double]
          NumBins: 25
         BinEdges: [1x26 double]
         BinWidth: 0.2513
        BinLimits: [-3.1416 3.1416]
    Normalization: 'count'
        FaceColor: 'auto'
        EdgeColor: [0 0 0]

  Show all properties

Используйте h, чтобы получить доступ и изменить свойства объекта гистограммы после того, как это будет создано. Например, покажите просто схему гистограммы путем установки свойства DisplayStyle объекта гистограммы.

h.DisplayStyle = 'stairs';

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

свернуть все

Данные, чтобы распределить среди интервалов, заданных как вектор или матрица. polarhistogram создает одну гистограмму, независимо от того, задаете ли вы вектор или матрицу. Задайте значения в радианах. Чтобы преобразовать градусы в радианы, используйте deg2rad.

Значения, которые соответствуют тому же угловому направлению, отличаются точно 2π и сортируются в тот же интервал. polarhistogram не включает NaN, Inf и значения -Inf ни в каком интервале.

Пример: тета = [0 0.4 0.5 0.7 2.3 3.0 1.7 0.3];

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

Количество интервалов, заданных как положительное целое число. Если вы не задаете nbins, то polarhistogram автоматически вычисляет сколько интервалов, чтобы использовать на основе значений в theta.

Пример: nbins = 15;

Края интервала, заданные как вектор. Различие между минимальными и максимальными граничными значениями должно быть меньше чем или равно 2π.

Пример: polarhistogram ('BinEdges', [0 пи пи/3 3*pi/2 2*pi], 'BinCounts', [5 3 4 6])

Количества интервала, заданные как вектор. Используйте эту опцию, если вы выполняете вычисление количеств интервала отдельно, и вы не хотите, чтобы polarhistogram сделал любое раскладывание данных.

Пример: polarhistogram ('BinEdges', [0 пи пи/3 3*pi/2 2*pi], 'BinCounts', [5 3 4 6])

Объект PolarAxes. Если вы не задаете полярные оси, то polarhistogram использует текущую систему координат. polarhistogram не поддерживает графическое изображение в Оси декартовой системы координат.

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

Укажите необязательные аргументы в виде пар ""имя, значение"", разделенных запятыми. Имя (Name) — это имя аргумента, а значение (Value) — соответствующее значение. Имя должно появиться в кавычках. Вы можете задать несколько аргументов в виде пар имен и значений в любом порядке, например: Name1, Value1, ..., NameN, ValueN.

Пример: polarhistogram (тета, 'FaceAlpha', 0.3) создает график гистограммы с полупрозрачными панелями.

Свойства гистограммы, перечисленные здесь, являются только подмножеством. Для полного списка смотрите Histogram Properties.

Пределы интервала, заданные как двухэлементный вектор формы [bmin,bmax], где bmin является меньше, чем bmax.

Эта опция строит график гистограммы с помощью значений входного массива, которые падают между bmin и bmax включительно. Таким образом, theta(theta>=bmin & theta<=bmax).

Пример: polarhistogram (тета, 'BinLimits', [-pi/2 пи/2]) строит график гистограммы с помощью только значения в тете, которые являются между-pi/2 и пи/2 включительно.

Ширина через верхнюю часть интервалов, заданных как скаляр меньше, чем 2π.

polarhistogram использует максимум 65 536 интервалов (или 216). Если заданная ширина интервала требует большего количества интервалов, то polarhistogram использует максимальное количество интервалов, и настройте ширину интервала соответственно.

Пример: polarhistogram (тета, 'BinWidth', пи) использует интервалы с шириной π.

Тип нормализации, заданной как одно из значений в этой таблице.

ЗначениеОписание
количество

Схема нормализации по умолчанию. Высота каждой панели является количеством наблюдений в каждом интервале. Суммой высот панели является numel(theta).

'probability'

Высота каждой панели является относительным количеством наблюдений, (количество наблюдений в интервале/общем количестве наблюдений). Суммой высот панели является 1.

'countdensity'

Высота каждой панели является количеством наблюдений в интервале/ширине интервала.

'pdf'

Оценка функции плотности вероятности. Высота каждой панели, (количество наблюдений в интервале) / (общее количество наблюдений * ширина интервала). Областью каждой панели является относительное количество наблюдений. Суммой баров является 1.

'cumcount'

Высота каждой панели является совокупным числом наблюдений в каждом интервале и всех предыдущих интервалах. Высотой последней панели является numel(theta).

'cdf'

Совокупная оценка функции плотности. Высота каждой панели равна совокупному относительному количеству наблюдений в интервале и всех предыдущих интервалах. Высотой последней панели является 1.

Пример: polarhistogram (тета, 'Нормализация', 'PDF') строит график оценки функции плотности вероятности для теты.

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

  • лестница Отобразите схему гистограммы только.

  • панель Покажите каждую отдельную панель с заполненной внутренней частью.

Пример: polarhistogram (тета, 'DisplayStyle', 'лестница') строит график схемы гистограммы.

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

Пример: polarhistogram (тета, 'FaceAlpha'.5) создает график гистограммы с полупрозрачными панелями.

Цвет панели гистограммы, заданный как 'auto', триплет RGB или один из перечисленных в таблице параметров цвета. Значение по умолчанию 'auto' позволяет гистограмме выбрать цвет.

Для пользовательского цвета укажите триплет RGB. Триплет RGB представляет собой трехэлементный вектор-строку, элементы которого определяют интенсивность красных, зеленых и синих компонентов цвета. Интенсивность должны быть в диапазоне [0,1]; например, [0,4 0,6 0,7]. Кроме того, вы можете задать имена некоторых простых цветов. В этой таблице перечислены варианты длинного и краткого наименований цветов и их эквивалентные значения 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]
'none'Нет цветаНе применяется

Если вы задаете DisplayStyle как 'stairs', то polarhistogram не использует свойство FaceColor.

Пример: polarhistogram (тета, 'FaceColor', 'g') создает график гистограммы с зелеными панелями.

Ограничения

  • polarhistogram не поддерживает гистограммы создания категориальных данных в полярных осях.

Смотрите также

Функции

Свойства

Введенный в R2017b

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