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 + array2string(a) + suffix

Вывод выравнивается влево на длину строки префикса, а обрезка выполняется в столбце max_line_width - len(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.bytes_ и numpy.str_

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

• ‘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'].

Изменено в версии 2.0: Параметр 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]'