cfdm.Field.unsqueeze

Field.unsqueeze(inplace=None)[source]

Insert size 1 axes into the data array.

All size 1 domain axes which are not spanned by the field construct’s data are inserted.

The axes are inserted into the slowest varying data array positions.

New in version (cfdm): 1.12.0.0

See also

insert_dimension, squeeze, transpose

Parameters
inplace: bool, optional

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

Returns
Field or None

The field construct with size-1 axes inserted in its data, or None if the operation was in-place.

Examples

>>>
>>> f = cfdm.example_field(0)
>>> print(f)
Field: specific_humidity (ncvar%q)
----------------------------------
Data            : specific_humidity(latitude(5), longitude(8)) 1
Cell methods    : area: mean
Dimension coords: latitude(5) = [-75.0, ..., 75.0] degrees_north
                : longitude(8) = [22.5, ..., 337.5] degrees_east
                : time(1) = [2019-01-01 00:00:00]
>>> g = f.unsqueeze()
>>> print(g)
Field: specific_humidity (ncvar%q)
----------------------------------
Data            : specific_humidity(time(1), latitude(5), longitude(8)) 1
Cell methods    : area: mean
Dimension coords: latitude(5) = [-75.0, ..., 75.0] degrees_north
                : longitude(8) = [22.5, ..., 337.5] degrees_east
                : time(1) = [2019-01-01 00:00:00]