numpy.format_parser

class numpy.format_parser(formats, names, titles, aligned=False, byteorder=None) [source]

Класс для преобразования форматов, имён, заголовков описания в тип данных.

После построения объекта format_parser, атрибут dtype — преобразованный тип данных: dtype = format_parser(formats, names, titles).dtype

Параметры:

formats : str или список str Описание формата, задаваемое либо строкой с перечислением описаний форматов, разделённых запятыми в формате 'f8, i4, a5', либо списком строк с описаниями форматов в формате ['f8', 'i4', 'a5']. names : str или список/кортеж str Имена полей, задаваемые либо строкой с перечислением имён, разделённых запятыми в формате 'col1, col2, col3', либо списком или кортежем строк в формате ['col1', 'col2', 'col3']. Можно использовать пустой список, в этом случае используются имена полей по умолчанию (‘f0’, ‘f1’, ...). titles : последовательность Последовательность строк заголовков. Можно использовать пустой список, чтобы не указывать заголовки. aligned : bool, необязательно Если True, выравнивать поля с помощью заполнения, как это делает компилятор C. По умолчанию False. byteorder : str, необязательно Если указано, все поля будут изменены на указанный порядок байтов. В противном случае используется порядок байтов по умолчанию. Для всех доступных строковых спецификаторов см. dtype.newbyteorder.

См. также

dtype, typename, sctype2char

Примеры

>>> np.format_parser(['f8', 'i4', 'a5'], ['col1', 'col2', 'col3'],
...                  ['T1', 'T2', 'T3']).dtype
dtype([(('T1', 'col1'), '<f8'), (('T2', 'col2'), '<i4'),
       (('T3', 'col3'), '|S5')])

names и/или titles могут быть пустыми списками. Если titles является пустым списком, заголовки просто не будут отображаться. Если names пустой, будут использоваться имена полей по умолчанию.

>>> np.format_parser(['f8', 'i4', 'a5'], ['col1', 'col2', 'col3'],
...                  []).dtype
dtype([('col1', '<f8'), ('col2', '<i4'), ('col3', '|S5')])
>>> np.format_parser(['f8', 'i4', 'a5'], [], []).dtype
dtype([('f0', '<f8'), ('f1', '<i4'), ('f2', '|S5')])

Атрибуты

dtype

(dtype) Преобразованный тип данных.