islocalmax

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

Синтаксис

TF = islocalmax(A)
TF = islocalmax(A,dim)
TF = islocalmax(___,Name,Value)
[TF,P] = islocalmax(___)

Описание

пример

TF = islocalmax(A) возвращает логический массив, элементы которого 1 (true), когда локальный максимум обнаруживается в соответствующем элементе массива, таблицы или расписания.

TF = islocalmax(A,dim) задает размерность A, чтобы действовать вперед. Например, islocalmax(A,2) находит локальные максимумы каждой строки матричного A.

пример

TF = islocalmax(___,Name,Value) задает дополнительные параметры для нахождения локальных максимумов с помощью одного или нескольких аргументов в виде пар "имя-значение". Например, islocalmax(A,'SamplePoints',t) находит локальные максимумы A относительно меток времени содержавшимися во временном векторе t.

пример

[TF,P] = islocalmax(___) также возвращает выдающееся положение, соответствующее каждому элементу A для любого из предыдущих синтаксисов.

Примеры

свернуть все

Вычислите и постройте график локальных максимумов вектора данных.

x = 1:100;
A = (1-cos(2*pi*0.01*x)).*sin(2*pi*0.15*x);
TF = islocalmax(A);
plot(x,A,x(TF),A(TF),'r*')

Создайте матрицу данных и вычислите локальные максимумы для каждой строки.

A = 25*diag(ones(5,1)) + rand(5,5);
TF = islocalmax(A,2)
TF = 5x5 logical array

   0   0   1   0   0
   0   1   0   0   0
   0   0   1   0   0
   0   1   0   1   0
   0   1   0   0   0

Вычислите локальные максимумы вектора данных относительно меток времени в векторном t. Используйте параметр 'MinSeparation', чтобы вычислить максимумы, которые на расстоянии по крайней мере в 45 минут.

t = hours(linspace(0,3,15));
A = [2 4 6 4 3 7 5 6 5 10 4 -1 -3 -2 0];
TF = islocalmax(A,'MinSeparation',minutes(45),'SamplePoints',t);
plot(t,A,t(TF),A(TF),'r*')

Задайте метод для указания на последовательные значения максимумов.

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

x = 0:0.1:5;
A = min(0.75, sin(pi*x));
TF1 = islocalmax(A, 'FlatSelection', 'first');
plot(x,A,x(TF1),A(TF1),'r*')

Укажите на максимум каждой плоской области со всеми случаями того значения.

TF2 = islocalmax(A, 'FlatSelection', 'all');
plot(x,A,x(TF2),A(TF2),'r*')

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

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

x = 1:100;
A = peaks(100);
A = A(50,:);
[TF1,P] = islocalmax(A);
P(TF1)
ans = 1×2

    1.7703    3.5548

plot(x,A,x(TF1),A(TF1),'r*')
axis tight

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

TF2 = islocalmax(A,'MinProminence',2);
plot(x,A,x(TF2),A(TF2),'r*')
axis tight

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

свернуть все

Входные данные, заданные как вектор, матрица, многомерный массив, таблица или расписание.

Типы данных: единственный | удваиваются | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64 | логический | таблица | расписание

Операционная размерность, заданная как положительный целочисленный скаляр. По умолчанию islocalmax действует по первому измерению, размер которого не равняется 1.

Например, если A является матрицей, то islocalmax(A,1) действует вдоль строк A, вычисляя локальные максимумы для каждого столбца.

islocalmax(A,2) действует вдоль столбцов A, вычисляя локальные максимумы для каждой строки.

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

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

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

Пример: TF = islocalmax (A, 'MinProminence', 2)

Минимальное выдающееся положение, заданное как пара, разделенная запятой, состоящая из 'MinProminence' и неотрицательного скаляра. islocalmax возвращает только локальные максимумы, выдающееся положение которых является, по крайней мере, заданным значением. Максимальным значением выдающегося положения по умолчанию является size(A,dim) для входного параметра A и операционная размерность dim.

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

Окно Prominence, заданное как пара, разделенная запятой, состоящая из 'ProminenceWindow' и положительного целочисленного скаляра, двухэлементного вектора положительных целых чисел, положительного скаляра длительности или двухэлементного вектора положительной длительности. Значение задает окно соседних точек, для которых можно вычислить выдающееся положение для каждого локального максимума.

Когда значение окна является положительным целочисленным скаляром k, затем окно центрируется о каждом локальном максимуме и содержит k-1 соседние элементы. Если k даже, то окно центрируется о текущих и предыдущих элементах. Если локальный максимум в плоской области, то islocalmax обрабатывает целую плоскую область как центральную точку окна.

Когда значением является двухэлементный векторный [b f] положительных целых чисел, затем окно содержит локальный максимум, элементы b назад и элементы f вперед. Если локальный максимум в плоской области, то окно запускает элементы b перед первой точкой области и заканчивает элементы f после последней точки области.

