maxk

배열에서 가장 큰 k개 요소 찾기

구문

B = maxk(A,k)

B = maxk(A,k,dim)

B = maxk(___,'ComparisonMethod',c)

[B,I] = maxk(___)

설명

B = maxk(A,k)는 A의 가장 큰 k개 요소를 반환합니다.

• A가 벡터인 경우 maxk는 A의 가장 큰 k개 요소가 포함된 벡터를 반환합니다.

• A가 행렬인 경우 maxk는 행렬을 반환합니다. 반환되는 행렬의 각 열에는 대응하는 A의 열의 가장 큰 k개 요소가 포함됩니다.

• A가 다차원 배열인 경우 maxk는 크기가 1이 아닌 첫 번째 차원의 가장 큰 k개 요소를 반환합니다.

B = maxk(A,k,dim)은 차원 dim에 있는 A의 가장 큰 k개 요소를 판별합니다.

B = maxk(___,'ComparisonMethod',c)는 위에 열거된 구문을 사용하고 A의 요소를 비교하는 방식을 선택 사항으로 지정합니다. 예를 들어, maxk(A,k,'ComparisonMethod','abs')는 절댓값을 기준으로 A의 가장 큰 k개 요소를 반환합니다.

[B,I] = maxk(___)는 A에서 가장 큰 k개 값의 인덱스를 찾아서 I에 반환합니다.

예제

벡터에서 가장 큰 요소

벡터에서 가장 큰 요소 3개를 계산합니다.

A = 1:10;
B = maxk(A,3)

B = 1×3

    10     9     8

행렬 행에서 가장 큰 요소

행렬의 각 행에서 가장 큰 요소 3개를 계산합니다.

A = magic(5)

A = 5×5

    17    24     1     8    15
    23     5     7    14    16
     4     6    13    20    22
    10    12    19    21     3
    11    18    25     2     9

B = maxk(A,3,2)

B = 5×3

    24    17    15
    23    16    14
    22    20    13
    21    19    12
    25    18    11

복소수 벡터

값의 크기 기준으로 복소수 벡터에서 가장 큰 요소 2개를 계산하고 입력 벡터 내 이들 요소의 위치에 대한 인덱스를 반환합니다.

A = [2-2i 5+i -7-3i -1+i]

A = 1×4 complex

   2.0000 - 2.0000i   5.0000 + 1.0000i  -7.0000 - 3.0000i  -1.0000 + 1.0000i

[B,I] = maxk(A,2,'ComparisonMethod','abs')

B = 1×2 complex

  -7.0000 - 3.0000i   5.0000 + 1.0000i

I = 1×2

     3     2

입력 인수

A — 입력 배열

벡터 | 행렬 | 다차원 배열

입력 배열로, 벡터, 행렬, 다차원 배열 중 하나로 지정됩니다.

• A가 벡터인 경우 maxk는 A의 가장 큰 k개 요소가 포함된 벡터를 반환합니다.

• A가 행렬인 경우 maxk는 행렬을 반환합니다. 반환되는 행렬의 각 열에는 대응하는 A의 열의 가장 큰 k개 요소가 포함됩니다.

• A가 다차원 배열인 경우 maxk는 크기가 1이 아닌 첫 번째 차원의 가장 큰 k개 요소를 반환합니다.

A의 유형이 categorical형이면 서수형이어야 합니다.

데이터형: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64 | logical | char | categorical | datetime | duration
복소수 지원 여부: 예

k — 최댓값의 개수

음이 아닌 정수 스칼라

반환할 최댓값 개수로, 양의 정수 스칼라로 지정됩니다. k가 연산 차원에 있는 요소 수보다 크거나 같으면 maxk는 해당 차원을 따라 입력 배열을 정렬합니다.

dim — 연산 차원

양의 정수 스칼라

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

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

• maxk(A,k,1)은 A의 각 열에서 가장 큰 k개 값을 구하고, k×n 행렬을 반환합니다.

  

• maxk(A,k,2)는 A의 각 행에서 가장 큰 k개 값을 구하고, m×k 행렬을 반환합니다.

  

c — 비교 방법

'auto' (디폴트 값) | 'real' | 'abs'

