sum
数组元素总和
说明
S = sum(
返回沿大小大于 1 的第一个数组维度计算的元素之和。A
)
如果
A
是向量,则sum(A)
返回元素之和。如果
A
是矩阵,则sum(A)
将返回包含每列总和的行向量。如果
A
是多维数组,则sum(A)
沿大小大于 1 的第一个数组维度计算,并将这些元素视为向量。此维度中S
的大小变为1
,而所有其他维度的大小仍与在A
中相同。如果
A
是表或时间表,则sum(A)
返回一个包含每个变量总和的单行表。 (自 R2023a 起)
示例
向量元素的总和
矩阵列总和
创建一个矩阵并计算每列中元素的总和。
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 的三维数组。
A = ones(4,3,2);
要对 A
的每个页中的所有元素求和,请使用向量维度参量指定要求和的维度(行和列)。两个页均为 4×3 的全 1 矩阵,因此每页的总和为 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
三维数组的总和
32 位整数之和
创建一个由 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
输入参数
A
— 输入数组
向量 | 矩阵 | 多维数组 | 表 | 时间表
输入数组,指定为向量、矩阵、多维数组、表或时间表。
如果
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
复数支持: 是
dim
— 沿其运算的维度
正整数标量
沿其运算的维度,指定为正整数标量。如果不指定维度,则默认为第一个大于 1 的数组维度。
维度 dim
表示长度减至 1 的维度。size(S,dim)
为 1
,而所有其他维度的大小保持不变。
以一个二维输入数组 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,而其他保持不变。
以 2×3×3 输入数组 A
为例。然后 sum(A,[1 2])
返回 1×1×3 数组,其元素是 A
的每个页的总和。
数据类型: double
| single
| int8
| int16
| int32
| int64
| uint8
| uint16
| uint32
| uint64
outtype
— 输出数据类型
"default"
(默认) | "double"
| "native"
输出数据类型,指定为 "default"
、"double"
或 "native"
。这些选项还指定执行运算采用的数据类型。
outtype | 输出数据类型 |
---|---|
"default" | double ,除非输入数据类型为 single 、duration 、table 或 timetable ,在此情况下输出为 "native" |
"double" | double ,除非数据类型为 duration 、table 或 timetable ,在此情况下不支持 "double" |
"native" | 与输入数据类型相同,除非输入数据类型为 char ,在这种情况下不支持 "native" ;或者,除非输入数据类型为 timetable ,在这种情况下输出数据类型为 table |
nanflag
— 缺失值条件
"includemissing"
(默认) | "includenan"
| "omitmissing"
| "omitnan"
缺失值条件,指定为下列值之一:
"includemissing"
或"includenan"
- 在计算总和时包括A
中的NaN
值。如果运算维度中的任一元素是NaN
,则S
中的对应元素也是NaN
。"includemissing"
和"includenan"
具有相同的行为。"omitmissing"
或"omitnan"
- 忽略A
中的NaN
值,并基于较少的点计算总和。如果运算维度中的所有元素均为NaN
,则S
中的对应元素为 0。"omitmissing"
和"omitnan"
具有相同的行为。
扩展功能
tall 数组
对行数太多而无法放入内存的数组进行计算。
此函数完全支持 tall 数组。有关详细信息,请参阅 tall 数组。
C/C++ 代码生成
使用 MATLAB® Coder™ 生成 C 代码和 C++ 代码。
用法说明和限制:
如果指定
dim
,则它必须为常量。outtype
和nanflag
选项必须为常量字符向量。请参阅Variable-Sizing Restrictions for Code Generation of Toolbox Functions (MATLAB Coder)。
GPU 代码生成
使用 GPU Coder™ 为 NVIDIA® GPU 生成 CUDA® 代码。
用法说明和限制:
如果指定
dim
,则它必须为常量。outtype
和nanflag
选项必须为常量字符向量。
基于线程的环境
使用 MATLAB® backgroundPool
在后台运行代码或使用 Parallel Computing Toolbox™ ThreadPool
加快代码运行速度。
此函数完全支持基于线程的环境。有关详细信息,请参阅在基于线程的环境中运行 MATLAB 函数。
GPU 数组
通过使用 Parallel Computing Toolbox™ 在图形处理单元 (GPU) 上运行来加快代码执行。
用法说明和限制:
未定义
sum
运算中的加法顺序。因此,对 GPU 数组执行sum
运算与对相应的数值数组执行sum
运算所返回的值可能不完全相同。当A
是有符号整数类型且其乘积在本机累积时,差异可能相当大。
有关详细信息,请参阅在 GPU 上运行 MATLAB 函数 (Parallel Computing Toolbox)。
分布式数组
使用 Parallel Computing Toolbox™ 在集群的组合内存中对大型数组进行分区。
用法说明和限制:
未定义
sum
运算中的加法顺序。因此,对分布式数组执行sum
运算与对相应的数值数组执行sum
运算所返回的值可能不完全相同。当A
是有符号整数类型且其乘积在本机累积时,差异可能相当大。
有关详细信息,请参阅使用分布式数组运行 MATLAB 函数 (Parallel Computing Toolbox)。
版本历史记录
在 R2006a 之前推出R2023a: 指定缺失值条件
使用 "includemissing"
或 "omitmissing"
选项计算总和时,包括还是忽略输入数组中的缺失值。这些选项的行为分别与 "includenan"
和 "omitnan"
选项相同。
R2023a: 直接对表和时间表执行计算
sum
函数可以对表或时间表中的所有变量执行计算,而无需通过索引访问这些变量。所有变量都必须具有支持计算的数据类型。有关详细信息,请参阅Direct Calculations on Tables and Timetables。
R2018b: 对多个维度执行运算
一次对输入数组的多个维度执行运算。指定一个由运算维度组成的向量,或指定 "all"
选项以对所有数组维度执行运算。
MATLAB 命令
您点击的链接对应于以下 MATLAB 命令:
请在 MATLAB 命令行窗口中直接输入以执行命令。Web 浏览器不支持 MATLAB 命令。
Select a Web Site
Choose a web site to get translated content where available and see local events and offers. Based on your location, we recommend that you select: .
You can also select a web site from the following list:
How to Get Best Site Performance
Select the China site (in Chinese or English) for best site performance. Other MathWorks country sites are not optimized for visits from your location.
Americas
- América Latina (Español)
- Canada (English)
- United States (English)
Europe
- Belgium (English)
- Denmark (English)
- Deutschland (Deutsch)
- España (Español)
- Finland (English)
- France (Français)
- Ireland (English)
- Italia (Italiano)
- Luxembourg (English)
- Netherlands (English)
- Norway (English)
- Österreich (Deutsch)
- Portugal (English)
- Sweden (English)
- Switzerland
- United Kingdom (English)