Main Content

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보다 큰 첫 번째 배열 차원을 따라 연산을 수행하며, 요소를 벡터로 취급합니다. 이 차원에서 S의 크기는 1이 되고 다른 모든 차원의 크기는 A와 동일하게 유지됩니다.

  • A가 테이블 또는 타임테이블인 경우 sum(A)는 각 변수의 합을 포함하는 한 행 크기의 테이블을 반환합니다. (R2023a 이후)

예제

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)는 A의 NaN 값을 포함시킬지 또는 생략할지 여부를 지정합니다. 예를 들어, sum(A,"omitnan")은 합을 구할 때 NaN 값을 무시합니다. 기본적으로 sum은 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로 구성된 4×3 행렬이므로 각 페이지의 합은 12가 됩니다.

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

    12


S1(:,:,2) =

    12

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

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

     6
     6
     6
     6

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

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로 구성된 4×2×3 배열을 만들고 세 번째 차원을 따라 합을 계산합니다.

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 NaN -2.95; NaN 0.34 NaN 0.19]
A = 2×4

    1.7700   -0.0050       NaN   -2.9500
       NaN    0.3400       NaN    0.1900

NaN 값을 제외하고 행렬의 합을 구합니다. NaN 값이 포함된 행렬 열의 경우 sum은 NaN이 아닌 요소에 대해 계산을 수행합니다. 값이 모두 NaN인 행렬 열의 경우 합은 0이 됩니다.

S = sum(A,"omitnan")
S = 1×4

    1.7700    0.3350         0   -2.7600

입력 인수

모두 축소

입력 배열로, 벡터, 행렬, 다차원 배열, table형 또는 timetable형으로 지정됩니다.

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

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

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

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

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

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

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

    sum(A,1) column-wise computation.

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

    sum(A,2) row-wise computation.

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

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

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

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

sum(A,[1 2]) collapses the pages of a 2-by-3-by-3 array into a 1-by-1-by-3 array.

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

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

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

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

  • "includemissing" 또는 "includenan" — 합을 구할 때 A의 NaN 값을 포함합니다. 연산 차원의 요소가 하나라도 NaN인 경우 이에 대응하는 S의 요소도 NaN입니다. "includemissing"과 "includenan"은 동일하게 동작합니다.

  • "omitmissing" 또는 "omitnan" — A의 NaN 값을 무시하고, 더 적은 수의 점을 대상으로 합을 구합니다. 연산 차원의 모든 요소가 NaN인 경우 이에 대응하는 S의 요소는 0이 됩니다. "omitmissing"과 "omitnan"은 동일하게 동작합니다.

확장 기능

버전 내역

R2006a 이전에 개발됨

모두 확장

참고 항목

| | |