pandas.api.extensions.ExtensionDtype

class pandas.api.extensions.ExtensionDtype [source]

Тип данных пользовательского определения, который следует использовать совместно с ExtensionArray.

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

См. также

extensions.register_extension_dtype

extensions.ExtensionArray

Примечания

Интерфейс включает следующие абстрактные методы, которые должны быть реализованы подклассами:

• type
• name
• construct_from_string

Следующие атрибуты влияют на поведение типа данных в операциях pandas:

• _is_numeric
• _is_boolean

По желанию можно переопределить construct_array_type для создания с именем этого типа данных с помощью реестра. См. extensions.register_extension_dtype().

• construct_array_type

Атрибут na_value можно использовать для установки значения по умолчанию NA для этого типа. numpy.nan используется по умолчанию.

ExtensionDtype должны быть хэшируемыми. Базовый класс предоставляет реализацию по умолчанию, которая полагается на атрибут _metadata. _metadata должен быть кортежем, содержащим строки, определяющие тип данных. Например, с PeriodDtype это атрибут freq.

Если у вас есть параметризованный тип данных, вы должны установить свойство класса ``_metadata``.

В идеале атрибуты в _metadata будут соответствовать параметрам вашего ExtensionDtype.__init__ (если таковые имеются). Если какой-либо из атрибутов в _metadata не реализует стандартный __eq__ или __hash__, реализации по умолчанию здесь не будут работать.

Изменено в версии 0.24.0: Добавлены _metadata, __hash__, и изменено по умолчанию определение __eq__.

Этот класс не наследуется от ‘abc.ABCMeta’ по соображениям производительности. Методы и свойства, необходимые для интерфейса, вызывают pandas.errors.AbstractMethodError и метод регистрации виртуальных подклассов register не предоставляется.

Атрибуты

kind	Код символа (один из ‘biufcmMOSUV’), по умолчанию ‘O’
na_value	Значение по умолчанию NA для использования в этом типе.
name	Строка, идентифицирующая тип данных.
names	Отсортированный список имен полей, или None, если полей нет.
type	Скалярный тип массива, например,

Методы

construct_array_type()	Возвращает тип массива, связанный с этим типом данных
construct_from_string(строка)	Строить этот тип из строки.
is_dtype(dtype)	Проверка на соответствие ‘dtype’.