numpy.array2string

numpy.array2string(a, max_line_width=None, precision=None, suppress_small=None, separator=' ', prefix='', style=<class 'numpy._globals._NoValue'>, formatter=None, threshold=None, edgeitems=None, sign=None, floatmode=None, suffix='', **kwarg) [source]

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

Параметры:	a : array_like Входной массив. max_line_width : int, необязательно Максимальное количество столбцов в строке. Символы новой строки разделяют строку соответствующим образом после элементов массива. precision : int или None, необязательно Точность с плавающей запятой. По умолчанию используется текущая точность вывода (обычно 8), которая может быть изменена с помощью set_printoptions. suppress_small : bool, необязательно Представлять очень малые числа как ноль. Число считается «очень малым», если оно меньше текущей точности вывода. separator : str, необязательно Вставляется между элементами. prefix : str, необязательно suffix: str, необязательно Длина строк prefix и suffix используется для выравнивания и перевода вывода соответственно. Массив обычно выводится так: prefix + array2string(a) + suffix Вывод выравнивается слева с помощью длины строки prefix, и перенос осуществляется на столбец max_line_width - len(suffix). style : _NoValue, необязательно Не оказывает влияния, не использовать. Устарело начиная с версии 1.14.0. formatter : словарь вызываемых функций, необязательно Если не None, ключи должны указывать тип(ы), к которому применяется соответствующая функция форматирования. Вызываемые функции должны возвращать строку. Типы, которые не указаны (соответствующими ключами), обрабатываются функциями форматирования по умолчанию. Отдельные типы, для которых можно установить форматировщик: - 'bool' - 'int' - 'timedelta' : a `numpy.timedelta64` - 'datetime' : a `numpy.datetime64` - 'float' - 'longfloat' : 128-bit floats - 'complexfloat' - 'longcomplexfloat' : composed of two 128-bit floats - 'void' : type `numpy.void` - 'numpystr' : types `numpy.string_` and `numpy.unicode_` - 'str' : all other strings Другие ключи, которые могут использоваться для установки группы типов сразу: - 'all' : sets all types - 'int_kind' : sets 'int' - 'float_kind' : sets 'float' and 'longfloat' - 'complex_kind' : sets 'complexfloat' and 'longcomplexfloat' - 'str_kind' : sets 'str' and 'numpystr' threshold : int, необязательно Общее количество элементов массива, которые вызывают суммарное представление вместо полного repr. edgeitems : int, необязательно Количество элементов массива в сводке в начале и конце каждого измерения. sign : строка, либо ‘-‘, ‘+’, или ‘ ‘, необязательно Управляет выводом знака для типов с плавающей запятой. Если ‘+’, всегда выводит знак для положительных значений. Если ‘ ‘, всегда выводит пробел (символ пробела) в позиции знака для положительных значений. Если ‘-‘, пропускает знак для положительных значений. floatmode : str, необязательно Управляет интерпретацией опции precision для типов с плавающей запятой. Может принимать следующие значения: ‘fixed’ : Always print exactly precision fractional digits, даже если это приведет к выводу большего или меньшего количества цифр, чем необходимо для уникальной спецификации значения. ‘unique : Print the minimum number of fractional digits necessary для уникального представления каждого значения. Разные элементы могут иметь разное количество цифр. Значение опции precision игнорируется. ‘maxprec’ : Print at most precision fractional digits, but if элемент может быть представлен уникальным образом с меньшим количеством цифр, выводите его только с этим количеством. ‘maxprec_equal’ : Print at most precision fractional digits, но если каждый элемент в массиве может быть представлен уникальным образом с равным количеством меньших цифр, используйте это количество цифр для всех элементов. legacy : строка или False, необязательно Если установлено в строку ‘1.13’ включает режим вывода 1.13 legacy. Это приблизительно соответствует выводу печати numpy 1.13, включая пробел в позиции знака чисел с плавающей запятой и разное поведение для 0d массивов. Если установлено в False, отключает режим legacy. Нерасшифрованные строки будут игнорироваться с предупреждением о совместимости в будущем. Новое в версии 1.14.0.
Возвращает:	array_str : str Строковое представление массива.
Возможные исключения:	TypeError если вызываемая функция в formatter не возвращает строку.

См. также

array_str, array_repr, set_printoptions, get_printoptions

Примечания

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

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

Примеры

>>> x = np.array([1e-16,1,2,3])
>>> print(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)})
'[0x0L 0x1L 0x2L]'