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)[源代码]#

返回数组的字符串表示形式.

参数:
andarray

输入数组.

max_line_widthint, optional

如果文本长度超过 max_line_width ,则插入换行符.默认为 numpy.get_printoptions()['linewidth'] .

precisionint 或 None,可选

浮点精度.默认为 numpy.get_printoptions()['precision'] .

suppress_smallbool,可选

将"非常接近"零的数字表示为零;默认值为 False.非常接近由精度定义:例如,如果精度为 8,则小于(绝对值)5e-9 的数字表示为零.默认为 numpy.get_printoptions()['suppress'] .

separatorstr, optional

插入在元素之间.

prefixstr, optional
suffixstr, optional

前缀和后缀字符串的长度分别用于对齐和包装输出.数组通常打印为:

prefix + array2string(a) + suffix

输出通过前缀字符串的长度进行左边填充,并且在 max_line_width - len(suffix) 列强制进行换行.应该注意的是,前缀和后缀字符串的内容不包含在输出中.

style_NoValue, optional

不起作用,请勿使用.

自 1.14.0 版本弃用.

formatter可调用对象的字典,可选

如果不是 None,则键应指示相应的格式化函数所应用到的类型.可调用对象应返回一个字符串.未指定类型(通过其相应的键)由默认格式化程序处理.可以设置格式化程序的单个类型为:

可用于一次设置一组类型的其他键有:

  • ‘all’:设置所有类型

  • ‘int_kind’:设置 ‘int’

  • ‘float_kind’:设置 ‘float’ 和 ‘longfloat’

  • ‘complex_kind’:设置 ‘complexfloat’ 和 ‘longcomplexfloat’

  • ‘str_kind’:设置 ‘numpystr’

thresholdint, optional

触发摘要而不是完整 repr 的数组元素总数.默认为 numpy.get_printoptions()['threshold'] .

edgeitemsint, optional

每个维度开始和结束时摘要中的数组项数.默认为 numpy.get_printoptions()['edgeitems'] .

sign字符串,可以是 ‘-’, ‘+’ 或 ‘ ‘,可选

控制浮点类型的符号打印.如果为 ‘+’,则始终打印正值的符号.如果为 ‘ ‘,则始终在正值的符号位置打印空格(空白字符).如果为 ‘-‘,则省略正值的符号字符.默认为 numpy.get_printoptions()['sign'] .

在 2.0 版本发生变更: sign 参数现在可以是整数类型,以前的类型是浮点类型.

floatmodestr, optional

控制浮点类型 precision 选项的解释.默认为 numpy.get_printoptions()['floatmode'] .可以采用以下值:

  • ‘fixed’:始终精确打印 precision 个小数位,即使这会打印比唯一指定该值所需的更多或更少位数.

  • ‘unique’:打印唯一表示每个值所需的最少小数位数.不同的元素可能具有不同数量的位数. precision 选项的值将被忽略.

  • ‘maxprec’:最多打印 precision 个小数位,但如果一个元素可以用更少的位数唯一表示,则只用那么多位数打印它.

  • ‘maxprec_equal’:最多打印 precision 个小数位,但如果数组中的每个元素都可以用相等数量的更少位数唯一表示,则对所有元素使用那么多位数.

legacy : 字符串或 False ,可选字符串或

如果设置为字符串 '1.13' ,则启用 1.13 传统打印模式.这通过在浮点数的符号位置包含空格以及对 0d 数组的不同行为来近似 numpy 1.13 打印输出.如果设置为 False ,则禁用传统模式.无法识别的字符串将被忽略,并发出警告以实现向前兼容性.

返回:
array_strstr

数组的字符串表示形式.

Raises:
TypeError

如果 formatter 中的可调用对象没有返回字符串.

参见

array_str , array_repr , set_printoptions , get_printoptions

注释

如果为某种类型指定了格式化程序,则该类型的 precision 关键字将被忽略.

这是一个非常灵活的函数; array_repr 和 array_str 在内部使用 array2string ,因此具有相同名称的关键字在所有三个函数中应以相同方式工作.

示例

>>> import numpy as np
>>> 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]'
On this page