Spec-Zone.ru › TensorFlow 1.15

tf.contrib.estimator.DNNRegressorWithLayerAnnotations

Регрессор для моделей TensorFlow DNN с аннотациями слоёв.

tf.contrib.estimator.DNNRegressorWithLayerAnnotations(
    hidden_units, feature_columns, model_dir=None, label_dimension=1,
    weight_column=None, optimizer='Adagrad', activation_fn=tf.nn.relu, dropout=None,
    input_layer_partitioner=None, config=None, warm_start_from=None,
    loss_reduction=losses.Reduction.SUM
)

Этот регрессор функционально идентичен estimator.DNNRegressor в отношении обучения и оценки моделей. Основное отличие заключается в том, что этот классификатор добавляет дополнительные аннотации слоёв, которые могут быть использованы для вычисления интегрированных градиентов.

Интегрированные градиенты — это метод, который позволяет присвоить предсказания классификатора определённым входным признакам (https://arxiv.org/pdf/1703.01365.pdf). Для конкретного входного объекта метод присваивает баллы значимости отдельным признакам пропорционально важности признака для предсказания классификатором.

Обратитесь к estimator.DNNRegressor для примеров кода обучения и оценки моделей с использованием этого регрессора.

Этот регрессор совместим с контрольными точками estimator.DNNRegressor, поэтому следующее должно работать без проблем:

Инициализация обычного оценщика как обычно.

estimator = tf.estimator.DNNRegressor( config, feature_columns, hidden_units, ...)

Обучение оценщика, экспорт контрольной точки.

tf.estimator.train_and_evaluate(estimator, ...)

Инициализация оценщика с аннотациями с теми же настройками, что и

обычный оценщик.

estimator_with_annotations = ( tf.contrib.estimator.DNNRegressorWithLayerAnnotations( config, feature_columns, hidden_units, ...))

Вызов export_savedmodel с теми же аргументами, что и обычный оценщик,

используя контрольную точку, созданную для обычного оценщика.

estimator_with_annotations.export_saved_model( export_dir_base, serving_input_receiver, ... checkpoint_path='/path/to/ordinary/estimator/checkpoint/model.ckpt-1234')

Аргументы
hidden_units Последовательность числа скрытых узлов на каждом слое. Все слои являются полносвязными. Например, [64, 32] означает, что первый слой имеет 64 узла, а второй — 32.
feature_columns Последовательность, содержащая все столбцы признаков, используемые моделью. Все элементы набора должны быть экземплярами классов, производных от _FeatureColumn.
model_dir Директория для сохранения параметров модели, графа и т.д. Это также можно использовать для загрузки контрольных точек из директории в оценщик, чтобы продолжить обучение ранее сохранённой модели.
label_dimension Количество регрессионных целевых значений на пример. Это размер последнего измерения меток и логитов Tensor объекты (как правило, эти объекты имеют форму [batch_size, label_dimension]).
weight_column Строка или _NumericColumn, созданная tf.feature_column.numeric_column, определяющая столбец признаков, представляющий веса. Он используется для понижения или повышения значимости примеров во время обучения. Он будет умножаться на потерю примера. Если это строка, она используется в качестве ключа для извлечения тензора весов из features. Если это _NumericColumn, сырой тензор извлекается по ключу weight_column.key, затем weight_column.normalizer_fn применяется к нему для получения тензора весов.
optimizer Экземпляр tf.Optimizer, используемый для обучения модели. По умолчанию используется оптимизатор Adagrad.
activation_fn Функция активации, применяемая к каждому слою. Если None, будет использована tf.nn.relu.
dropout Если не None, вероятность того, что заданная координата будет исключена.
input_layer_partitioner Необязательно. Разделитель для входного слоя. По умолчанию min_max_variable_partitioner с min_slice_size 64 << 20.
config Объект RunConfig для настройки параметров выполнения.
warm_start_from Путь к файлу в виде строки с контрольной точкой для теплого запуска или объект WarmStartSettings для полной настройки теплого запуска. Если предоставлен строковый путь к файлу вместо WarmStartSettings, все веса запускаются с помощью теплого запуска, и предполагается, что словари и имена тензоров не изменены.
loss_reduction Один из tf.losses.Reduction за исключением NONE. Описывает способ уменьшения потерь обучения по пакету. По умолчанию SUM.
Возвращаемые значения
DNNRegressor с аннотациями слоёв.

© 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/contrib/estimator/DNNRegressorWithLayerAnnotations

Spec-Zone.ru

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