numpy.finfo

classnumpy.finfo(dtype)[source]

Пределы машинных представлений для типов с плавающей запятой.

Параметры:

dtypefloat, dtype или экземпляр

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

См. также

iinfo

Аналог для целочисленных типов данных.

spacing

Расстояние между значением и ближайшим смежным числом

nextafter

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

Примечания

Для разработчиков NumPy: не инициализируйте этот объект на уровне модуля. Изначальный расчет этих параметров дорогостоящий и негативно сказывается на времени импорта. Эти объекты кэшируются, поэтому вызов finfo() многократно внутри ваших функций не проблема.

Обратите внимание, что smallest_normal фактически не является наименьшим положительным представимым значением в типе с плавающей запятой NumPy. Как и в стандарте IEEE-754 [1], типы с плавающей запятой NumPy используют поднормализованные числа для заполнения пробела между 0 и smallest_normal. Однако поднормализованные числа могут иметь значительно сниженную точность [2].

Эта функция также может использоваться для комплексных типов данных. Если она используется, вывод будет таким же, как и для соответствующего вещественного типа с плавающей запятой (например, numpy.finfo(numpy.csingle) такое же, как numpy.finfo(numpy.single)). Однако вывод верен для вещественной и мнимой частей.

Список литературы

[1]

IEEE Standard for Floating-Point Arithmetic, IEEE Std 754-2008, стр.1-70, 2008, https://doi.org/10.1109/IEEESTD.2008.4610935

[2]

Wikipedia, «Денермализованные числа», https://en.wikipedia.org/wiki/Denormal_number

Примеры

>>> np.finfo(np.float64).dtype
dtype('float64')
>>> np.finfo(np.complex64).dtype
dtype('float32')

Атрибуты:

bitsint

Количество битов, занимаемых типом.

dtypedtype

Возвращает тип данных, для которого finfo возвращает информацию. Для комплексных входных данных возвращаемый тип данных — связанный float* тип данных для вещественной и комплексной частей.

epsfloat

Разница между 1.0 и следующим меньшим представимым числом с плавающей запятой, большим 1.0. Например, для 64-битных двоичных чисел с плавающей запятой в стандарте IEEE-754, eps = 2**-52, примерно 2.22e-16.

epsnegfloat

Разница между 1.0 и следующим меньшим представимым числом с плавающей запятой, меньшим 1.0. Например, для 64-битных двоичных чисел с плавающей запятой в стандарте IEEE-754, epsneg = 2**-53, примерно 1.11e-16.

iexpint

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

machepint

Порядок, дающий eps.

maxчисло с плавающей запятой соответствующего типа

Наибольшее представимое число.

maxexpint

Наименьшая положительная степень основания (2), которая вызывает переполнение.

minчисло с плавающей запятой соответствующего типа

Наименьшее представимое число, обычно -max.

minexpint

Наиболее отрицательная степень основания (2), согласованная с тем, что в мантиссе нет ведущих нулей.

negepint

Порядок, дающий epsneg.

nexpint

Количество битов в порядке, включая его знак и смещение.

nmantint

Количество битов в мантиссе.

precisionint

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

resolutionчисло с плавающей запятой соответствующего типа

Приблизительное десятичное разрешение этого типа, т. е. 10**-precision.

tinyfloat

Возвращает значение для tiny, псевдоним smallest_normal.

smallest_normalfloat

Возвращает значение для наименьшего нормального числа.

smallest_subnormalfloat

Наименьшее положительное число с плавающей запятой с 0 как ведущим битом в мантиссе, следуя IEEE-754.