이 번역 페이지는 최신 내용을 담고 있지 않습니다. 최신 내용을 영문으로 보려면 여기를 클릭하십시오.

islocalmax

국소 최댓값 구하기

구문

TF = islocalmax(A)

TF = islocalmax(A,dim)

TF = islocalmax(___,Name,Value)

[TF,P] = islocalmax(___)

설명

TF = islocalmax(A)는 A의 요소에서 국소 최댓값이 발견되면 이에 대응하는 요소가 1(true)인 논리형 배열을 반환합니다.

라이브 스크립트에 국소 극값 찾기 작업을 추가하여 islocalmax 기능을 대화형 방식으로 사용할 수 있습니다.

TF = islocalmax(A,dim)은 함수 동작이 수행될 A의 차원을 지정합니다. 예를 들어, islocalmax(A,2)는 행렬 A를 구성하는 각 행의 국소 최댓값을 구합니다.

TF = islocalmax(___,Name,Value)는 국소 최댓값을 찾기 위해 위에 열거된 구문의 입력 인수 조합 중 하나와 더불어 하나 이상의 이름-값 인수를 사용하여 파라미터를 지정합니다. 예를 들어, islocalmax(A,'SamplePoints',t)는 시간 벡터 t에 포함된 타임스탬프 값 대비 A의 국소 최댓값을 구합니다.

