Main Content

cummax

누적 최댓값(Cumulative Maximum)

페이지 내 모두 축소

구문

M = cummax(A)
M = cummax(A,dim)
M = cummax(___,direction)
M = cummax(___,nanflag)

설명

예제

M = cummax(A)는 A의 누적 최대 요소를 반환합니다. 기본적으로 cummax(A)는 크기가 1이 아닌 첫 번째 배열 차원을 따라 동작합니다.

  • A가 벡터이면 cummax(A)는 A의 누적 최댓값을 포함하는, 동일한 크기의 벡터를 반환합니다.

  • A가 행렬이면 cummax(A)는 A의 각 열의 누적 최댓값을 포함하는, 동일한 크기의 행렬을 반환합니다.

  • A가 다차원 배열이면 cummax(A)는 A의 차원 중 크기가 1이 아닌 첫 번째 배열 차원을 따라 누적 최댓값(Cumulative Maximum)을 구하고, 동일한 크기의 배열을 반환합니다.

예제

M = cummax(A,dim)은 차원 dim을 따라 누적 최댓값을 반환합니다. 예를 들어, A가 행렬인 경우 cummax(A,2)는 A의 행을 따라 누적 최댓값을 반환합니다.

예제

M = cummax(___,direction)은 위에 열거된 구문 중 하나를 사용하고 선택적으로 방향을 지정합니다. A는 반드시 지정해야 하며, dim을 선택적으로 지정할 수 있습니다. 예를 들어, cummax(A,2,'reverse')는 A의 두 번째 차원의 끝에서 시작 방향으로 작업하여 A의 누적 최댓값을 반환합니다.

예제

M = cummax(___,nanflag)는 위에 열거된 구문의 계산에 NaN 값을 포함시킬지 또는 생략할지 여부를 지정합니다. cummax(A,'includenan')은 계산에 모든 NaN 값을 포함시키는 반면 cummax(A,'omitnan')은 NaN 값을 무시합니다.

예제

모두 축소

라이브 스크립트 열기

임의의 정수로 구성된 1×10 벡터의 누적 최댓값을 구합니다. 

v = randi(10,1,10)
v = 1×10

     9    10     2    10     7     1     3     6    10    10


M = cummax(v)
M = 1×10

     9    10    10    10    10    10    10    10    10    10
라이브 스크립트 열기

3×3 행렬에서 열의 누적 최댓값을 구합니다. 

A = [3 5 2; 1 6 3; 7 8 1]
A = 3×3

     3     5     2
     1     6     3
     7     8     1


M = cummax(A)
M = 3×3

     3     5     2
     3     6     3
     7     8     3
라이브 스크립트 열기

3×3 행렬에서 행의 누적 최댓값을 구합니다. 

A = [3 5 2; 1 6 3; 7 8 1]
A = 3×3

     3     5     2
     1     6     3
     7     8     1


M = cummax(A,2)
M = 3×3

     3     5     5
     1     6     6
     7     8     8
라이브 스크립트 열기

2×2×3 배열에서 세 번째 차원의 누적 최댓값을 계산합니다. direction을 'reverse'로 지정하여 세 번째 차원의 끝에서 시작 방향으로 작업하도록 합니다. 

A = cat(3,[1 2; 3 4],[9 10; 11 12],[5 6; 7 8])
A = 
A(:,:,1) =

     1     2
     3     4


A(:,:,2) =

     9    10
    11    12


A(:,:,3) =

     5     6
     7     8


M = cummax(A,3,'reverse')
M = 
M(:,:,1) =

     9    10
    11    12


M(:,:,2) =

     9    10
    11    12


M(:,:,3) =

     5     6
     7     8
라이브 스크립트 열기

NaN 값을 포함하는 벡터를 만든 다음 누적 최댓값을 계산합니다. 기본적으로 cummax는 NaN 값을 무시합니다.

A = [3 5 NaN 9 0 NaN];
M = cummax(A)
M = 1×6

     3     5     5     9     9     9

계산에 NaN 값을 포함시키면 A에서 첫 번째 NaN 값이 발견되는 즉시 누적 최댓값은 NaN이 됩니다.

M = cummax(A,'includenan')
M = 1×6

     3     5   NaN   NaN   NaN   NaN

입력 인수

모두 축소

입력 배열로, 벡터, 행렬, 다차원 배열 중 하나로 지정됩니다. 복소수 요소의 경우 cummax는 요소의 크기를 비교합니다. 크기가 같을 경우 cummax는 위상각을 비교합니다.

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

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

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

  • cummax(A,1)은 A의 열에 있는 연속된 요소에 대해 동작을 수행하고 각 열의 누적 최댓값을 포함하는, A와 동일한 크기의 배열을 반환합니다.

    cummax(A,1) column-wise operation

  • cummax(A,2)는 A의 행에 있는 연속된 요소에 대해 동작을 수행하고 각 행의 누적 최댓값을 포함하는, A와 동일한 크기의 배열을 반환합니다.

    cummax(A,2) row-wise operation

dim이 ndims(A)보다 큰 경우 cummax는 A를 반환합니다.

누적 방향으로, 'forward'(디폴트 값) 또는 'reverse'로 지정됩니다.

  • 'forward'는 활성 차원의 1에서 end 방향으로 동작합니다.

  • 'reverse'는 활성 차원의 end에서 1 방향으로 동작합니다.

데이터형: char

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

  • 'omitnan' — 입력값의 모든 NaN 값을 무시합니다. 입력값에 연속된 선행 NaN 값이 있는 경우 cummax는 출력값의 대응하는 요소에 NaN을 반환합니다. 예를 들어, cummax([NaN 7 13 6],'omitnan')은 행 벡터 [NaN 7 13 13]을 반환합니다.

  • 'includenan' — 누적 최댓값을 계산할 때 입력값의 NaN 값을 포함하며 출력값에 NaN 값을 반환합니다.

출력 인수

모두 축소

누적 최댓값으로, 벡터, 행렬, 다차원 배열 중 하나로 반환됩니다. M의 크기와 데이터형은 A의 크기와 데이터형과 같습니다.

팁

  • 많은 누적 함수에서 'reverse' 옵션을 사용하면 입력 배열을 뒤집거나 반사하지 않고도 방향 계산을 빠르게 수행할 수 있습니다.

확장 기능

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

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

버전 내역

R2014b에 개발됨

참고 항목

| | | | |