cf.Data.tan

Data.tan(inplace=False, i=False)[source]

Take the trigonometric tangent of the data element-wise.

Units are accounted for in the calculation. If the units are not equivalent to radians (such as Kelvin) then they are treated as if they were radians. For example, the tangents of 45 degrees_east, 0.78539816 radians and 0.78539816 Kelvin are all 1.0.

The output units are changed to ‘1’ (nondimensional).

See also

arctan, cos, sin, tanh

Parameters
inplace: bool, optional

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

i: deprecated at version 3.0.0

Use the inplace parameter instead.

Returns

Data or None

Examples

>>> d.Units
<Units: degrees_north>
>>> print(d.array)
[[-45 0 45 --]]
>>> e = d.tan()
>>> e.Units
<Units: 1>
>>> print(e.array)
[[-1.0 0.0 1.0 --]]
>>> d.Units
<Units: m s-1>
>>> print(d.array)
[[1 2 3 --]]
>>> d.tan(inplace=True)
>>> d.Units
<Units: 1>
>>> print(d.array)
[[1.55740772465 -2.18503986326 -0.142546543074 --]]