Spec-Zone.ru › TensorFlow 1.15

tf.contrib.learn.DNNLinearCombinedEstimator

Эстиматор для моделей TensorFlow Linear и DNN, объединённых для обучения.

Наследуется от: Estimator

tf.contrib.learn.DNNLinearCombinedEstimator(
    head, model_dir=None, linear_feature_columns=None, linear_optimizer=None,
    _joint_linear_weights=False, dnn_feature_columns=None, dnn_optimizer=None,
    dnn_hidden_units=None, dnn_activation_fn=None, dnn_dropout=None,
    gradient_clip_norm=None, config=None, feature_engineering_fn=None,
    embedding_lr_multipliers=None, fix_global_step_increment_bug=False,
    input_layer_partitioner=None
)

ЭТОТ КЛАСС УСТАРЕЛ. См. contrib/learn/README.md для общих инструкций по миграции.

Примечание: Новым пользователям необходимо установить fix_global_step_increment_bug=True при создании эстиматора.

Входные данные fit, train, и evaluate должны иметь следующие атрибуты, иначе произойдёт KeyError: если weight_column_name не None, атрибут с key=weight_column_name, значение которого — Tensor. Для каждого column в dnn_feature_columns + linear_feature_columns.

- if `column` is a `SparseColumn`, a feature with `key=column.name`
  whose `value` is a `SparseTensor`.
- if `column` is a `WeightedSparseColumn`, two features: the first with
  `key` the id column name, the second with `key` the weight column
  name. Both features' `value` must be a `SparseTensor`.
