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 legacy. Это приближает вывод печати 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)