Когда входные данные являются расписанием или когда 'SamplePoints' задан как datetime или вектор duration, значение окна должно иметь тип duration, и окно вычисляется относительно точек выборки.

Типы данных: единственный | удваиваются | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64 | длительность

Плоский индикатор области для того, когда локальное максимальное значение повторяется последовательно, задал как пара, разделенная запятой, состоящая из 'FlatSelection' и одно из следующего:

  • центр Укажите только на центральный элемент плоской области как локальный максимум. Элемент TF, соответствующего центру плоского, равняется 1 и 0 для остающихся плоских элементов.

  • 'first' — Укажите только на первый элемент плоской области как локальный максимум. Элемент TF, соответствующего запуску плоского, равняется 1 и 0 для остающихся плоских элементов.

  • 'last' — Укажите только на последний элемент плоской области как локальный максимум. Элемент TF, соответствующего в конец плоского, равняется 1 и 0 для остающихся плоских элементов.

  • все Укажите на все элементы плоской области как локальные максимумы. Элементы TF, соответствующего всем частям плоского, равняются 1.

При использовании 'MinSeparation' или пар "имя-значение" 'MaxNumExtrema', плоские точки области совместно рассматриваются единственный максимальный вопрос.

Минимальное разделение между локальными максимумами, заданными как пара, разделенная запятой, состоящая из 'MinSeparation' и неотрицательного скаляра. Разделительное значение задано в тех же модулях как вектор точек выборки, который является [1 2 3 ...] по умолчанию. Когда разделительное значение больше, чем 0, islocalmax выбирает самый большой локальный максимум и игнорирует все другие локальные максимумы в рамках заданного разделения. Этот процесс повторяется, пока больше нет локальных обнаруженных максимумов.

Когда вектор точек выборки имеет, вводят datetime, разделительное значение должно иметь, вводят duration.

Типы данных: единственный | удваиваются | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64 | длительность

Максимальное количество максимумов, обнаруженных, заданных как пара, разделенная запятой, состоящая из 'MaxNumExtrema' и положительного целочисленного скаляра. islocalmax находит не больше, чем конкретное количество большинства видных максимумов, которое является длиной операционной размерности по умолчанию.

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

Точки выборки, заданные как пара, разделенная запятой, состоящая из 'SamplePoints' и вектора. Точки выборки представляют местоположение данных в A. Точки выборки не должны быть однородно выбраны, но должны быть отсортированы с уникальными элементами. По умолчанию вектором точек выборки является [1 2 3 ...].

islocalmax не поддерживает эту пару "имя-значение", когда входные данные являются расписанием.

Типы данных: удвойтесь | единственный | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64 | datetime | длительность

Табличные переменные, заданные как пара, разделенная запятой, состоящая из 'DataVariables' и имени переменной, массива ячеек имен переменных, числового вектора, логического вектора или указателя на функцию. Значение 'DataVariables' указывает который столбцы входной таблицы или расписания, чтобы работать с. Это значение может быть одним из следующего:

  • Вектор символа, задающий единственное имя табличной переменной

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

  • Вектор индексов табличной переменной

  • Логический вектор, элементы которого каждый соответствует табличной переменной, где true включает соответствующую переменную и false, исключает его

  • Указатель на функцию, который берет табличную переменную в качестве входного параметра и возвращает логический скаляр

Заданные табличные переменные должны иметь числовой или тип logical.

Пример: 'Возраст'

Пример: {'Высота', 'Вес'}

Пример: isnumeric

Типы данных: char | ячейка | удваивается | единственный | логический | function_handle

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

свернуть все

Локальный индикатор максимумов, возвращенный как вектор, матрица или многомерный массив. TF одного размера как A.

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

Выдающееся положение, возвращенное как вектор, матрица или многомерный массив. P одного размера как A.

Если входные данные имеют целое число со знаком или тип беззнаковых целых чисел, то P является беззнаковым целым.

Больше о

свернуть все

Выдающееся положение локального максимума

Выдающееся положение локального максимума (или пик) измеряется, как пик выделяется относительно своей высоты и местоположения относительно другого peaks.

Чтобы измерить выдающееся положение пика, сначала расширьте горизонтальную строку от пика налево и справа от пика. Найдите, где строка пересекает данные слева и справа, который или будет другим пиком или концом данных. Отметьте эти местоположения как внешние конечные точки левых и правых интервалов. Затем, найдите самую низкую долину в обоих интервалах. Возьмите большие из этих двух долин и измерьте вертикальное расстояние от той долины до пика. Это расстояние является выдающимся положением.

Для векторного x самое большое выдающееся положение в большей части max(x)-min(x).

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

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

| | |

Введенный в R2017b

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