cf.FieldAncillary.arccos

FieldAncillary.arccos(*args, **kwargs)[source]

Take the trigonometric inverse cosine of the data element- wise.

Units are ignored in the calculation. The result has units of radians.

The “standard_name” and “long_name” properties are removed from the result.

New in version 3.2.0.

See also

cos, arcsin, arctan, arccosh

Parameters
inplace: bool, optional

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

Returns
FieldAncillary or None

The construct with the trigonometric inverse cosine of data values. If the operation was in-place then None is returned.

Examples:

>>> print(f.array)
[[0.5 0.7]
 [0.9 1.1]]
>>> g = f.arccos()
>>> g.Units
<Units: radians>
>>> print(g.array)
[[1.04719755 0.79539883]
 [0.45102681        nan]]

>>> print(f.array)
[1.2 1.0 0.8 0.6 --]
>>> f.arccos(inplace=True)
>>> print(f.array)
[nan 0.0 0.6435011087932843 0.9272952180016123 --]
>>> f.mask_invalid(inplace=True)
>>> print(f.array)
[-- 0.0 0.6435011087932843 0.9272952180016123 --]