Модуль: tf.math

Математические операции.

Примечание: Функции, принимающие Tensor аргументы, также могут принимать любые значения, принимаемые tf.convert_to_tensor.

Примечание: Элементные бинарные операции в TensorFlow следуют правилам вещания NumPy.

TensorFlow предоставляет множество математических функций, включая:

• Основные арифметические операторы и тригонометрические функции.
• Специальные математические функции (например: tf.math.igamma и tf.math.zeta)
• Функции для комплексных чисел (например: tf.math.imag и tf.math.angle)
• Функции агрегации и сканирования (например: tf.math.reduce_mean и tf.math.cumsum)
• Функции для сегментов (например: tf.math.segment_sum)

См.: tf.linalg для функций матриц и тензоров.

О сегментации

TensorFlow предоставляет несколько операций, которые можно использовать для выполнения общих математических вычислений над сегментами тензора. Здесь сегментация — это разбиение тензора по первому измерению, т.е. она определяет отображение первого измерения на segment_ids. Тензор segment_ids должен иметь размер первого измерения, d0, со значениями, представляющими собой последовательные идентификаторы в диапазоне 0 до k, где k<d0. В частности, сегментация матричного тензора представляет собой отображение строк на сегменты.

Например:

c = tf.constant([[1,2,3,4], [-1,-2,-3,-4], [5,6,7,8]])
tf.math.segment_sum(c, tf.constant([0, 0, 1]))
#  ==>  [[0 0 0 0]
#        [5 6 7 8]]

Стандартные segment_* функции предполагают, что индексы сегментов отсортированы. Если у вас неотсортированные индексы, используйте эквивалентную функцию unsorted_segment_. Эти функции принимают дополнительный аргумент num_segments, чтобы выходной тензор можно было эффективно выделить.

c = tf.constant([[1,2,3,4], [-1,-2,-3,-4], [5,6,7,8]])
tf.math.unsorted_segment_sum(c, tf.constant([0, 1, 0]), num_segments=2)
# ==> [[ 6,  8, 10, 12],
#       [-1, -2, -3, -4]]

Функции

abs(...): Вычисляет абсолютное значение тензора.

accumulate_n(...): Возвращает поэлементную сумму списка тензоров.

acos(...): Вычисляет acos от x поэлементно.

acosh(...): Вычисляет обратную гиперболическую косинусу от x поэлементно.

add(...): Возвращает x + y поэлементно.

add_n(...): Складывает все входные тензоры поэлементно.

angle(...): Возвращает аргумент комплексного (или вещественного) тензора поэлементно.

argmax(...): Возвращает индекс с максимальным значением по осям тензора. (устаревшие аргументы)

argmin(...): Возвращает индекс с минимальным значением по осям тензора. (устаревшие аргументы)

asin(...): Вычисляет тригонометрический обратный синус от x поэлементно.

asinh(...): Вычисляет обратный гиперболический синус от x поэлементно.

atan(...): Вычисляет тригонометрический обратный тангенс от x поэлементно.

atan2(...): Вычисляет арктангенс от y/x поэлементно, учитывая знаки аргументов.

atanh(...): Вычисляет обратный гиперболический тангенс от x поэлементно.

bessel_i0(...): Вычисляет функцию Бесселя i0 от x поэлементно.

bessel_i0e(...): Вычисляет функцию Бесселя i0e от x поэлементно.

bessel_i1(...): Вычисляет функцию Бесселя i1 от x поэлементно.

bessel_i1e(...): Вычисляет функцию Бесселя i1e от x поэлементно.

betainc(...): Вычисляет регуляризованный неполный интеграл Бета \(I_x(a, b)\).

bincount(...): Подсчитывает количество вхождений каждого значения в целочисленный массив.

ceil(...): Возвращает наименьшее целое число, не меньшее, чем x, поэлементно.

confusion_matrix(...): Вычисляет матрицу неточностей из предсказаний и меток.

conj(...): Возвращает комплексно сопряжённое значение комплексного числа.

cos(...): Вычисляет cos от x поэлементно.

cosh(...): Вычисляет гиперболический косинус от x поэлементно.

