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')])])

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

>>> np.dtype([('f1', np.uint64), ('f2', np.int32)])
dtype([('f1', '<u8'), ('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',(np.int64,3)),('world',np.void,10)])
dtype([('hello', '<i8', (3,)), ('world', 'V10')])

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

>>> np.dtype((np.int16, {'x':(np.int8,0), 'y':(np.int8,1)}))
dtype((numpy.int16, [('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 Требуемое выравнивание (байты) этого типа данных в соответствии с компилятором. base Возвращает тип данных для базового элемента подмассивов, независимо от их размерности или формы. byteorder Символ, указывающий порядок байтов для этого объекта типа данных. char Уникальный символьный код для каждого из 21 встроенного типа. descr __array_interface__ описание типа данных. fields Словарь именованных полей, определённых для этого типа данных, или None. flags Флаги битов, описывающие, как интерпретировать этот тип данных. hasobject Булево значение, указывающее, содержит ли этот тип данных какие-либо объекты со счётчиками ссылок в любых полях или подтипах. isalignedstruct Булево значение, указывающее, является ли тип данных структурой, которая поддерживает выравнивание полей. isbuiltin Целое число, указывающее, как этот тип данных относится к встроенным типам данных. isnative Булево значение, указывающее, соответствует ли порядок байтов этого типа данных порядку байтов платформы. itemsize Размер элемента этого объекта типа данных. kind Символьный код (один из ‘biufcmMOSUV’) для идентификации общего типа данных. metadata name Имя ширины бита для этого типа данных. names Упорядоченный список имён полей, или None если полей нет. ndim Количество измерений подмассива, если этот тип данных описывает подмассив, и 0 в противном случае. num Уникальное число для каждого из 21 встроенного типа. shape Кортеж формы подмассива, если этот тип данных описывает подмассив, и () в противном случае. str Строка типа протокола массива для этого объекта типа данных. subdtype Кортеж (item_dtype, shape) если этот dtype описывает подмассив, и None в противном случае. type Объект типа, используемый для создания скаляра этого типа данных.

Методы

newbyteorder([new_order])

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