cfdm.FieldAncillary.insert_dimension

FieldAncillary.insert_dimension(*args, **kwargs)[source]

Expand the shape of the data array.

Inserts a new size 1 axis into the data array.

New in version (cfdm): 1.7.0

See also

squeeze, transpose

Parameters
position: int, optional

Specify the position that the new axis will have in the data array. By default the new axis has position 0, the slowest varying position. Negative integers counting from the last position are allowed.

Parameter example:

position=2

Parameter example:

position=-1

inplace: bool, optional

If True then do the operation in-place and return None.

Returns
FieldAncillary or None

A new instance with expanded data axes. If the operation was in-place then None is returned.

Examples

>>> f.shape
(19, 73, 96)
>>> f.insert_dimension(position=3).shape
(19, 73, 96, 1)
>>> f.insert_dimension(position=-1).shape
(19, 73, 1, 96)