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

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

예제

벡터의 누적 최댓값

임의의 정수로 구성된 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 값이 포함된 벡터

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에 개발됨

×

예제 열기

귀하의 시스템에 이 예제의 수정된 버전이 있습니다. 이 버전을 대신 여시겠습니까?

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