- if `column` is a `RealValuedColumn, a feature with `key=column.name`
  whose `value` is a `Tensor`.
Аргументы
head Объект _Head.
model_dir Каталог для сохранения параметров модели, графа и т. д. Также может быть использован для загрузки контрольных точек из каталога в эстиматор для продолжения обучения ранее сохранённой модели.
linear_feature_columns Итерируемый объект, содержащий все столбцы признаков, используемые линейной частью модели. Все элементы должны быть экземплярами классов, производных от FeatureColumn.
linear_optimizer Экземпляр tf.Optimizer для применения градиентов к линейной части модели. Если None, используется оптимизатор FTRL.
_joint_linear_weights Если True, используется один (возможно, разнесённый по частям) переменный для хранения всех весов линейной модели. Более эффективно при большом количестве столбцов, однако требует, чтобы все столбцы были разреженными и имели комбинирующее свойство «суммы».
dnn_feature_columns Итерируемый объект, содержащий все столбцы признаков, используемые глубокой частью модели. Все элементы должны быть экземплярами классов, производных от FeatureColumn.
dnn_optimizer Экземпляр tf.Optimizer для применения градиентов к глубокой части модели. Если None, используется оптимизатор Adagrad.
dnn_hidden_units Список скрытых узлов на слой. Все слои полностью соединены.
dnn_activation_fn Функция активации, применяемая к каждому слою. Если None, используется tf.nn.relu.
dnn_dropout Если не None, вероятность отбрасывания заданной координаты.
gradient_clip_norm Вещественное число > 0. Если указано, градиенты ограничены по глобальной норме с этим коэффициентом ограничения. См. tf.clip_by_global_norm для получения дополнительной информации.
config Объект RunConfig для настройки параметров выполнения.
feature_engineering_fn Функция инженерной обработки признаков. Принимает признаки и метки, которые являются результатом input_fn, и возвращает признаки и метки, которые будут переданы в модель.
embedding_lr_multipliers Необязательно. Словарь из EmbeddingColumn до множителя float. Множитель будет использоваться для умножения на скорость обучения для переменных вложения.
fix_global_step_increment_bug Если False, для оптимизации линейной и глубокой частей эстиматор требует двух шагов подгонки. Если True, эта ошибка исправлена. Новым пользователям необходимо установить это в True, но по умолчанию значение равно False для обратной совместимости.
input_layer_partitioner Необязательно. Разделитель для входного слоя.
Исключения
ValueError Если и linear_feature_columns, и dnn_features_columns одновременно пусты.
Атрибуты
config
model_dir Возвращает путь, по которому процесс оценки будет искать контрольные точки.
model_fn Возвращает model_fn, привязанный к self.params.

Методы

evaluate

Просмотреть исходный код

evaluate(
    x=None, y=None, input_fn=None, feed_fn=None, batch_size=None, steps=None,
    metrics=None, name=None, checkpoint_path=None, hooks=None, log_progress=True
)

См. Evaluable. (устаревшие аргументы).

Предупреждение: НЕКОТОРЫЕ АРГУМЕНТЫ УСТАРЕЛИ: (batch_size, x, y). Они будут удалены после 2016-12-01. Инструкции по обновлению: Эстиматор отвязан от интерфейса Scikit Learn, перемещён в отдельный класс SKCompat. Аргументы x, y и batch_size доступны только в классе SKCompat, эстиматор будет принимать только input_fn. Пример преобразования: est = Estimator(...) -> est = SKCompat(Estimator(...))
Исключения
ValueError Если хотя бы один из x или y предоставлен, и хотя бы один из input_fn или feed_fn предоставлен. Или если metrics не None или dict.

export

Просмотреть исходный код

export(
    export_dir, input_fn=export._default_input_fn, input_feature_key=None,
    use_deprecated_input_fn=True, signature_fn=None, prediction_key=None,
    default_batch_size=1, exports_to_keep=None, checkpoint_path=None
)

Экспортирует граф вывода в указанный каталог. (устарело)

Предупреждение: ЭТА ФУНКЦИЯ УСТАРЕЛА. Она будет удалена после 2017-03-25. Инструкции по обновлению: Используйте вместо этого Estimator.export_savedmodel().
Аргументы
export_dir Строка, содержащая каталог для записи экспортированного графа и контрольных точек.
input_fn Если use_deprecated_input_fn истинно, то функция, которая, принимая Tensor из Example строк, парсит их в признаки, которые затем передаются модели. В противном случае функция, которая не принимает аргументов и возвращает кортеж из (признаков, меток), где признаки — словарь строк в качестве ключей к Tensor, а метки — Tensor, которые в данный момент не используются (и поэтому могут быть None).
input_feature_key Используется только если use_deprecated_input_fn ложно. Строковый ключ в словаре признаков, возвращаемом input_fn, который соответствует сырым Example строкам Tensor, которые будет принимать экспортированная модель. Может быть только None, если вы используете пользовательскую signature_fn, которая не использует первый аргумент (примеры).
use_deprecated_input_fn Определяет формат сигнатуры input_fn.
signature_fn Функция, возвращающая стандартную сигнатуру и карту именованных сигнатур, принимая Tensor из Example строк, dict из Tensor для признаков и Tensor или dict из Tensor для прогнозов.
prediction_key Ключ для тензора в словаре predictions (выходной данные model_fn) для использования в качестве входных данных predictions для signature_fn. Необязательно. Если None, прогнозы будут переданы signature_fn без фильтрации.
default_batch_size Стандартный размер пакета для Example заполнителя.
exports_to_keep Количество экспортов для сохранения.
checkpoint_path Путь к контрольной точке модели, которая должна быть экспортирована. Если это None (по умолчанию), будет использоваться последняя контрольная точка в export_dir.
Возвращаемое значение
Строковый путь к экспортированному каталогу. Примечание: эта функциональность была добавлена ок. 2016/09/25; клиентам, которые зависят от возвращаемого значения, может потребоваться обработать случай, когда эта функция возвращает None, потому что подклассы не возвращают значение.

export_savedmodel

Просмотреть исходный код

export_savedmodel(
    export_dir_base, serving_input_fn, default_output_alternative_key=None,
    assets_extra=None, as_text=False, checkpoint_path=None,
    graph_rewrite_specs=(GraphRewriteSpec((tag_constants.SERVING,), ()),),
    strip_default_attrs=False
)

Экспортирует граф вывода как SavedModel в указанный каталог.

Аргументы
export_dir_base Строка, содержащая путь к каталогу для записи экспортированной графы и контрольных точек.
serving_input_fn Функция без аргументов, возвращающая InputFnOps.
default_output_alternative_key Имя головки для обработки, если не указано. Не нужно для моделей с одной головкой.
assets_extra Словарь, определяющий, как заполнить каталог assets.extra в экспортированном SavedModel. Каждый ключ должен указывать путь назначения (включая имя файла) относительно каталога assets.extra. Соответствующее значение — полный путь к исходному файлу для копирования. Например, простой случай копирования одного файла без переименования задаётся как {'my_asset_file.txt': '/path/to/my_asset_file.txt'}.
as_text Нужно ли записать прото SavedModel в текстовом формате.
checkpoint_path Путь к контрольной точке для экспорта. Если None (по умолчанию), выбирается самая последняя контрольная точка, найденная в каталоге модели.
graph_rewrite_specs Итерируемый набор GraphRewriteSpec. Каждый элемент создаст отдельную MetaGraphDef в экспортированном SavedModel, помеченную и переписанную в соответствии с указанными параметрами. По умолчанию используется один элемент с меткой по умолчанию ("serve") и без переписывания.
strip_default_attrs Булево значение. Если True, атрибуты с значениями по умолчанию будут удалены из NodeDefs. Подробное руководство см. в Удаление атрибутов с значениями по умолчанию.
Возвращает
Строковый путь к экспортированному каталогу.
Исключения
ValueError Если запрошен неизвестный тип экспорта.

fit

Просмотреть исходный код

fit(
    x=None, y=None, input_fn=None, steps=None, batch_size=None, monitors=None,
    max_steps=None
)

См. Trainable. (аргументы устарели)

Предупреждение: НЕКОТОРЫЕ АРГУМЕНТЫ УСТАРЕЛИ: (batch_size, x, y). Они будут удалены после 01.12.2016. Инструкции по обновлению: Класс Estimator отвязан от интерфейса Scikit Learn, переместившись в отдельный класс SKCompat. Аргументы x, y и batch_size доступны только в классе SKCompat, класс Estimator будет принимать только input_fn. Пример преобразования: est = Estimator(...) -> est = SKCompat(Estimator(...))
Исключения
ValueError Если x или y не None, в то время как input_fn не None.
ValueError Если и steps, и max_steps не None.

get_params

Просмотреть исходный код

get_params(
    deep=True
)

Получить параметры этого оценщика.

Аргументы
deep булево, необязательно

Если True, вернёт параметры этого оценщика и содержащихся в нём подобъектов, являющихся оценщиками.

Возвращает
params сопоставление строки с любым Параметры имен, сопоставленные с их значениями.

get_variable_names

Просмотреть исходный код

get_variable_names()

Возвращает список всех имён переменных в этой модели.

Возвращает
Список имён.

get_variable_value

Просмотреть исходный код

get_variable_value(
    name
)

Возвращает значение переменной, заданной по имени.

Аргументы
name строка, имя тензора.
Возвращает
Массив NumPy — значение тензора.

partial_fit

Просмотреть исходный код

partial_fit(
    x=None, y=None, input_fn=None, steps=1, batch_size=None, monitors=None
)

Инкрементное обучение на наборе образцов. (аргументы устарели)

Предупреждение: НЕКОТОРЫЕ АРГУМЕНТЫ УСТАРЕЛИ: (batch_size, x, y). Они будут удалены после 01.12.2016. Инструкции по обновлению: Класс Estimator отвязан от интерфейса Scikit Learn, переместившись в отдельный класс SKCompat. Аргументы x, y и batch_size доступны только в классе SKCompat, класс Estimator будет принимать только input_fn. Пример преобразования: est = Estimator(...) -> est = SKCompat(Estimator(...))

Ожидается, что этот метод будет вызываться несколько раз последовательно на разных или одних и тех же частях набора данных. Это может реализовать итеративное обучение или обучение вне памяти/онлайн.

Это особенно полезно, когда весь набор данных слишком велик, чтобы поместиться в памяти одновременно. Или когда модель долго сходится, и вы хотите разбить обучение на части.

Аргументы
x Матрица формы [n_samples, n_features...]. Может быть итератором, возвращающим массивы признаков. Образцы входных данных для обучения модели. Если задано, input_fn должно быть None.
y Вектор или матрица [n_samples] или [n_samples, n_outputs]. Может быть итератором, возвращающим массив меток. Значения меток обучения (метки классов в классификации, вещественные числа в регрессии). Если задано, input_fn должно быть None.
input_fn Функция ввода. Если задано, x, y, и batch_size должны быть None.
steps Количество шагов для обучения модели. Если None, обучаться бесконечно.
batch_size Размер мини-пакета для использования на входе, по умолчанию — первое измерение x. Должно быть None, если задан input_fn.
monitors Список экземпляров подкласса BaseMonitor. Используются для обратных вызовов внутри цикла обучения.
Возвращает
self, для цепочки.
Исключения
ValueError Если хотя бы один из x и y задан, а input_fn задан.

predict

Просмотреть исходный код

predict(
    x=None, input_fn=None, batch_size=None, outputs=None, as_iterable=True,
    iterate_batches=False
)

Возвращает предсказания для заданных признаков. (аргументы устарели)

Предупреждение: НЕКОТОРЫЕ АРГУМЕНТЫ УСТАРЕЛИ: (as_iterable, batch_size, x). Они будут удалены после 01.12.2016. Инструкции по обновлению: Класс Estimator отвязан от интерфейса Scikit Learn, переместившись в отдельный класс SKCompat. Аргументы x, y и batch_size доступны только в классе SKCompat, класс Estimator будет принимать только input_fn. Пример преобразования: est = Estimator(...) -> est = SKCompat(Estimator(...))
Аргументы
x Матрица формы [n_samples, n_features...]. Может быть итератором, возвращающим массивы признаков. Образцы входных данных для обучения модели. Если задано, input_fn должно быть None.
input_fn Функция ввода. Если задано, x и 'batch_size' должны быть None.
batch_size Переопределение размера пакета по умолчанию. Если задано, 'input_fn' должно быть 'None'.
outputs список str, имя выходного значения для предсказания. Если None, возвращаются все.
as_iterable Если True, возвращает итератор, который продолжает генерировать предсказания для каждого примера, пока входные данные не закончатся. Примечание: Входные данные должны завершиться, если вы хотите, чтобы итератор завершился (например, убедитесь, что вы передаёте num_epochs=1, если вы используете что-то вроде read_batch_features).
iterate_batches Если True, возвращает всю партию сразу вместо разбиения партии на отдельные образцы. Актуально только когда as_iterable равно True.
Возвращаемое значение
Массив NumPy предсказанных классов или значений регрессии, если конструктор model_fn возвращает Tensor для predictions или список массивов NumPy, если model_fn возвращает dict. Возвращает итерируемый объект предсказаний, если as_iterable имеет значение True.
Исключения
ValueError Если x и input_fn оба предоставлены или оба None.

set_params

Просмотреть исходный код

set_params(
    **params
)

Устанавливает параметры этого оценщика.

Метод работает как с простыми оценщиками, так и с вложенными объектами (например, с конвейерами). В первом случае параметры имеют вид <component>__<parameter>, что позволяет обновлять каждый компонент вложенного объекта.

Аргументы
**params Параметры.
Возвращаемое значение
self
Исключения
ValueError Если params содержат недопустимые имена.

© 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/learn/DNNLinearCombinedEstimator

Spec-Zone.ru

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