pandas.Series.to_numpy

Series.to_numpy(dtype=None, copy=False, na_value=_NoDefault.no_default, **kwargs)[source]

Массив NumPy, представляющий значения в этом ряде или индексе.

Параметры

dtype:str или numpy.dtype, необязательно

Тип данных, который передать numpy.asarray().

copy:bool, по умолчанию False

Указывает, нужно ли гарантировать, что возвращаемое значение не является представлением другого массива. Обратите внимание, что copy=False не гарантирует, что to_numpy() не будет копией. Вместо этого copy=True гарантирует, что будет создана копия, даже если это не строго необходимо.

na_value:Любое значение, необязательно

Значение, которое использовать для пропущенных значений. Значение по умолчанию зависит от dtype и типа массива.

Доступно начиная с версии 1.0.0.

**kwargs

Дополнительные ключевые слова, передаваемые в метод to_numpy базового массива (для расширяемых массивов).

Доступно начиная с версии 1.0.0.

Возвращаемое значение

numpy.ndarray

См. также

Series.array

Получить фактические данные, хранящиеся внутри.

Index.array

Получить фактические данные, хранящиеся внутри.

DataFrame.to_numpy

Аналогичный метод для DataFrame.

Примечания

Возвращаемый массив будет таким же до равенства (значения, равные в self, будут равны в возвращаемом массиве; то же самое касается значений, которые не равны). Когда self содержит ExtensionArray, тип данных может быть другим. Например, для ряда с типом данных категории, to_numpy() вернёт массив NumPy, и тип данных категории будет утерян.

Для типов данных NumPy это будет ссылка на фактические данные, хранящиеся в этом ряде или индексе (при условии copy=False). Изменение результата на месте изменит данные, хранящиеся в ряде или индексе (не рекомендуем этого делать).

Для расширенных типов to_numpy() может потребоваться копирование данных и приведение результата к типу NumPy (возможно, объект), что может быть дорогостоящим. Если вам нужна ссылка без копирования на базовые данные, следует использовать Series.array.

В этой таблице представлены разные типы данных и типы возвращаемых массивов to_numpy() для различных типов данных в pandas.

dtype	тип массива
category[T]	ndarray[T] (тот же тип данных, что и входной)
period	ndarray[object] (Периоды)
interval	ndarray[object] (Интервалы)
IntegerNA	ndarray[object]
datetime64[ns]	datetime64[ns]
datetime64[ns, tz]	ndarray[object] (Марки времени)

Примеры

>>> ser = pd.Series(pd.Categorical(['a', 'b', 'a']))
>>> ser.to_numpy()
array(['a', 'b', 'a'], dtype=object)

Укажите dtype для управления тем, как представляются данные с маркировкой даты и времени. Используйте dtype=object для возврата ndarray из pandas Timestamp объекты, каждый с правильным tz.

>>> ser = pd.Series(pd.date_range('2000', periods=2, tz="CET"))
>>> ser.to_numpy(dtype=object)
array([Timestamp('2000-01-01 00:00:00+0100', tz='CET'),
       Timestamp('2000-01-02 00:00:00+0100', tz='CET')],
      dtype=object)

Или dtype='datetime64[ns]' для возврата ndarray с нативными значениями datetime64. Значения преобразуются в UTC, и информация о часовом поясе отбрасывается.

>>> ser.to_numpy(dtype="datetime64[ns]")
... 
array(['1999-12-31T23:00:00.000000000', '2000-01-01T23:00:00...'],
      dtype='datetime64[ns]')