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]

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

Параметры

andarray

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

max_line_widthint, необязательно

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

precisionint или None, необязательно

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

suppress_smallbool, необязательно

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

separatorstr, необязательно

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

prefixstr, необязательно

suffixstr, необязательно

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

prefix + array2string(a) + suffix

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

style_NoValue, необязательно

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

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

formatterсловарь вызываемых объектов, необязательно

Если не None, ключи должны указывать тип(ы), к которому применяется соответствующая функция форматирования. Вызываемые объекты должны возвращать строку. Типы, которые не указаны (соответствующими ключами), обрабатываются функциями форматирования по умолчанию. Отдельные типы, для которых можно установить функцию форматирования:

• ‘bool’
• ‘int’
• ‘timedelta’ : numpy.timedelta64
• ‘datetime’ : numpy.datetime64
• ‘float’
• ‘longfloat’ : 128-битные числа с плавающей точкой
• ‘complexfloat’
• ‘longcomplexfloat’ : составленные из двух 128-битных чисел с плавающей точкой
• ‘void’ : тип numpy.void
• ‘numpystr’ : типы numpy.string_ и numpy.unicode_

Другие ключи, которые можно использовать для установки группы типов одновременно:

• ‘all’ : устанавливает все типы
• ‘int_kind’ : устанавливает ‘int’
• ‘float_kind’ : устанавливает ‘float’ и ‘longfloat’
• ‘complex_kind’ : устанавливает ‘complexfloat’ и ‘longcomplexfloat’
• ‘str_kind’ : устанавливает ‘numpystr’

thresholdint, необязательно

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

edgeitemsint, необязательно

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

signстрока, ‘-‘, ‘+’, или ‘ ‘, необязательно

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

floatmodestr, необязательно

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

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

legacyстрока или False, необязательно

Если установлено значение ‘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]'