[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 = 5×5 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

입력 인수

A — 입력 데이터

벡터 | 행렬 | 다차원 배열 | 테이블 | 타임테이블

입력 데이터로, 벡터, 행렬, 다차원 배열, table형 또는 timetable형으로 지정됩니다.

dim — 연산 차원

양의 정수 스칼라

연산 차원으로, 양의 정수 스칼라로 지정됩니다. 값이 지정되지 않은 경우 디폴트 값은 크기가 1이 아닌 첫 번째 배열 차원이 됩니다.

m×n 입력 행렬 A가 있다고 가정합니다.

• islocalmax(A,1)은 A의 각 열에 있는 데이터에 따라 국소 최댓값을 계산하고 m×n 행렬을 반환합니다.

  

• islocalmax(A,2)는 A의 각 행에 있는 데이터에 따라 국소 최댓값을 계산하고 m×n 행렬을 반환합니다.

  

table형 또는 timetable형 입력 데이터의 경우 dim은 지원되지 않으며 연산은 각 테이블 변수나 타임테이블 변수를 따라 개별적으로 수행됩니다.

이름-값 인수

선택적 인수 쌍을 Name1=Value1,...,NameN=ValueN으로 지정합니다. 여기서 Name은 인수 이름이고 Value는 대응값입니다. 이름-값 인수는 다른 인수 뒤에 와야 하지만, 인수 쌍의 순서는 상관없습니다.

R2021a 이전 릴리스에서는 쉼표를 사용하여 각 이름과 값을 구분하고 Name을 따옴표로 묶으십시오.

예: TF = islocalmax(A,'MinProminence',2)

데이터 옵션

SamplePoints — 샘플 점

벡터 | 테이블 변수 이름 | 스칼라 | 함수 핸들 | 테이블 vartype 첨자

샘플 점으로, 샘플 점 값으로 구성된 벡터로 지정되거나 입력 데이터가 테이블인 경우 다음 표에 나와 있는 옵션 중 하나로 지정됩니다. 샘플 점은 데이터의 x축 위치를 나타내며, 이 샘플 점은 정렬되고 고유한 요소를 가져야 합니다. 샘플 점은 균일하게 샘플링할 필요가 없습니다. 벡터 [1 2 3 ...]이 디폴트 값입니다.

입력 데이터가 테이블이면 다음 옵션 중 하나를 사용하여 샘플 점을 테이블 변수로 지정할 수 있습니다.

인덱싱 방식	예제
변수 이름: string형 스칼라 또는 문자형 벡터	"A" 또는 'A' — A라는 변수
변수 인덱스: 테이블에서의 변수 위치를 나타내는 인덱스 번호 논리형 벡터. 일반적으로 이 벡터는 변수의 개수와 길이가 같지만 후행 0 값 또는 false 값을 생략할 수 있음	3 — 테이블의 세 번째 변수 [false false true] — 세 번째 변수
함수 핸들: 테이블 변수를 입력값으로 받고 논리형 스칼라를 반환하는 함수 핸들	@isnumeric — 숫자형 값을 포함하는 하나의 변수
변수 유형: 지정된 유형의 변수 하나를 선택하는 vartype 첨자	vartype("numeric") — 숫자형 값을 포함하는 하나의 변수

참고

입력 데이터가 timetable형인 경우에는 이 이름-값 인수가 지원되지 않습니다. 타임테이블은 행 시간값으로 구성된 벡터를 샘플 점으로 사용합니다. 다른 샘플 점을 사용하려면 행 시간값이 원하는 샘플 점을 포함하도록 타임테이블을 편집해야 합니다.

예: islocalmax(A,'SamplePoints',0:0.1:10)

예: islocalmax(T,'SamplePoints',"Var1")

DataVariables — 연산을 수행할 테이블 변수

테이블 변수 이름 | 스칼라 | 벡터 | 셀형 배열 | pattern형 | 함수 핸들 | 테이블 vartype 첨자

연산을 수행할 테이블 변수로, 다음 표에 있는 옵션 중 하나로 지정됩니다. DataVariables 값은 입력 테이블에서 국소 최댓값이 있는지 조사할 변수를 나타냅니다. 지정된 변수와 연결된 데이터형은 숫자형 또는 logical형이어야 합니다.

OutputFormat의 값이 'tabular'가 아닌 경우 첫 번째 출력값 TF는 DataVariables로 지정되지 않은 변수에 대해 false를 포함합니다.

인덱싱 방식	지정할 값	예제
변수 이름	string형 스칼라 또는 문자형 벡터 string형 배열 또는 문자형 벡터로 구성된 셀형 배열 pattern 객체	"A" 또는 'A' — A라는 변수 ["A" "B"] 또는 {'A','B'} — A 및 B라는 두 개의 변수 "Var"+digitsPattern(1) — "Var" 다음에 하나의 숫자가 오는 이름을 갖는 변수
변수 인덱스	테이블에서의 변수 위치를 나타내는 인덱스 번호 숫자로 구성된 벡터 logical형 벡터. 일반적으로 이 벡터는 변수의 개수와 길이가 같지만 후행 0(false) 값을 생략할 수 있습니다.	3 — 테이블의 세 번째 변수 [2 3] — 테이블의 두 번째 변수와 세 번째 변수 [false false true] — 세 번째 변수
함수 핸들	테이블 변수를 입력값으로 받고 logical형 스칼라를 반환하는 함수 핸들	@isnumeric — 숫자형 값을 포함하는 모든 변수
변수 유형	지정된 유형의 변수를 선택하는 vartype 첨자	vartype("numeric") — 숫자형 값을 포함하는 모든 변수

예: islocalmax(T,'DataVariables',["Var1" "Var2" "Var4"])

OutputFormat — 출력 데이터형

'logical' (디폴트 값) | 'tabular'

출력 데이터형으로, 다음 값 중 하나로 지정됩니다.

• 'logical' — table형 또는 timetable형 입력 데이터의 경우 출력값 TF를 논리형 배열로 반환합니다.

• 'tabular' — table형 입력 데이터의 경우 출력값 TF를 table형으로 반환합니다. timetable형 입력 데이터의 경우 출력값 TF를 timetable형으로 반환합니다.

벡터, 행렬 또는 다차원 배열 입력 데이터에는 OutputFormat이 지원되지 않습니다.

예: islocalmax(T,'OutputFormat','tabular')

극값 감지 옵션

MinProminence — 최소 돌출부

0 (디폴트 값) | 음이 아닌 스칼라

최소 돌출부로, 음이 아닌 스칼라로 지정됩니다. islocalmax는 돌출부가 이 지정값 이상인 국소 최댓값만 반환합니다.

ProminenceWindow — 돌출부 윈도우

양의 정수 스칼라 | 양의 정수로 구성된 요소를 2개 가진 벡터 | 양의 duration형 스칼라 | 양의 duration형으로 구성된 요소를 2개 가진 벡터

돌출부 윈도우로, 양의 정수 스칼라, 양의 정수로 구성된 요소를 2개 가진 벡터, 양의 duration형 스칼라 또는 양의 duration형으로 구성된 요소를 2개 가진 벡터로 지정됩니다. 이 값은 각 국소 최댓값의 돌출부를 계산할 인접 점의 윈도우를 정의합니다.

윈도우 값이 양의 정수 스칼라 k인 경우 윈도우는 각각의 국소 최댓값 지점을 중심으로 하며, k-1개의 인접 요소를 가집니다. k가 짝수이면 윈도우의 중심은 현재 요소 및 이전 요소가 됩니다. 국소 최댓값이 평탄 영역 내에 있는 경우 islocalmax는 전체 평탄 영역을 윈도우의 중심점으로 취급합니다.

이 값이 양의 정수 요소를 2개 가진 벡터 [b f]인 경우 윈도우에는 국소 최댓값, 국소 최댓값의 역방향으로 b개 요소, 그리고 국소 최댓값의 정방향으로 f개 요소가 포함됩니다. 국소 최댓값이 평탄 영역 내에 있는 경우 윈도우는 평탄 영역의 첫 번째 점으로부터 b개 요소 앞에서 시작하고 평탄 영역의 마지막 점으로부터 f개 요소 뒤에서 끝납니다.

입력 데이터가 timetable형이거나 SamplePoints가 datetime형 또는 duration형 벡터로 지정된 경우 윈도우 값은 duration형이어야 하며, 윈도우는 샘플 점을 기준으로 하여 계산됩니다.

FlatSelection — 평탄 영역 표시자

'center' (디폴트 값) | 'first' | 'last' | 'all'

국소 최댓값이 연속으로 반복되는 경우에 대한 평탄 영역 표시자로, 다음 값 중 하나로 지정됩니다.

• 'center' — 평탄 영역의 중앙 요소만 국소 최댓값으로 나타냅니다. 평탄 영역의 중앙에 해당하는 TF의 요소가 1이 되고 나머지 요소는 0이 됩니다.

• 'first' — 평탄 영역의 첫 번째 요소만 국소 최댓값으로 나타냅니다. 평탄 영역의 시작 지점에 해당하는 TF의 요소가 1이 되고 나머지 요소는 0이 됩니다.

• 'last' — 평탄 영역의 마지막 요소만 국소 최댓값으로 나타냅니다. 평탄 영역의 끝 지점에 해당하는 TF의 요소가 1이 되고 나머지 요소는 0이 됩니다.

• 'all' — 평탄 영역의 모든 요소를 국소 최댓값으로 나타냅니다. 평탄 영역에 해당하는 모든 TF의 요소가 1이 됩니다.

MinSeparation 또는 MaxNumExtrema 이름-값 인수를 사용하면 평탄 영역의 점들은 다 같이 하나의 국소 최댓값으로 간주됩니다.

MinSeparation — 최소 간격

0 (디폴트 값) | 음이 아닌 스칼라

국소 최댓값 간의 최소 간격으로, 음이 아닌 스칼라로 지정됩니다. 간격 값은 샘플 점 벡터와 같은 단위로 정의되며, 이것은 기본적으로 [1 2 3 ...]입니다. 간격 값이 0보다 크면 islocalmax는 가장 큰 국소 최댓값을 선택하고 지정된 간격 내 다른 모든 국소 최댓값은 무시합니다. 이 과정은 더 이상 국소 최댓값이 발견되지 않을 때까지 반복됩니다.

샘플 점 벡터가 datetime형을 사용할 경우 간격 값은 duration형을 사용해야 합니다.

MaxNumExtrema — 최대 국소 최댓값 개수

양의 정수 스칼라

국소 최댓값의 최대 개수로, 양의 정수 스칼라로 지정됩니다. islocalmax는 지정된 최대 개수만큼의 가장 두드러진 국소 최댓값을 찾습니다. 이 개수는 기본적으로 연산 차원의 길이입니다.

출력 인수

TF — 국소 최댓값 표시자

벡터 | 행렬 | 다차원 배열 | 테이블 | 타임테이블

국소 최댓값 표시자로, 벡터, 행렬, 다차원 배열, table형 또는 timetable형으로 반환됩니다.

OutputFormat의 값이 'tabular'가 아닌 경우 TF는 A와 크기가 동일합니다. OutputFormat의 값이 'tabular'이면 TF는 지정된 DataVariables에 대응하는 변수만 가집니다.

데이터형: logical

P — 돌출부

벡터 | 행렬 | 다차원 배열 | 테이블 | 타임테이블

돌출부로, 벡터, 행렬, 다차원 배열, table형 또는 timetable형으로 반환됩니다.

• P가 벡터, 행렬 또는 다차원 배열이면 P는 A와 크기가 동일합니다.

• P가 table형이나 timetable형이면 P는 A와 높이가 동일하고 지정된 DataVariables에 대응하는 변수만 가집니다.

입력 데이터의 유형이 부호 있는 정수나 부호 없는 정수인 경우, P는 부호 없는 정수가 됩니다.

알고리즘

islocalmax 함수는 입력 데이터의 모든 국소 최댓값(또는 피크)을 식별하고 다음 단계를 따라 각 국소 최댓값의 돌출부를 계산합니다. 국소 최댓값의 돌출부는 어떠한 피크가 높이와 위치 측면에서 다른 피크에 비해 얼마나 두드러지는지를 측정합니다.

1. 가로선을 현재 피크의 왼쪽과 오른쪽에 그립니다. 가로선을 그리다가 데이터의 끝이나 데이터 교차 지점에 도달하면 멈춥니다.

2. 가로선 아래에 있는 밸리를 식별합니다.

3. 그러한 밸리 중 가장 높은 밸리를 기저 값으로 사용합니다. 돌출부는 현재 국소 최댓값의 높이와 기저 값의 절대 차이입니다.

대체 기능

라이브 편집기 작업

라이브 스크립트에 국소 극값 찾기 작업을 추가하여 islocalmax 기능을 대화형 방식으로 사용할 수 있습니다.

확장 기능

tall형 배열

메모리에 담을 수 없을 정도로 많은 행을 가진 배열을 계산할 수 있습니다.

islocalmax 함수는 tall형 배열을 지원하지만 다음과 같은 사용법 관련 참고 및 제한 사항이 있습니다.

• tall형 타임테이블은 지원되지 않습니다.

• ProminenceWindow 이름-값 인수에 대한 값을 지정해야 합니다.

• MaxNumExtrema, MinSeparation 및 SamplePoints 이름-값 인수는 지원되지 않습니다.

• DataVariables의 값은 함수 핸들일 수 없습니다.

자세한 내용은 tall형 배열 항목을 참조하십시오.

C/C++ 코드 생성

MATLAB® Coder™를 사용하여 C 코드나 C++ 코드를 생성할 수 있습니다.

사용법 관련 참고 및 제한 사항:

• 가변 크기 배열에 대한 지원을 활성화해야 합니다.

• ProminenceWindow 이름-값 인수는 지원되지 않습니다.

스레드 기반 환경

MATLAB®의 backgroundPool을 사용해 백그라운드에서 코드를 실행하거나 Parallel Computing Toolbox™의 ThreadPool을 사용해 코드 실행 속도를 높일 수 있습니다.

이 함수는 스레드 기반 환경을 완전히 지원합니다. 자세한 내용은 스레드 기반 환경에서 MATLAB 함수 실행하기 항목을 참조하십시오.

GPU 배열

Parallel Computing Toolbox™를 사용해 GPU(그래픽스 처리 장치)에서 실행하여 코드 실행 속도를 높일 수 있습니다.

islocalmax 함수는 GPU 배열을 완전히 지원합니다. GPU에서 이 함수를 실행하려면 입력 데이터를 gpuArray (Parallel Computing Toolbox)로 지정하십시오. 자세한 내용은 GPU에서 MATLAB 함수 실행하기 (Parallel Computing Toolbox) 항목을 참조하십시오.

버전 내역

R2017b에 개발됨

R2022a: 논리형 출력값을 포함하는 테이블 또는 타임테이블 반환

table형 또는 timetable형 입력 데이터의 경우 OutputFormat 이름-값 인수를 'tabular'로 설정하여 논리형 배열 대신 테이블 형식 출력값 TF를 반환합니다.

R2021b: 샘플 점을 테이블 변수로 지정

table형 입력 데이터의 경우, SamplePoints 이름-값 인수를 사용하여 샘플 점을 테이블 변수로 지정합니다.

참고 항목

함수

• max | islocalmax2 | isoutlier | ischange | islocalmin

라이브 편집기 작업

• 국소 극값 찾기

도움말 항목

• 라이브 편집기 작업을 사용하여 정리되지 않은 데이터 정리 및 극값 찾기