bounds

数组的最小值和最大值

全页折叠

语法

[minA,maxA] = bounds(A)
[minA,maxA] = bounds(A,"all")
[minA,maxA] = bounds(A,dim)
[minA,maxA] = bounds(A,vecdim)
[minA,maxA] = bounds(___,missingflag)

说明

[minA,maxA] = bounds(A) 返回数组中的最小值 minA 和最大值 maxA。minA 等效于 min(A)，而 maxA 等效于 max(A)。

示例

[minA,maxA] = bounds(A,"all") 计算 A 的所有元素的最小值和最大值。

示例

[minA,maxA] = bounds(A,dim) 沿 A 的维度 dim 执行运算。例如，如果 A 是矩阵，则 bounds(A,2) 返回包含每行最小值和最大值的列向量 minA 和 maxA。

示例

[minA,maxA] = bounds(A,vecdim) 基于向量 vecdim 中指定的维度计算最小值和最大值。例如，如果 A 是矩阵，则 bounds(A,[1 2]) 将返回 A 中所有元素的最小值和最大值，因为矩阵的每个元素都包含在由维度 1 和 2 定义的数组切片中。

示例

[minA,maxA] = bounds(___,missingflag) 指定在上述任一语法的基础上是省略还是包含 A 中的缺失值。例如，bounds(A,"missingflag") 在计算最小值和最大值时会包括所有缺失值。默认情况下，bounds 会忽略缺失值。

示例

示例

全部折叠

打开实时脚本

同时计算向量的最小值和最大值。

A = [2 4 -1 10 6 3 0 -16];
[minA,maxA] = bounds(A)
minA = 
-16

maxA = 
10
打开实时脚本

计算矩阵每行的最小值和最大值。

A = magic(4)
A = 4×4

    16     2     3    13
     5    11    10     8
     9     7     6    12
     4    14    15     1


[minA,maxA] = bounds(A,2)
minA = 4×1

     2
     5
     6
     1


maxA = 4×1

    16
    11
    12
    15
打开实时脚本

创建一个三维数组并计算每页数据（行和列）的最小值和最大值。

A(:,:,1) = [2 4; -2 1];
A(:,:,2) = [9 13; -5 7];
A(:,:,3) = [4 4; 8 -3];
[minA1,maxA1] = bounds(A,[1 2]);
minA1
minA1 = 
minA1(:,:,1) =

    -2


minA1(:,:,2) =

    -5


minA1(:,:,3) =

    -3


maxA1
maxA1 = 
maxA1(:,:,1) =

     4


maxA1(:,:,2) =

    13


maxA1(:,:,3) =

     8

要计算数组的所有维度的边界，可以在向量维度参量中指定每个维度，或使用 "all" 选项。

[minA2,maxA2] = bounds(A,[1 2 3])
minA2 = 
-5

maxA2 = 
13

[minAall,maxAall] = bounds(A,"all")
minAall = 
-5

maxAall = 
13
打开实时脚本

创建一个包含 NaN 值的矩阵。

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

     2   NaN     6    -5
     0     3   NaN     9

计算矩阵的最小值和最大值，包括 NaN 值。对于包含任何 NaN 值的矩阵列，最小值和最大值为 NaN。

[minA,maxA] = bounds(A,"includenan")
minA = 1×4

     0   NaN   NaN    -5


maxA = 1×4

     2   NaN   NaN     9

输入参数

全部折叠

输入数组，指定为向量、矩阵、多维数组、表或时间表。

数据类型: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64 | logical | categorical | datetime | duration | table | timetable
复数支持: 是

沿其运算的维度，指定为正整数标量。如果不指定维度，则默认值是大小不等于 1 的第一个数组维度。

以一个 m×n 输入矩阵 A 为例：

  • bounds(A,1) 计算 A 的每列中的最小值和最大值，并返回两个 1×n 行向量。

    bounds(A,1) column-wise operation

  • bounds(A,2) 计算 A 的每行中的最小值和最大值，并返回两个 m×1 列向量。

    bounds(A,2) row-wise operation

维度向量，指定为正整数向量。每个元素代表输入数组的一个维度。指定的操作维度的输出长度为 1，而其他保持不变。

以 2×3×3 输入数组 A 为例。然后 [minA,maxA] = bounds(A,[1 2]) 对 minA 和 maxA 返回 1×1×3 数组。minA 和 maxA 的元素分别是 A 对应页中的最小值和最大值。

Mapping of a 2-by-3-by-3 input array to a 1-by-1-by-3 output array

缺失值条件，指定为下表中的值之一。

值输入数据类型描述
"omitmissing"所有支持的数据类型忽略输入数组中的缺失值，并基于较少的点计算最小值和最大值。如果运算维度中的所有元素都缺失，则 minA 和 maxA 中的对应元素也会缺失。
"omitnan"double, single, duration
"omitnat"datetime
"omitundefined"categorical
"includemissing"所有支持的数据类型

计算最小值和最大值时，包括输入数组中的缺失值。如果运算维度中的任一元素缺失，则 minA 和 maxA 中的对应元素也会缺失。

"includenan"double, single, duration
"includenat"datetime
"includeundefined"categorical

输出参量

全部折叠

最小值，以向量、矩阵或多维数组或表的形式返回。

最大值，指定为向量、矩阵、多维数组或表。

扩展功能

全部展开

C/C++ 代码生成
使用 MATLAB® Coder™ 生成 C 代码和 C++ 代码。

版本历史记录

在 R2017a 中推出

全部展开

另请参阅

|