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

mink

计算数组的 k 个最小元素

说明

示例

B = mink(A,k) 返回 Ak 个最小元素。

  • 如果 A 是向量,则 mink 返回一个向量,其中包含 Ak 个最小元素。

  • 如果 A 是矩阵,则 mink 返回一个矩阵,该矩阵的列包含 A 的每一列中的 k 个最小元素。

  • 如果 A 是多维数组,则 mink 返回大小不等于 1 的第一个维度上的 k 个最小元素。

示例

B = mink(A,k,dim) 确定 A 在维度 dim 上的 k 个最小元素。

示例

B = mink(___,'ComparisonMethod',c) 为上述任何语法指定如何比较 A 的元素,但此项为可选项。例如,mink(A,k,'ComparisonMethod','abs') 根据绝对值返回 Ak 个最小元素。

示例

[B,I] = mink(___) 计算 Ak 个最小值的索引,并在 I 中返回这些索引。

示例

全部折叠

计算向量的 3 个最小元素。

A = 1:10;
B = mink(A,3)
B = 1×3

     1     2     3

计算矩阵中每一行的 3 个最小元素。

A = magic(5)
A = 5×5

    17    24     1     8    15
    23     5     7    14    16
     4     6    13    20    22
    10    12    19    21     3
    11    18    25     2     9

B = mink(A,3,2)
B = 5×3

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

根据模计算复数向量的 2 个最小元素,并返回它们在输入向量中的位置的索引。

A = [2-2i 5+i -7-3i -1+i]
A = 1×4 complex

   2.0000 - 2.0000i   5.0000 + 1.0000i  -7.0000 - 3.0000i  -1.0000 + 1.0000i

[B,I] = mink(A,2,'ComparisonMethod','abs')
B = 1×2 complex

  -1.0000 + 1.0000i   2.0000 - 2.0000i

I = 1×2

     4     1

输入参数

全部折叠

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

  • 如果 A 是向量,则 mink 返回一个向量,其中包含 Ak 个最小元素。

  • 如果 A 是矩阵,则 mink 返回一个矩阵,该矩阵的列包含 A 的每一列中的 k 个最小元素。

  • 如果 A 是多维数组,则 mink 返回大小不等于 1 的第一个维度上的 k 个最小元素。

如果 A 的类型为 categorical,则它必须是有序的。

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

要返回的最小值的个数,指定为正整数标量。如果 k 大于或等于运算维度中的元素数,则 mink 沿该维度对输入数组进行排序。

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

运算维度,指定为正整数标量。默认情况下,mink 沿其大小不为 1 的第一个维度进行运算。

例如,如果 A 是矩阵,则 mink(A,k,1) 沿 A 的行进行运算,计算每一列的最小值。

mink(A,k,2) 沿 A 的列进行运算,计算每一行的最小值。

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

比较方法,指定为以下选项之一:

  • 'auto' - 当 A 为实数时,按 real(A) 对输入 A 的元素进行比较;当 A 为复数时,按 abs(A) 进行比较。

  • 'real' - 当 A 为实数或复数时,按 real(A) 对输入 A 的元素进行比较。如果 A 包含具有相等实部的元素,则使用 imag(A) 进行排序。

  • 'abs' - 当 A 为实数或复数时,按 abs(A) 对输入 A 的元素进行比较。如果 A 包含具有相等模的元素,则使用区间 (-π,π] 中的 angle(A) 进行排序。

输出参数

全部折叠

输出数组,以标量、向量、矩阵或多维数组形式返回。mink 按照从小到大的顺序返回 k 个元素。

索引数组,以向量、矩阵或多维数组形式返回。I 的大小与 B 相同。如果输出数组 B 包含重复的元素,则它们的索引在 I 中的顺序与它们在输入数组中的顺序一致。

扩展功能

另请参阅

| |

在 R2017b 中推出