pandas.SparseDtype#

class pandas.SparseDtype(dtype=<class 'numpy.float64'>, fill_value=None)[source]#

Dtype for data stored in SparseArray.

This dtype implements the pandas ExtensionDtype interface.

Parameters:

dtypestr, ExtensionDtype, numpy.dtype, type, default numpy.float64

The dtype of the underlying array storing the non-fill value values.

fill_valuescalar, optional

The scalar value not stored in the SparseArray. By default, this depends on dtype.

dtype	na_value
float	`np.nan`
int	`0`
bool	`False`
datetime64	`pd.NaT`
timedelta64	`pd.NaT`

The default value may be overridden by specifying a fill_value.

Examples

>>> ser = pd.Series([1, 0, 0], dtype=pd.SparseDtype(dtype=int, fill_value=0))
>>> ser
0    1
1    0
2    0
dtype: Sparse[int64, 0]
>>> ser.sparse.density
0.3333333333333333

Attributes

None

Methods

None