xdas.DataArray.expand_dims#

DataArray.expand_dims(dim, axis=0)[source]#

Add an additional dimension at a given axis position.

Parameters:

  • dim (str) – Dimensions to include on the new variable.

  • axis (int) – Axis position where new axis is to be inserted (position(s) on the result array).

Returns:

expanded – A copy of this object, but with additional dimension.

Return type:

DataArray

Notes

This operation returns a view of this array’s data if this later is a numpy.ndarray object. Otherwise the data is loaded into memory.

See also

numpy.expand_dims

Examples

>>> import xdas as xd

>>> da = xd.DataArray([1., 2., 3.], {"x": [0, 1, 2]})
>>> da
<xdas.DataArray (x: 3)>
[1. 2. 3.]
Coordinates:
  * x (x): [0 ... 2]

>>> da.expand_dims("y", 0)
<xdas.DataArray (y: 1, x: 3)>
[[1. 2. 3.]]
Coordinates:
  * x (x): [0 ... 2]
Dimensions without coordinates: y