dsp.PeakFinder

(Чтобы быть удаленным), Идентифицируют пиковые значения во входном сигнале

Описание

dsp.PeakFinder Система object™ считает количество пиковых значений (максимумы, минимумы или оба) в каждом столбце входного сигнала с действительным знаком. Чтобы квалифицировать как пик, точка должна быть больше (или меньшей), чем обе из ее соседних точек. Конечные точки не рассматриваются как пиковые значения. Объект может также вывести индексы и значения peaks и двоичный массив, который указывает, является ли пик максимумами или минимумы.

Чтобы вывести пиковые индексы и пиковые значения, установите PeakIndicesOutputPort и PeakValuesOutputPort к true, соответственно. Кроме того, можно определить, какое из пиковых значений является максимумами или минимумы с помощью матрицы полярности. Матрица полярности является логическим массивом, в котором 1 указывает на максимумы, и 0 указывает на минимумы. Чтобы просмотреть матрицу полярности, установите PeakType на 'Maxima and Minima' и доступ четвертый выход.

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

Если вы устанавливаете IgnoreSmallPeaks на true, объект больше не обнаруживает низкую амплитуду, достигает максимума и игнорирует шум в пороговом значении, которое вы задаете. В этом режиме текущее значение является максимумом если (current – previous)> threshold и (current – next)> threshold. Текущее значение является минимумом если (current – previous) <–threshold и (current – next) <–threshold.

Примечание

dsp.PeakFinder Системный объект будет удален в будущем релизе. Чтобы определить локальные максимумы, используйте findpeaks функция. Чтобы определить локальные минимумы, используйте islocalmin функционируйте и найдите значения сигналов, соответствующие локальным индексам минимумов, которые определяет функция. Для получения дополнительной информации см. Вопросы совместимости.

Определить пиковые значения во входном сигнале:

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

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

Создание

Синтаксис

pkFind = dsp.PeakFinder

pkFind = dsp.PeakFinder(Name,Value)

Описание

pkFind = dsp.PeakFinder создает пиковый Системный объект средства поиска, который идентифицирует пиковые значения (максимумы, минимумы или оба) во входном сигнале.

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

Пример: задержитесь = dsp. PeakFinder ('PeakType', 'Максимумы');

Свойства

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

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

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

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

`PeakType` — Тип peaks, чтобы идентифицировать
`'Maxima and Minima'` (значение по умолчанию) | `'Maxima'` | `'Minima'`

Тип peaks, чтобы идентифицировать, заданный как одно из следующего:

'Maxima' – Если IgnoreSmallPeaks установлен в true, текущее значение идентифицировано как максимум если (current – previous)> threshold и (current – next)> threshold. Задайте threshold в свойстве PeakThreshold. Если IgnoreSmallPeaks установлен в false, текущее значение должно быть больше, чем обе его соседних точки.
'Minima' – Если IgnoreSmallPeaks установлен в true, текущее значение идентифицировано как минимум если (current – previous) <–threshold и (current – next) <–threshold. Если IgnoreSmallPeaks установлен в false, текущее значение должно быть меньшим, чем обе его соседних точки.
'Maxima and Minima' – Объект идентифицирует и максимумы и точки минимумов.

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

Включите выход пиковых индексов, заданных как также:

true – Объект возвращает индексы пиковых значений входного сигнала.
false – Объект не возвращает индексы пиковых значений входного сигнала.

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

Включите выход пиковых значений, заданных как также:

true – Объект возвращает пиковые значения входного сигнала.
false – Объект не возвращает пиковые значения входного сигнала.

`MaximumPeakCount` — Максимальное количество пиковых значений, чтобы идентифицировать
10 (значение по умолчанию) | целое число, больше, чем или равный 1

Максимальное количество пиковых значений, чтобы идентифицировать в каждом входном сигнале, заданном как целое число, больше, чем или равный 1. Объект прекращает искать входной сигнал peaks, если это идентифицирует максимальное количество.

Пример 5

Пример: 50

`IgnoreSmallPeaks` — Проигнорируйте peaks ниже порога
`false` (значение по умолчанию) | `true`

Проигнорируйте peaks ниже порога, заданного как также:

false – Объект идентифицирует текущее значение как пик, если текущее значение больше (или меньше), чем обе из его соседних точек.
true – Объект идентифицирует текущее значение как максимум если (current – previous)> threshold и (current – next)> threshold. Объект идентифицирует текущее значение как минимум если (current – previous) <–threshold и (current – next) <–threshold.

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

Порог, ниже которого проигнорирован peaks, задал как действительный скаляр, больше, чем или равный 0 или вектор со всеми элементами, больше, чем или равный 0. Длина вектора должна быть равна количеству каналов.

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

Пример: 0.2

Пример: [0.3 2.4]

Пример: [3; 0.4]

Зависимости

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

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

