Main Content

maxk

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

설명

예제

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

  • A가 벡터인 경우 maxkA의 가장 큰 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가 벡터인 경우 maxkA의 가장 큰 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가 연산 차원에 있는 요소 수보다 크거나 같으면 maxk는 해당 차원을 따라 입력 배열을 정렬합니다.

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

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

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

    maxk(A,k,1) column-wise operation

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

    maxk(A,k,2) row-wise operation

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

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

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

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

출력 인수

모두 축소

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

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

확장 기능

버전 내역

R2017b에 개발됨

참고 항목

| |