Spec-Zone.ru › NumPy 1.13

numpy.array2string

numpy.array2string(self, *args, **kwargs) [source]

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

Параметры:

a : ndarray

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

max_line_width : int, необязательно

Максимальное количество столбцов в строке. Символы новой строки разбивают строку соответствующим образом после элементов массива.

precision : int, необязательно

Точность чисел с плавающей запятой. По умолчанию используется текущая точность вывода (обычно 8), которую можно изменить с помощью set_printoptions.

suppress_small : bool, необязательно

Представлять очень маленькие числа как нули. Число считается «очень маленьким», если оно меньше текущей точности вывода.

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

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

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

Массив обычно выводится следующим образом:

'prefix(' + array2string(a) + ')'

Длина строки префикса используется для правильного выравнивания вывода.

style : function, необязательно

Функция, которая принимает ndarray и возвращает строку. Используется только тогда, когда форма a равна (), т.е. для массивов размерности 0.

formatter : dict of callables, необязательно

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

- 'bool'
- 'int'
- 'timedelta' : a `numpy.timedelta64`
- 'datetime' : a `numpy.datetime64`
- 'float'
- 'longfloat' : 128-bit floats
- 'complexfloat'
- 'longcomplexfloat' : composed of two 128-bit floats
- 'numpystr' : types `numpy.string_` and `numpy.unicode_`
- 'str' : all other strings

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

- 'all' : sets all types
- 'int_kind' : sets 'int'
- 'float_kind' : sets 'float' and 'longfloat'
- 'complex_kind' : sets 'complexfloat' and 'longcomplexfloat'
- 'str_kind' : sets 'str' and 'numpystr'
Возвращает:

array_str : str

Строковое представление массива.

Исключения:

TypeError

если вызываемая функция в formatter не возвращает строку.

См. также

array_str, array_repr, set_printoptions, get_printoptions

Примечания

Если форматировщик указан для определенного типа, ключевое слово precision игнорируется для этого типа.

Эта функция очень гибкая; array_repr и array_str используют array2string внутри, поэтому ключевые слова с одинаковым именем должны работать одинаково во всех трех функциях.

Примеры

>>> x = np.array([1e-16,1,2,3])
>>> print(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)})
'[0x0L 0x1L 0x2L]'

© 2008–2017 NumPy Developers
Licensed under the NumPy License.
https://docs.scipy.org/doc/numpy-1.13.0/reference/generated/numpy.array2string.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API