numpy.format_float_scientific

numpy.format_float_scientific(x, precision=None, unique=True, trim='k', sign=False, pad_left=None, exp_digits=None) [source]

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

Предоставляет контроль над округлением, обрезкой и дополнением. Использует и предполагает несмещённое округление IEEE. Использует алгоритм «Dragon4».

Параметры

xpython float or numpy floating scalar

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

precisionnon-negative integer or None, optional

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

uniqueboolean, optional

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

trimone of ‘k’, ‘.’, ‘0’, ‘-‘, optional

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

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

signboolean, optional

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

pad_leftnon-negative integer, optional

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

exp_digitsnon-negative integer, optional

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

Возвращает

repstring

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

См. также

format_float_positional

Примеры

>>> np.format_float_scientific(np.float32(np.pi))
'3.1415927e+00'
>>> s = np.float32(1.23e24)
>>> np.format_float_scientific(s, unique=False, precision=15)
'1.230000071797338e+24'
>>> np.format_float_scientific(s, exp_digits=4)
'1.23e+0024'