padarray

Rellenar arreglos

Sintaxis

B = padarray(A,padsize)

B = padarray(A,padsize,padval)

B = padarray(___,direction)

Descripción

B = padarray(A,padsize) rellena el arreglo A con una cantidad de relleno en cada dimensión que especifica padsize. La función padarray rellena imágenes numéricas o lógicas con el valor 0 e imágenes categóricas con la categoría <undefined>. paddarray añade relleno antes del primer elemento y después del último de cada dimensión, por defecto.

B = padarray(A,padsize,padval) rellena el arreglo A, en el que padval especifica un valor constante que se desea utilizar para los elementos de relleno o un método para replicar los elementos del arreglo.

B = padarray(___,direction) rellena A en la dirección que especifica direction.

Ejemplos

Añadir relleno a arreglos 2D y 3D

Rellenar el inicio de un vector

Añada tres elementos de relleno al principio de un vector con valor de relleno 9.

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

Rellenar todas las dimensiones de un arreglo 2D

Añada tres elementos de relleno al final de la primera dimensión del arreglo y dos elementos de relleno al final de la segunda dimensión. Utilice el valor del último elemento del arreglo en cada dimensión como valor de relleno.

A = [ 1 2; 3 4 ]

A = 2×2

     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

Rellenar todas las dimensiones de un arreglo 3D

Añada tres elementos de relleno en cada una de las dimensiones de un arreglo tridimensional. Cada elemento de relleno contiene el valor 0.

En primer lugar, cree un arreglo 3D.

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

Rellene el arreglo 3D.

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

Argumentos de entrada

A — Arreglo que se desea rellenar

Arreglo numérico | Arreglo lógico | Arreglo categórico

Arreglo que se desea rellenar, especificado como arreglo numérico, lógico o categórico de cualquier dimensión.

Tipos de datos: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64 | logical | categorical

padsize — Cantidad de relleno

Vector de enteros no negativos

Cantidad de relleno que se desea añadir a cada dimensión, especificada como vector de enteros no negativos. Por ejemplo, un valor padsize de [2 3] añade dos elementos de relleno a lo largo de la primera dimensión y tres elementos de relleno a lo largo de la segunda dimensión.

Tipos de datos: double

padval — Valor de relleno

0 | Escalar numérico | "circular" | "replicate" | "symmetric" | escalar de cadena | vector de caracteres | missing

Valor de relleno, especificado como escalar numérico, un escalar de cadena o un vector de caracteres.

Esta tabla muestra las opciones de relleno para imágenes numéricas y lógicas. El valor de relleno por defecto de las imágenes numéricas y lógicas es 0.

Valores de relleno para imágenes numéricas y lógicas

Valor	Descripción	Ejemplo
Escalar numérico, X	A los valores del arreglo de entrada que se encuentran fuera de los límites del arreglo se les asigna el valor X. Cuando no se especifica una opción de relleno, el valor predeterminado es 0.	$$\left[\begin{array}{ccc}3& 1& 4\\ 1& 5& 9\\ 2& 6& 5\end{array}\right]\to \left[\begin{array}{ccccccc}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{array}\right]$$
"symmetric"	Los valores del arreglo de entrada que se encuentran fuera de los límites del arreglo se calculan reflejando en espejo el arreglo a lo largo de su borde.	$$\left[\begin{array}{ccc}3& 1& 4\\ 1& 5& 9\\ 2& 6& 5\end{array}\right]\to \left[\begin{array}{ccccccc}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{array}\right]$$
"replicate"	Los valores del arreglo de entrada que se encuentran fuera de los límites del arreglo se asumen iguales que el valor de borde más cercano del arreglo.	$$\left[\begin{array}{ccc}3& 1& 4\\ 1& 5& 9\\ 2& 6& 5\end{array}\right]\to \left[\begin{array}{ccccccc}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{array}\right]$$
"circular"	Los valores del arreglo de entrada que se encuentran fuera de los límites del arreglo se calculan asumiendo implícitamente que el arreglo de entrada es periódico.	$$\left[\begin{array}{ccc}3& 1& 4\\ 1& 5& 9\\ 2& 6& 5\end{array}\right]\to \left[\begin{array}{ccccccc}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{array}\right]$$

Esta tabla muestra las opciones de relleno para imágenes categóricas. El valor de relleno predeterminado de las imágenes categóricas es missing.

Valores de relleno para imágenes categóricas

Valor	Descripción
Escalar de cadena o vector de caracteres	Relleno con elementos de una categoría especificada. La cadena o el vector de caracteres deben corresponder a una categoría válida de la imagen.
missing	Relleno con la categoría <undefined>. Para obtener más información, consulte missing.
"symmetric"	Los valores del arreglo de entrada que se encuentran fuera de los límites del arreglo se calculan reflejando en espejo el arreglo a lo largo de su borde.
"replicate"	Los valores del arreglo de entrada que se encuentran fuera de los límites del arreglo se asumen iguales que el valor de borde más cercano del arreglo.
"circular"	Los valores del arreglo de entrada que se encuentran fuera de los límites del arreglo se calculan asumiendo implícitamente que el arreglo de entrada es periódico.

Tipos de datos: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64 | logical | char | string

direction — Dirección en la que se rellenan los arreglos

"both" (predeterminado) | "post" | "pre"

Dirección en la que se rellenan los arreglos, especificada como uno de los siguientes valores:

Valor	Significado
"both"	Relleno antes del primer elemento y después del último elemento del arreglo, a lo largo de cada dimensión.
"post"	Relleno después del último elemento del arreglo, a lo largo de cada dimensión.
"pre"	Relleno antes del primer elemento del arreglo, a lo largo de cada dimensión.

Tipos de datos: char | string

Argumentos de salida

B — Arreglo relleno

Arreglo numérico | Arreglo lógico | Arreglo categórico

Arreglo relleno, devuelto como arreglo del mismo tipo de datos que A.

Capacidades ampliadas

Generación de código C/C++

Genere código C y C++ mediante MATLAB® Coder™.

Notas y limitaciones de uso:

• padarray es compatible con la generación de código C y C++ (requiere MATLAB^® Coder™). Para obtener más información, consulte Code Generation for Image Processing.

• Los arreglos de entrada de tipo de datos categóricos no son compatibles.

• A la hora de generar código, padarray solo es compatible con entradas hasta 3D.

• Los argumentos de entrada padval y direction, deben ser constantes en tiempo de compilación.

Generación de código de GPU

Genere código CUDA® para GPU NVIDIA® mediante GPU Coder™.

Notas y limitaciones de uso:

• Los arreglos de entrada de tipo de datos categóricos no son compatibles.

• A la hora de generar código, padarray solo es compatible con entradas hasta 3D.

• Los argumentos de entrada padval y direction, deben ser constantes en tiempo de compilación.

Arreglos GPU

Acelere código mediante la ejecución en una unidad de procesamiento gráfico (GPU) mediante Parallel Computing Toolbox™.

Esta función es totalmente compatible con los arreglos de GPU. Para obtener más información, consulte Procesamiento de imágenes en una GPU.

Historial de versiones

Introducido antes de R2006a

Consulte también

circshift | imfilter | paddata

Temas

• Opciones de relleno de límites de imfilter