padarray

填充数组

语法

B = padarray(A,padsize)

B = padarray(A,padsize,padval)

B = padarray(___,direction)

说明

B = padarray(A,padsize) 填充数组 A，每个维度的填充量由 padsize 指定。padarray 函数用值 0 填充数值或逻辑图像，用类别 <undefined> 填充分类图像。默认情况下，paddarray 在每个维度的第一个元素之前和最后一个元素之后添加填充。

示例

B = padarray(A,padsize,padval) 填充数组 A，其中 padval 指定用于填充元素的常量值或用于复制数组元素的方法。

B = padarray(___,direction) 在 direction 指定的方向上填充 A。

示例

全部折叠

向二维和三维数组添加填充值

打开实时脚本

填充向量的开头

用填充值 9 在向量的开头添加三个填充元素，得到 4×4 数组。

A = [ 1 2 3 4 ]

A = 1×4

     1     2     3     4

B = padarray(A,3,9,'pre')

B = 4×4

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

填充二维数组的每个维度

在数组第一个维度的末尾添加三个填充元素，在第二个维度的末尾添加两个填充元素。使用每个维度上最后一个数组元素的值作为填充值。

A = [ 1 2; 3 4 ]

B = padarray(A,[3 2],'replicate','post')

B = 5×4

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

填充三维数组的每个维度

向三维数组的每个维度添加三个填充元素。每个填充元素均包含填充值 0。

首先创建三维数组。

A = [1 2; 3 4];
B = [5 6; 7 8];
C = cat(3,A,B)

C = 
C(:,:,1) =

     1     2
     3     4


C(:,:,2) =

     5     6
     7     8

填充三维数组

D = padarray(C,[3 3],0,'both')

D = 
D(:,:,1) =

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


D(:,:,2) =

     0     0     0     0     0     0     0     0
     0     0     0     0     0     0     0     0
     0     0     0     0     0     0     0     0
     0     0     0     5     6     0     0     0
     0     0     0     7     8     0     0     0
     0     0     0     0     0     0     0     0
     0     0     0     0     0     0     0     0
     0     0     0     0     0     0     0     0

输入参数

全部折叠

`A` — 要填充的数组
数值数组 | 逻辑数组 | 分类数组

要填充的数组，指定为任意维度的数值、逻辑或分类数组。

`padsize` — 填充量
由非负整数组成的向量

添加到每个维度的填充量，指定为由非负整数组成的向量。例如，padsize 值为 [2 3] 会沿第一个维度添加两个填充元素，沿第二个维度添加三个填充元素。

数据类型: double

`padval` — 填充值
`0` | 数值标量 | `"circular"` | `"replicate"` | `"symmetric"` | 字符串标量 | 字符向量 | `missing`

填充值，指定为数值标量、字符串标量或字符向量。

下表显示数值图像和逻辑图像的填充选项。数值图像和逻辑图像的默认填充值为 0。

数值图像和逻辑图像的填充值

值	描述	示例
数值标量，`X`	数组边界之外的输入数组值被赋予值 `X`。如果未指定填充选项，默认值为 `0`。	$[\begin{matrix} 3 & 1 & 4 \\ 1 & 5 & 9 \\ 2 & 6 & 5 \end{matrix}] \to [\begin{matrix} 2 & 2 & 2 & 2 & 2 & 2 & 2 \\ 2 & 2 & 2 & 2 & 2 & 2 & 2 \\ 2 & 2 & 3 & 1 & 4 & 2 & 2 \\ 2 & 2 & 1 & 5 & 9 & 2 & 2 \\ 2 & 2 & 2 & 6 & 5 & 2 & 2 \\ 2 & 2 & 2 & 2 & 2 & 2 & 2 \\ 2 & 2 & 2 & 2 & 2 & 2 & 2 \end{matrix}]$
`"symmetric"`	数组边界之外的输入数组值是通过沿数组边界对数组进行镜面反射得到。	$[\begin{matrix} 3 & 1 & 4 \\ 1 & 5 & 9 \\ 2 & 6 & 5 \end{matrix}] \to [\begin{matrix} 5 & 1 & 1 & 5 & 9 & 9 & 5 \\ 1 & 3 & 3 & 1 & 4 & 4 & 1 \\ 1 & 3 & 3 & 1 & 4 & 4 & 1 \\ 5 & 1 & 1 & 5 & 9 & 9 & 5 \\ 6 & 2 & 2 & 6 & 5 & 5 & 6 \\ 6 & 2 & 2 & 6 & 5 & 5 & 6 \\ 5 & 1 & 1 & 5 & 9 & 9 & 5 \end{matrix}]$
`"replicate"`	数组边界之外的输入数组值假定为等于最近的数组边界值。	$[\begin{matrix} 3 & 1 & 4 \\ 1 & 5 & 9 \\ 2 & 6 & 5 \end{matrix}] \to [\begin{matrix} 3 & 3 & 3 & 1 & 4 & 4 & 4 \\ 3 & 3 & 3 & 1 & 4 & 4 & 4 \\ 3 & 3 & 3 & 1 & 4 & 4 & 4 \\ 1 & 1 & 1 & 5 & 9 & 9 & 9 \\ 2 & 2 & 2 & 6 & 5 & 5 & 5 \\ 2 & 2 & 2 & 6 & 5 & 5 & 5 \\ 2 & 2 & 2 & 6 & 5 & 5 & 5 \end{matrix}]$
`"circular"`	数组边界之外的输入数组值是通过隐式假设输入数组具有周期性来计算的。	$[\begin{matrix} 3 & 1 & 4 \\ 1 & 5 & 9 \\ 2 & 6 & 5 \end{matrix}] \to [\begin{matrix} 5 & 9 & 1 & 5 & 9 & 1 & 5 \\ 6 & 5 & 2 & 6 & 5 & 2 & 6 \\ 1 & 4 & 3 & 1 & 4 & 3 & 1 \\ 5 & 9 & 1 & 5 & 9 & 1 & 5 \\ 6 & 5 & 2 & 6 & 5 & 2 & 6 \\ 1 & 4 & 3 & 1 & 4 & 3 & 1 \\ 5 & 9 & 1 & 5 & 9 & 1 & 5 \end{matrix}]$

