numpy.set_printoptions

numpy.set_printoptions(precision=None, threshold=None, edgeitems=None, linewidth=None, suppress=None, nanstr=None, infstr=None, formatter=None, sign=None, floatmode=None, **kwarg) [source]

Настройка параметров вывода.

Эти параметры определяют способ отображения чисел с плавающей запятой, массивов и других объектов NumPy.

Параметры:

precision : int или None, необязательно Количество знаков после запятой для вывода чисел с плавающей запятой (по умолчанию 8). Может быть None если floatmode не fixed, чтобы вывести столько знаков, сколько необходимо для уникальной спецификации значения. threshold : int, необязательно Общее количество элементов массива, которые вызывают обобщение вместо полного представления (по умолчанию 1000). edgeitems : int, необязательно Количество элементов массива в обобщении в начале и конце каждой размерности (по умолчанию 3). linewidth : int, необязательно Количество символов в строке для вставки перевода строки (по умолчанию 75). suppress : bool, необязательно Если True, всегда выводить числа с плавающей запятой с помощью фиксированной точки, в этом случае числа, равные нулю в текущей точности, будут выводиться как ноль. Если False, используется экспоненциальная форма записи, когда абсолютное значение наименьшего числа < 1e-4 или отношение максимального абсолютного значения к минимальному > 1e3. По умолчанию False. nanstr : str, необязательно Строковое представление числа с плавающей запятой, не являющегося числом (по умолчанию nan). infstr : str, необязательно Строковое представление бесконечности с плавающей запятой (по умолчанию inf). sign : строка, либо ‘-‘, ‘+’, или ‘ ‘, необязательно Управляет выводом знака чисел с плавающей запятой. Если ‘+’, всегда выводить знак положительных значений. Если ‘ ‘, всегда выводить пробел в позиции знака положительных значений. Если ‘-‘, пропускать знак положительных значений. (по умолчанию ‘-‘) formatter : словарь вызываемых функций, необязательно Если не 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_` - 'object' : `np.object_` arrays - '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' floatmode : str, необязательно Управляет интерпретацией параметра precision для типов с плавающей запятой. Может принимать следующие значения: ‘fixed’ : Always print exactly precision fractional digits, даже если это приведет к выводу большего или меньшего количества знаков, чем необходимо для уникальной спецификации значения. ‘unique : Print the minimum number of fractional digits necessary чтобы каждое значение было представлено однозначно. Различные элементы могут иметь разное количество знаков. Значение параметра precision игнорируется. ‘maxprec’ : Print at most precision fractional digits, but if элемент может быть представлен уникально с меньшим количеством знаков, отображать его только с этим количеством. ‘maxprec_equal’ : Print at most precision fractional digits, но если каждый элемент в массиве может быть представлен уникально с одинаковым меньшим количеством знаков, используйте это количество знаков для всех элементов. legacy : строка или False, необязательно Если установлено в строку ‘1.13’, включает режим вывода версии 1.13. Это приближает вывод numpy 1.13, включая пробел в позиции знака чисел с плавающей запятой и разное поведение для 0d массивов. Если установлено в False, отключает режим legacy. Нераспознанные строки будут проигнорированы с предупреждением для обратной совместимости. Добавлена в версии 1.14.0.

См. также

get_printoptions, set_string_function, array2string

Примечания

formatter всегда сбрасывается при вызове set_printoptions.

Примеры

Точность чисел с плавающей запятой может быть установлена:

>>> np.set_printoptions(precision=4)
>>> print(np.array([1.123456789]))
[ 1.1235]

Длинные массивы могут быть представлены в сжатом виде:

>>> np.set_printoptions(threshold=5)
>>> print(np.arange(10))
[0 1 2 ..., 7 8 9]

Малые результаты могут быть подавлены:

>>> eps = np.finfo(float).eps
>>> x = np.arange(4.)
>>> x**2 - (x + eps)**2
array([ -4.9304e-32,  -4.4409e-16,   0.0000e+00,   0.0000e+00])
>>> np.set_printoptions(suppress=True)
>>> x**2 - (x + eps)**2
array([-0., -0.,  0.,  0.])

Пользовательская функция форматирования может использоваться для отображения элементов массива по желанию:

>>> np.set_printoptions(formatter={'all':lambda x: 'int: '+str(-x)})
>>> x = np.arange(3)
>>> x
array([int: 0, int: -1, int: -2])
>>> np.set_printoptions()  # formatter gets reset
>>> x
array([0, 1, 2])

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

>>> np.set_printoptions(edgeitems=3,infstr='inf',
... linewidth=75, nanstr='nan', precision=8,
... suppress=False, threshold=1000, formatter=None)