Spec-Zone.ru › TensorFlow 1.15

tf.feature_column.categorical_column_with_identity

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

A CategoricalColumn that returns identity values.

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

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

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

tf.compat.v1.feature_column.categorical_column_with_identity, `tf.compat.v2.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 Если None, операции графа для этого столбца признаков будут завершаться ошибкой для входных данных вне диапазона. В противном случае это значение должно находиться в диапазоне [0, num_buckets), и оно заменит входные данные в этом диапазоне.
Возвращаемое значение
A CategoricalColumn that returns identity values.
Исключения
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/r1.15/api_docs/python/tf/feature_column/categorical_column_with_identity

Spec-Zone.ru

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