pandas.api.extensions.ExtensionDtype

class pandas.api.extensions.ExtensionDtype [source]

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

Новое в версии 0.23.0.

См. также

pandas.api.extensions.register_extension_dtype, pandas.api.extensions.ExtensionArray

Примечания

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

• type
• name
• construct_from_string

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

• _is_numeric
• _is_boolean

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

• construct_array_type

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

ExtensionDtypes должны быть хешируемыми. Базовый класс предоставляет реализацию по умолчанию, которая использует атрибут _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’
name	Строка, идентифицирующая тип данных.
names	Упорядоченный список имён полей, или None, если полей нет.
type	Скалярный тип массива, например

Методы

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