Spec-Zone.ru › TensorFlow

tf.random.learned_unigram_candidate_sampler

Выбирает набор классов из распределения, сформированного во время обучения.

Просмотреть псевдонимы

Основные псевдонимы

tf.nn.learned_unigram_candidate_sampler

Псевдонимы для совместимости при миграции

Подробнее см. в руководстве по миграции.

tf.compat.v1.nn.learned_unigram_candidate_sampler, tf.compat.v1.random.learned_unigram_candidate_sampler

tf.random.learned_unigram_candidate_sampler(
    true_classes,
    num_true,
    num_sampled,
    unique,
    range_max,
    seed=None,
    name=None
)

Эта операция случайным образом выбирает тензор выбранных классов (sampled_candidates) из диапазона целых чисел [0, range_max).

Краткое введение в алгоритмы выборки кандидатов см. в справочнике по алгоритмам выборки кандидатов.

Элементы sampled_candidates выбираются из базового распределения без повторений (если unique=True) или с повторениями (если unique=False).

Базовое распределение для этой операции формируется в процессе обучения. Это унимодальное распределение по целевым классам, встретившимся к текущему моменту обучения. Начальный вес каждого целого числа в [0, range_max) равен 1 и увеличивается на 1 при каждом появлении этого числа в качестве целевого класса. Базовое распределение не сохраняется в контрольных точках, поэтому при повторной загрузке модели оно сбрасывается.

Кроме того, эта операция возвращает тензоры true_expected_count и sampled_expected_count, представляющие ожидаемое количество появлений каждого целевого класса (true_classes) и каждого выбранного класса (sampled_candidates) в среднем тензоре выбранных классов. Эти значения соответствуют величинам Q(y|x), определенным в справочнике по алгоритмам выборки кандидатов. Если unique=True, то это вероятности после отклонения, и мы вычисляем их приближенно.

Обратите внимание, что эта функция (как и другие функции *_candidate_sampler) предоставляет только компоненты для реализации различных алгоритмов выборки кандидатов, перечисленных в большой таблице справочника по алгоритмам выборки кандидатов. Алгоритмы вам всё равно нужно реализовать самостоятельно.

Например, согласно этой таблице, выражение «отрицательные примеры» может иметь разный смысл в разных алгоритмах. Так, в NCE «отрицательные примеры» — это S_i (то есть только выбранные классы), которые могут пересекаться с истинными классами, тогда как в Sampled Logistic «отрицательные примеры» — это S_i - T_i, не включающие истинные классы. Возвращаемое значение sampled_candidates соответствует S_i, а не какому-либо конкретному определению «отрицательных примеров» в каком-либо алгоритме. Вы сами должны выбрать алгоритм и вычислить «отрицательные примеры», определенные этим алгоритмом (например, S_i - T_i).

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

Аргументы
true_classes int64-тензор типа Tensor и формы [batch_size, num_true]. Целевые классы.
num_true int. Число целевых классов на обучающий пример.
num_sampled int. Число классов, выбираемых случайным образом.
unique bool. Определяет, должны ли все выбранные классы в пакете быть уникальными.
range_max int. Число возможных классов.
seed int. Начальное значение, специфичное для операции. Значение по умолчанию — 0.
name Имя операции (необязательно).
Возвращает
sampled_candidates Тензор типа int64 и формы [num_sampled]. Выбранные классы. Как отмечалось выше, sampled_candidates могут пересекаться с истинными классами.
true_expected_count Тензор типа float. Имеет ту же форму, что и true_classes. Ожидаемое число появлений каждого элемента true_classes согласно распределению выборки.
sampled_expected_count Тензор типа float. Имеет ту же форму, что и sampled_candidates. Ожидаемое число появлений каждого элемента sampled_candidates согласно распределению выборки.

© 2022 The TensorFlow Authors. All rights reserved.
Licensed under the Creative Commons Attribution License 4.0.
Code samples licensed under the Apache 2.0 License.
https://www.tensorflow.org/api_docs/python/tf/random/learned_unigram_candidate_sampler

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API