本页对应的英文页面已更新,但尚未翻译。 若要查看最新内容,请点击此处访问英文页面。

bounds

最小元素和最大元素

说明

示例

[S,L] = bounds(A) 返回数组的最小元素 S 和最大元素 LS 等同于 min(A)L 等同于 max(A)

示例

[S,L] = bounds(A,'all') 计算 A 的所有元素的最小值和最大值。此语法适用于 MATLAB® R2018b 及更高版本。

示例

[S,L] = bounds(A,dim) 沿 A 的维度 dim 执行运算。例如,如果 A 是矩阵,则 bounds(A,2) 返回包含每一行的最小元素和最大元素的列向量 SL

示例

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

示例

[S,L] = bounds(___,nanflag) 指定在确定最小元素和最大元素时是包含还是忽略 NaN 值。bounds(A,'omitnan') 将忽略 NaN 值。如果 A 的任何元素为 NaN,则 bounds(A,'includenan') 将为 SL 都返回 NaN。默认行为是 'omitnan'

示例

全部折叠

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

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

计算矩阵每一行的最小元素和最大元素。

A = magic(4)
A = 4×4

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

[S,L] = bounds(A,2)
S = 4×1

     2
     5
     6
     1

L = 4×1

    16
    11
    12
    15

创建三维数组并计算每页数据(行和列)中的最小值和最大值。

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

    -2


S1(:,:,2) =

    -5


S1(:,:,3) =

    -3

L1
L1 = 
L1(:,:,1) =

     4


L1(:,:,2) =

    13


L1(:,:,3) =

     8

从 R2018b 开始,要计算数组的所有维度的边界,可以在向量维度参数中指定每个维度,或使用 'all' 选项。

[S2,L2] = bounds(A,[1 2 3])
S2 = -5
L2 = 13
[Sall,Lall] = bounds(A,'all')
Sall = -5
Lall = 13

计算向量的最小值和最大值时,是包含还是忽略 NaN 元素。

计算向量的最小值和最大值时,忽略 NaN 值,此为默认设置。

A = [2 NaN 6 -5 0 NaN 10];
[S,L] = bounds(A)
S = -5
L = 10

使用 'includenan' 选项可以包含 NaN 值,这将导致 boundsA 的最大值和最小值都返回 NaN

[S,L] = bounds(A,'includenan')
S = NaN
L = NaN

输入参数

全部折叠

输入数组,指定为向量、矩阵或多维数组。

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

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

假设有一个矩阵 A

  • bounds(A,1) 计算每一列的最小值和最大值。

  • bounds(A,2) 计算每一行的最小值和最大值。

数据类型: double | single | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

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

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

数据类型: double | single | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

NaN 条件,指定为下列值之一:

  • 'omitnan' - 忽略输入中的所有 NaN 值。如果输入只包含 NaN 值,则 bounds 将为 SL 都返回 NaN

  • 'includenan' - 包含 NaN 值。如果输入的任何元素为 NaN,则 bounds 将为 SL 都返回 NaN

输出参数

全部折叠

最小元素,指定为向量、矩阵或多维数组。

最大元素,指定为向量、矩阵或多维数组。

扩展功能

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

另请参阅

|

在 R2017a 中推出