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

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 값이 포함된 벡터

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

입력 인수

A — 입력 배열

벡터 | 행렬 | 다차원 배열

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

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

dim — 함수 동작이 수행될 차원

양의 정수 스칼라

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

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

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

  

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

  

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

direction — 누적 방향

'forward' (디폴트 값) | 'reverse'

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

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

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

데이터형: char

nanflag — NaN 조건

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

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

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

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

데이터형: char

출력 인수

M — 누적 최댓값

벡터 | 행렬 | 다차원 배열

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

팁

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

확장 기능

tall형 배열

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

이 함수는 tall형 배열을 지원하지만 다음과 같은 제한 사항이 있습니다.

'reverse' 방향은 지원되지 않습니다.

자세한 내용은 tall형 배열 항목을 참조하십시오.

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

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

GPU 배열

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

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

• nanflag 인수는 지원되지 않습니다.

자세한 내용은 GPU에서 MATLAB 함수 실행하기 (Parallel Computing Toolbox) 항목을 참조하십시오.

분산 배열

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

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

참고 항목

cummin | cumprod | cumsum | max | min | movmax

R2014b에 개발됨

×

예제 열기

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

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