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’ : 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 для типов с плавающей точкой. Может принимать следующие значения (по умолчанию maxprec_equal): ‘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, выключает режим старой версии. Неизвестные строки будут игнорироваться с предупреждением о совместимости с будущими версиями. Добавлено в версии 1.14.0.

См. также

get_printoptions, set_string_function, array2string

Примечания

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

Примеры

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

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

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

>>> np.set_printoptions(threshold=5)
>>> np.arange(10)
array([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)