numpy.format_float_positional#

numpy.format_float_positional(x, точность=None, уникальный=True, дробный=True, trim='k', знак=False, pad_left=None, pad_right=None, min_digits=None)[источник]#

Форматирование скаляра с плавающей точкой как десятичной строки в позиционной нотации.

Обеспечивает контроль над округлением, обрезкой и заполнением. Использует и предполагает несмещённое округление IEEE. Использует алгоритм "Dragon4".

Параметры:

xpython float или numpy скаляр с плавающей точкой

Значение для форматирования.

точностьнеотрицательное целое число или None, опционально

Максимальное количество цифр для вывода. Может быть None, если unique является True, но должен быть целым числом, если unique – False.

уникальныйлогический, необязательный

Если True, используйте стратегию генерации цифр, которая дает кратчайшее представление, однозначно идентифицирующее число с плавающей запятой среди других значений того же типа, путем разумного округления. Если точность задано меньше цифр, чем необходимо для печати, или если min_digits задано больше, может быть выведено больше, в таких случаях последняя цифра округляется с несмещённым округлением. Если False, цифры генерируются так, как если бы печаталось значение бесконечной точности и остановка после точность цифры, округляя оставшееся значение с несмещённым округлением

дробныйлогический, необязательный

Если True, пороговые значения точность и min_digits относится к общему количеству цифр после десятичной точки, включая ведущие нули. Если False, точность и min_digits относятся к общему количеству значащих цифр, до или после десятичной точки, игнорируя ведущие нули.

trimодин из 'k', '.', '0', '-', опционально

Управляет постобработкой обрезки конечных цифр следующим образом:

‘k’ : сохранять конечные нули, сохранять десятичную точку (без обрезки)
‘.’ : обрезать все конечные нули, оставить десятичную точку
‘0’ : обрезать всё, кроме нуля перед десятичной точкой. Вставить ноль, если он отсутствует.
'-' : обрезать конечные нули и любую конечную десятичную точку

знаклогический, необязательный

Показывать ли знак для положительных значений.

pad_leftнеотрицательное целое число, необязательно

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

pad_rightнеотрицательное целое число, необязательно

Дополните правую сторону строки пробелами, пока справа от десятичной точки не окажется хотя бы столько символов.

min_digitsнеотрицательное целое число или None, опционально

Минимальное количество цифр для вывода. Имеет эффект только если unique=True в этом случае могут быть выведены дополнительные цифры сверх необходимых для однозначной идентификации значения, с округлением последней дополнительной цифры.

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

Возвращает:

repstring: Строковое представление значения с плавающей точкой

Смотрите также

format_float_scientific

Примеры

>>> import numpy as np
>>> np.format_float_positional(np.float32(np.pi))
'3.1415927'
>>> np.format_float_positional(np.float16(np.pi))
'3.14'
>>> np.format_float_positional(np.float16(0.3))
'0.3'
>>> np.format_float_positional(np.float16(0.3), unique=False, precision=10)
'0.3000488281'