下表显示分类图像的填充选项。分类图像的默认填充值为 missing。

分类图像的填充值

值	描述
字符串标量或字符向量	用指定类别的元素填充。字符串或字符向量必须对应于图像中的一个有效类别。
`missing`	用 `<undefined>` 类别填充。有关详细信息，请参阅 `missing`。
`"symmetric"`	数组边界之外的输入数组值是通过沿数组边界对数组进行镜面反射得到。
`"replicate"`	数组边界之外的输入数组值假定为等于最近的数组边界值。
`"circular"`	数组边界之外的输入数组值是通过隐式假设输入数组具有周期性来计算的。

`direction` — 填充数组的方向
`"both"` (默认) | `"post"` | `"pre"`

沿每个维度填充数组的方向，指定为下列值之一：

值	意义
`"both"`	沿每个维度在第一个元素之前和最后一个数组元素之后填充。
`"post"`	沿每个维度在最后一个数组元素之后填充。
`"pre"`	沿每个维度在第一个数组元素之前填充。

数据类型: char | string

输出参量

全部折叠

`B` — 填充后的数组
数值数组 | 逻辑数组 | 分类数组

填充后的数组，以与 A 具有相同数据类型的数组形式返回。

扩展功能

全部展开

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

用法说明和限制：

padarray 支持 C 和 C++ 代码生成（需要 MATLAB^® Coder™）。有关详细信息，请参阅图像处理的代码生成。
不支持分类数据类型的输入数组。
生成代码时，padarray 最多仅支持三维输入
输入参量 padval 和 direction 必须为编译时常量。

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

用法说明和限制：

不支持分类数据类型的输入数组。
生成代码时，padarray 最多仅支持三维输入。
输入参量 padval 和 direction 必须为编译时常量。

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

此函数完全支持 GPU 数组。有关详细信息，请参阅GPU 上的图像处理。

版本历史记录

在 R2006a 之前推出

另请参阅

circshift | imfilter | paddata

主题

imfilter 边界填充选项

padarray

语法

说明

示例

向二维和三维数组添加填充值

输入参数

A — 要填充的数组 数值数组 | 逻辑数组 | 分类数组

padsize — 填充量 由非负整数组成的向量

padval — 填充值 0 | 数值标量 | "circular" | "replicate" | "symmetric" | 字符串标量 | 字符向量 | missing

direction — 填充数组的方向 "both" (默认) | "post" | "pre"

输出参量

B — 填充后的数组 数值数组 | 逻辑数组 | 分类数组

扩展功能

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

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

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

版本历史记录

另请参阅

主题

`A` — 要填充的数组
数值数组 | 逻辑数组 | 分类数组

`padsize` — 填充量
由非负整数组成的向量

`padval` — 填充值
`0` | 数值标量 | `"circular"` | `"replicate"` | `"symmetric"` | 字符串标量 | 字符向量 | `missing`

`direction` — 填充数组的方向
`"both"` (默认) | `"post"` | `"pre"`

`B` — 填充后的数组
数值数组 | 逻辑数组 | 分类数组

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

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

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