pandas.SparseDtype — pandas 2.2.3 documentation (original) (raw)
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.
Attributes
Methods
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