scale#
- movement.transforms.scale(data, factor=1.0, space_unit=None)[source]#
Scale data by a given factor with an optional unit.
- Parameters:
data (xarray.DataArray) – The input data to be scaled.
factor (ArrayLike or float) – The scaling factor to apply to the data. If factor is a scalar (a single float), the data array is uniformly scaled by the same factor. If factor is an object that can be converted to a 1D numpy array (e.g. a list of floats), the length of the resulting array must match the length of data array’s space dimension along which it will be broadcasted.
space_unit (str or None) – The unit of the scaled data stored as a property in xarray.DataArray.attrs[‘space_unit’]. In case of the default (
None
) thespace_unit
attribute is dropped.
- Returns:
The scaled data array.
- Return type:
Notes
When scale is used multiple times on the same xarray.DataArray, xarray.DataArray.attrs[“space_unit”] is overwritten each time or is dropped if
None
is passed by default or explicitly.