Repeat the contents of the input array along the specified dimensions. More...
Functions | |
AFAPI array | tile (const array &in, const unsigned x, const unsigned y=1, const unsigned z=1, const unsigned w=1) |
AFAPI array | tile (const array &in, const dim4 &dims) |
AFAPI af_err | af_tile (af_array *out, const af_array in, const unsigned x, const unsigned y, const unsigned z, const unsigned w) |
Repeat the contents of the input array along the specified dimensions.
Creates copies of the input array and concatenates them with each other, such that the output array will have as many copies of the input array as the user specifies, along each dimension. In this sense, the output array is essentially a set of "tiles", where each copy of the input array (including the original) is a "tile" (hence the name of this function).
Given below are some examples. The input array looks like this:
Here, the input array is tiled along the first dimenson, 2 times:
Here, the input is tiled along the second dimension, 3 times:
Lastly, one can also tile along multiple dimensions simultaneously. Here, the input is tiled 2 times in the first dimension and 3 times in the second dimension:
AFAPI af_err af_tile | ( | af_array * | out, |
const af_array | in, | ||
const unsigned | x, | ||
const unsigned | y, | ||
const unsigned | z, | ||
const unsigned | w | ||
) |
[out] | out | is the tiled version of the input array |
[in] | in | is the input matrix |
[in] | x | is the number of times in is copied along the first dimension |
[in] | y | is the number of times in is copied along the the second dimension |
[in] | z | is the number of times in is copied along the third dimension |
[in] | w | is the number of times in is copied along the fourth dimension |
x
, y
, z
, and w
includes the original in the count as well. Thus, if no duplicates are needed in a certain dimension, leave it as 1 (the default value for just one copy) [in] | in | is the input array |
[in] | dims | specifies the number of times in is copied along each dimension |
dims
includes the original in the count as well. Thus, if no duplicates are needed in a certain dimension, leave it as 1 (the default value for just one copy) AFAPI array af::tile | ( | const array & | in, |
const unsigned | x, | ||
const unsigned | y = 1 , |
||
const unsigned | z = 1 , |
||
const unsigned | w = 1 |
||
) |
[in] | in | is the input array |
[in] | x | is the number of times in is copied along the first dimension |
[in] | y | is the number of times in is copied along the the second dimension |
[in] | z | is the number of times in is copied along the third dimension |
[in] | w | is the number of times in is copied along the fourth dimension |
x
, y
, z
, and w
includes the original in the count as well. Thus, if no duplicates are needed in a certain dimension, leave it as 1 (the default value for just one copy)