Mathematica 9 is now available
SEARCH MATHEMATICA 8 DOCUMENTATION
THIS IS DOCUMENTATION FOR AN OBSOLETE PRODUCT.
SEE THE DOCUMENTATION CENTER FOR THE LATEST INFORMATION.
Mathematica > Core Language > List Manipulation > Rearranging & Restructuring Lists >
Mathematica > Data Manipulation > Handling Arrays of Data > Rearranging & Restructuring Lists >
Built-in Mathematica SymbolSee Also »|More About »

ArrayPad

ArrayPad[array, m]
gives an array with m 0s of padding on every side.
ArrayPad[array, m, padding]
uses the specified padding.
ArrayPad[array, {m, n}, ...]
pads with m elements at the beginning and n elements at the end.
ArrayPad[array, {{m1, n1}, {m2, n2}, ...}, ...]
pads with mi, ni elements at level i in array.
  • The following forms of padding can be specified:
ca constant c
{c1,c2,...}cyclic repetition of constants c1, ...
"Extrapolated"polynomial extrapolation of elements
"Fixed"repetitions of the elements on each boundary
"Periodic"cyclic repetitions of the complete array
"Reflected"reflections of the array in the boundary
"ReflectedDifferences"reflections of the differences between elements
"Reversed"reversals of the complete array
"ReversedDifferences"reversals of the differences between elements
"ReversedNegation"negated reversals of the array
  • The padding value "Fixed" indicates that the elements added at each corner should be copies of the elements at the corners of the original array.
  • "Reversed" indicates that the outermost elements in the array should be repeated as the innermost elements in the padding. "Reflected" specifies that these elements should not be repeated.
  • With the padding value "Extrapolated", the degree of polynomial used is specified by the option InterpolationOrder.
  • ArrayPad pads full arrays of any depth.
  • ArrayPad[array, -m] removes m elements from each side of array.
EXAMPLESCLOSE ALL
Basic Examples   (5)
Pad the edges of a list with 0s:
Pad the edges of a matrix:
Specify different padding on each side:
Pad with any expression:
Pad according to a named rule:
Pad the edges of a list with 0s:
In[1]:=
Click for copyable input
Out[1]=
 
Pad the edges of a matrix:
In[1]:=
Click for copyable input
Out[1]//MatrixForm=
 
Specify different padding on each side:
In[1]:=
Click for copyable input
Out[1]=
 
Pad with any expression:
In[1]:=
Click for copyable input
Out[1]=
 
Pad according to a named rule:
In[1]:=
Click for copyable input
Out[1]=
Scope   (12)
Pad only on the right:
Remove elements from each edge of an array:
Pad with extra rows:
Pad with extra columns:
Specify different padding for each edge:
Pad only the first level of an array:
Pad by repeating periodically:
Pad with the reversal of the list:
Pad with the negative of the reversal:
Pad by reflecting about the edge:
Pad antisymmetrically about the value at the edge:
Pad antisymmetrically about the edge of the array with reversed differences:
The differences are reflected about the edge of the original array:
Pad using linear extrapolation:
Pad using extrapolation of different orders:
Pad using the maximal extrapolation order:
Options   (3)
Specity the order of interpolation for "Extrapolated" padding:
By default linear interpolation is used:
Use the maximum possible order, in this case order 3:
Applications   (1)
Lay out tiles by reflecting about their edges:
Properties & Relations   (2)
PadLeft[list, n] and PadRight[list, n] pad to make a list of length n:
ArrayPad[list, n] pads with n additional elements on each side:
ArrayPad[list, {-n, 0}] is effectively Drop[list, n] for a one dimensional list:
ArrayPad[list, {0, -n}] is effectively Drop[list, -n]:
Possible Issues   (2)
A single number or pair of numbers is interpreted to apply in each dimension:
Explicitly specify the padding amount in each dimension:
Normally even empty array dimensions are padded:
With padding types that depend on array values only nonempty array dimensions are padded:
Neat Examples   (1)
Visualize the different named padding rules:
New in 7
Ask a question about this page  |  Suggest an improvement  |  Leave a message for the team