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. «Очень близкие» определяются точностью: если точность 8, например, числа, меньшие (по модулю) 5e-9, представляются как ноль. По умолчанию numpy.get_printoptions()['suppress'].

separatorstr, optional

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

prefixstr, optional

suffix: str, необязательно

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

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, включая пробел в позиции знака чисел с плавающей точкой и разное поведение для 0-мерных массивов. Если установлено в 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]'