`RoundingMethod` — Округление метода
`'Floor'` (значение по умолчанию)

Округление метода, заданного как 'Floor', который эквивалентен усечению. Установка округляет результат вычисления к самому близкому представимому номеру в направлении отрицательной бесконечности.

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

Действие переполнения для операций фиксированной точки, заданных как одно из следующего:

'Wrap' – Объект переносит результат своих операций фиксированной точки.
'Saturate' – Объект насыщает результат своих операций фиксированной точки.

Для получения дополнительной информации о действиях переполнения смотрите режим переполнения для операций фиксированной точки.

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

Синтаксис

cnt = pkFind(input)

[cnt,idx] = pkFind(input)

[___,val] = pkFind(input)

[___,pol] = pkFind(input)

Описание

cnt = pkFind(input) возвращает количество пиковых значений (минимумы, максимумы или оба) во входном сигнале. Каждый столбец входа обработан как отдельный канал.

[cnt,idx] = pkFind(input) возвращает количество пиковых значений, cnt, и пиковые индексы, idx, во входном сигнале.

Чтобы получить доступ к пиковым индексам выход, установите PeakIndicesOutputPort свойство к true.

pkFind = dsp.PeakFinder('PeakType','Maxima', ...
'PeakIndicesOutputPort',true);
...
[cnt,idx] = pkFind(input);

[___,val] = pkFind(input) возвращает пиковые значения val во входном сигнале.

Чтобы получить доступ к пиковым значениям выход, установите PeakValuesOutputPort свойство к true.

pkFind = dsp.PeakFinder('PeakType','Maxima', ...
'PeakValuesOutputPort',true);
...
[cnt,idx,val] = pkFind(input);

[___,pol] = pkFind(input) возвращает полярность пикового значения pol во входном сигнале. Полярностью является 1 для максимумов и 0 для минимумов.

Чтобы получить доступ к полярности выход, установите PeakType свойство к 'Maxima and Minima', и PeakIndicesOutputPort свойство к true.

pkFind = dsp.PeakFinder('PeakType','Maxima and Minima', ...
'PeakIndicesOutputPort',true);
...
[cnt,idx,val,pol] = pkFind(input);

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

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

`input` — Ввод данных
вектор-столбец по крайней мере трех строк | матрица по крайней мере с тремя строками

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

Пример: [9 6 10 3 5 5 0 12; 9 6 1 13 4 1 0 12]'

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

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

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

`cnt` — Количество пиковых значений
скаляр | вектор-строка

Количество пиковых значений, возвращенных как скаляр или вектор-строка из длины, равняется количеству каналов во вводе данных.

Пример: [4 3]

Типы данных: uint32

`idx` — Индексы пиковых значений
вектор-столбец | матрица

Индексы пиковых значений во входном сигнале, возвращенном как вектор-столбец или матрица. Размер пиковых индексов выход совпадает с размером входа. Все ненулевые элементы представляют пиковые индексы.

Пример: [1 2 3 6 0 0 0 0 0 0; 2 3 6 0 0 0 0 0 0 0]'

Зависимости

Чтобы включить этот выход, установите PeakIndicesOutputPort свойство к true.

Типы данных: uint32

`val` — Пиковые значения
вектор-столбец | матрица

Пиковые значения во входном сигнале, возвращенном как вектор-столбец или матрица.

Пример: [6 10 3 0 0 0 0 0 0 0; 1 13 0 0 0 0 0 0 0 0]'

Зависимости

Чтобы получить доступ к пиковым значениям выход, установите PeakValuesOutputPort свойство к true.

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

`pol` — Полярность пикового значения
вектор-столбец | матрица

Полярность пикового значения во входном сигнале, возвращенном как вектор-столбец или матрица логической 1 с и 0s. Полярностью является 1 для максимумов и 0 для минимумов.

Пример: [0 1 0 0 0 0 0 0 0 0; 0 1 0 0 0 0 0 0 0 0]'

Типы данных: логический

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

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

release(obj)

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

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

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

Примеры

Определите локальные максимумы и минимумы

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

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

pkFind = dsp.PeakFinder;
pkFind.PeakIndicesOutputPort = true;
pkFind.PeakValuesOutputPort = true;

x1 = [9 6 10 3 4 5 0 12]';

Найдите peaks каждого входа [prev;cur;next]: {[9;6;10],[6;10;3],...}

[cnt1, idx1, val1, pol1] = pkFind(x1)

cnt1 = uint32
    5

idx1 = 10x1 uint32 column vector

   1
   2
   3
   5
   6
   0
   0
   0
   0
   0

val1 = 10×1

     6
    10
     3
     5
     0
     0
     0
     0
     0
     0

pol1 = 10x1 logical array

   0
   1
   0
   1
   0
   0
   0
   0
   0
   0

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

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

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

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

Обновите код

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

