dsp.Histogram

(Чтобы быть удаленным) Гистограмма входа или последовательность входных параметров

Описание

Histogram объект генерирует гистограмму для входа или последовательности входных параметров.

Примечание

dsp.Histogram Система object™ будет удалена в будущем релизе. Используйте histcounts функцию вместо этого. Для получения дополнительной информации см. Вопросы совместимости.

Сгенерировать гистограмму для входа или последовательности входных параметров:

Создайте dsp.Histogram объект и набор его свойства.
Вызовите объект с аргументами, как будто это была функция.

Чтобы узнать больше, как Системные объекты работают, смотрите то, Что Системные объекты? MATLAB.

Создание

Синтаксис

hist = dsp.Histogram

hist = dsp.Histogram(min,max,numbins)

hist = dsp.Histogram(Name,Value)

Описание

hist = dsp.Histogram возвращает объект гистограммы, hist, это вычисляет плотность распределения элементов в каждой входной матрице.

hist = dsp.Histogram(min,max,numbins) возвращает объект гистограммы, hist, с LowerLimit набор свойств к min, UpperLimit набор свойств к max, и NumBins набор свойств к numbins.

hist = dsp.Histogram(Name,Value) возвращает объект гистограммы, hist, с каждым заданным набором свойств к заданному значению. Заключите каждое имя свойства в одинарные кавычки. Незаданные свойства имеют значения по умолчанию.

Свойства

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

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

Если свойство является настраиваемым, можно изменить его значение в любое время.

Для получения дополнительной информации об изменении значений свойств смотрите Разработку системы в MATLAB Используя Системные объекты (MATLAB).

`LowerLimit` — Нижняя граница
0 (значение по умолчанию) | действительный скаляр

Задайте нижнюю границу интервала с самым низким знаком как скаляр с действительным знаком. NaN и Inf не допустимые значения для этого свойства.

Настраиваемый: да

`UpperLimit` — Верхний контур
10 (значение по умолчанию) | действительный скаляр

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

Настраиваемый: да

`NumBins` — Количество интервалов в гистограмме
11 (значение по умолчанию) | положительное целое число

Задайте количество интервалов в гистограмме.

`Dimension` — Размерность
`Column` (значение по умолчанию) | `All`

Задайте, как вычисление гистограммы выполняется по данным как All или Column.

`Normalize` — Включите нормализацию выходного вектора
`false` (значение по умолчанию) | `true`

Задайте, нормирует ли объект гистограммы выходной вектор, v, так, чтобы $s u m (v) = 1$ . Когда вы устанавливаете это свойство на true, выходной вектор нормирован. Когда вы устанавливаете его на false, операции фиксированной точки поддержки объектов и не используют это свойство в нормализации.

`RunningHistogram` — Включите вычисление по последовательным вызовам алгоритма
`false` (значение по умолчанию) | `true`

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

`ResetInputPort` — Позвольте сбросить в рабочем режиме гистограммы
`false` (значение по умолчанию) | `true`

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

Зависимости

Это свойство применяется, когда вы устанавливаете RunningHistogram свойство к true.

`ResetCondition` — Сбросьте условие для рабочего режима гистограммы
`Non-zero` (значение по умолчанию) | `Rising edge` | `Falling edge` | `Either edge`

Задайте событие, которое сбрасывает рабочую гистограмму как Rising edge, Falling edge, Either edge, или Non-zero.

Зависимости

Это свойство применяется, когда вы устанавливаете ResetInputPort свойство к true.

Свойства фиксированной точки

`RoundingMethod` — Округление метода для операций фиксированной точки
`Floor` (значение по умолчанию) | `Ceiling` | `Convergent` | `Nearest` | `Round` | `Simplest` | `Zero`

Задайте метод округления.

`OverflowAction` — Действие переполнения для операций фиксированной точки
`Wrap` (значение по умолчанию) | `Saturate`

Задайте действие переполнения как Wrap или Saturate.

`ProductDataType` — Слово продукта и дробные длины
`Same as input` (значение по умолчанию) | `Custom`

Задайте тип данных с фиксированной точкой продукта как Same as input или Custom.

`CustomProductDataType` — Пользовательское слово продукта и дробные длины
`numerictype([],32,30)` (значение по умолчанию) | numerictype

Задайте фиксированную точку продукта как масштабированный numerictype объект с Signedness из Auto.

Зависимости

Это свойство применяется, когда вы устанавливаете ProductDataType свойство к Custom.

`AccumulatorDataType` — Слово аккумулятора и дробные длины
`Same as input` (значение по умолчанию) | `Same as product` | `Custom`

Задайте тип данных с фиксированной точкой аккумулятора как один из Same as product, Same as input, или Custom |.

`CustomAccumulatorDataType` — Пользовательское слово аккумулятора и дробные длины
`numerictype([],32,30)` (значение по умолчанию) | numerictype

