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, отключает режим 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]'