pandas.Series.array

propertySeries.array[source]

Массив Extension для данных, на которых основана эта Series или Index.

Returns:

ExtensionArray

ExtensionArray сохраненных значений. Для типов расширений это фактический массив. Для типов NumPy это тонкая (без копирования) оболочка вокруг numpy.ndarray.

.array отличается от .values, что может потребовать преобразования данных в другой формат.

См. также

Index.to_numpy

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

Series.to_numpy

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

Примечания

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

тип данных	тип массива
category	Categorical
period	PeriodArray
interval	IntervalArray
IntegerNA	IntegerArray
string	StringArray
boolean	BooleanArray
datetime64[ns, tz]	DatetimeArray

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

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

Примеры

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

>>> pd.Series([1, 2, 3]).array
<NumpyExtensionArray>
[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']