pandas.arrays.IntegerArray — pandas 0.24.2 documentation (original) (raw)
class pandas.arrays. IntegerArray(values, mask, copy=False)[source]¶
Array of integer (optional missing) values.
New in version 0.24.0.
Warning
IntegerArray is currently experimental, and its API or internal implementation may change without warning.
We represent an IntegerArray with 2 numpy arrays:
- data: contains a numpy integer array of the appropriate dtype
- mask: a boolean array holding a mask on the data, True is missing
To construct an IntegerArray from generic array-like input, usepandas.array() with one of the integer dtypes (see examples).
See Nullable Integer Data Type for more.
| Parameters: | values : numpy.ndarray A 1-d integer-dtype array. mask : numpy.ndarray A 1-d boolean-dtype array indicating missing values. copy : bool, default False Whether to copy the values and mask. |
|---|---|
| Returns: | IntegerArray |
Examples
Create an IntegerArray with pandas.array().
int_array = pd.array([1, None, 3], dtype=pd.Int32Dtype()) int_array [1, NaN, 3] Length: 3, dtype: Int32
String aliases for the dtypes are also available. They are capitalized.
pd.array([1, None, 3], dtype='Int32') [1, NaN, 3] Length: 3, dtype: Int32
pd.array([1, None, 3], dtype='UInt16') [1, NaN, 3] Length: 3, dtype: UInt16
Attributes
| nbytes | The number of bytes needed to store this object in memory. |
|---|---|
| ndim | Extension Arrays are only allowed to be 1-dimensional. |
| shape | Return a tuple of the array dimensions. |
| dtype | | | --------- | |
Methods
| argsort([ascending, kind]) | Return the indices that would sort this array. |
|---|---|
| astype(dtype[, copy]) | Cast to a NumPy array or IntegerArray with ‘dtype’. |
| copy([deep]) | Return a copy of the array. |
| dropna() | Return ExtensionArray without NA values |
| factorize([na_sentinel]) | Encode the extension array as an enumerated type. |
| fillna([value, method, limit]) | Fill NA/NaN values using the specified method. |
| isna() | A 1-D array indicating if each value is missing. |
| repeat(repeats[, axis]) | Repeat elements of a ExtensionArray. |
| searchsorted(value[, side, sorter]) | Find indices where elements should be inserted to maintain order. |
| shift([periods, fill_value]) | Shift values by desired number. |
| take(indexer[, allow_fill, fill_value]) | Take elements from an array. |
| unique() | Compute the ExtensionArray of unique values. |
| value_counts([dropna]) | Returns a Series containing counts of each category. |