Задайте фиксированную точку аккумулятора как масштабированный numerictype объект с Signedness из Auto.

Зависимости

Это свойство применяется, когда вы устанавливаете AccumulatorDataType свойство к Custom.

Использование

Синтаксис

y = hist(x)

y = hist(x,r)

Описание

y = hist(x) возвращает гистограмму y для входных данных x . Когда RunningHistogram свойством является trueY соответствует гистограмме входных элементов по последовательным вызовам алгоритма.

y = hist(x,r) сбрасывает состояние гистограммы на основе сигнала сброса, r и ResetCondition объекта свойство. Можно сбросить состояние гистограммы только когда RunningHistogram и ResetInputPort свойствами является true.

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

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

`x` — Ввод данных
вектор | матрица | N-D массив

Ввод данных, заданный как вектор, матрица или N-D массив. Если x матрица, каждый столбец обработан как независимый канал.

`r` — Сбросьте сигнал
скаляр

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

Зависимости

Можно сбросить состояние гистограммы только когда RunningHistogram и ResetInputPort свойствами является true.

Типы данных: single | double | int8 | int16 | int32 | logical

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

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

`y` — Histogram выход
скаляр | вектор

Histogram выход входного сигнала, возвращенного как скаляр, вектор или матрица. Выход зависит от установки Dimension:

'Column' – Объект вычисляет значение гистограммы каждого входного канала. Если вход является вектор-столбцом, выход является скаляром. Если вход является многоканальным сигналом, выходной сигнал 1 N вектором, где N является количеством входных каналов.
'All' – Объект вычисляет значение гистограммы по всем входным каналам.

Типы данных: single | double | uint32

Функции объекта

Чтобы использовать объектную функцию, задайте Системный объект как первый входной параметр. Например, чтобы выпустить системные ресурсы Системного объекта под названием obj, используйте этот синтаксис:

release(obj)

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

Характерный для всех системных объектов

`step`	Запустите алгоритм Системного объекта
`release`	Высвободите средства и позвольте изменения в значениях свойств Системного объекта и введите характеристики
`reset`	Сбросьте внутренние состояния Системного объекта

Примеры

Вычислите гистограмму последовательности

Примечание: Если вы используете R2016a или более ранний релиз, заменяете каждый вызов объекта с эквивалентным step синтаксис. Например, obj(x) становится step(obj,x).

Вычислите гистограмму с четырьмя интервалами для возможных входных значений 1 - 4.

