# tile
> Return an [ndarray][@stdlib/ndarray/base/ctor] created by repeating the elements of an input [ndarray][@stdlib/ndarray/base/ctor] a specified number of times along each dimension.
## Usage
```javascript
var tile = require( '@stdlib/ndarray/base/tile' );
```
#### tile( x, reps )
Returns an [ndarray][@stdlib/ndarray/base/ctor] created by repeating the elements of an input [ndarray][@stdlib/ndarray/base/ctor] a specified number of times along each dimension.
```javascript
var array = require( '@stdlib/ndarray/array' );
var x = array( [ [ 1, 2 ], [ 3, 4 ] ] );
// returns [ [ 1, 2 ], [ 3, 4 ] ]
var y = tile( x, [ 2, 2 ] );
// returns [ [ 1, 2, 1, 2 ], [ 3, 4, 3, 4 ], [ 1, 2, 1, 2 ], [ 3, 4, 3, 4 ] ]
```
The function accepts the following arguments:
- **x**: input [ndarray][@stdlib/ndarray/base/ctor].
- **reps**: list specifying the number of times to repeat elements of an input [ndarray][@stdlib/ndarray/base/ctor] along each dimension.
## Notes
- The number of repetitions must have at least as many elements as the number of input dimensions. When the number of repetitions exceeds the number of input dimensions, the input [ndarray][@stdlib/ndarray/base/ctor] is treated as if singleton dimensions were prepended.
- The function always copies data to a new [ndarray][@stdlib/ndarray/base/ctor].
## Examples
```javascript
var array = require( '@stdlib/ndarray/array' );
var ndarray2array = require( '@stdlib/ndarray/to-array' );
var tile = require( '@stdlib/ndarray/base/tile' );
// Create a 2x2 array:
var x = array( [ [ 1, 2 ], [ 3, 4 ] ] );
console.log( ndarray2array( x ) );
// Tile the array to 4x4:
var out = tile( x, [ 2, 2 ] );
console.log( ndarray2array( out ) );
```
[@stdlib/ndarray/base/ctor]: https://github.com/stdlib-js/ndarray/tree/main/base/ctor