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]

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

Параметры

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, 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’ : a 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 legacy. Это приближает вывод numpy 1.13 print, включая пробел в позиции знака чисел с плавающей точкой и разное поведение для 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]'