Среда для быстрого выполнения операций TensorFlow.
Eager Execution — это императивная среда программирования, которая оценивает операции немедленно, без построения графиков. Операции возвращают конкретные значения вместо построения вычислительного графа для последующего запуска, как в случае с Graph
и Session
.
Это упрощает разработку с помощью TensorFlow и модели отладки, поскольку он больше похож на стандартную библиотеку программирования.
Экземпляры EagerSession
являются потокобезопасными.
Вложенные классы
перечисление | EagerSession.DevicePlacementPolicy | Управляет тем, как действовать, когда мы пытаемся выполнить операцию на данном устройстве, но некоторые входные тензоры отсутствуют на этом устройстве. | |
сорт | EagerSession.Options | ||
перечисление | EagerSession.ResourceCleanupStrategy | Управляет очисткой ресурсов TensorFlow, когда они больше не нужны. |
Публичные методы
синхронизированная пустота | закрывать () |
статический EagerSession | создавать () Возвращает EagerSession , настроенный с параметрами по умолчанию. |
статический EagerSession | |
статический EagerSession | initDefault (опции EagerSession.Options ) Инициализирует активный сеанс по умолчанию, который остается активным на протяжении всего времени существования приложения. |
ОперацияBuilder | |
статический EagerSession.Options | параметры () Возвращает объект, который настраивает и создает EagerSession с настраиваемыми параметрами. |
Унаследованные методы
Публичные методы
общедоступная синхронизированная недействительная закрытие ()
общедоступный статический EagerSession create ()
Возвращает EagerSession
, настроенный с параметрами по умолчанию.
ВНИМАНИЕ: Экземпляры EagerSession
, возвращаемые этим методом, должны быть явно освобождены путем вызова close()
когда они больше не нужны. Этого можно достичь, используя технику «попробуй с ресурсами».
Пример использования:
try (EagerSession session = EagerSession.create()) {
Ops tf = Ops.create(session);
// build execute operations eagerly...
}
общедоступный статический EagerSession getDefault ()
Возвращает активный сеанс по умолчанию
После инициализации активный сеанс по умолчанию остается активным на протяжении всей жизни приложения, в отличие от сеансов, полученных с помощью create()
или build()
, которые должны быть закрыты после их использования.
Набор EagerSession.Options
по умолчанию используется для инициализации сеанса при первом вызове. Чтобы переопределить это поведение, можно вызвать initDefault(Options)
с другим набором параметров перед этим первым вызовом.
Пример использования:
// Starting to build eager operations using default session, by calling
// EagerSession.getDefault() implicitly
Ops tf = Ops.create();
// Starting to build eager operations using default session, by calling
// EagerSession.getDefault() explictly
Ops tf = Ops.create(EagerSession.getDefault());
Возврат
- нетерпеливый сеанс по умолчанию
См. также
public static EagerSession initDefault (опции EagerSession.Options )
Инициализирует активный сеанс по умолчанию, который остается активным на протяжении всего времени существования приложения.
Этот метод неявно вызывается при первом вызове getDefault()
, но его также можно вызывать явно для переопределения параметров по умолчанию.
Обратите внимание, что вызов этого метода более одного раза приведет к возникновению IllegalArgumentException
, поскольку сеанс по умолчанию не может быть изменен после его создания. Поэтому важно явно инициализировать его перед первым вызовом getDefault()
из любого потока.
Пример использования:
// Initializing default session to override default options is valid but
// is optional
EagerSession.initDefault(EagerSession.options().async(true));
// Starting to build eager operations using default session, by calling
// EagerSession.getDefault() implicitly
Ops tf = Ops.create();
// Initializing default session more than once or after using it is not
// permitted and throws an exception
EagerSession.initDefault(EagerSession.options().async(true)); // throws
Параметры
параметры | параметры, которые можно использовать для создания сеанса по умолчанию |
---|
Возврат
- нетерпеливый сеанс по умолчанию
Броски
IllegalStateException | если сеанс по умолчанию уже инициализирован |
---|
См. также
public OperationBuilder opBuilder (тип строки, имя строки)
Возвращает конструктор для создания новой Operation
.
Параметры
тип | Операции (т. е. идентифицирует вычисление, которое необходимо выполнить) |
---|---|
имя | для ссылки на созданную операцию в этой области среды. |
Возврат
-
OperationBuilder
для создания операции при вызовеbuild()
. Еслиbuild()
не вызывается, может произойти утечка некоторых ресурсов.
общедоступные статические параметры EagerSession.Options ()
Возвращает объект, который настраивает и создает EagerSession
с настраиваемыми параметрами.
ВНИМАНИЕ: Экземпляры EagerSession
, возвращаемые этим методом, должны быть явно освобождены путем вызова close()
когда они больше не нужны. Этого можно достичь, используя технику «попробуй с ресурсами».
Пример использования:
try (EagerSession session = EagerSession.options().async(true).build()) {
Ops tf = Ops.create(session);
// build execute operations eagerly and asynchronously...
}