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='', *, legacy=None) [source]

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

Параметры

aarray_like

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

max_line_widthint, optional

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

precisionint or None, optional

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

suppress_smallbool, optional

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

separatorstr, optional

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

prefixstr, optional

suffix: str, optional

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

prefix + array2string(a) + suffix

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

style_NoValue, optional

Не оказывает никакого влияния, не использовать.

Устарело начиная с версии 1.14.0.

formatterdict 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’

thresholdint, optional

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

edgeitemsint, optional

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

signstring, either ‘-‘, ‘+’, or ‘ ‘, optional

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

floatmodestr, optional

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

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

legacystring or False, optional

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

Введено в версии 1.14.0.

Возвращает

array_strstr

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

Возбуждает

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]'