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 or None, optional Количество знаков после запятой для вывода чисел с плавающей запятой (по умолчанию 8). Может быть None если floatmode не fixed, для вывода необходимого количества знаков для уникальной спецификации значения. threshold : int, optional Общее количество элементов массива, которые вызывают обобщение вместо полного представления (по умолчанию 1000). edgeitems : int, optional Количество элементов массива в обобщении в начале и конце каждой размерности (по умолчанию 3). linewidth : int, optional Количество символов на строку для вставки перевода строк (по умолчанию 75). suppress : bool, optional Если True, всегда выводить числа с плавающей запятой с использованием фиксированной точки, в этом случае числа, равные нулю в текущей точности, будут выводиться как ноль. Если False, используется экспоненциальная запись, когда абсолютное значение наименьшего числа < 1e-4 или отношение максимального абсолютного значения к минимальному > 1e3. По умолчанию False. nanstr : str, optional Строковое представление числа с плавающей запятой не являющегося числом (по умолчанию nan). infstr : str, optional Строковое представление бесконечности с плавающей запятой (по умолчанию inf). sign : string, either ‘-‘, ‘+’, or ‘ ‘, optional Управляет выводом знака для чисел с плавающей запятой. Если ‘+’, всегда выводить знак положительных значений. Если ‘ ‘, всегда выводить пробел в позиции знака для положительных значений. Если ‘-‘, пропускать знак положительных значений. (по умолчанию ‘-‘) formatter : dict of callables, optional Если не None, ключи должны указывать тип(ы), к которому относится соответствующая функция форматирования. Вызываемые функции должны возвращать строку. Типы, которые не указаны (соответствующими ключами), обрабатываются с помощью функций форматирования по умолчанию. Индивидуальные типы, для которых можно установить форматировщик: ‘bool’ ‘int’ ‘timedelta’ : a numpy.timedelta64 ‘datetime’ : a numpy.datetime64 ‘float’ ‘longfloat’ : 128-битные числа с плавающей точкой ‘complexfloat’ ‘longcomplexfloat’ : составлено из двух 128-битных чисел с плавающей точкой ‘numpystr’ : типы numpy.string_ и numpy.unicode_ ‘object’ : массивы np.object_ ‘str’ : все другие строки Другие ключи, которые могут быть использованы для установки группы типов одновременно: ‘all’ : устанавливает все типы ‘int_kind’ : устанавливает ‘int’ ‘float_kind’ : устанавливает ‘float’ и ‘longfloat’ ‘complex_kind’ : устанавливает ‘complexfloat’ и ‘longcomplexfloat’ ‘str_kind’ : устанавливает ‘str’ и ‘numpystr’ floatmode : str, optional Управляет интерпретацией опции precision для чисел с плавающей запятой. Может принимать следующие значения: ‘fixed’: Always print exactly precision fractional digits, даже если это приведет к выводу большего или меньшего числа знаков, чем необходимо для уникальной спецификации значения. ‘unique’: Вывести минимальное количество знаков после запятой, необходимых для уникального представления каждого значения. Разные элементы могут иметь разное количество знаков. Значение опции precision игнорируется. ‘maxprec’: Print at most precision fractional digits, but if элемент может быть уникально представлен с меньшим количеством знаков, выводить его только с этим количеством. ‘maxprec_equal’: Print at most precision fractional digits, но если каждый элемент массива может быть уникально представлен с одинаковым меньшим количеством знаков, использовать это количество знаков для всех элементов. legacy : string or False, optional Если установлено в строку ‘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)