pandas.Series.array

Series.array

Массив расширений данных, лежащих в основе этого ряда или индекса.

Введено в версии 0.24.0.

Возвращает:	ExtensionArray Массив расширений значений, хранящихся внутри. Для типов расширений это фактический массив. Для типов NumPy это тонкая (без копирования) обёртка вокруг numpy.ndarray. .array отличается от .values, что может потребовать преобразования данных в другой вид.

См. также

Index.to_numpy

Аналогичный метод, который всегда возвращает массив NumPy.

Series.to_numpy

Аналогичный метод, который всегда возвращает массив NumPy.

Примечания

Эта таблица описывает различные типы массивов для каждого типа расширения данных в pandas.

Тип	Тип массива
category	Categorical
period	PeriodArray
interval	IntervalArray
IntegerNA	IntegerArray
datetime64[ns, tz]	DatetimeArray

Для любых типов расширений сторонних производителей тип массива будет ExtensionArray.

Для всех остальных типов данных .array будет arrays.NumpyExtensionArray , обертывающим фактический массив ndarray, хранящийся внутри. Если вам абсолютно необходим массив NumPy (возможно, с копированием/принудительным преобразованием данных), используйте Series.to_numpy() вместо этого.

Примеры

Для обычных типов NumPy, таких как int и float, возвращается PandasArray.

>>> pd.Series([1, 2, 3]).array
<PandasArray>
[1, 2, 3]
Length: 3, dtype: int64

Для типов расширений, таких как Categorical, возвращается фактический ExtensionArray.

>>> ser = pd.Series(pd.Categorical(['a', 'b', 'a']))
>>> ser.array
[a, b, a]
Categories (2, object): [a, b]