hist = dsp.Histogram(1,4,4);
y = hist([1 2 2 3 3 3 4 4 4 4]')

Алгоритмы

Этот объект реализует алгоритм, входные параметры и выходные параметры, описанные на странице с описанием блока Histogram. Свойства объектов соответствуют параметрам блоков, кроме:

Параметры блоков Reset port соответствуют обоим ResetCondition и ResetInputPort свойства объектов.
Параметры блоков Find histogram over соответствуют Свойству измерения объекта.

Вопросы совместимости

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

dsp. Системный объект гистограммы будет удален

Предупреждает запуск в R2019b

dsp.Histogram Системный объект будет удален в будущем релизе. Используйте histcounts функцию вместо этого.

Обновите код

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

Нежелательное использование (R2016b или позже)	Нежелательное использование (перед R2016b)	Рекомендуемая замена
x = [1 2 2 3 3 3 4 4 4 4]'; myhistogram = dsp.Histogram(1,4,4) n = myhistogram(x) n является гистограммой. myhistogram = dsp.Histogram(1,5,4) n = myhistogram(x)	x = [1 2 2 3 3 3 4 4 4 4]'; myhistogram = dsp.Histogram(1,4,4) n = step(myhistogram,x) myhistogram = dsp.Histogram(1,5,4) n = step(myhistogram,x)	x = [1 2 2 3 3 3 4 4 4 4]'; [n,edges] = histcounts(x) n является гистограммой, и edges является ребрами интервала. [n,edges] = histcounts(x,4,'BinLimits',[1 5],... 'BinEdges',[1 2.25 3.5 4.75 5])

Нежелательное использование (R2016b или позже)

Нежелательное использование (перед R2016b)

Рекомендуемая замена

x = [1 2 2 3 3 3 4 4 4 4]';
myhistogram = dsp.Histogram(1,4,4)
n = myhistogram(x)

n является гистограммой.

myhistogram = dsp.Histogram(1,5,4)
n = myhistogram(x)

x = [1 2 2 3 3 3 4 4 4 4]';
myhistogram = dsp.Histogram(1,4,4)
n = step(myhistogram,x)

myhistogram = dsp.Histogram(1,5,4)
n = step(myhistogram,x)

x = [1 2 2 3 3 3 4 4 4 4]';
[n,edges] = histcounts(x)

n является гистограммой, и edges является ребрами интервала.

[n,edges] = histcounts(x,4,'BinLimits',[1 5],...
'BinEdges',[1 2.25 3.5 4.75 5])

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

Генерация кода C/C++
Генерация кода C и C++ с помощью MATLAB® Coder™.

Указания и ограничения по применению:

Этот объект не имеет никаких настраиваемых свойств для генерации кода.
Смотрите системные объекты в Генерации кода MATLAB (MATLAB Coder).

Документация

dsp.Histogram

Описание

Примечание

Создание

Синтаксис

Описание

Свойства

LowerLimit — Нижняя граница0 (значение по умолчанию) | действительный скаляр

UpperLimit — Верхний контур10 (значение по умолчанию) | действительный скаляр

NumBins — Количество интервалов в гистограмме11 (значение по умолчанию) | положительное целое число

Dimension — Размерность Column (значение по умолчанию) | All

Normalize — Включите нормализацию выходного вектора false (значение по умолчанию) | true

RunningHistogram — Включите вычисление по последовательным вызовам алгоритма false (значение по умолчанию) | true

ResetInputPort — Позвольте сбросить в рабочем режиме гистограммы false (значение по умолчанию) | true

Зависимости

ResetCondition — Сбросьте условие для рабочего режима гистограммы Non-zero (значение по умолчанию) | Rising edge | Falling edge | Either edge

Зависимости

Свойства фиксированной точки

RoundingMethod — Округление метода для операций фиксированной точки Floor (значение по умолчанию) | Ceiling | Convergent | Nearest | Round | Simplest | Zero

OverflowAction — Действие переполнения для операций фиксированной точки Wrap (значение по умолчанию) | Saturate

ProductDataType — Слово продукта и дробные длины Same as input (значение по умолчанию) | Custom

CustomProductDataType — Пользовательское слово продукта и дробные длины numerictype([],32,30) (значение по умолчанию) | numerictype

Зависимости

AccumulatorDataType — Слово аккумулятора и дробные длины Same as input (значение по умолчанию) | Same as product | Custom

CustomAccumulatorDataType — Пользовательское слово аккумулятора и дробные длины numerictype([],32,30) (значение по умолчанию) | numerictype

Зависимости

Использование

Синтаксис

Описание

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

x — Ввод данных вектор | матрица | N-D массив

r — Сбросьте сигнал скаляр

Зависимости

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

y — Histogram выход скаляр | вектор

Функции объекта

Характерный для всех системных объектов

Примеры

Вычислите гистограмму последовательности

Алгоритмы

Вопросы совместимости

dsp. Системный объект гистограммы будет удален

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

Генерация кода C/C++ Генерация кода C и C++ с помощью MATLAB® Coder™.

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

Функции

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

Документация DSP System Toolbox

Поддержка

`LowerLimit` — Нижняя граница
0 (значение по умолчанию) | действительный скаляр

`UpperLimit` — Верхний контур
10 (значение по умолчанию) | действительный скаляр

`NumBins` — Количество интервалов в гистограмме
11 (значение по умолчанию) | положительное целое число

`Dimension` — Размерность
`Column` (значение по умолчанию) | `All`

`Normalize` — Включите нормализацию выходного вектора
`false` (значение по умолчанию) | `true`

`RunningHistogram` — Включите вычисление по последовательным вызовам алгоритма
`false` (значение по умолчанию) | `true`

`ResetInputPort` — Позвольте сбросить в рабочем режиме гистограммы
`false` (значение по умолчанию) | `true`

`ResetCondition` — Сбросьте условие для рабочего режима гистограммы
`Non-zero` (значение по умолчанию) | `Rising edge` | `Falling edge` | `Either edge`

`RoundingMethod` — Округление метода для операций фиксированной точки
`Floor` (значение по умолчанию) | `Ceiling` | `Convergent` | `Nearest` | `Round` | `Simplest` | `Zero`

`OverflowAction` — Действие переполнения для операций фиксированной точки
`Wrap` (значение по умолчанию) | `Saturate`

`ProductDataType` — Слово продукта и дробные длины
`Same as input` (значение по умолчанию) | `Custom`

`CustomProductDataType` — Пользовательское слово продукта и дробные длины
`numerictype([],32,30)` (значение по умолчанию) | numerictype

`AccumulatorDataType` — Слово аккумулятора и дробные длины
`Same as input` (значение по умолчанию) | `Same as product` | `Custom`

`CustomAccumulatorDataType` — Пользовательское слово аккумулятора и дробные длины
`numerictype([],32,30)` (значение по умолчанию) | numerictype

`x` — Ввод данных
вектор | матрица | N-D массив

`r` — Сбросьте сигнал
скаляр

`y` — Histogram выход
скаляр | вектор

Генерация кода C/C++
Генерация кода C и C++ с помощью MATLAB® Coder™.