Spec-Zone.ru › TensorFlow 2.4

tf.feature_column.categorical_column_with_identity

Просмотреть исходный код на GitHub

Функция, возвращающая идентификаторы.

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

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

См. Руководство по миграции для получения дополнительной информации.

tf.compat.v1.feature_column.categorical_column_with_identity

tf.feature_column.categorical_column_with_identity(
    key, num_buckets, default_value=None
)

Используйте эту функцию, когда ваши входные данные являются целыми числами в диапазоне [0, num_buckets), и вы хотите использовать значение входных данных в качестве категориального идентификатора. Значения за пределами этого диапазона приведут к default_value если указано, в противном случае произойдёт ошибка.

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

Для входного словаря features, features[key] равно либо Tensor, либо SparseTensor. Если Tensor, пропущенные значения могут быть представлены как -1 для целых чисел и '' для строк, которые будут пропущены этой колонкой признаков.

В следующих примерах каждому входу в диапазоне [0, 1000000) присваивается то же значение. Все остальные входы присваиваются default_value 0. Обратите внимание, что буквальный 0 в входе приведет к тому же значению по умолчанию.

Линейная модель:

video_id = categorical_column_with_identity(
    key='video_id', num_buckets=1000000, default_value=0)
columns = [video_id, ...]
features = tf.io.parse_example(..., features=make_parse_example_spec(columns))
linear_prediction, _, _ = linear_model(features, columns)

Встраивание для модели DNN:

columns = [embedding_column(video_id, 9),...]
features = tf.io.parse_example(..., features=make_parse_example_spec(columns))
dense_tensor = input_layer(features, columns)
Аргументы
key Уникальная строка, идентифицирующая входной признак. Она используется в качестве имени колонки и ключа словаря для конфигураций разбора признаков, объектов признаков Tensor и колонок признаков.
num_buckets Диапазон входных и выходных значений [0, num_buckets).
default_value Если задано, значения за пределами диапазона [0, num_buckets) будут заменены этим значением. Если не задано, значения ≥ num_buckets вызовут ошибку, а значения < 0 будут пропущены.
Возвращаемое значение
Функция, возвращающая идентификаторы.
Исключения
ValueError если num_buckets меньше единицы.
ValueError если default_value не находится в диапазоне [0, num_buckets).

© 2020 The TensorFlow Authors. All rights reserved.
Licensed under the Creative Commons Attribution License 3.0.
Code samples licensed under the Apache 2.0 License.
https://www.tensorflow.org/versions/r2.4/api_docs/python/tf/feature_column/categorical_column_with_identity

Spec-Zone.ru

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