이 페이지의 최신 내용은 아직 번역되지 않았습니다. 최신 내용은 영문으로 볼 수 있습니다.

max

배열의 최댓값 요소

설명

예제

M = max(A)는 배열의 최댓값 요소를 반환합니다.

  • A가 벡터인 경우 max(A)A의 최댓값을 반환합니다.

  • A가 행렬인 경우 max(A)는 각 열의 최댓값이 포함된 행 벡터입니다.

  • A가 다차원 배열인 경우 max(A)는 크기가 1이 아닌 첫 번째 배열 차원을 따라 동작을 수행하며, 요소를 벡터로 취급합니다. 이 차원의 크기는 1이 되고 다른 모든 차원의 크기는 변경되지 않습니다. A가 첫 번째 차원 길이가 0인 빈 배열인 경우 max(A)A와 동일한 크기의 빈 배열을 반환합니다.

예제

M = max(A,[],dim)은 차원 dim에서 최댓값 요소를 반환합니다. 예를 들어, A가 행렬인 경우 max(A,[],2)는 각 행의 최댓값이 포함된 열 벡터입니다.

예제

M = max(A,[],nanflag)는 계산에 NaN 값을 포함시킬지 또는 생략할지 여부를 지정합니다. 예를 들어, max(A,[],'includenan')A의 모든 NaN 값을 포함하는 반면 max(A,[],'omitnan')은 이러한 NaN 값을 무시합니다.

또한 M = max(A,[],dim,nanflag)nanflag 옵션을 사용할 때 연산을 수행할 차원도 지정합니다.

예제

[M,I] = max(___)는 위에 열거된 모든 구문에서 A의 최댓값에 대응하는 연산 차원에 대한 인덱스도 반환합니다.

예제

M = max(A,[],'all')A의 모든 요소에 대한 최댓값을 찾습니다. 이 구문은 MATLAB® 버전 R2018b 이상에서 유효합니다.

예제

M = max(A,[],vecdim)은 벡터 vecdim에 지정된 차원에 대한 최댓값을 구합니다. 예를 들어, A가 행렬인 경우 max(A,[],[1 2])는 차원 1과 2로 정의된 배열 슬라이스에 이 행렬의 모든 요소가 포함되어 있으므로 A의 모든 요소 중에서 최댓값을 구합니다.

M = max(A,[],'all',nanflag)nanflag 옵션을 사용할 때 A의 모든 요소 중에서 최댓값을 구합니다.

M = max(A,[],vecdim,nanflag)nanflag 옵션을 사용할 때 함수 동작이 수행될 여러 차원을 지정합니다.

예제

[M,I] = max(A,[],___,'linear')A의 최댓값에 대응하는 A에 대한 선형 인덱스를 반환합니다. 이 구문은 Acategorical형, datetime형 또는 duration형인 경우에는 지원되지 않습니다.

예제

C = max(A,B)AB의 요소를 비교해 큰 요소를 반환값으로 포함시켜 배열로 반환합니다.

또한 C = max(A,B,nanflag)NaN 값을 취급하는 방식을 지정합니다.

예제

모두 축소

벡터를 만든 다음, 벡터에서 가장 큰 요소를 구합니다.

A = [23 42 37 18 52];
M = max(A)
M = 52

복소수 벡터를 만든 다음, 이 벡터에서 가장 큰 요소(즉, 최대 크기를 갖는 요소)를 구합니다.

A = [-2+2i 4+i -1-3i];
max(A)
ans = 4.0000 + 1.0000i

행렬을 만든 다음, 각 열에서 가장 큰 요소를 구합니다.

A = [2 8 4; 7 3 9]
A = 2×3

     2     8     4
     7     3     9

M = max(A)
M = 1×3

     7     8     9

행렬을 만든 다음, 각 행에서 가장 큰 요소를 구합니다.

A = [1.7 1.2 1.5; 1.3 1.6 1.99]
A = 2×3

    1.7000    1.2000    1.5000
    1.3000    1.6000    1.9900

M = max(A,[],2)
M = 2×1

    1.7000
    1.9900

벡터를 만든 다음, 벡터에서 NaN 값을 제외한 최댓값을 구합니다.

A = [1.77 -0.005 3.98 -2.95 NaN 0.34 NaN 0.19];
M = max(A,[],'omitnan')
M = 3.9800

'omitnan'은 디폴트 옵션이므로, max(A)도 또한 같은 결과를 산출합니다.

'includenan' 플래그를 사용하여 NaN을 반환합니다.

M = max(A,[],'includenan')
M = NaN

행렬 A를 만든 다음, 각 열의 가장 큰 요소뿐 아니라 이러한 요소가 표시되는 A의 행 인덱스를 구합니다.

A = [1 9 -2; 8 4 -5]
A = 2×3

     1     9    -2
     8     4    -5

[M,I] = max(A)
M = 1×3

     8     9    -2

I = 1×3

     2     1     1

3차원 배열을 만들고 데이터의 각 페이지(행과 열)의 최댓값을 구합니다.

A(:,:,1) = [2 4; -2 1];
A(:,:,2) = [9 13; -5 7];
A(:,:,3) = [4 4; 8 -3];
M1 = max(A,[],[1 2])
M1 = 
M1(:,:,1) =

     4


M1(:,:,2) =

    13


M1(:,:,3) =

     8

R2018b부터, 배열의 모든 차원에 대한 최댓값을 구하려면 벡터 차원 인수에 각 차원을 지정하거나 'all' 옵션을 사용할 수 있습니다.

M2 = max(A,[],[1 2 3])
M2 = 13
Mall = max(A,[],'all')
Mall = 13

행렬 A를 만들고 각 행의 최댓값을 행렬 M로 반환합니다. M = A(I)를 만족하는 선형 인덱스 I도 반환하려면 'linear' 옵션을 사용하십시오.

