repelem

重复数组元素副本

全页折叠

语法

u = repelem(v,n)

B = repelem(A,r1,...,rN)

说明

u = repelem(v,n) 返回一个重复 v 中元素的向量，其中 v 是一个标量或向量。

如果 n 是一个标量，则 v 的每个元素都重复 n 次。u 的长度为 length(v)*n。
如果 n 为向量，则它必须与 v 具有相同的长度。n 的每个元素指定重复 v 对应元素的次数。

table 输入不支持此语法。

示例

B = repelem(A,r1,...,rN) 将 A 中的每个元素依 r1,...,rN 进行重复，返回一个数组。r1,...,rN 中的每个元素必须是一个标量，或是与 A 在对应维度具有相同长度的向量。例如，如果 A 是一个矩阵，repelem(A,2,3) 则返回一个矩阵，其中包含 A 中每个元素的一个 2×3 块。

示例

全部折叠

重复向量元素

打开实时脚本

创建一个向量，并将其每个元素重复三次复制到一个新向量中。

v = [1 2 3 4];
u = repelem(v,3)

u = 1×12

     1     1     1     2     2     2     3     3     3     4     4     4

将 v 的头两个元素重复两次，最后两个元素重复三次。

u = repelem(v,[2 2 3 3])

u = 1×10

     1     1     2     2     3     3     3     4     4     4

重复矩阵元素

打开实时脚本

创建一个矩阵，并将其每个元素复制到一个新矩阵的 3×2 块中。

A = [1 2; 3 4]

B = repelem(A,3,2)

B = 6×4

     1     1     2     2
     1     1     2     2
     1     1     2     2
     3     3     4     4
     3     3     4     4
     3     3     4     4

重复矩阵列

打开实时脚本

创建一个矩阵并将其列复制到新数组中，第一列重复两次，第二列重复三次。

A = [1 2; 3 4]

B = repelem(A,1,[2 3])

B = 2×5

     1     1     2     2     2
     3     3     4     4     4

合并向量元素

打开实时脚本

创建两个列向量。

A = [1; 3; 5];
B = [2; 4];

使用 repelem 和 repmat 生成两个向量的所有元素组合。输出 T 的每行均为来自第一个向量的第一个元素和来自第二个向量的第二个元素的组合。此命令等效于求两个向量的笛卡尔积。

T = [repelem(A,numel(B)) repmat(B,numel(A),1)]

从 R2023a 开始，您还可以使用 combinations 函数来生成两个向量的所有元素组合。

T = combinations(A,B)

T=6×2 table
    A    B
    _    _

    1    2
    1    4
    3    2
    3    4
    5    2
    5    4

输入参数

全部折叠

`v` — 输入元素
标量 | 向量

输入值，指定为标量或向量。

`n` — 每个元素的重复次数
标量 | 向量

每个元素的重复次数，指定为标量或向量。如果 n 是一个标量，则 v 的所有元素都重复 n 次。如果 n 为向量，则 n 的各个元素用于指定重复 v 中对应元素的次数。在任一情况下，n 都必须是整数值。

`A` — 输入数组
矩阵 | 多维数组

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

`r1,...,rN` — 每个维度的重复因子（指定为单独的参量）
标量 | 向量

每个维度的重复因子，指定为整数值标量或向量的单独参量。如果 A 是一个表格，则每个重复因子都必须是标量。

输出参量

全部折叠

`u` — 输出向量
向量

输出向量。如果 v 是一个行向量或标量，则 u 是一个行向量。如果 v 是一个列向量，则 u 也是一个列向量。

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

输出数组，以矩阵或多维数组的形式返回。

扩展功能

全部展开

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

此函数支持 tall 数组，但存在以下限制：

不支持双输入语法。
第一个维度中的复制因子必须为 1。例如，repelem(TA,1,n,p,...)。

有关详细信息，请参阅 tall 数组。

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

用法说明和限制：

输入必须为向量或矩阵。输入不能为多维数组。

GPU 代码生成
使用 GPU Coder™ 为 NVIDIA® GPU 生成 CUDA® 代码。

用法说明和限制：

输入必须为向量或矩阵。输入不能为多维数组。

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

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

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

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

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

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

版本历史记录

在 R2015a 中推出

另请参阅

kron | repmat

repelem

语法

说明

示例

重复向量元素

重复矩阵元素

重复矩阵列

合并向量元素

输入参数

v — 输入元素 标量 | 向量

n — 每个元素的重复次数 标量 | 向量

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

r1,...,rN — 每个维度的重复因子（指定为单独的参量） 标量 | 向量

输出参量

u — 输出向量 向量

B — 输出数组 矩阵 | 多维数组

扩展功能

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

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

GPU 代码生成 使用 GPU Coder™ 为 NVIDIA® GPU 生成 CUDA® 代码。

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

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

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

版本历史记录

另请参阅

`v` — 输入元素
标量 | 向量

`n` — 每个元素的重复次数
标量 | 向量

`A` — 输入数组
矩阵 | 多维数组

`r1,...,rN` — 每个维度的重复因子（指定为单独的参量）
标量 | 向量

`u` — 输出向量
向量

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

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

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

GPU 代码生成
使用 GPU Coder™ 为 NVIDIA® GPU 生成 CUDA® 代码。

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

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

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