Main Content

cummin

설명

예제

M = cummin(A)A의 누적 최소 요소를 반환합니다.

  • A가 벡터이면 M은 동일한 크기와 유형의 벡터이며 A의 누적 최솟값을 포함합니다.

  • A가 행렬이면 M은 동일한 크기와 유형의 행렬이며 A의 각 열의 누적 최솟값을 포함합니다.

  • A가 다차원 배열이면 M은 동일한 크기와 유형의 배열이며, A의 차원 중 크기가 1보다 큰 첫 번째 배열 차원을 따라 누적 최솟값을 포함합니다.

  • A가 테이블 또는 타임테이블이면 cummin(A)는 각 변수의 누적 최솟값을 포함하는 테이블 또는 타임테이블을 반환합니다. (R2023a 이후)

예제

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

예제

M = cummin(___,direction)은 위에 열거된 구문에 대해 방향을 지정합니다. 예를 들어, cummin(A,2,"reverse")A의 두 번째 차원의 끝에서 시작 방향으로 작업하여 A의 누적 최솟값을 반환합니다.

예제

M = cummin(___,nanflag)ANaN 값을 생략할지 또는 포함할지 여부를 지정합니다. 예를 들어, cummin(A,"includenan")은 각 최솟값을 구할 때 NaN 값을 포함합니다. 기본적으로 cumminNaN 값을 생략합니다.

예제

모두 축소

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

v = randi([0,10],1,10)
v = 1×10

     8     9     1    10     6     1     3     6    10    10

M = cummin(v)
M = 1×10

     8     8     1     1     1     1     1     1     1     1

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 = cummin(A)
M = 3×3

     3     5     2
     1     5     2
     1     5     1

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 = cummin(A,2)
M = 3×3

     3     3     2
     1     1     1
     7     7     1

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 = cummin(A,3,"reverse")
M = 
M(:,:,1) =

     1     2
     3     4


M(:,:,2) =

     5     6
     7     8


M(:,:,3) =

     5     6
     7     8

NaN 값이 포함된 행렬을 만듭니다.

A = [3 5 NaN 4; 2 6 2 9; 1 3 0 NaN]
A = 3×4

     3     5   NaN     4
     2     6     2     9
     1     3     0   NaN

NaN 값을 포함하여 행렬의 누적 최솟값을 구합니다. NaN 값이 포함된 행렬 열의 경우 첫 번째 NaN 값이 발견되는 즉시 누적 최솟값은 NaN이 됩니다.

M = cummin(A,"includenan")
M = 3×4

     3     5   NaN     4
     2     5   NaN     4
     1     3   NaN   NaN

입력 인수

모두 축소

입력 배열로, 벡터, 행렬, 다차원 배열, table형 또는 timetable형으로 지정됩니다. 복소수 요소의 경우 cummin은 요소의 크기를 비교합니다. 크기가 같을 경우 cummin은 위상각을 비교합니다.

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

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

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

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

    cummin(A,1) column-wise operation

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

    cummin(A,2) row-wise operation

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

누적 방향으로, 다음 값 중 하나로 지정됩니다.

  • "forward" — 연산 차원의 1에서 end 방향으로 동작합니다.

  • "reverse" — 연산 차원의 end에서 1 방향으로 동작합니다.

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

  • "omitmissing" 또는 "omitnan" — 누적 최솟값을 계산할 때 ANaN 값을 무시합니다. A에 연속된 선행 NaN 값이 있는 경우 M의 대응하는 요소는 NaN입니다. "omitmissing""omitnan"은 동일하게 동작합니다.

  • "includemissing" 또는 "includenan" — 누적 최솟값을 계산할 때 ANaN 값을 포함합니다. A에서 첫 번째 NaN 값이 발견되는 즉시 M의 요소는 NaN이 됩니다. "includemissing""includenan"은 동일하게 동작합니다.

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

확장 기능

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

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

버전 내역

R2014b에 개발됨

모두 확장

참고 항목

| | | | |