A = [1 2 3; 4 5 6]
A = 2×3

     1     2     3
     4     5     6

[M,I] = max(A,[],2,'linear')
M = 2×1

     3
     6

I = 2×1

     5
     6

maxvals = A(I)
maxvals = 2×1

     3
     6

행렬을 만든 다음, 각 요소와 스칼라를 비교하여 가장 큰 값을 반환합니다.

A = [1 7 3; 6 2 9]
A = 2×3

     1     7     3
     6     2     9

B = 5;
C = max(A,B)
C = 2×3

     5     7     5
     6     5     9

입력 인수

모두 축소

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

  • A가 복소수이면 max(A)는 최대 크기를 갖는 복소수를 반환합니다. 최대 크기가 같은 경우 max(A)는 최대 크기와 가장 큰 위상각을 갖는 값을 반환합니다.

  • A가 스칼라이면 max(A)A를 반환합니다.

  • A가 0x0 크기의 빈 배열이면 max(A)도 0x0의 빈 배열이 됩니다.

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

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

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

차원 dim은 길이가 1로 줄어드는 차원을 나타냅니다. size(M,dim)1이 되고, size(A,dim)0이 아닌 다른 차원의 크기는 변경되지 않습니다. size(A,dim)0일 경우 max(A,dim)A와 크기가 동일한 빈 배열을 반환합니다.

2차원 입력 배열 A가 있다고 가정하겠습니다.

  • dim = 1인 경우 max(A,[],1)은 각 열의 가장 큰 요소가 포함된 행 벡터를 반환합니다.

  • dim = 2인 경우 max(A,[],2)는 각 행의 가장 큰 요소가 포함된 열 벡터를 반환합니다.

dimndims(A)보다 큰 경우 maxA를 반환합니다.

차원의 벡터로, 양의 정수의 벡터로 지정됩니다. 각 요소는 입력 배열의 차원을 나타냅니다. 지정된 연산 차원의 출력값의 길이는 1이고, 다른 모든 차원의 길이는 변경되지 않습니다.

2x3x3 입력 배열 A가 있다고 가정하겠습니다. 이때 max(A,[],[1 2])A의 각 페이지에서 얻은 최댓값을 요소로 갖는 1x1x3 배열을 반환합니다.

데이터형: double | single | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

추가 입력 배열로, 스칼라, 벡터, 행렬, 다차원 배열 중 하나로 지정됩니다. 숫자형 입력값 AB는 동일한 크기이거나 호환되는 크기를 가져야 합니다. 후자의 예로는 AMxN 행렬이고 B가 스칼라이거나 1xN 행 벡터인 경우를 들 수 있습니다. 자세한 내용은 기본 연산에 대해 호환되는 배열 크기 항목을 참조하십시오.

AB가 datetime형 배열, duration형 배열 또는 categorical형 배열인 경우, 둘 중 하나가 스칼라가 아닌 한 크기가 동일해야 합니다.

  • AB는 둘 중 하나가 double형인 경우를 제외하고 동일한 데이터형이어야 합니다. 둘 중 하나가 double형인 경우 다른 배열의 데이터형은 single형, duration형, 임의의 정수형 중 하나일 수 있습니다.

  • AB가 순서형 categorical형 배열인 경우 A와 B는 동일한 순서로 된 동일한 범주 집합을 가져야 합니다.

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

NaN 조건으로, 다음 값 중 하나로 지정됩니다.

  • 'omitnan' — 입력값의 모든 NaN 값을 무시합니다. 모든 요소가 NaN인 경우 max는 첫 번째 NaN을 반환합니다.

  • 'includenan' — 계산의 입력값에 NaN 값을 포함시킵니다.

datetime형 배열의 경우에는 'omitnat' 또는 'includenat'를 사용하여 NaT 값을 생략하거나 포함시킬 수 있습니다.

max 함수는 categorical형 배열에 대해 nanflag 옵션을 지원하지 않습니다.

데이터형: char

출력 인수

모두 축소

최댓값으로, 스칼라, 벡터, 행렬, 다차원 배열 중 하나로 반환됩니다. size(M,dim)1이 되고, size(A,dim)0이 아닌 경우 다른 차원의 크기는 대응값 A의 크기와 같게 됩니다. size(A,dim)0일 경우 MA와 크기가 동일한 빈 배열입니다.

인덱스로, 스칼라, 벡터, 행렬 또는 다차원 배열로 반환됩니다. I는 첫 번째 출력값과 크기가 동일합니다.

'linear'가 지정되지 않은 경우 I는 연산 차원에 대한 인덱스입니다. 'linear'가 지정된 경우 I는 최댓값에 대응하는 A의 선형 인덱스를 포함합니다.

가장 큰 요소가 두 개 이상 있는 경우 I는 첫 번째 값에 대한 인덱스를 포함합니다.

A 또는 B의 최대 요소로, 스칼라, 벡터, 행렬, 다차원 배열 중 하나로 반환됩니다. C의 크기는 AB의 차원의 암시적 확장(Implicit Expansion)에 의해 결정됩니다. 자세한 내용은 기본 연산에 대해 호환되는 배열 크기 항목을 참조하십시오.

C의 데이터형은 AB의 데이터형에 따라 달라집니다.

  • AB의 데이터형이 동일한 경우 CAB의 데이터형과 일치합니다.

  • A 또는 B 중 하나가 single형인 경우 Csingle형입니다.

  • AB 중 하나는 정수 데이터형이고 다른 하나는 double형 스칼라인 경우 C는 정수 데이터형이 됩니다.

확장 기능

참고 항목

| | | | |

도움말 항목

R2006a 이전에 개발됨