tf.feature_column.categorical_column_with_identity
| Просмотреть исходный код на GitHub |
A CategoricalColumn that returns identity values.
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