tf.compat.v1.train.init_from_checkpoint

Заменяет инициализаторы tf.Variable, чтобы они загружали значения из файла контрольной точки.

tf.compat.v1.train.init_from_checkpoint(
    ckpt_dir_or_file, assignment_map
)

tf.compat.v1.train.init_from_checkpoint не рекомендуется использовать для восстановления значений переменных в TF2.

Для восстановления контрольных точек в TF2 используйте tf.keras.Model.load_weights или tf.train.Checkpoint.restore. Эти API используют объектный метод создания контрольных точек, тогда как tf.compat.v1.init_from_checkpoint полагается на более ненадёжный метод создания контрольных точек на основе имён переменных. В TF2 нет объектного аналога init_from_checkpoint.

Незамедлительно перепишите контрольные точки с помощью объектных API. Подробнее см. в руководстве по переходу.

Контрольную точку на основе имён, созданную с помощью tf.compat.v1.train.Saver, можно загрузить, используя tf.train.Checkpoint.restore или tf.keras.Model.load_weights. Однако может потребоваться изменить имена переменных в модели, чтобы они совпадали с именами переменных в контрольной точке на основе имён. Их можно просмотреть с помощью tf.train.list_variables(path).

Также можно создать assignment_map, сопоставляющий имена переменных в контрольной точке на основе имён с переменными в модели, например:

{
    'sequential/dense/bias': model.variables[0],
    'sequential/dense/kernel': model.variables[1]
}

и использовать tf.compat.v1.train.init_from_checkpoint(path, assignment_map) для восстановления контрольной точки на основе имён.

После восстановления перекодируйте контрольную точку с помощью tf.train.Checkpoint.save или tf.keras.Model.save_weights.

Описание

Используется в блокнотах

Значения загружаются не сразу, а при запуске инициализатора (обычно при запуске операции tf.compat.v1.global_variables_initializer).

Примечание: Это переопределяет операции инициализации по умолчанию для указанных переменных и меняет тип данных.

Карта назначений поддерживает следующий синтаксис:

• 'checkpoint_scope_name/': 'scope_name/' — загрузит все переменные из текущей scope_name из checkpoint_scope_name с совпадающими именами тензоров.
• 'checkpoint_scope_name/some_other_variable': 'scope_name/variable_name' — инициализирует переменную scope_name/variable_name из checkpoint_scope_name/some_other_variable.
• 'scope_variable_name': variable — инициализирует указанный объект tf.Variable тензором 'scope_variable_name' из контрольной точки.
• 'scope_variable_name': list(variable) — инициализирует список секционированных переменных тензором 'scope_variable_name' из контрольной точки.
• '/': 'scope_name/' — загрузит все переменные из текущей scope_name из корня контрольной точки (например, без области видимости).

Поддерживается загрузка в секционированные переменные, представленные в виде '<variable>/part_<part #>'.

Карта назначений может быть словарём или списком пар. Последний вариант необходим, чтобы инициализировать несколько переменных в текущем графе из одной и той же переменной в контрольной точке.

Пример:

# Say, '/tmp/model.ckpt' has the following tensors:
#  -- name='old_scope_1/var1', shape=[20, 2]
#  -- name='old_scope_1/var2', shape=[50, 4]
#  -- name='old_scope_2/var3', shape=[100, 100]

# Create new model's variables
with tf.compat.v1.variable_scope('new_scope_1'):
  var1 = tf.compat.v1.get_variable('var1', shape=[20, 2],
                         initializer=tf.compat.v1.zeros_initializer())
with tf.compat.v1.variable_scope('new_scope_2'):
  var2 = tf.compat.v1.get_variable('var2', shape=[50, 4],
                         initializer=tf.compat.v1.zeros_initializer())
  # Partition into 5 variables along the first axis.
  var3 = tf.compat.v1.get_variable(name='var3', shape=[100, 100],
                         initializer=tf.compat.v1.zeros_initializer(),
                         partitioner=lambda shape, dtype: [5, 1])

# Initialize all variables in `new_scope_1` from `old_scope_1`.
init_from_checkpoint('/tmp/model.ckpt', {'old_scope_1/': 'new_scope_1/'})

# Use names to specify which variables to initialize from checkpoint.
init_from_checkpoint('/tmp/model.ckpt',
                     {'old_scope_1/var1': 'new_scope_1/var1',
                      'old_scope_1/var2': 'new_scope_2/var2'})

# Or use tf.Variable objects to identify what to initialize.
init_from_checkpoint('/tmp/model.ckpt',
                     {'old_scope_1/var1': var1,
                      'old_scope_1/var2': var2})

# Initialize partitioned variables using variable's name
init_from_checkpoint('/tmp/model.ckpt',
                     {'old_scope_2/var3': 'new_scope_2/var3'})

# Or specify the list of tf.Variable objects.
init_from_checkpoint('/tmp/model.ckpt',
                     {'old_scope_2/var3': var3._get_variable_list()})