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

cummax

누적 최댓값(Cumulative Maximum)

설명

예제

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 값을 무시합니다.

예제

모두 축소

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

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

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

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

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

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

2x2x3 배열에서 세 번째 차원의 누적 최댓값을 계산합니다. 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 값을 포함하는 벡터를 만든 다음 누적 최댓값을 계산합니다. 기본적으로 cummaxNaN 값을 무시합니다.

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,2)A의 행에 있는 연속된 요소에 대해 동작을 수행하고 각 행의 누적 최댓값을 포함하는, A와 동일한 크기의 배열을 반환합니다.

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

누적 방향으로, '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 값을 반환합니다.

데이터형: char

출력 인수

모두 축소

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

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

확장 기능

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

참고 항목

| | | | |

R2014b에 개발됨