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)

数组页的边界

打开实时脚本

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

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

输入参数

全部折叠

`A` — 输入数组
向量 | 矩阵 | 多维数组 | 表 | 时间表

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

`dim` — 沿其运算的维度
正整数标量

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

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

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

`vecdim` — 维度向量
正整数向量

维度向量，指定为正整数向量。每个元素代表输入数组的一个维度。指定的操作维度的输出长度为 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

`missingflag` — 缺失值条件
`"omitmissing"` (默认) | `"omitnan"` | `"omitnat"` | `"omitundefined"` | `"includemissing"` | `"includenan"` | `"includenat"` | `"includeundefined"`

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

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

输出参量

全部折叠

`minA` — 最小值
向量 | 矩阵 | 多维数组 | 表

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

`maxA` — 最大值
向量 | 矩阵 | 多维数组 | 表

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

扩展功能

全部展开

tall 数组
对行数太多而无法放入内存的数组进行计算。

bounds 函数完全支持 tall 数组。有关详细信息，请参阅 tall 数组。

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

基于线程的环境
使用 MATLAB® `backgroundPool` 在后台运行代码或使用 Parallel Computing Toolbox™ `ThreadPool` 加快代码运行速度。

此函数完全支持基于线程的环境。有关详细信息，请参阅在基于线程的环境中运行 MATLAB 函数。

GPU 数组
通过使用 Parallel Computing Toolbox™ 在图形处理单元 (GPU) 上运行来加快代码执行。

bounds 函数完全支持 GPU 数组。要在 GPU 上运行该函数，请将输入数据指定为 gpuArray (Parallel Computing Toolbox)。有关详细信息，请参阅在 GPU 上运行 MATLAB 函数 (Parallel Computing Toolbox)。

分布式数组
使用 Parallel Computing Toolbox™ 在集群的组合内存中对大型数组进行分区。

此函数完全支持分布式数组。有关详细信息，请参阅使用分布式数组运行 MATLAB 函数 (Parallel Computing Toolbox)。

版本历史记录

在 R2017a 中推出

全部展开

R2023a: 指定缺失值条件

使用 "omitmissing" 或 "includemissing" 选项计算最小值和最大值时，忽略还是包括输入数组中的缺失值。以前，"omitnan"、"includenan"、"omitnat"、"includenat"、"omitundefined" 和 "includeundefined" 指定特定于输入数组的数据类型的缺失值条件。

R2023a: 直接对表和时间表执行计算

bounds 函数可以对表或时间表中的所有变量执行计算，而无需通过索引访问这些变量。所有变量都必须具有支持计算的数据类型。有关详细信息，请参阅Direct Calculations on Tables and Timetables。

R2018b: 对多个维度执行运算

一次对输入数组的多个维度执行运算。指定一个由运算维度组成的向量，或指定 "all" 选项以对所有数组维度执行运算。

另请参阅

min | max

bounds

语法

说明

示例

向量的最小值和最大值

矩阵行的最小值和最大值

数组页的边界

包括缺失值的边界

输入参数

A — 输入数组 向量 | 矩阵 | 多维数组 | 表 | 时间表

dim — 沿其运算的维度 正整数标量

vecdim — 维度向量 正整数向量

missingflag — 缺失值条件 "omitmissing" (默认) | "omitnan" | "omitnat" | "omitundefined" | "includemissing" | "includenan" | "includenat" | "includeundefined"

输出参量

minA — 最小值 向量 | 矩阵 | 多维数组 | 表

maxA — 最大值 向量 | 矩阵 | 多维数组 | 表

扩展功能

tall 数组 对行数太多而无法放入内存的数组进行计算。

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

基于线程的环境 使用 MATLAB® backgroundPool 在后台运行代码或使用 Parallel Computing Toolbox™ ThreadPool 加快代码运行速度。

GPU 数组 通过使用 Parallel Computing Toolbox™ 在图形处理单元 (GPU) 上运行来加快代码执行。

分布式数组 使用 Parallel Computing Toolbox™ 在集群的组合内存中对大型数组进行分区。

版本历史记录

R2023a: 指定缺失值条件

R2023a: 直接对表和时间表执行计算

R2018b: 对多个维度执行运算

另请参阅

`A` — 输入数组
向量 | 矩阵 | 多维数组 | 表 | 时间表

`dim` — 沿其运算的维度
正整数标量

`vecdim` — 维度向量
正整数向量

`missingflag` — 缺失值条件
`"omitmissing"` (默认) | `"omitnan"` | `"omitnat"` | `"omitundefined"` | `"includemissing"` | `"includenan"` | `"includenat"` | `"includeundefined"`

`minA` — 最小值
向量 | 矩阵 | 多维数组 | 表

`maxA` — 最大值
向量 | 矩阵 | 多维数组 | 表

tall 数组
对行数太多而无法放入内存的数组进行计算。

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

基于线程的环境
使用 MATLAB® `backgroundPool` 在后台运行代码或使用 Parallel Computing Toolbox™ `ThreadPool` 加快代码运行速度。

GPU 数组
通过使用 Parallel Computing Toolbox™ 在图形处理单元 (GPU) 上运行来加快代码执行。

分布式数组
使用 Parallel Computing Toolbox™ 在集群的组合内存中对大型数组进行分区。