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

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

3차원 배열의 합

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

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

S = 4×2

     3     3
     3     3
     3     3
     3     3

32비트 정수의 합

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

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

S = int32
    55

NaN을 제외한 합

벡터를 만들고, 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 — 입력 배열

벡터 | 행렬 | 다차원 배열

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

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

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

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

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

양의 정수 스칼라

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

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

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

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

  

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

  

dim이 ndims(A)보다 크거나 size(A,dim)이 1인 경우 sum은 A를 반환합니다.

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

vecdim — 차원의 벡터

양의 정수의 벡터

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

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

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

outtype — 출력 데이터형

'default' (디폴트 값) | 'double' | 'native'

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

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

데이터형: char

nanflag — NaN 조건

‘includenan’ (디폴트 값) | ‘omitnan’

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

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

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

데이터형: char

확장 기능

tall형 배열

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

이 함수는 tall형 배열을 완전히 지원합니다. 자세한 내용은 tall형 배열 항목을 참조하십시오.

C/C++ 코드 생성

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

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

• dim을 지정할 경우 그 값은 상수여야 합니다.

• 'all' 옵션과 vecdim 인수는 지원되지 않습니다.

• outtype 옵션과 nanflag 옵션은 상수 문자형 벡터여야 합니다.

• Variable-Sizing Restrictions for Code Generation of Toolbox Functions (MATLAB Coder) 항목을 참조하십시오.

GPU 배열

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

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

• sum 연산의 덧셈의 순서는 정의되지 않습니다. 따라서 GPU 배열에 대한 sum 연산은 대응되는 MATLAB^® 숫자형 배열에 대한 sum 연산과 동일한 답을 반환하지 않을 수 있습니다. A가 부호 있는 정수형이고 그 곱이 기본적으로(natively) 누적되는 경우 이 차이가 커질 수 있습니다.

자세한 내용은 Run MATLAB Functions on a GPU (Parallel Computing Toolbox) 항목을 참조하십시오.

분산 배열

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

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

• sum 연산의 덧셈의 순서는 정의되지 않습니다. 따라서 분산 배열에 대한 sum 연산은 대응되는 MATLAB 숫자형 배열에 대한 sum 연산과 동일한 답을 반환하지 않을 수 있습니다. A가 부호 있는 정수형이고 그 곱이 기본적으로(natively) 누적되는 경우 이 차이가 커질 수 있습니다.

자세한 내용은 Run MATLAB Functions with Distributed Arrays (Parallel Computing Toolbox) 항목을 참조하십시오.

참고 항목

cumsum | diff | mean | prod

R2006a 이전에 개발됨