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

sum

배열 요소의 합

구문

S = sum(A)
S = sum(A,'all')
S = sum(A,dim)
S = sum(A,vecdim)
S = sum(___,outtype)
S = sum(___,nanflag)

설명

예제

S = sum(A)는 크기가 1이 아닌 첫 번째 배열 차원을 따라 A의 요소의 합을 반환합니다.

  • A가 벡터인 경우 sum(A)는 요소의 합을 반환합니다.

  • A가 행렬인 경우 sum(A)는 각 열의 합이 포함된 행 벡터를 반환합니다.

  • A가 다차원 배열인 경우 sum(A)는 크기가 1이 아닌 첫 번째 배열 차원을 따라 동작을 수행하며, 요소를 벡터로 취급합니다. 이 차원은 1이 되고 다른 모든 차원의 크기는 변경되지 않습니다.

예제

S = sum(A,'all')A의 모든 요소의 합을 구합니다.

예제

S = sum(A,dim)은 차원 dim에 따라 합을 반환합니다. 예를 들어, A가 행렬인 경우 sum(A,2)는 각 행의 합이 포함된 열 벡터입니다.

예제

S = sum(A,vecdim)은 벡터 vecdim에 지정된 차원을 기준으로 A의 요소의 합을 구합니다. 예를 들어, A가 행렬인 경우 sum(A,[1 2])는 차원 1과 2로 정의된 배열 슬라이스에 행렬의 모든 요소가 포함되어 있으므로 A의 모든 요소의 합이 됩니다.

예제

S = sum(___,outtype)은 위에 열거된 구문에 입력 인수 사용 시 지정된 데이터형으로 합을 반환합니다. outtype'default', 'double' 또는 'native'일 수 있습니다.

예제

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

예제

모두 축소

벡터를 만든 다음 벡터 요소의 합을 계산합니다.

A = 1:10;
S = sum(A)
S = 55

행렬을 만든 다음 각 열에 있는 요소의 합을 계산합니다.

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

     1     3     2
     4     2     5
     6     1     4

S = sum(A)
S = 1×3

    11     6    11

행렬을 만든 다음 각 행에 있는 요소의 합을 계산합니다.

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

     1     3     2
     4     2     5
     6     1     4

S = sum(A,2)
S = 3×1

     6
    11
    11

벡터 차원 인수를 사용하여 배열의 특정 슬라이스에 대해 연산합니다.

요소가 모두 1인 3차원 배열을 만듭니다.

A = ones(4,3,2);

A의 각 페이지의 요소의 합을 구하려면 벡터 차원 인수를 사용하여 합을 구할 차원(행과 열)을 지정하십시오. 두 페이지 모두 1로 구성된 4x3 행렬이므로 각 페이지의 합은 12가 됩니다.

S1 = sum(A,[1 2])
S1 = 
S1(:,:,1) =

    12


S1(:,:,2) =

    12

A를 첫 번째 차원을 따라 자르면 그 결과로 나오는 4개 페이지(각각 3x2 행렬) 의 요소의 합을 구할 수 있습니다.

S2 = sum(A,[2 3])
S2 = 4×1

     6
     6
     6
     6

두 번째 차원을 따라 자르면 각각 4x2 행렬이 되는 페이지의 합을 구할 수 있습니다.

S3 = sum(A,[1 3])
S3 = 1×3

     8     8     8

배열의 모든 차원에 걸쳐 합을 구하려면 벡터 차원 인수에 차원을 지정하거나 'all' 옵션을 사용하면 됩니다.

S4 = sum(A,[1 2 3])
S4 = 24
Sall = sum(A,'all')
Sall = 24

1로 구성된 4x2x3 배열을 만들고 세 번째 차원을 따라 합을 계산합니다.

A = ones(4,2,3);
S = sum(A,3)
S = 4×2

     3     3
     3     3
     3     3
     3     3

32비트 정수로 구성된 벡터를 만들고, 출력 유형을 native로 지정하여 해당 요소의 int32형 합을 계산합니다.

A = int32(1:10);
S = sum(A,'native')
S = int32
    55

벡터를 만들고, NaN 값을 제외하여 해당 합을 계산합니다.

A = [1.77 -0.005 3.98 -2.95 NaN 0.34 NaN 0.19];
S = sum(A,'omitnan')
S = 3.3250

'omitnan'을 지정하지 않으면 sum(A)NaN을 반환합니다.

입력 인수

모두 축소

입력 배열로, 벡터, 행렬, 다차원 배열 중 하나로 지정됩니다.

  • A가 스칼라이면 sum(A)A를 반환합니다.

  • A가 빈 0x0 행렬인 경우 sum(A)0을 반환합니다.

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

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

차원 dim은 길이가 1로 줄어드는 차원을 나타냅니다. size(S,dim)1이 되고, 다른 모든 차원의 크기는 변경되지 않습니다.

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

  • sum(A,1)A의 열에 있는 연속된 요소에 대해 동작을 수행하고 각 열의 합으로 구성된 행 벡터를 반환합니다.

  • sum(A,2)A의 행에 있는 연속된 요소에 대해 동작을 수행하고 각 행의 합으로 구성된 열 벡터를 반환합니다.

dimndims(A)보다 크거나 size(A,dim)1인 경우 sumA를 반환합니다.

데이터형: double | single | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

차원의 벡터로, 양의 정수의 벡터로 지정됩니다. 각 요소는 입력 배열의 차원을 나타냅니다. 지정된 연산 중인 차원의 출력값의 길이는 1이고, 다른 모든 차원의 길이는 변경되지 않습니다.

2x3x3 입력 배열 A가 있다고 가정하겠습니다. 이때 sum(A,[1 2])A의 각 페이지의 합을 요소로 갖는 1x1x3 배열을 반환합니다.

데이터형: double | single | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

출력 데이터형으로, 'default', 'double', 'native' 중 하나로 지정됩니다. 이러한 옵션은 또한 연산을 수행할 때 사용되는 데이터형을 지정합니다.

outtype출력 데이터형
'default'double형(단, 입력 데이터형이 single형 또는 duration형이 아닌 경우. 입력 데이터형이 이 중 하나일 때 출력값은 'native'가 됩니다.)
'double'double형(단, 데이터형이 duration형이 아닌 경우. duration형인 경우에는 'double'형이 지원되지 않습니다.)
'native'입력값과 동일한 데이터형(단, 입력 데이터형이 char이 아닌 경우. 문자형인 경우에는 'native'가 지원되지 않습니다.)

데이터형: char

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

  • 'includenan' — 합을 계산할 때 NaN 값을 포함하며, NaN 결과가 생성됩니다.

  • 'omitnan' — 입력값의 모든 NaN 값을 무시합니다.

데이터형: char

확장 기능

참고 항목

| | |

R2006a 이전에 개발됨