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

max

배열의 최댓값 요소

구문

M = max(A)

M = max(A,[],dim)

M = max(A,[],nanflag)

M = max(A,[],dim,nanflag)

[M,I] = max(___)

M = max(A,[],'all')

M = max(A,[],vecdim)

M = max(A,[],'all',nanflag)

M = max(A,[],vecdim,nanflag)

[M,I] = max(A,[],'all',___)

[M,I] = max(A,[],___,'linear')

C = max(A,B)

C = max(A,B,nanflag)

___ = max(___,'ComparisonMethod',method)

설명

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

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

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

• A가 다차원 배열인 경우 max(A)는 크기가 1이 아닌 A의 첫 번째 차원을 따라 연산을 수행하며, 요소를 벡터로 취급합니다. 이 차원의 크기는 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,[],'all',___)는 'all'을 지정할 때 A의 최댓값에 대응하는 A에 대한 선형 인덱스를 반환합니다.

[M,I] = max(A,[],___,'linear')는 A의 최댓값에 대응하는 A에 대한 선형 인덱스를 반환합니다.

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

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

___ = max(___,'ComparisonMethod',method)는 위에 열거된 구문에 대해 요소를 비교하는 방식을 선택 사항으로 지정합니다. 예를 들어, 벡터 A = [-1 2 -9]의 경우 구문 max(A,[],'ComparisonMethod','abs')는 A의 요소를 절댓값을 기준으로 비교하여 -9를 반환합니다.

예제

벡터에서 가장 큰 요소

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

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을 포함한 가장 큰 요소

벡터를 만든 다음, 벡터에서 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 — 입력 배열

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

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

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

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

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

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

복소수 지원 여부: 예

dim — 연산을 수행할 차원

양의 정수 스칼라

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

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

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

• max(A,[],1)은 A의 각 열에서 요소들의 최댓값을 구하고, 1×n 행 벡터를 반환합니다.

  

• max(A,[],2)는 A의 각 행에서 요소들의 최댓값을 구하고, m×1 열 벡터를 반환합니다.

  

vecdim — 차원의 벡터

양의 정수로 구성된 벡터

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

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

B — 추가 입력 배열

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

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

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

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

복소수 지원 여부: 예

nanflag — NaN 조건

'omitnan' (디폴트 값) | 'includenan'

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

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

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

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

categorical형 배열의 경우에는 'omitundefined' 또는 'includeundefined'를 사용하여 정의되지 않은 값을 생략하거나 포함시킬 수 있습니다.

method — 비교 방법

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

숫자형 입력값에 대한 비교 방법으로, 다음 값 중 하나로 지정됩니다.

• 'auto' — 숫자형 입력값 배열 A의 경우 A가 실수일 때 real(A)를 사용하고 A가 복소수일 때 abs(A)를 사용하여 요소를 비교합니다.

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

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

출력 인수

M — 최댓값

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

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

I — 인덱스

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

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

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

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

C — A 또는 B의 최대 요소

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

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

C의 데이터형은 A와 B의 데이터형에 따라 달라집니다.

• A와 B의 데이터형이 동일한 경우 C는 A와 B의 데이터형과 일치합니다.

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

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

확장 기능

tall형 배열

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

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

C/C++ 코드 생성

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

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

• dim 또는 nanflag를 제공하기 위해 두 번째 인수로 빈 배열을 지정하는 경우, 두 번째 인수는 0×0 차원의 고정 크기여야 합니다.

• dim 또는 nanflag를 지정하는 경우, 상수로 지정해야 합니다.

• 입력값이 가변 크기 배열인 경우, 런타임 시 연산을 수행할 차원의 길이는 0이 아니어야 합니다.

• Variable-Sizing Restrictions for Code Generation of Toolbox Functions (MATLAB Coder) 항목을 참조하십시오.

• Code Generation for Complex Data with Zero-Valued Imaginary Parts (MATLAB Coder) 항목을 참조하십시오.

GPU 코드 생성

GPU Coder™를 사용하여 NVIDIA® GPU용 CUDA® 코드를 생성할 수 있습니다.

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

• dim 또는 nanflag를 제공하기 위해 두 번째 인수로 빈 배열을 지정하는 경우, 두 번째 인수는 0×0 차원의 고정 크기여야 합니다.

• dim 또는 nanflag를 지정하는 경우, 상수로 지정해야 합니다.

• Variable-Sizing Restrictions for Code Generation of Toolbox Functions (MATLAB Coder) 항목을 참조하십시오.

• Code Generation for Complex Data with Zero-Valued Imaginary Parts (MATLAB Coder) 항목을 참조하십시오.

HDL 코드 생성

HDL Coder™를 사용하여 FPGA나 ASIC 설계용의 Verilog 코드나 VHDL 코드를 생성할 수 있습니다.

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

• 3차원 이상의 행렬 입력값은 지원되지 않습니다.

• 복소수 데이터형의 입력값은 지원되지 않습니다.

• 입력 행렬 또는 벡터는 크기가 같아야 합니다.

스레드 기반 환경

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

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

GPU 배열

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

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

분산 배열

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

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

버전 내역

R2006a 이전에 개발됨

R2021b: 비교 방법 지정

ComparisonMethod 파라미터를 사용하여 입력값의 최댓값을 결정하는 방법으로 실수 값 방법 또는 절댓값 방법을 지정합니다.

참고 항목

maxk | bounds | min | mean | median | sort | islocalmax

도움말 항목

• 배열 인덱싱

×

예제 열기

이 예제의 수정된 버전이 있습니다. 사용자가 편집한 내용을 반영하여 이 예제를 여시겠습니까?

아니요, 수정된 버전을 덮어씁니다. 예