numpy.array2string#

numpy.array2string(a, max_line_width=None, точность=None, suppress_small=None, разделитель=' ', префикс='', *, форматер=None, порог=None, edgeitems=None, знак=None, floatmode=None, суффикс='', устаревший=None)[источник]#

Возвращает строковое представление массива.

Параметры:

andarray

Входной массив.

max_line_widthint, необязательный

Вставляет переводы строк, если текст длиннее max_line_width. По умолчанию numpy.get_printoptions()['linewidth'].

точностьint или None, опционально

Точность с плавающей запятой. По умолчанию numpy.get_printoptions()['precision'].

suppress_smallbool, необязательно

Представлять числа "очень близкие" к нулю как ноль; по умолчанию False. Очень близко определяется точностью: если точность равна 8, например, числа меньше (по абсолютному значению) 5e-9 представляются как ноль. По умолчанию numpy.get_printoptions()['suppress'].

разделительstr, optional

Вставлено между элементами.

префиксstr, optional

суффиксstr, optional

Длины строк префикса и суффикса используются для выравнивания и переноса вывода соответственно. Массив обычно выводится как:

prefix + array2string(a) + suffix

Вывод дополняется слева длиной строки префикса, и перенос строки принудительно выполняется на столбце max_line_width - len(suffix). Следует отметить, что содержимое строк префикса и суффикса не включается в вывод.

форматерсловарь вызываемых объектов, опционально

Если не None, ключи должны указывать тип(ы), к которым применяется соответствующая функция форматирования. Вызываемые объекты должны возвращать строку. Типы, которые не указаны (по соответствующим ключам), обрабатываются форматтерами по умолчанию. Отдельные типы, для которых можно установить форматтер:

'bool'
'int'
'timedelta': a numpy.timedelta64
‘datetime’ : a numpy.datetime64
'float'
‘longfloat’ : числа с плавающей точкой 128-бит
‘complexfloat’
‘longcomplexfloat’ : состоит из двух 128-битных чисел с плавающей запятой
‘void’ : тип numpy.void
‘numpystr’ : типы numpy.bytes_ и numpy.str_

Другие ключи, которые можно использовать для установки группы типов сразу:

‘all’ : устанавливает все типы
‘int_kind’ : устанавливает ‘int’
'float_kind' : устанавливает 'float' и 'longfloat'
'complex_kind' : устанавливает 'complexfloat' и 'longcomplexfloat'
‘str_kind’ : устанавливает ‘numpystr’

порогint, необязательный

Общее количество элементов массива, которое вызывает сводку вместо полного repr. По умолчанию: numpy.get_printoptions()['threshold'].

edgeitemsint, необязательный

Количество элементов массива в сводке в начале и конце каждого измерения. По умолчанию: numpy.get_printoptions()['edgeitems'].

знакстрока, либо '-', '+', или ' ', опционально

Управляет выводом знака для типов с плавающей запятой. Если '+', всегда выводить знак положительных значений. Если ' ', всегда выводить пробел (символ пробела) в позиции знака для положительных значений. Если '-', опускать знак для положительных значений. По умолчанию numpy.get_printoptions()['sign'].

Изменено в версии 2.0: Параметр sign теперь может быть целочисленным типом, ранее типы были типами с плавающей точкой.

floatmodestr, optional

Управляет интерпретацией точность опция для типов с плавающей запятой. По умолчанию numpy.get_printoptions()['floatmode']. Может принимать следующие значения:

‘fixed’: Всегда выводить ровно точность дробные цифры, даже если это выведет больше или меньше цифр, чем необходимо для однозначного определения значения.
‘unique’: Выводить минимальное количество дробных цифр, необходимое для уникального представления каждого значения. Разные элементы могут иметь разное количество цифр. Значение точность опция игнорируется.
'maxprec': Выводить не более точность дробных цифр, но если элемент может быть однозначно представлен с меньшим количеством цифр, выводить только с таким количеством.
‘maxprec_equal’: Выводить максимум точность дробных цифр, но если каждый элемент массива может быть однозначно представлен с равным количеством меньших цифр, использовать это количество цифр для всех элементов.

устаревшийстрока или False, опционально

Если установлено в строку '1.13' включает режим печати в стиле 1.13. Это приближает вывод печати numpy 1.13, включая пробел в позиции знака у чисел с плавающей точкой и другое поведение для 0d массивов. Если установлено в False, отключает режим совместимости. Неизвестные строки будут игнорироваться с предупреждением для обеспечения обратной совместимости.

Возвращает:

array_strstr: Строковое представление массива.

Вызывает:

TypeError: если вызываемый объект в форматер не возвращает строку.

Смотрите также

array_str, array_repr, set_printoptions, get_printoptions

Примечания

Если для определённого типа указан форматтер, точность ключевое слово игнорируется для этого типа.

Это очень гибкая функция; array_repr и array_str используют array2string внутренне, поэтому ключевые слова с тем же именем должны работать идентично во всех трёх функциях.

Примеры

>>> import numpy as np
>>> x = np.array([1e-16,1,2,3])
>>> np.array2string(x, precision=2, separator=',',
...                       suppress_small=True)
'[0.,1.,2.,3.]'

>>> x  = np.arange(3.)
>>> np.array2string(x, formatter={'float_kind':lambda x: "%.2f" % x})
'[0.00 1.00 2.00]'

>>> x  = np.arange(3)
>>> np.array2string(x, formatter={'int':lambda x: hex(x)})
'[0x0 0x1 0x2]'