tf.feature_column.categorical_column_with_identity
| Просмотреть исходный код на GitHub |
Функция, возвращающая идентификаторы.
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