cf.List.mask_invalidΒΆ

List.mask_invalid(*args, **kwargs)[source]ΒΆ

Mask the array where invalid values occur.

Note that:

  • Invalid values are Nan or inf

  • Invalid values in the results of arithmetic operations only occur if the raising of FloatingPointError exceptions has been suppressed by cf.Data.seterr.

  • If the raising of FloatingPointError exceptions has been allowed then invalid values in the results of arithmetic operations it is possible for them to be automatically converted to masked values, depending on the setting of cf.Data.mask_fpe. In this case, such automatic conversion might be faster than calling mask_invalid.

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
List or None

TODO

Examples:

>>> print(f.array)
[ 0.  1.]
>>> print(g.array)
[ 1.  2.]
>>> old = cf.Data.seterr('ignore')
>>> h = g/f
>>> print(h.array)
[ inf   2.]
>>> h.mask_invalid(inplace=True)
>>> print(h.array)
[--  2.]
>>> h = g**12345
>>> print(h.array)
[ 1.  inf]
>>> h.mask_invalid(inplace=True)
>>> print(h.array)
[1.  --]
>>> old = cf.Data.seterr('raise')
>>> old = cf.Data.mask_fpe(True)
>>> print((g/f).array)
[ --  2]
>>> print((g**12345).array)
[1.  -- ]