numpy.dtype

class numpy.dtype(obj, align=False, copy=False) [source]

Создать объект типа данных.

Массив numpy является однородным и содержит элементы, описываемые объектом dtype. Объект dtype можно создать из различных комбинаций основных числовых типов.

Параметры:

obj Объект, который должен быть преобразован в объект типа данных. align : bool, optional Добавить заполнение к полям, чтобы соответствовать выводу компилятора C для аналогичной структуры C. Может быть True только если obj является словарем или строкой, разделенной запятыми. Если создаётся структура dtype, это также устанавливает флаг привязки выравнивания isalignedstruct. copy : bool, optional Создать новую копию объекта типа данных. Если False, результат может быть просто ссылкой на встроенный объект типа данных.

См. также

result_type

Примеры

Использование типа массив-скаляр:

>>> np.dtype(np.int16)
dtype('int16')

Структурный тип, одно имя поля «f1», содержащее int16:

>>> np.dtype([('f1', np.int16)])
dtype([('f1', '<i2')])

Структурный тип, одно поле с именем «f1», само по себе содержащее структурированный тип с одним полем:

>>> np.dtype([('f1', [('f1', np.int16)])])
dtype([('f1', [('f1', '<i2')])])

Структурный тип, два поля: первое поле содержит целое число без знака, второе — целое число int32:

>>> np.dtype([('f1', np.uint), ('f2', np.int32)])
dtype([('f1', '<u4'), ('f2', '<i4')])

Использование строковых типов протокола массивов:

>>> np.dtype([('a','f8'),('b','S10')])
dtype([('a', '<f8'), ('b', '|S10')])

Использование форматов полей, разделённых запятыми. Форма — (2,3):

>>> np.dtype("i4, (2,3)f8")
dtype([('f0', '<i4'), ('f1', '<f8', (2, 3))])

Использование кортежей. int — фиксированный тип, 3 — форма поля. void — гибкий тип, здесь размером 10:

>>> np.dtype([('hello',(int,3)),('world',np.void,10)])
dtype([('hello', '<i4', 3), ('world', '|V10')])

Разделить int16 на 2 int8 под названием x и y. 0 и 1 — смещения в байтах:

>>> np.dtype((np.int16, {'x':(np.int8,0), 'y':(np.int8,1)}))
dtype(('<i2', [('x', '|i1'), ('y', '|i1')]))

Использование словарей. Два поля с именем «gender» и «age»:

>>> np.dtype({'names':['gender','age'], 'formats':['S1',np.uint8]})
dtype([('gender', '|S1'), ('age', '|u1')])

Смещения в байтах, здесь 0 и 25:

>>> np.dtype({'surname':('S25',0),'age':(np.uint8,25)})
dtype([('surname', '|S25'), ('age', '|u1')])

Атрибуты:

alignment Требуемое выравнивание (байты) этого типа данных в соответствии с компилятором. Дополнительная информация доступна в разделе C-API руководства. base byteorder Символ, указывающий порядок байтов этого объекта типа данных. Один из: ‘=’ родной ‘<’ малоэндианский ‘>’ многоэндианский ‘|’ неприменимо Все встроенные объекты типа данных имеют порядок байтов либо ‘=’ либо ‘|’. >>> dt = np.dtype('i2') >>> dt.byteorder '=' >>> # endian is not relevant for 8 bit numbers >>> np.dtype('i1').byteorder '|' >>> # or ASCII strings >>> np.dtype('S2').byteorder '|' >>> # Even if specific code is given, and it is native >>> # '=' is the byteorder >>> import sys >>> sys_is_le = sys.byteorder == 'little' >>> native_code = sys_is_le and '<' or '>' >>> swapped_code = sys_is_le and '>' or '<' >>> dt = np.dtype(native_code + 'i2') >>> dt.byteorder '=' >>> # Swapped code shows up as itself >>> dt = np.dtype(swapped_code + 'i2') >>> dt.byteorder == swapped_code True char Уникальный кодовый символ для каждого из 21 встроенного типа. descr __array_interface__ описание типа данных. fields Словарь именованных полей, определённых для этого типа данных, или None. flags Флаги-биты, описывающие способ интерпретации этого типа данных. Маски битов находятся в numpy.core.multiarray как константы ITEM_HASOBJECT, LIST_PICKLE, ITEM_IS_POINTER, NEEDS_INIT, NEEDS_PYAPI, USE_GETITEM, USE_SETITEM. Полное объяснение этих флагов находится в документации C-API; они в основном полезны для пользовательских типов данных. hasobject Булево значение, указывающее, содержит ли этот dtype какие-либо объекты со счётом ссылок в любых полях или подтипах. isalignedstruct Булево значение, указывающее, является ли dtype структурой, которая поддерживает выравнивание полей. isbuiltin Целое число, указывающее, как этот dtype относится к встроенным dtype. isnative Булево значение, указывающее, соответствует ли порядок байтов этого dtype порядку платформы. itemsize Размер элемента этого объекта типа данных. Для 18 из 21 типа это число фиксировано типом данных. Для гибких типов данных это число может быть любым. kind Кодовый символ (один из ‘biufcmMOSUV’) для идентификации общего вида данных. b булево i целое со знаком u целое без знака f с плавающей точкой c комплексное число с плавающей точкой m timedelta M datetime O object S (байт-)строка U Unicode V пустое metadata name Имя ширины бита для этого типа данных. names Упорядоченный список имён полей или None если полей нет. ndim Число измерений подмассива, если этот тип данных описывает подмассив, и 0 в противном случае. num Уникальное число для каждого из 21 встроенного типа. Они примерно упорядочены от наименьшей к наибольшей точности. shape Кортеж формы подмассива, если этот тип данных описывает подмассив, и () в противном случае. str Строка типа протокола массива для этого объекта типа данных. subdtype Кортеж (item_dtype, shape) если этот dtype описывает подмассив, и None в противном случае. type Объект типа, используемый для создания скаляра этого типа данных.

Методы

newbyteorder([new_order])

Возвращает новый dtype с другим порядком байтов.