tf.compat.v2.variable_creator_scope

Область, определяющая функцию создания переменной, которая будет использоваться функцией variable().

@tf_contextlib.contextmanager
tf.compat.v2.variable_creator_scope(
    variable_creator
)

variable_creator должна быть функцией со следующим сигнатуром:

def variable_creator(next_creator, **kwargs)

Создатель должен, в конечном счёте, вызвать next_creator для создания переменной, если он хочет создать переменную, а не вызывать напрямую Variable или ResourceVariable. Это помогает сделать создателей композируемыми. Создатель может выбрать создание нескольких переменных, вернуть уже существующие переменные или просто зарегистрировать, что переменная была создана, и передать задачу следующим создателям в очереди. Создатели также могут изменять ключевые аргументы, используемые следующими создателями.

Пользовательские методы доступа в области переменной, в конечном счёте, будут использовать эти пользовательские создатели при создании переменных.

Действительные ключевые аргументы в kwds: initial_value: A Tensor, или объект Python, преобразуемый в Tensor, который является начальным значением для переменной. Начальное значение должно иметь указанную форму, если validate_shape не установлено в False. Также может быть вызываемым объектом без аргументов, который возвращает начальное значение при вызове. В этом случае, dtype должно быть указано. (Обратите внимание, что функции инициализации из init_ops.py должны быть связаны с формой перед использованием здесь.) trainable: Если True, по умолчанию, GradientTapes автоматически отслеживают использование этой переменной. validate_shape: Если False, позволяет переменной быть инициализированной значением неизвестной формы. Если True, по умолчанию, форма initial_value должна быть известна. caching_device: Необязательная строка устройства, описывающая, где должна быть кэширована переменная для чтения. По умолчанию используется устройство переменной. Если не None, кэшируется на другом устройстве. Типичное использование — кэширование на устройстве, где находятся операции, использующие переменную, чтобы избежать дублирования копирования через Switch и другие условные операторы. name: Необязательное имя для переменной. По умолчанию 'Variable' и автоматически уникализируется. dtype: Если установлено, initial_value будет преобразован в заданный тип. Если None, либо тип данных будет сохранён (если initial_value — это тензор), либо convert_to_tensor примет решение. constraint: Функция ограничения, которая будет применена к переменной после обновлений некоторыми алгоритмами. synchronization: Указывает, когда распределённая переменная будет агрегирована. Допустимые значения — константы, определённые в классе tf.VariableSynchronization. По умолчанию синхронизация установлена в AUTO и текущий DistributionStrategy выбирает, когда синхронизировать. aggregation: Указывает, как распределённая переменная будет агрегирована. Допустимые значения — константы, определённые в классе tf.VariableAggregation.

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

Возвращает:

Область, в которой создатель активен