numpy.array2string

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

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

Параметры:	a : array_like Вводной массив. max_line_width : int, optional Вставляет новые строки, если текст длиннее, чем max_line_width. По умолчанию numpy.get_printoptions()['linewidth']. precision : int or None, optional Точность чисел с плавающей запятой. По умолчанию numpy.get_printoptions()['precision']. suppress_small : bool, optional Представляет числа, «очень близкие» к нулю, как ноль; по умолчанию False. Очень близко определяется точностью: если точность 8, например, числа, меньшие (по абсолютной величине) 5e-9, представляются как ноль. По умолчанию numpy.get_printoptions()['suppress']. separator : str, optional Вставляется между элементами. prefix : str, optional suffix: str, optional Длина префиксных и суффиксных строк используется для выравнивания и обрезки вывода. Массив обычно печатается так: prefix + array2string(a) + suffix Вывод выравнивается слева длиной префиксной строки, а обрезка выполняется по столбцу max_line_width - len(suffix). Следует отметить, что содержимое префиксных и суффиксных строк не включено в вывод. style : _NoValue, optional Не оказывает никакого влияния, не используйте. Устарело начиная с версии 1.14.0. formatter : dict of callables, optional Если не None, ключи должны указывать тип(ы), к которому(ым) применяется соответствующая функция форматирования. Вызываемые объекты должны возвращать строку. Типы, которые не указаны (соответствующими ключами), обрабатываются стандартными форматировщиками. Отдельные типы, для которых можно установить форматировщик: ‘bool’ ‘int’ ‘timedelta’ : numpy.timedelta64 ‘datetime’ : a numpy.datetime64 ‘float’ ‘longfloat’ : 128-битные числа с плавающей точкой ‘complexfloat’ ‘longcomplexfloat’ : составлено из двух 128-битных чисел с плавающей точкой ‘void’ : тип numpy.void ‘numpystr’ : типы numpy.string_ и numpy.unicode_ ‘str’ : все остальные строки Другие ключи, которые могут быть использованы для установки группы типов сразу: ‘all’ : устанавливает все типы ‘int_kind’ : устанавливает ‘int’ ‘float_kind’ : устанавливает ‘float’ и ‘longfloat’ ‘complex_kind’ : устанавливает ‘complexfloat’ и ‘longcomplexfloat’ ‘str_kind’ : устанавливает ‘str’ и ‘numpystr’ threshold : int, optional Общее количество элементов массива, которые вызывают суммирование вместо полного представления. По умолчанию numpy.get_printoptions()['threshold']. edgeitems : int, optional Количество элементов массива в сводке в начале и конце каждого измерения. По умолчанию numpy.get_printoptions()['edgeitems']. sign : string, either ‘-‘, ‘+’, or ‘ ‘, optional Управляет печатью знака чисел с плавающей точкой. Если ‘+’, всегда печатает знак положительных значений. Если ‘ ‘, всегда печатает пробел (пробельный символ) в позиции знака положительных значений. Если ‘-‘, пропускает знак положительных значений. По умолчанию numpy.get_printoptions()['sign']. floatmode : str, optional Управляет интерпретацией опции precision для чисел с плавающей точкой. По умолчанию numpy.get_printoptions()['floatmode']. Может принимать следующие значения: ‘fixed’: Всегда печатает ровно precision дробных цифр, даже если это напечатает больше или меньше цифр, чем необходимо для уникального указания значения. ‘unique’: Печатает минимальное количество дробных цифр, необходимых для уникального представления каждого значения. У разных элементов может быть разное количество цифр. Значение опции precision игнорируется. ‘maxprec’: Печатает не более precision дробных цифр, но если элемент можно уникально представить меньшим количеством цифр, печатает их. ‘maxprec_equal’: Печатает не более precision дробных цифр, но если каждый элемент в массиве можно уникально представить одинаковым меньшим количеством цифр, использует это количество цифр для всех элементов. legacy : string or False, optional Если установлено в строку ‘1.13’ включает режим печати версии 1.13. Это приближает вывод печати 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])
>>> 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]'