Spec-Zone.ru › TensorFlow

tf.compat.v1.feature_column.linear_model

Возвращает линейное предсказание Tensor на основе заданных feature_columns. (устарело)

Предупреждение: tf.feature_column не рекомендуется для нового кода. Вместо этого предварительная обработка признаков может быть выполнена непосредственно с помощью слоёв предварительной обработки Keras или через универсальную утилиту слоёв предварительной обработки Keras или через универсальную утилиту tf.keras.utils.FeatureSpace, построенную на их основе. Подробности см. в руководстве по миграции.
tf.compat.v1.feature_column.linear_model(
    features,
    feature_columns,
    units=1,
    sparse_combiner='sum',
    weight_collections=None,
    trainable=True,
    cols_to_vars=None
)
Устарело: ЭТА ФУНКЦИЯ УСТАРЕЛА. Она будет удалена в будущей версии. Инструкции по обновлению: Используйте слои предварительной обработки Keras вместо этого, либо напрямую, либо через утилиту tf.keras.utils.FeatureSpace. Каждому из tf.feature_column.* соответствует функциональный аналог в tf.keras.layers для предварительной обработки признаков при обучении модели Keras.

Эта функция генерирует взвешенную сумму на основе размерности выходного пространства units. Взвешенная сумма относится к логам в задачах классификации. В задачах линейной регрессии она относится к самому предсказанию.

Примечание о поддерживаемых столбцах: linear_model рассматривает категориальные столбцы как indicator_column. Точнее, предположим, что вход SparseTensor выглядит так:

shape = [2, 2]
{
    [0, 0]: "a"
    [1, 0]: "b"
    [1, 1]: "c"
}

linear_model присваивает веса для наличия "a", "b", "c" неявно, как и indicator_column, в то время как input_layer явно требует обертывания каждого категориального столбца в embedding_column или indicator_column.

Пример использования:

price = numeric_column('price')
price_buckets = bucketized_column(price, boundaries=[0., 10., 100., 1000.])
keywords = categorical_column_with_hash_bucket("keywords", 10K)
keywords_price = crossed_column('keywords', price_buckets, ...)
columns = [price_buckets, keywords, keywords_price ...]
features = tf.io.parse_example(..., features=make_parse_example_spec(columns))
prediction = linear_model(features, columns)

Аргумент sparse_combiner работает следующим образом. Например, для двух признаков, представленных как категориальные столбцы:

# Feature 1

shape = [2, 2]
{
    [0, 0]: "a"
    [0, 1]: "b"
    [1, 0]: "c"
}

# Feature 2

shape = [2, 3]
{
    [0, 0]: "d"
    [1, 0]: "e"
    [1, 1]: "f"
    [1, 2]: "f"
}

при sparse_combiner как "mean", линейная модель выводит соответственно:

y_0 = 1.0 / 2.0 * ( w_a + w_b ) + w_d + b
y_1 = w_c + 1.0 / 3.0 * ( w_e + 2.0 * w_f ) + b

где y_i — это выход, b — это смещение, а w_x — это вес, присваиваемый наличию x во входных признаках.

Аргументы
features Сопоставление ключа с тензорами. _FeatureColumn ищут по этим ключам. Например, numeric_column('price') обратится к ключу 'price' в этом словаре. Значения — это Tensor или SparseTensor в зависимости от соответствующего _FeatureColumn.
feature_columns Итерируемый объект, содержащий FeatureColumns, которые будут использоваться в качестве входных данных для вашей модели. Все элементы должны быть экземплярами классов, производных от _FeatureColumn.
units Целое число, размерность выходного пространства. Значение по умолчанию — 1.
sparse_combiner Строка, определяющая способ агрегации, если категориальный столбец многозначен. За исключением numeric_column, почти все столбцы, передаваемые в linear_model, считаются категориальными. Он комбинирует каждый категориальный столбец независимо. В настоящее время поддерживаются "mean", "sqrtn" и "sum", при этом "sum" является значением по умолчанию для линейной модели. "sqrtn" часто обеспечивает хорошую точность, особенно с bag-of-words столбцами.
  • "sum": не нормализуйте признаки в столбце
  • "mean": выполните l1-нормализацию признаков в столбце
  • "sqrtn": выполните l2-нормализацию признаков в столбце
weight_collections Список имен коллекций, в которые будет добавлен Переменная. Обратите внимание, что переменные также будут добавлены в коллекции tf.GraphKeys.GLOBAL_VARIABLES и ops.GraphKeys.MODEL_VARIABLES.
trainable Если True, также добавьте переменную в коллекцию графа GraphKeys.TRAINABLE_VARIABLES (см. tf.Variable).
cols_to_vars Если не None, должен быть словарь, который будет заполнен отображением из _FeatureColumn в соответствующий список Variable. Например, после вызова у нас может быть cols_to_vars = { _NumericColumn( key='numeric_feature1', shape=(1,): [], 'bias': [], _NumericColumn( key='numeric_feature2', shape=(2,)): []}. Если столбец не создаёт переменных, его значение будет пустым списком. Обратите внимание, что cols_to_vars также будет содержать строковый ключ 'bias', который отображается на список переменных.
Возвращаемые значения
A Tensor, представляющий предсказания/логиты линейной модели. Его форма — (batch_size, units), а тип — float32.
Исключения
ValueError если элемент в feature_columns не является _DenseColumn или _CategoricalColumn.

© 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/linear_model

Spec-Zone.ru

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