tile¶
- tile(x: array, repetitions: Tuple[int, ...], /) array ¶
Constructs an array by tiling an input array.
- Parameters:
x (array) – input array.
repetitions (Tuple[int, ...]) –
number of repetitions along each axis (dimension).
Let
N = len(x.shape)
andM = len(repetitions)
.If
N > M
, the function must prepend ones until all axes (dimensions) are specified (e.g., ifx
has shape(8,6,4,2)
andrepetitions
is the tuple(3,3)
, thenrepetitions
must be treated as(1,1,3,3)
).If
N < M
, the function must prepend singleton axes (dimensions) tox
untilx
has as many axes (dimensions) asrepetitions
specifies (e.g., ifx
has shape(4,2)
andrepetitions
is the tuple(3,3,3,3)
, thenx
must be treated as if it has shape(1,1,4,2)
).
- Returns:
out (array) – a tiled output array. The returned array must have the same data type as
x
and must have a rank (i.e., number of dimensions) equal tomax(N, M)
. IfS
is the shape of the tiled array after prepending singleton dimensions (if necessary) andr
is the tuple of repetitions after prepending ones (if necessary), then the number of elements along each axis (dimension) must satisfyS[i]*r[i]
, wherei
refers to thei
th axis (dimension).
Notes
New in version 2023.12.