Esta página aún no se ha traducido para esta versión. Puede ver la versión más reciente de esta página en inglés.

padarray

Array Pad

Sintaxis

B = padarray(A,padsize)

B = padarray(A,padsize,padval)

B = padarray(___,direction)

gpuarrayB = padarray(gpuarrayA,___)

Descripción

B = padarray(A,padsize) pads array A con 0s (ceros). padsize es un vector de enteros no negativos que especifica tanto la cantidad de relleno que se va a agregar como la dimensión a lo largo de la cual agregarla. El valor de un elemento del vector especifica la cantidad de relleno que se agregará. El orden del elemento en el vector especifica la dimensión a lo largo de la cual se agrega el relleno.

B = padarray(A,padsize,padval) pads array A donde padval especifica un valor constante que se utiliza para los elementos acolchados o un método para replicar elementos de matriz.

B = padarray(___,direction) pads A en la dirección especificada por direction.

gpuarrayB = padarray(gpuarrayA,___) realiza la operación de relleno en una GPU, donde gpuarrayA es un objeto gpuArray que contiene la imagen A. El valor devuelto gpuarrayB es también un gpuArray. Esta sintaxis requiere el Parallel Computing Toolbox™.

Ejemplos

Agregar relleno a matrices 2-d y 3-d

Pad el inicio de un vector

Añada tres elementos de relleno al principio de un vector con el 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

Almohadilla de cada dimensión de una matriz de 2-D

Añada tres elementos de relleno al final de la primera dimensión de la matriz y dos elementos de relleno al final de la segunda dimensión. Utilice el valor del último elemento Array de 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

Almohadilla de cada dimensión de una matriz tridimensional

Añada tres elementos de relleno a cada dimensión de una matriz tridimensional. Cada elemento Pad contiene el valor 0.

En primer lugar, cree el array 3-D.

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  

Rellenar el array 3-D

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  

Realizar relleno en una GPU

Añada relleno en todos los lados de una imagen.

gcam = gpuArray(imread('cameraman.tif')); padcam = padarray(gcam,[50 50],'both'); imshow(padcam) 

Argumentos de entrada

A — Array a rellenar

matriz numérica o lógica

Matriz que se debe rellenar, especificada como una matriz de cualquier dimensión. Cuando el relleno con un valor constante, A debe ser numérico o lógico. Cuando se rellena con los métodos 'circular', 'replicate'o 'symmetric' , A puede ser de cualquier clase.

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

padsize — Cantidad de relleno para agregar a cada dimensión

Vector de enteros no negativos

Cantidad de relleno que se agrega a cada dimensión, especificada como un vector de enteros no negativos. Por ejemplo, un valor padsize de [2 3] significa añadir 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. De forma predeterminada, paddarray agrega relleno antes del primer elemento y después del último elemento a lo largo de la cota especificada.

Tipos de datos: double

padval — Valor a utilizar para el relleno

0 (predeterminado) | escalar numérico | 'circular' | 'replicate' | 'symmetric'

Valor que se utilizará para el relleno, especificado como uno de los siguientes.

Valor	Significado
escalar numérico	Array pad con elementos de valor constante.
'circular'	Almohadilla con repetición circular de elementos dentro de la dimensión.
'replicate'	Almohadilla repitiendo elementos de borde de matriz.
'symmetric'	Array pad con reflejos espejo de sí mismo.

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

direction — Dónde rellenar la matriz a lo largo de cada dimensión

'both' (predeterminado) | 'post' | 'pre'

Dónde rellenar array a lo largo de cada dimensión, especificada como uno de los siguientes valores:

Valor	Significado
'both'	Pads antes del primer elemento y después del último elemento Array a lo largo de cada dimensión.
'post'	Pad después del último elemento Array a lo largo de cada dimensión.
'pre'	Pad antes del primer elemento Array a lo largo de cada dimensión.

Tipos de datos: char | string

gpuarrayA — Matriz que se rellena cuando se ejecuta en una GPU

gpuArray (predeterminado)

Imagen a rellenar cuando se ejecuta en una GPU, especificada como un gpuArray.

Argumentos de salida

B — Matriz acolchada

matriz numérica

Matriz acolchada, devuelta como una matriz numérica. B es de la misma clase que A.

gpuarrayB — Arreglo de discos acolchado cuando se ejecuta en una GPU

gpuArray (predeterminado)

Matriz acolchada cuando se ejecuta en una GPU, regresó como un gpuArray.

Capacidades ampliadas

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

Generar código C y C++ utilizando MATLAB® Coder™.

Usage notes and limitations:

• Esta función soporta la generación de código C utilizando MATLAB^® Coder™. Para obtener más información, consulte Code Generation for Image Processing.

• Al generar código, padarray sólo admite entradas de hasta 3-D, y los argumentos de entrada, padval y direction deben ser constantes de tiempo de compilación.

Consulte también

circshift | gpuArray | imfilter

Introducido antes de R2006a