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, *, legacy=None) [source]

Установить параметры вывода.

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

Параметры

precisionint or None, optional

Количество значащих цифр для вывода чисел с плавающей запятой (по умолчанию 8). Может быть None, если floatmode не fixed, для вывода необходимого количества цифр для уникального задания значения.

thresholdint, optional

Общее количество элементов массива, которые вызывают сворачивание, вместо полного представления (по умолчанию 1000). Чтобы всегда использовать полное представление без сворачивания, передайте sys.maxsize.

edgeitemsint, optional

Количество элементов массива в сворачивании в начале и конце каждого измерения (по умолчанию 3).

linewidthint, optional

Количество символов на строку для вставки перевода строк (по умолчанию 75).

suppressbool, optional

Если True, всегда выводить числа с плавающей запятой с фиксированной точкой, в этом случае числа, равные нулю в текущей точности, будут выводиться как ноль. Если False, используется научная запись, когда абсолютное значение наименьшего числа < 1e-4 или отношение максимального абсолютного значения к минимальному > 1e3. По умолчанию False.

nanstrstr, optional

Строковое представление числа с плавающей запятой, не являющегося числом (по умолчанию nan).

infstrstr, optional

Строковое представление бесконечности с плавающей запятой (по умолчанию inf).

signstring, either ‘-‘, ‘+’, or ‘ ‘, optional

Управляет выводом знака для чисел с плавающей запятой. Если ‘+’, всегда выводить знак положительных значений. Если ‘ ‘, всегда выводить пробел в позиции знака для положительных значений. Если ‘-‘, опускать знак для положительных значений. (по умолчанию ‘-‘)

formatterdict 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’

floatmodestr, 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,

  но если каждый элемент массива может быть уникально представлен равным меньшим количеством цифр, использовать это количество цифр для всех элементов.

legacystring or False, optional

Если установлено в строку ‘1.13’, включает режим печати по умолчанию 1.13. Это приближает вывод печати numpy 1.13, включая пробел в позиции знака чисел с плавающей запятой и различное поведение для 0d массивов. Если установлено в False, выключает режим по умолчанию. Неопознанные строки будут игнорироваться с предупреждением для обеспечения обратной совместимости.

Новое в версии 1.14.0.

См. также

get_printoptions, printoptions, set_string_function, array2string

Примечания

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

Используйте 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)

Также для временной переопределения параметров можно использовать printoptions в качестве контекстного менеджера:

>>> with np.printoptions(precision=2, suppress=True, threshold=5):
...     np.linspace(0, 10, 10)
array([ 0.  ,  1.11,  2.22, ...,  7.78,  8.89, 10.  ])