numpy.format_float_scientific

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

Форматирование вещественного числа в научной нотации.

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

Параметры:

xpython float или numpy вещественный скаляр

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

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

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

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

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

trimодин из ‘k’, ‘.’, ‘0’, ‘-’, необязательно

Управляет обрезанием хвостовых цифр после обработки, как указано ниже:

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

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

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

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

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

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

Заполнить экспоненту нулями до тех пор, пока она не будет содержать не менее этого количества цифр. Если опущено, экспонента будет содержать не менее 2 цифр.

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

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

Добавлена в версии 1.21.0.

Возвращает:

repстрока

Строковое представление вещественного числа

См. также

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'