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 Максимальное количество столбцов в строке. Символы новой строки разделяют строку соответствующим образом после элементов массива. precision : int or None, optional Точность для чисел с плавающей точкой. По умолчанию используется текущая точность печати (обычно 8), которую можно изменить с помощью set_printoptions. suppress_small : bool, optional Представлять очень малые числа как ноль. Число считается «очень малым», если оно меньше текущей точности печати. 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’ : 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 Общее количество элементов массива, которое вызывает резюмирование вместо полного представления. edgeitems : int, optional Количество элементов массива в сводке в начале и конце каждого измерения. sign : string, either ‘-‘, ‘+’, or ‘ ‘, optional Управляет выводом знака для чисел с плавающей точкой. Если ‘+’, всегда выводит знак положительных значений. Если ‘ ‘, всегда выводит пробел (пробел) в позиции знака положительных значений. Если ‘-‘, опускает знак положительных значений. floatmode : str, optional Управляет интерпретацией параметра precision для чисел с плавающей точкой. Может принимать следующие значения: ‘fixed’: Всегда выводит ровно precision дробных цифр, даже если это приведет к выводу большего или меньшего количества цифр, чем необходимо для уникальной спецификации значения. ‘unique’: Выводит минимальное количество дробных цифр, необходимых для уникального представления каждого значения. Разные элементы могут иметь разное количество цифр. Значение параметра precision игнорируется. ‘maxprec’: Выводит не более precision дробных цифр, но если элемент может быть уникально представлен меньшим количеством цифр, выводит только это количество. ‘maxprec_equal’: Выводит не более precision дробных цифр, но если каждый элемент массива может быть уникально представлен равным количеством меньших цифр, использует это количество цифр для всех элементов. legacy : string or False, optional Если установлено в строку ‘1.13’ включит режим печати 1.13. Это приближает вывод numpy 1.13, включая пробел в позиции знака чисел с плавающей точкой и разное поведение для 0d массивов. Если установлено в False, выключит режим старой версии. Нераспознанные строки будут игнорироваться с предупреждением для совместимости с будущими версиями. Введено в версии 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]'