Spec-Zone.ru › TensorFlow 2.9

tf.compat.v1.keras.estimator.model_to_estimator

Создаёт экземпляр Estimator из заданной модели Keras.

tf.compat.v1.keras.estimator.model_to_estimator(
    keras_model=None,
    keras_model_path=None,
    custom_objects=None,
    model_dir=None,
    config=None,
    checkpoint_format='saver',
    metric_names_map=None,
    export_outputs=None
)

Если вы используете инфраструктуру или другие инструменты, которые полагаются на оценщики, вы по-прежнему можете создать модель Keras и использовать model_to_estimator для преобразования модели Keras в оценщик для использования с системами нисходящего уровня.

Пример использования см. на странице: Создание оценщиков из моделей Keras.

Веса выборок:

Оценщики, возвращаемые model_to_estimator , настроены так, чтобы они могли обрабатывать веса выборок (аналогично keras_model.fit(x, y, sample_weights)).

Для передачи весов выборок при обучении или оценке оценщика первый элемент, возвращаемый функцией ввода, должен быть словарем с ключами features и sample_weights. Пример ниже:

keras_model = tf.keras.Model(...)
keras_model.compile(...)

estimator = tf.keras.estimator.model_to_estimator(keras_model)

def input_fn():
  return dataset_ops.Dataset.from_tensors(
      ({'features': features, 'sample_weights': sample_weights},
       targets))

estimator.train(input_fn, steps=1)

Пример с настраиваемой сигнатурой экспорта:

inputs = {'a': tf.keras.Input(..., name='a'),
          'b': tf.keras.Input(..., name='b')}
outputs = {'c': tf.keras.layers.Dense(..., name='c')(inputs['a']),
           'd': tf.keras.layers.Dense(..., name='d')(inputs['b'])}
keras_model = tf.keras.Model(inputs, outputs)
keras_model.compile(...)
export_outputs = {'c': tf.estimator.export.RegressionOutput,
                  'd': tf.estimator.export.ClassificationOutput}

estimator = tf.keras.estimator.model_to_estimator(
    keras_model, export_outputs=export_outputs)

def input_fn():
  return dataset_ops.Dataset.from_tensors(
      ({'features': features, 'sample_weights': sample_weights},
       targets))

estimator.train(input_fn, steps=1)
Аргументы
keras_model Объект скомпилированной модели Keras. Этот аргумент взаимоисключающий с keras_model_path. Оценщик model_fn использует структуру модели для клонирования модели. По умолчанию None.
keras_model_path Путь к сохранённой на диске скомпилированной модели Keras в формате HDF5, которую можно сгенерировать с помощью метода save() модели Keras. Этот аргумент взаимоисключающий с keras_model. По умолчанию None.
custom_objects Словарь для клонирования настраиваемых объектов. Используется с классами, которые не являются частью этого пакета pip. Например, если пользователь поддерживает класс relu6 , который наследуется от tf.keras.layers.Layer, то передайте custom_objects={'relu6': relu6}. По умолчанию None.
model_dir Каталог для сохранения параметров модели Estimator , графа, файлов отчётов для TensorBoard и т. д. Если не задан, будет создан каталог с именем tempfile.mkdtemp
config RunConfig для конфигурации Estimator. Позволяет настроить вещи в model_fn на основе конфигурации, такой как num_ps_replicas, или model_dir. По умолчанию None. Если оба config.model_dir и аргумент model_dir (выше) указаны, аргумент model_dir имеет приоритет.
checkpoint_format Устанавливает формат контрольной точки, сохраняемой оценщиком при обучении. Может быть saver или checkpoint, в зависимости от того, нужно ли сохранять контрольные точки из tf.train.Saver или tf.train.Checkpoint. Этот аргумент в настоящее время по умолчанию saver. При выпуске версии 2.0 значение по умолчанию будет checkpoint. Оценщики используют контрольные точки на основе имён, в то время как модели Keras используют контрольные точки на основе объектов из tf.train.Checkpoint. В настоящее время сохранение контрольных точек на основе объектов из model_to_estimator поддерживается только функциональными и последовательными моделями. По умолчанию 'saver'.
metric_names_map Необязательный словарь, сопоставляющий имена метрик выходных данных модели Keras с пользовательскими именами. Это можно использовать для переопределения значений имен метрик выходных данных модели Keras по умолчанию в случае использования модели с несколькими выводами и для предоставления пользовательских имён для eval_metric_ops в оценщике. Имена метрик модели Keras можно получить, используя model.metrics_names , исключая любые метрики потерь, такие как общая потеря и потери выходных данных. Например, если у вашей модели Keras есть два вывода out_1 и out_2, с потерей mse и метрикой acc, то model.metrics_names будет ['loss', 'out_1_loss', 'out_2_loss', 'out_1_acc', 'out_2_acc']. Имена метрик модели, исключая метрики потерь, будут ['out_1_acc', 'out_2_acc'].
export_outputs Необязательный словарь. Это можно использовать для переопределения значений экспорта выходных данных модели Keras по умолчанию в случае использования модели с несколькими выводами и для предоставления пользовательских имён для export_outputs в tf.estimator.EstimatorSpec. Значение по умолчанию None, что эквивалентно {'serving_default': tf.estimator.export.PredictOutput}. Если не None, ключи должны совпадать с ключами model.output_names. Словарь {name: output} , где:
  • name: произвольное имя для этого выхода.
  • output: класс ExportOutput , такой как ClassificationOutput, RegressionOutput, или PredictOutput. Модели с одним выходом должны указать только одну запись в этом словаре. Модели с несколькими выходами должны указать по одной записи для каждого выхода, одно из которых должно быть названо с помощью tf.saved_model.signature_constants.DEFAULT_SERVING_SIGNATURE_DEF_KEY Если запись не предоставлена, будет создана карта по умолчанию PredictOutput , сопоставленная с predictions.
Возвращаемое значение
Оценщик из заданной модели Keras.
Исключения
ValueError Если ни keras_model, ни keras_model_path не были указаны.
ValueError Если и keras_model, и keras_model_path были указаны.
ValueError Если keras_model_path является URI GCS.
ValueError Если модель keras не была скомпилирована.
ValueError Если был задан неверный формат checkpoint_format.

© 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/versions/r2.9/api_docs/python/tf/compat/v1/keras/estimator/model_to_estimator

Spec-Zone.ru

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