cf.AuxiliaryCoordinate.override_units¶
- AuxiliaryCoordinate.override_units(*args, **kwargs)[source]¶
Override the units.
The new units need not be equivalent to the original ones, and the data array elements will not be changed to reflect the new units. Therefore, this method should only be used when it is known that the data array values are correct but the units have incorrectly encoded.
Not to be confused with changing to equivalent units with the
to_units
method or theUnits
,units
, orcalendar
attributes. These approaches also convert the data values to conform with the new units.See also
override_calendar
,to_units
,Units
,units
,calendar
- Parameters:
- Returns:
AuxiliaryCoordinate
orNone
The construct with data converted to the new units, or
None
if the operation was in-place.
Examples
>>> f.Units <Units: hPa> >>> f.datum(0) 100000.0 >>> f.override_units('km') >>> f.Units <Units: km> >>> f.datum(0) 100000.0 >>> f.override_units(Units('watts')) >>> f.Units <Units: watts> >>> f.datum(0) 100000.0