cfdm.Data.first_element

Data.first_element()[source]

Return the first element of the data as a scalar.

New in version (cfdm): 1.7.0

See also

last_element, second_element

Returns

The first element of the data.

Examples

>>> d = cfdm.Data(9.0)
>>> x = d.first_element()
>>> print(x, type(x))
9.0 <class 'float'>

>>> d = cfdm.Data([[1, 2], [3, 4]])
>>> x = d.first_element()
>>> print(x, type(x))
1 <class 'int'>
>>> d[0, 0] = cfdm.masked
>>> y = d.first_element()
>>> print(y, type(y))
-- <class 'numpy.ma.core.MaskedConstant'>

>>> d = cfdm.Data(['foo', 'bar'])
>>> x = d.first_element()
>>> print(x, type(x))
foo <class 'str'>