Нежелательное использование (R2016b или позже)	Нежелательное использование (перед R2016b)	Рекомендуемая замена
Найдите локальные максимумы x = [9 6 10 3 4 5 0 12]'; pf = dsp.PeakFinder('PeakType','Maxima', ... 'PeakValuesOutputPort', true); [cnt,val] = pf(x) Найдите локальные минимумы x = [9 6 10 3 4 5 0 12]'; pf = dsp.PeakFinder('PeakType','Minima', ... 'PeakValuesOutputPort', true); [cnt,val] = pf(x)	Найдите локальные максимумы x = [9 6 10 3 4 5 0 12]'; pf = dsp.PeakFinder('PeakType','Maxima', ... 'PeakValuesOutputPort', true); [cnt,val] = step(pf,x) Найдите локальные минимумы x = [9 6 10 3 4 5 0 12]'; pf = dsp.PeakFinder('PeakType','Minima', ... 'PeakValuesOutputPort', true); [cnt,val] = step(pf,x)	Найдите локальные максимумы x = [9 6 10 3 4 5 0 12]'; val = findpeaks(x) cnt = numel(val) Найдите локальные минимумы x = [9 6 10 3 4 5 0 12]'; tf = islocalmin(x); val = x(tf) cnt = sum(tf)

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

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

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

Найдите локальные максимумы

x = [9 6 10 3 4 5 0 12]';
pf = dsp.PeakFinder('PeakType','Maxima', ...
    'PeakValuesOutputPort', true);
[cnt,val] = pf(x)

Найдите локальные минимумы

x = [9 6 10 3 4 5 0 12]';
pf = dsp.PeakFinder('PeakType','Minima', ...
    'PeakValuesOutputPort', true);
[cnt,val] = pf(x)

Найдите локальные максимумы

x = [9 6 10 3 4 5 0 12]';
pf = dsp.PeakFinder('PeakType','Maxima', ...
    'PeakValuesOutputPort', true);
[cnt,val] = step(pf,x)

Найдите локальные минимумы

x = [9 6 10 3 4 5 0 12]';
pf = dsp.PeakFinder('PeakType','Minima', ...
    'PeakValuesOutputPort', true);
[cnt,val] = step(pf,x)

Найдите локальные максимумы

x = [9 6 10 3 4 5 0 12]';
val = findpeaks(x)
cnt = numel(val)

Найдите локальные минимумы

x = [9 6 10 3 4 5 0 12]';
tf = islocalmin(x);
val = x(tf)
cnt = sum(tf)

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

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

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

Смотрите системные объекты в Генерации кода MATLAB (MATLAB Coder).

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

dsp.PeakFinder

Описание

Примечание

Создание

Синтаксис

Описание

Свойства

PeakType — Тип peaks, чтобы идентифицировать 'Maxima and Minima' (значение по умолчанию) | 'Maxima' | 'Minima'

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

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

MaximumPeakCount — Максимальное количество пиковых значений, чтобы идентифицировать10 (значение по умолчанию) | целое число, больше, чем или равный 1

IgnoreSmallPeaks — Проигнорируйте peaks ниже порога false (значение по умолчанию) | true

PeakThreshold — Порог, ниже которого проигнорирован peaks0 (значение по умолчанию) | положительный действительный скаляр | вектор

Зависимости

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

RoundingMethod — Округление метода 'Floor' (значение по умолчанию)

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

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

Синтаксис

Описание

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

input — Ввод данных вектор-столбец по крайней мере трех строк | матрица по крайней мере с тремя строками

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

cnt — Количество пиковых значений скаляр | вектор-строка

idx — Индексы пиковых значений вектор-столбец | матрица

Зависимости

val — Пиковые значения вектор-столбец | матрица

Зависимости

pol — Полярность пикового значения вектор-столбец | матрица

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

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

Примеры

Определите локальные максимумы и минимумы

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

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

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

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

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

Функции

Блоки

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

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

Поддержка

`PeakType` — Тип peaks, чтобы идентифицировать
`'Maxima and Minima'` (значение по умолчанию) | `'Maxima'` | `'Minima'`

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

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

`MaximumPeakCount` — Максимальное количество пиковых значений, чтобы идентифицировать
10 (значение по умолчанию) | целое число, больше, чем или равный 1

`IgnoreSmallPeaks` — Проигнорируйте peaks ниже порога
`false` (значение по умолчанию) | `true`

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

`RoundingMethod` — Округление метода
`'Floor'` (значение по умолчанию)

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

`input` — Ввод данных
вектор-столбец по крайней мере трех строк | матрица по крайней мере с тремя строками

`cnt` — Количество пиковых значений
скаляр | вектор-строка

`idx` — Индексы пиковых значений
вектор-столбец | матрица

`val` — Пиковые значения
вектор-столбец | матрица

`pol` — Полярность пикового значения
вектор-столбец | матрица

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