cf.FieldAncillary.arcsin

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

Take the trigonometric inverse sine 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

sin, arccos, arctan, arcsinh

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 sine 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.arcsin()
>>> g.Units
<Units: radians>
>>> print(g.array)
[[0.52359878 0.7753975 ]
 [1.11976951        nan]]

>>> print(f.array)
[1.2 1.0 0.8 0.6 --]
>>> f.arcsin(inplace=True)
>>> print(f.array)
[nan 1.5707963267948966 0.9272952180016123 0.6435011087932844 --]
>>> f.masked_invalid(inplace=True)
>>> print(f.array)
[-- 1.5707963267948966 0.9272952180016123 0.6435011087932844 --]