비교 방법으로, 다음 중 하나로 지정됩니다.

• 'auto' — A가 실수인 경우 real(A)를 사용하고, A가 복소수인 경우 abs(A)를 사용하여 입력값 A의 요소를 비교합니다.

• 'real' — A가 실수나 복소수인 경우 real(A)를 사용하여 입력값 A의 요소를 비교합니다. A에 실수부가 동일한 요소가 있는 경우, imag(A)를 사용하여 우선 순위를 결정합니다.

• 'abs' — A가 실수나 복소수인 경우 abs(A)를 사용하여 입력값 A의 요소를 비교합니다. A에 크기가 동일한 요소가 있는 경우, 구간 (-π,π]에서의 angle(A)를 사용하여 우선 순위를 결정합니다.

출력 인수

B — 출력 배열

스칼라 | 벡터 | 행렬 | 다차원 배열

출력 배열로, 스칼라, 벡터, 행렬 또는 다차원 배열로 반환됩니다. maxk는 가장 큰 요소부터 가장 작은 요소의 순서로, k개 요소를 반환합니다. A에 같은 요소가 여러 개 있는 경우 그들 간의 순서는 B에서도 그대로 유지됩니다.

I — 인덱스 배열

스칼라 | 벡터 | 행렬 | 다차원 배열

인덱스 배열로, 벡터, 행렬 또는 다차원 배열로 반환됩니다. I는 B와 크기가 동일합니다. 출력 배열 B에 반복되는 요소가 들어 있으면 I에서 인덱스의 순서는 입력 배열에서 나타나는 순서와 일치합니다.

확장 기능

tall형 배열

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

maxk 함수는 tall형 배열을 완전히 지원합니다. 자세한 내용은 tall형 배열 항목을 참조하십시오.

C/C++ 코드 생성

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

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

• 입력 인수 A에 대해 다음이 적용됩니다.

  • 차원을 지정하지 않을 경우 코드 생성기는 입력 배열에서 가변 크기이거나 크기가 1이 아닌 첫 번째 차원을 따라 연산을 수행합니다. 이 차원이 코드 생성 시점에 가변 크기이고 런타임에 1인 경우, 런타임 오류가 발생할 수 있습니다. 이 오류를 피하려면 차원을 지정하십시오.

  • 생성된 코드에서 입력 배열은 모든 요소의 허수부 값이 0이더라도 복소수로 유지됩니다. 이러한 경우, 생성된 코드의 결과는 MATLAB에서 생성된 결과와 다를 수 있습니다. Code Generation for Complex Data with Zero-Valued Imaginary Parts (MATLAB Coder) 항목을 참조하십시오.

스레드 기반 환경

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

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

분산 배열

Parallel Computing Toolbox™를 사용하여 대규모 배열을 클러스터의 결합된 메모리에 걸쳐 분할할 수 있습니다.

이 함수는 분산 배열을 완전히 지원합니다. 자세한 내용은 분산 배열을 사용하여 MATLAB 함수 실행 (Parallel Computing Toolbox) 항목을 참조하십시오.

버전 내역

R2017b에 개발됨

R2025a: 숫자형 또는 논리형 데이터에 대해 많은 개수의 행을 반환할 때의 성능이 개선됨

k가 최소 512이고 연산 차원 길이의 8% 이상일 때 maxk 함수는 복소수 데이터를 포함한 숫자형 데이터와 논리형 데이터에 대해 더 높은 성능을 보입니다.

예를 들어, 다음 코드는 각 열에서 가장 큰 요소 5000개를 10,000개 행을 포함하는 숫자형 행렬로 반환합니다. 이 코드는 이전 릴리스보다 약 4.2배 빠릅니다.

function timingTest
A = rand(1e4,10);
for i = 1:120
    M = maxk(A,5000);
end
end

대략적인 실행 시간은 다음과 같습니다.

R2024b: 1.05초

R2025a: 0.25초

코드 실행 시간은 Windows^® 11, AMD EPYC™ 74F3 24-Core Processor @ 3.19GHz 테스트 시스템에서 timeit 함수를 사용하여 측정했습니다.

timeit(@timingTest)

참고 항목

max | topkrows | mink