count_nonzero(...): Вычисляет количество ненулевых элементов по измерениям тензора. (устаревшие аргументы) (устаревшие аргументы)

cumprod(...): Вычисляет кумулятивное произведение тензора x по axis.

cumsum(...): Вычисляет кумулятивную сумму тензора x по axis.

cumulative_logsumexp(...): Вычисляет кумулятивную log-sum-exp тензора x по axis.

digamma(...): Вычисляет функцию Пси, производную от Lgamma (логарифм абсолютного значения

divide(...): Вычисляет деление по стилю Python x на y.

divide_no_nan(...): Вычисляет безопасное деление, возвращающее 0, если y равно нулю.

equal(...): Возвращает логическое значение (x == y) поэлементно.

erf(...): Вычисляет функцию ошибок Гаусса от x поэлементно.

erfc(...): Вычисляет дополнительную функцию ошибок от x поэлементно.

exp(...): Вычисляет экспоненту от x поэлементно. \(y = e^x\).

expm1(...): Вычисляет exp(x) - 1 поэлементно.

floor(...): Возвращает наибольшее целое число, не большее, чем x, поэлементно.

floordiv(...): Делит x / y поэлементно, округляя к ближайшему отрицательному целому.

floormod(...): Возвращает остаток от деления поэлементно. Когда x < 0 xor y < 0

greater(...): Возвращает логическое значение (x > y) поэлементно.

greater_equal(...): Возвращает логическое значение (x >= y) поэлементно.

igamma(...): Вычисляет нижнюю регуляризованную неполную гамма-функцию P(a, x).

igammac(...): Вычисляет верхнюю регуляризованную неполную гамма-функцию Q(a, x).

imag(...): Возвращает мнимую часть комплексного (или вещественного) тензора.

in_top_k(...): Проверяет, находятся ли целевые значения в числе лучших K предсказаний.

invert_permutation(...): Вычисляет обратную перестановку тензора.

is_finite(...): Возвращает элементы x, которые являются конечными.

is_inf(...): Возвращает элементы x, которые равны Inf.

is_nan(...): Возвращает элементы x, которые равны NaN.

is_non_decreasing(...): Возвращает True, если x не убывает.

is_strictly_increasing(...): Возвращает True, если x строго возрастает.

l2_normalize(...): Нормализует по измерению axis с помощью L2 нормы. (устаревшие аргументы)

lbeta(...): Вычисляет \(ln(|Beta(x)|)\), агрегируя по последнему измерению.

less(...): Возвращает логическое значение (x < y) поэлементно.

less_equal(...): Возвращает логическое значение (x <= y) поэлементно.

lgamma(...): Вычисляет логарифм абсолютного значения Gamma(x) поэлементно.

log(...): Вычисляет натуральный логарифм от x поэлементно.

log1p(...): Вычисляет натуральный логарифм (1 + x) поэлементно.

log_sigmoid(...): Вычисляет логарифм сигмоиды от x поэлементно.

log_softmax(...): Вычисляет log softmax активации. (устаревшие аргументы)

logical_and(...): Возвращает логическое значение x AND y поэлементно.

logical_not(...): Возвращает логическое значение NOT x поэлементно.

logical_or(...): Возвращает логическое значение x OR y поэлементно.

logical_xor(...): Логическая функция XOR.

maximum(...): Возвращает max от x и y (т.е. x > y ? x : y) поэлементно.

minimum(...): Возвращает min от x и y (т.е. x < y ? x : y) поэлементно.

mod(...): Возвращает остаток от деления поэлементно. Когда x < 0 xor y < 0

multiply(...): Возвращает x * y поэлементно.

multiply_no_nan(...): Вычисляет произведение x и y и возвращает 0, если y равно нулю, даже если x — NaN или бесконечность.

negative(...): Вычисляет числовое отрицание поэлементно.

nextafter(...): Возвращает следующее представимое значение x1 в направлении x2, поэлементно.

not_equal(...): Возвращает логическое значение (x != y) поэлементно.

polygamma(...): Вычисляет полигамма-функцию \(\psi^{(n)}(x)\).

polyval(...): Вычисляет значение многочлена поэлементно.

pow(...): Вычисляет степень одного значения по другому.

real(...): Возвращает вещественную часть комплексного (или вещественного) тензора.

reciprocal(...): Вычисляет обратную величину x поэлементно.

reciprocal_no_nan(...): Выполняет безопасную операцию вычисления обратной величины поэлементно.

reduce_all(...): Вычисляет "логическое И" элементов по измерениям тензора. (устаревшие аргументы)

reduce_any(...): Вычисляет "логическое ИЛИ" элементов по измерениям тензора. (устаревшие аргументы)

reduce_euclidean_norm(...): Вычисляет евклидову норму элементов по измерениям тензора.

reduce_logsumexp(...): Вычисляет log(sum(exp(элементов по измерениям тензора))). (устаревшие аргументы)

reduce_max(...): Вычисляет максимальное значение элементов по измерениям тензора. (устаревшие аргументы)

reduce_mean(...): Вычисляет среднее значение элементов по измерениям тензора.

reduce_min(...): Вычисляет минимальное значение элементов по измерениям тензора. (устаревшие аргументы)

reduce_prod(...): Вычисляет произведение элементов по измерениям тензора. (устаревшие аргументы)

reduce_std(...): Вычисляет стандартное отклонение элементов по измерениям тензора.

reduce_sum(...): Вычисляет сумму элементов по измерениям тензора. (устаревшие аргументы)

reduce_variance(...): Вычисляет дисперсию элементов по измерениям тензора.

rint(...): Возвращает ближайшее целое число к x поэлементно.

round(...): Округляет значения тензора до ближайшего целого числа поэлементно.

rsqrt(...): Вычисляет обратную величину квадратного корня из x поэлементно.

scalar_mul(...): Умножает скаляр на объект Tensor или IndexedSlices.

segment_max(...): Вычисляет максимальное значение по сегментам тензора.

segment_mean(...): Вычисляет среднее значение по сегментам тензора.

segment_min(...): Вычисляет минимальное значение по сегментам тензора.

segment_prod(...): Вычисляет произведение по сегментам тензора.

segment_sum(...): Вычисляет сумму по сегментам тензора.

sigmoid(...): Вычисляет сигмоиду от x поэлементно.

sign(...): Возвращает поэлементное указание знака числа.

sin(...): Вычисляет синус от x поэлементно.

sinh(...): Вычисляет гиперболический синус от x поэлементно.

softmax(...): Вычисляет активации softmax. (устаревшие аргументы)

softplus(...): Вычисляет softplus: log(exp(features) + 1).

softsign(...): Вычисляет softsign: features / (abs(features) + 1).

sqrt(...): Вычисляет квадратный корень из x поэлементно.

square(...): Вычисляет квадрат x поэлементно.

squared_difference(...): Возвращает (x - y)(x - y) поэлементно.

subtract(...): Возвращает x - y поэлементно.

tan(...): Вычисляет тангенс от x поэлементно.

tanh(...): Вычисляет гиперболический тангенс от x поэлементно.

top_k(...): Находит значения и индексы k наибольших элементов для последнего измерения.

truediv(...): Делит x / y поэлементно (используя семантику оператора деления Python 3).

unsorted_segment_max(...): Вычисляет максимальное значение по сегментам тензора.

unsorted_segment_mean(...): Вычисляет среднее значение по сегментам тензора.

unsorted_segment_min(...): Вычисляет минимальное значение по сегментам тензора.

unsorted_segment_prod(...): Вычисляет произведение по сегментам тензора.

unsorted_segment_sqrt_n(...): Вычисляет сумму по сегментам тензора, делённую на sqrt(N).

unsorted_segment_sum(...): Вычисляет сумму по сегментам тензора.

xdivy(...): Возвращает 0, если x == 0, и x / y в противном случае поэлементно.

xlogy(...): Возвращает 0, если x == 0, и x * log(y) в противном случае поэлементно.

zero_fraction(...): Возвращает долю нулей в value.

zeta(...): Вычисляет функцию дзета Гурвица \(ζ(x, q)\).