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. В этом случае может быть выведено больше цифр, чем необходимо для однозначной идентификации значения, и эти цифры будут округляться без смещения.

– versionadded:: 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'