The ExtensionArray of the data backing this Series or Index.
This property provides direct access to the underlying array data of a Series or Index without requiring conversion to a NumPy array. It returns an ExtensionArray, which is the native storage format for pandas extension dtypes.
An ExtensionArray of the values stored within. For extension types, this is the actual array. For NumPy native types, this is a thin (no copy) wrapper around numpy.ndarray
.
.array
differs from .values
, which may require converting the data to a different form.
Notes
This table lays out the different array types for each extension dtype within pandas.
For any 3rd-party extension types, the array type will be an ExtensionArray.
For all remaining dtypes .array
will be a arrays.NumpyExtensionArray
wrapping the actual ndarray stored within. If you absolutely need a NumPy array (possibly with copying / coercing data), then use Series.to_numpy()
instead.
Examples
For regular NumPy types like int, and float, a NumpyExtensionArray is returned.
>>> pd.Series([1, 2, 3]).array <NumpyExtensionArray> [1, 2, 3] Length: 3, dtype: int64
For extension types, like Categorical, the actual ExtensionArray is returned
>>> ser = pd.Series(pd.Categorical(["a", "b", "a"])) >>> ser.array ['a', 'b', 'a'] Categories (2, object): ['a', 'b']
RetroSearch is an open source project built by @garambo | Open a GitHub Issue
Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo
HTML:
3.2
| Encoding:
UTF-8
| Version:
0.7.4