Spec-Zone.ru › TensorFlow

tf.compat.v1.feature_column.shared_embedding_columns

Список плотных столбцов, преобразующих разреженный категориальный ввод. (устарело)

Предупреждение: tf.feature_column не рекомендуется для нового кода. Вместо этого предварительная обработка признаков может выполняться непосредственно с помощью слоев предварительной обработки Keras или через универсальную утилиту слоев предварительной обработки Keras или через универсальную утилиту tf.keras.utils.FeatureSpace, построенную на их основе. Подробности см. в руководстве по миграции.
tf.compat.v1.feature_column.shared_embedding_columns(
    categorical_columns,
    dimension,
    combiner='mean',
    initializer=None,
    shared_embedding_collection_name=None,
    ckpt_to_load_from=None,
    tensor_name_in_ckpt=None,
    max_norm=None,
    trainable=True,
    use_safe_embedding_lookup=True
)
Устарело: ЭТА ФУНКЦИЯ УСТАРЕЛА. Она будет удалена в будущей версии. Инструкции по обновлению: Используйте слои предварительной обработки Keras вместо этого, либо напрямую, либо через утилиту tf.keras.utils.FeatureSpace. У каждого из tf.feature_column.* есть функциональный эквивалент в tf.keras.layers для предварительной обработки признаков при обучении модели Keras.

Это аналогично embedding_column, за исключением того, что оно генерирует список столбцов встраивания, которые используют одни и те же весовые коэффициенты встраивания.

Используйте это, когда ваши входные данные разреженные и одного типа (например, идентификаторы видео, просмотренных и показанных, которые используют один и тот же словарь), и вы хотите преобразовать их в плотную форму (например, для подачи в DNN).

Входные данные должны быть списком категориальных столбцов, созданных любой из функций categorical_column_*. Они должны быть одного типа и иметь одинаковые аргументы, за исключением key. Например, они могут быть categorical_column_with_vocabulary_file с одним и тем же vocabulary_file. Некоторые или все столбцы также могут быть weighted_categorical_column.

Аргументы
categorical_columns Список категориальных столбцов, созданных функцией categorical_column_with_*. Эти столбцы производят разреженные идентификаторы, которые являются входными данными для поиска встраивания. Все столбцы должны быть одного типа и иметь одинаковые аргументы, за исключением key. Например, они могут быть categorical_column_with_vocabulary_file с одним и тем же vocabulary_file. Некоторые или все столбцы также могут быть weighted_categorical_column.
dimension Целое число, определяющее размер встраивания, должно быть > 0.
combiner Строка, определяющая способ сведения, если в одной строке несколько записей. В настоящее время поддерживаются 'mean', 'sqrtn' и 'sum', по умолчанию используется 'mean'. 'sqrtn' часто обеспечивает хорошую точность, особенно со столбцами bag-of-words. Каждый из них можно рассматривать как нормализацию на уровне примера для столбца. Для получения дополнительной информации см. tf.embedding_lookup_sparse.
initializer Функция инициализации переменной, используемая для инициализации переменной встраивания. Если не указано, по умолчанию используется truncated_normal_initializer со средним значением 0.0 и стандартным отклонением 1/sqrt(dimension).
shared_embedding_collection_name Необязательное имя коллекции, в которую добавляются общие весовые коэффициенты встраивания. Если не указано, будет выбрано разумное имя на основе имен categorical_columns. Это также используется в variable_scope при создании общих весовых коэффициентов встраивания.
ckpt_to_load_from Строка, представляющая имя/шаблон контрольной точки, из которого необходимо восстановить весовые коэффициенты столбца. Требуется, если tensor_name_in_ckpt не None.
tensor_name_in_ckpt Имя Tensor в ckpt_to_load_from, из которого необходимо восстановить весовые коэффициенты столбца. Требуется, если ckpt_to_load_from не None.
max_norm Если не None, каждое встраивание усекается, если его l2-норма больше этого значения, прежде чем объединять.
trainable Определяет, обучается ли встраивание. По умолчанию True.
use_safe_embedding_lookup Если True, используется safe_embedding_lookup_sparse вместо embedding_lookup_sparse. safe_embedding_lookup_sparse гарантирует отсутствие пустых строк и всех положительных весовых коэффициентов и идентификаторов за счёт дополнительных затрат вычислительных ресурсов. Это относится только к входным тензорам ранга 2 (NxM). По умолчанию True, рассмотрите возможность отключения, если вышеуказанные проверки не нужны. Обратите внимание, что наличие пустых строк не вызовет никакой ошибки, хотя выходной результат может быть 0 или пропущен.
Возвращаемое значение
Список плотных столбцов, преобразующих разреженный ввод. Порядок результатов соответствует порядку categorical_columns.
Исключения
ValueError если dimension не > 0.
ValueError если какой-либо из заданных categorical_columns имеет другой тип или другие аргументы, чем остальные.
ValueError если точно один из ckpt_to_load_from и tensor_name_in_ckpt указан.
ValueError если initializer указан и не является вызываемым.
RuntimeError если включено выполнение в режиме eager.

© 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/compat/v1/feature_column/shared_embedding_columns

Spec-Zone.ru

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