xarray.DataArray.str.casefold#

DataArray.str.casefold()[source]#

Convert strings in the array to be casefolded.

Casefolding is similar to converting to lowercase, but removes all case distinctions. This is important in some languages that have more complicated cases and case conversions. For example, the ‘ß’ character in German is case-folded to ‘ss’, whereas it is lowercased to ‘ß’.

Returns:

casefolded (same type as values)

Examples

>>> da = xr.DataArray(["TEMPERATURE", "HuMiDiTy"], dims="x")
>>> da
<xarray.DataArray (x: 2)>
array(['TEMPERATURE', 'HuMiDiTy'], dtype='<U11')
Dimensions without coordinates: x
>>> casefolded = da.str.casefold()
>>> casefolded
<xarray.DataArray (x: 2)>
array(['temperature', 'humidity'], dtype='<U11')
Dimensions without coordinates: x
>>> da = xr.DataArray(["ß", "İ"], dims="x")
>>> da
<xarray.DataArray (x: 2)>
array(['ß', 'İ'], dtype='<U1')
Dimensions without coordinates: x
>>> casefolded = da.str.casefold()
>>> casefolded
<xarray.DataArray (x: 2)>
array(['ss', 'i̇'], dtype='<U2')
Dimensions without coordinates: x