dsp. Гистограмма

Гистограмма входа или последовательность входных параметров

Описание

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

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

  1. Создайте объект dsp.Histogram и установите его свойства.

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

Чтобы узнать больше, как Системные объекты работают, смотрите то, Что Системные объекты? 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).

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

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

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

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

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

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

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

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

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

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

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

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

Зависимости

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

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

Зависимости

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

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

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

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

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

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

Зависимости

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

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

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

Зависимости

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

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

Для версий ранее, чем R2016b, используйте функцию step, чтобы запустить Систему object™ алгоритм. Аргументы к step являются объектом, который вы создали, сопровождаемый аргументами, показанными в этом разделе.

Например, y = step(obj,x) и y = obj(x) выполняют эквивалентные операции.

Синтаксис

y = hist(x)
y = hist(x,r)

Описание

пример

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

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

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

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

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

Типы данных: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64 | fi
Поддержка комплексного числа: Да

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

Зависимости

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

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

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

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

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

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

  • все Объект вычисляет значение гистограммы по всем входным каналам.

Типы данных: 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]')
y = 4×1

     1
     2
     3
     4

Алгоритмы

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

  • Параметры блоков Reset port соответствуют и ResetCondition и свойствам объектов ResetInputPort.

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

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

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

Системные объекты

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