tf.compat.v1.feature_column.shared_embedding_columns
Список плотных столбцов, преобразующих разреженный категориальный ввод. (устарело)
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
)
Это аналогично 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