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` — 输入数组
向量 | 矩阵 | 多维数组

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

如果 A 是向量，则 mink 返回一个向量，其中包含 A 的 k 个最小元素。
如果 A 是矩阵，则 mink 返回一个矩阵，该矩阵的列包含 A 的每一列中的 k 个最小元素。
如果 A 是多维数组，则 mink 返回大小不等于 1 的第一个维度上的 k 个最小元素。

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

`k` — 最小值的个数
非负整数标量

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

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

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

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

mink(A,k,1) 计算 A 的每列中的 k 个最小值，并返回一个 k×n 矩阵。
mink(A,k,2) 计算 A 的每行中的 k 个最小值，并返回一个 m×k 矩阵。

`c` — 比较方法
`'auto'` (默认) | `'real'` | `'abs'`

比较方法，指定为以下选项之一：

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

输出参量

全部折叠

`B` — 输出数组
标量 | 向量 | 矩阵 | 多维数组

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

`I` — 索引数组
标量 | 向量 | 矩阵 | 多维数组

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

扩展功能

全部展开

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

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

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

用法说明和限制：

对于输入参量 A：
- 如果不指定维度，代码生成器将沿输入数组中具有可变大小或其大小不为 1 的第一个维度进行运算。如果此维度在代码生成时具有可变大小且在运行时为 1，则可能发生运行时错误。为避免此错误，请指定维度。
- 在生成的代码中，输入数组保持复数，即使其所有元素都具有零值虚部也是如此。在这些情况下，生成的代码产生的结果可能与 MATLAB 产生的结果不同。请参阅具有零值虚部的复数数据的代码生成 (MATLAB Coder)。

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

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

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

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

版本历史记录

在 R2017b 中推出

全部展开

R2025a: 改进了返回大量数值或逻辑数据行时的性能

当 k 至少为 512 且至少为运算维度长度的 8% 时，mink 函数改进了处理数值数据（包括复数数据）和逻辑数据的性能。

例如，以下代码返回一个包含 10,000 行的数值矩阵中每列的最小 5000 个元素。代码执行速度比上一版本大约快 3.75 倍。

function timingTest
A = rand(1e4,10);
for i = 1:120
    M = mink(A,5000);
end
end

大致的执行时间是：

R2024b：1.05 秒

R2025a：0.28 秒

此代码是在运行 Windows^® 11 的 AMD EPYC™ 74F3 24 核处理器 @ 3.19 GHz 测试系统上使用 timeit 函数计时的。

timeit(@timingTest)

另请参阅

min | topkrows | maxk

mink

语法

说明

示例

最小向量元素

矩阵行的最小元素

复数向量

输入参数

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

k — 最小值的个数 非负整数标量

dim — 运算维度 正整数标量

c — 比较方法 'auto' (默认) | 'real' | 'abs'