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} , где:
|
| Возвращаемое значение | |
|---|---|
| Оценщик из заданной модели 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