# cf.Data.override_units

`Data.``override_units`(units, i=False)

  Override the data array units.

  Not to be confused with setting the `Units` attribute to units which are equivalent to the original units. This is different because in this case 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.

  Parameters: | units: `str` or `cf.Units` The new units for the data array. i: `bool`, optional If True then update the data array in place. By default a new data array is created.
  Returns: | out: `cf.Data`
  Examples: |

      >>> d = cf.Data(1012.0, 'hPa')
      >>> d.override_units('km')
      >>> d.Units
      <CF Units: km>
      >>> d.datum(0)
      1012.0
      >>> d.override_units(cf.Units('watts'))
      >>> d.Units
      <CF Units: watts>
      >>> d.datum(0)
      1012.0